Koko Analytics

説明

Koko Analytics は、プライバシーを尊重した WordPress 向けアナリティクスプラグインです。外部サービスを一切使用していないので、訪問者に関する情報が第三者の機関と共有されることはありません。

さらに、訪問者の個人情報は収集されないほか、訪問者自身でもブラウザ上の “Do Not Track” 設定を有効化することで簡単に追跡を止めることができます。

訪問者の情報を第三者の企業と共有して、利益を出させるのをやめましょう。不必要にサイトを遅くしないようにしましょう。Koko Analytics は訪問者のプライバシーを尊重しながら、重要なことに焦点を絞って、必要なすべての統計情報をお届けします。

特徴

  • プラグアンドプレイ: インストールして有効化するだけで、自動に統計を取得します。
  • プライバシー: 個人情報や訪問者固有の情報は一切追跡されません。
  • GDPR: しっかり準拠しています。
  • データの保管方法: 外部サービスは一切使用していません。訪問者のデータはあなたのものです。
  • パフォーマンス: 急激なトラフィックの増加にも汗一つかかず対応できます。
  • 統計: 訪問者数・ページビュー数・リファラーの3つ、必要なものだけです。
  • Cookie: Cookie を一切使用しない設定も選択できます。
  • スパム判定: リファラースパムを除外するビルトインのブラックリストを備えています。
  • キャッシュ: キャッシュされたページからでも記録が可能です。
  • AMP: AMP を使っているページのトラッキングにも対応しています (現在 公式 AMP プラグイン にのみ対応)。
  • オープンソース: コードは GPL 3.0 ライセンスのもとに提供されています。

貢献

あなたも Koko Analytics に様々な方法で貢献できます。例えば…

スクリーンショット

  • サイトの統計を表示するための Koko Analytics のダッシュボード
  • The settings page where you can exclude certain user roles from being counted.
  • 一定期間に最も閲覧された投稿(またはその他の投稿タイプ)を表示するウィジェット。
  • 過去2週間のサイト訪問者数を素早く表示するダッシュボードウィジェット。

インストール

  1. WordPress の管理画面 で、「プラグイン」→「新規追加」と進み、Koko Analytics で検索し、「今すぐインストール」をクリックします。
  2. プラグインファイルをダウンロードし、koko-analytics.zip の内容をお使いの WordPress のプラグイン ディレクトリ(通常は /wp-content/plugins/ )にアップロードする方法でもかまいません。
  3. プラグインを有効化してください。Koko Analytics はすぐに記録を始めます。
  4. WordPress の管理画面で「ダッシュボード」→「アナリティクス」と進むと、アナリティクスをご確認いただけます。

FAQ

訪問者のプライバシーを尊重していますか?

訪問者につながる可能性のあるものは何も記録されません。訪問者がブラウザの設定で「Do Not Track」を有効にしている場合は、訪問者の追跡は一切行われません。

外部サービスは使っていますか?

いいえ、データがあなたのウェブサイトから出ることはありません。これが、プライバシーを重視する方にとって、 Koko Analytics が素晴らしい選択である理由のひとつです。

Cookie をセットしますか ?

デフォルトでは、そうなっています。しかし、簡単にプラグインの設定より無効化できます。Cookie を使用しない場合でもページビューの検出はできますが、再訪問者は検出できません。

サイトが遅くなったりしませんか?

いいえ、このプラグインはサイトが遅くならないように設計されています。重い処理がある場合、すべてバックグラウンドで行われます。

実際、このプラグインは外部サービスに依存していないため、通常はサードパーティ製の分析ツールよりもはるかに高速です。

ページビューが記録されないのですが…

通常は、これはファイルの権限による問題です。まずは、お使いのサーバーで /wp-content/uploads/pageviews.php が存在して、書き込みができるようになっているかを確認してください。

同意画面のあとで Cookie を利用するにはどうすればいいですか?

まず、デフォルトで Cookie を使用しないように Koko Analytics を設定します。

そして、同意した訪問者には以下のコードを追加するように、Cookie 同意画面プラグインを設定してください。

<script>
if (window.koko_analytics) window.koko_analytics.use_cookie = true;
</script>

ユーザーにダッシュボード画面へのアクセス権限を与えるには

User Role Editor のようなプラグインを使用して、view_koko_analyticsmanage_koko_analytics の権限を付与してください。権限を追加した後、プラグインを再度削除することができます。

「ページビュー」の定義は ?

ページビューは、サイト上のページの閲覧数として定義されます。ユーザーがページに到達した後に再読み込みをクリックした場合、これは別の閲覧としてカウントされます。訪問者が別のページに移動して元のページに戻ると、その閲覧もカウントされます。

「訪問者」の定義は ?

訪問者は、あなたのウェブサイトや特定のページが1回以上閲覧されたセッション数のことを指します。

アナリティクスのダッシュボードを開くと空白のページが表示されるのですが…

最近、たくさんのアドブロッカーで採用されているフィルターリストである「EasyPrivacy」に、Koko Analytics が追加されました。このリストではトラッキング用のスクリプトとダッシュボード用のスクリプトの両方がブロックされており、現在 EasyPrivacy チームとともにこの問題の解決にあたっています。

解決されるまでは、あなたのドメインをアドブロッカーのホワイトリストに含めるようにしてください。

How can I help fund Koko Analytics?

Please visit the Koko Analytics project page on OpenCollective.

評価

2022年10月30日
I check Koko multiple times a day. I like the selectivity of the data it collects. This way my site can say “We don’t collect personal data.” The design of the monitoring screen is great. The time filters are useful. It even supports keyboard shortcuts to navigate between time periods. Clearly a great deal of thought and care went into this plugin. Would pay for it.
2022年9月25日
I use this plugin for two reasons. 1. It provides with a nice GUI what I think I need, and shows information correct. 2. It has an awesome widget that allows me to show "Most read posts" - I love it! The plugin is easy to use, easy to setup, I dont belive it takes many system ressources, I could change the widgets out-put laungage to danish. This is a development I would like to support. thanks Knud Denmark
2022年8月18日 2 replies
I'd been on the lookout for a privacy-focused analytics solution for quite some time. I used to love Shaun Inman's Mint back in the day, and was sad to see there being no real replacement for it. I don't remember how I stumbled onto Koko Analytics, but I sure as hell am glad I did. I have been using it on various websites for a few months now, and it leaves me thoroughly impressed every time I use it. There's so much joy in its simplicity and how it just works. The setup is as easy as chewing gum. It gets you the data you really need to care about, without any fluff. Koko Analytics has fast become one of my favorite WordPress plugins, and it is one of the first plugins I install on any new website.
89件のレビューをすべて表示

貢献者と開発者

Koko Analytics はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“Koko Analytics” は18ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“Koko Analytics” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。

変更履歴

1.0.35 – Oct 21, 2022

  • You can now call koko_analytics.trackPageview( postId ) to manually track a pageview. This is especially useful for Single Page Applications.
  • Update referrer blocklist.
  • If referrer URL is on referrer blocklist, the entire request is now ignored (vs. just the referrer part).
  • Update JavaScript dependencies.

1.0.34 – Sep 19, 2022

  • Track visits to front page (if not a static page) as well.
  • Use gmdate() for determining whether to send cache headers.
  • Update JavaScript dependencies.

1.0.33 – Aug 17, 2022

  • Always show at least 1 visitor if pageviews were recorded that day.
  • Decrease Cache-Control header of REST API responses to 60s.
  • Add button to reset all statistics.
  • Add filter koko_analytics_url_aggregations to modify or add URL aggregations for referrer URL’s.
  • Created an initiative on OpenCollective for others to help fund development and support costs of Koko Analytics. Please visit https://opencollective.com/koko-analytics for more details.

1.0.32 – Jun 2, 2022

  • Fix error in latest release by ensuring Endpoint_Installer class is always loaded when needed.

1.0.30 – Jun 1, 2022

  • Delete option koko_analytics_use_custom_endpoint on plugin uninstall.
  • Only load dashboard-widget.js if user has required capability for viewing stats.
  • Add constant KOKO_ANALYTICS_CUSTOM_ENDPOINT for disabling the custom endpoint entirely. This filter can also be used to manually install the endpoint file to a different file location.
  • Re-attempt installation of the custom endpoint file every hour. This also automatically re-tests whether the custom endpoint is still working as expected. The plugin already did this whenever you visited the dashboard page, but now it simply runs more often and without requiring you to log-in to your WordPress admin.

1.0.29 – Jan 25, 2022

  • Skip empty lines in buffer file to avoid a PHP notice in certain edge cases.
  • Make use of JS library for date presets.
  • Filter out user agents containing “preview”.
  • Normalize referrer URl’s for Yahoo search results.
  • Add class attribute to cron warning so it can be hidden using CSS by targeting .koko-analytics-cron-warning.

1.0.28 – Sep 27, 2021

  • Account for missing configuration object, for example if theme does not properly call wp_head().
  • Cast database result to integer types so we do not have to do it client-side.
  • Cache dashboard requests to REST API for 5 minutes (using browser cache).
  • Use integers for viewbox coordinates (for increased performance).
  • Simple locking mechanism for aggregation job to detect previous runs which are still busy.
  • Add WP CLI command for aggregating stats without having to go through WP Cron: wp koko-analytics aggregate

1.0.27 – May 4, 2021

  • Use defer attribute on script to not block parsing at all.
  • Normalize Pinterest URL’s with and without www subdomain.
  • Fix some missing translations.

1.0.26 – Feb 17, 2021

  • Re-introduce last 28 days by popular request.
  • Fix date presets dropdown not working in WebKit based browsers.
  • Update built-in referrer blocklist.

1.0.25 – Feb 16, 2021

  • Add several new date presets, like yesterday or last week.
  • Add support for entering custom date ranges using keyboard input.
  • Improve algorithm for chart y-axes to prevent huge jumps.
  • Add function for manually printing tracking script: <?php koko_analyics_tracking_script(); ?>
  • Update JS dependencies.

1.0.24 – Jan 20, 2021

  • Append random query parameter to tracking request to avoid beind cached now that the plugin is using a custom tracking endpoint.
  • Update JS dependencies.

1.0.23 – Jan 15, 2021

Major performance improvement by writing an optimized endpoint file containing the correct file paths, regardless of WordPress directory structure set-up.

If your WordPress root directory is not writable, go to the Koko Analytics settings page for instructions on how to manually create this optimized endpoint file.

1.0.22 – Nov 18, 2020

  • Fix PHP warnings in migration script, for trying to unlink unexisting file (eg on new plugin installs).
  • Generate URL to custom endpoint file correctly. Fixes issue with some multilingual plugins not recording pageviews correctly.

1.0.21 – Nov 5, 2020

  • Update option that stores whether to use custom endpoint after unlinking it, to prevent sending requests to an unexisting file.

1.0.20 – Nov 3, 20202

  • Do not use custom endpoint file if using custom uploads directory.
  • Use value from KOKO_ANALYTICS_USE_CUSTOM_ENDPOINT if it is defined.
  • Only call add_cap on administrator role if such a role exists
  • Update JS dependencies.
  • Update built-in referrer blocklist.

1.0.19 – Sep 2, 2020

  • Create buffer file directory if it does not exist yet, eg on a fresh WP install.
  • Update preact and date-fns to their latest versions.
  • Update built-in referrer blocklist.

1.0.18 – Aug 25, 2020

  • Fix issue with tracking not working on AMP powered pages or issuing a request to a non-existing file on cdn.ampproject.org.

1.0.17 – Aug 19, 2020

  • Fix issue when using Modern color scheme introduced in WordPress 5.5.
  • Improve test for custom endpoint file by checking for exact response body.
  • Prevent horizontal scrollbar from showing when hovering chart near edge of screen.

1.0.16 – Jul 21, 2020

  • Fix blank screen on WordPress versions lower than 5.0.
  • Fix settings link showing despite user lacking required capability.
  • Fix code for custom referrer blocklist using filter koko_analytics_referrer_blocklist.
  • Do not use custom endpoint file when site URL differs from WordPress URL.
  • Improve test for custom endpoint file.

1.0.15 – Jun 22, 2020

  • Fix weird date for “this week” preset.
  • Fix weeknames in datepicker.
  • Fix translation files not being loaded. Hopefully…

1.0.14 – Jun 22, 2020

  • Do not use custom tracking endpoint on Multisite installations because it ignores the site-specifix database prefix.
  • Show errors in aggegration process if WP_DEBUG is enabled.
  • Update referrer blocklist.
  • Use wp.i18n for managing translations in JavaScript files.
  • Bump table row count up to 25 per page.
  • Add filter hook: koko_analytics_referrer_blocklist (example)
  • Add filter hook: koko_analytics_ignore_referrer_url (example)

1.0.13 – May 28, 2020

  • Update referrer blocklist.
  • Improve date parsing from URL parameters to account for negative UTC offsets. Fixes an issue with the date jumping back one day.
  • Don’t attempt to install custom endpoint if it was manually installed (using the KOKO_ANALYTICS_USE_CUSTOM_ENDPOINT constant).
  • Revert to using home_url() for the tracker endpoint URL.

1.0.12 – May 14, 2020

  • Add filter koko_analytics_honor_dnt to allow ignoring DoNotTrack.
  • Huge performance improvement for the tracking request if you’re on a standard WordPress installation with the root directory writable.
  • Limit scope of tracking script to prevent variable naming collisions.

1.0.11 – Apr 17, 2020

  • Add setting for specifying default date period when opening analytics dashboard.
  • Add Chrome-Lighthouse to list of ignored HTTP user agents.
  • Show notice on analytics dashboard page when buffer file is not writable.
  • Derive cookie path from home URL to work properly with WordPress installations not living at the root of a domain.
  • Track pageview on window.load instead of window.DOMContentLoaded, to make it easier to overwrite the configuration object.
  • Minor optimizations to tracking script.

1.0.10 – Mar 23, 2020

  • Print configuration object early on in page HTML so it is easier to override it using a cookie consent plugin.
  • Add help text explaining the use of a multi-select element.

1.0.9 – Mar 9, 2020

  • Use arrow keys (without Ctrl-key) for quickly cycling through date ranges.
  • Group chart by month if showing more than 2 (full) months of data.
  • Replace React by Preact to cut JS bundle size in half.
  • Normalize referrer URL’s without protocol.
  • Improve total comparision with previous period.

1.0.8 – Feb 14, 2020

  • Add date preset for last 28 days
  • Add keyboard navigation support for quickly cycling through date periods (Ctrl + Arrow key)
  • Expand referrer aggregation logic. If you have any URL’s you would like to see combined into a single domain, please post them here.
  • Fix referrer URL’s table missing the AUTO_INCREMENT statement.
  • Change dropdown to number input in most viewed posts widget.
  • Show notice on dashboard page if an issue with WP Cron is detected.
  • Improved y-axes in chart when maximum value is lower than 10.
  • Use colors from admin scheme in chart tooltip.

1.0.7 – Jan 30, 2020

  • Aggregate certain referrers, e.g. google.com/search becomes google.com.
  • Use WordPress color scheme (from user profile) for colors in chart.
  • Show more labels on the chart’s x-axes (wide screens only).
  • 過去1時間のページビュー数を表示します。
  • Show day of week to chart tooltip.
  • Use Paul Heckbert’s loose labels (nice numbers) algorithm for labels on y-axes.
  • All colors now have a contrast ratio that is (at least) WCAAG AA compliant.
  • Revert multiple bar chart change (because of user feedback), use inner bar instead.
  • Minor performance optimisations for viewing dashboard page.
  • Fixes “Invalid time” error when re-opening the dashboard in Safari.

1.0.6 – Jan 20, 2020

  • Remember view period when navigating away from analytics dashboard.
  • Add filter hook to prevent loading the tracking script: koko_analytics_load_tracking_script
  • Ignore all user agents containing the word seo
  • Ignore requests if page is loaded inside an iframe.
  • Only read document.cookie if cookie use is actually enabled.
  • In chart, use separate bars instead of stacked bars.

1.0.5 – Dec 30, 2019

  • Add “today” option to date periods preset menu.
  • Hide chart component when viewing just a single day of data.
  • Automatically refresh data in dashboard every minute.
  • Use human readable number format on chart’s y-axes.
  • Show chart elements even if outside of chart container.

1.0.4 – Dec 13, 2019

  • Fix referrer URL’s not being saved correctly.
  • Fix unique pageview detection
  • Fix pretty number with only trailing zeroes.
  • Fix bar chart not stacking properly.
  • Improved display of Twitter or Android app referrers.
  • Improved chart tooltip.
  • Improved styling for small mobile screens.
  • Trim trailing slashes from referrer URL’s.
  • Escape all strings coming from translation files.
  • Filter out common bots by checking user agent in tracking script.

1.0.3 – Dec 6, 2019

  • Fix link to settings page from plugins overview page.
  • Fix REST API URL’s when not using pretty permalinks.
  • Add support for tracking AMP-powered pages.
  • Add setting to disable cookie usage.
  • Handle network request errors on admin pages.
  • Return HTTP 500 error when unable to write to buffer file.
  • Simplify adding post title to post type statistics.
  • Extend browser support to include older browsers.
  • Handle filesystem errors in aggregation process.

1.0.2 – Nov 22, 2019

  • Add icons to datepickers to quickly cycle through selected date periods.
  • Add capabilities view_koko_analytics and manage_koko_analytics to control whether a user role can view or manage statistics.
  • Add setting to automatically delete data older than X months.
  • Add menu item to WP Admin Bar.
  • Update URL when date range changes so page can be refreshed or shared.
  • Update browser history with chosen date ranges.
  • Show total size of Koko Analytics’ database tables on settings page.
  • Improved animations when dashboard data updates.
  • Improved column type constraints for storing data.
  • Improved labels for chart x-axes.
  • Consistent ordering of posts and referrers tables.
  • Remove trailing ? character from referrer URL’s after query parameters are stripped.
  • Fix retrieving post title when post type is excluded from search.

1.0.1 – Nov 14, 2019

  • Add dashboard widget showing site visits over last 14 days.
  • Add widget for showing most viewed posts, pages or any other post type over a given period.
  • Add [koko_analytics_most_viewed_posts] shortcode.
  • Add pagination to tables showing top posts and top referrers.
  • Add settings link to plugin row on plugins overview page in WP admin.
  • Use ASCII for storing textual data. Fixes an issue with error message “specified key is too long” on some MySQL installations when the charset is utf8mb4.
  • Remove all data when uninstalling the plugin. Thanks to Santiago Degetau.
  • Improved memory usage when handling huge bursts of traffic.
  • Load tracking script asynchronously.
  • Styling improvements for the dashboard page.

1.0.0 – Nov 4, 2019

Initial release.