アナリティクス連携

プライバシーに配慮したアナリティクスをウェブサイトに追加する方法です。

スクリプト設置

このドキュメントの方法で privatestater.js を設置します。

既に設置済みの場合はこのセクションを飛ばしてください。

自動収集されるデータ

スクリプトを設置すると、次のデータが自動で収集されます:

データ	説明	例
訪問者	時間あたりのユニーク訪問者	1 時間単位で集計
ページパス	閲覧した URL パス	`/`, `/about`, `/blog/post-1`
ブラウザ	利用ブラウザ	Chrome, Firefox, Safari
デバイス種別	デバイス分類	Desktop, Mobile, Tablet
言語	ブラウザの言語設定	ko, en, ja
リファラー	流入元	google.com, twitter.com

プライバシー保護の仕組み

IP ハッシュ化: IP アドレスは日付と時刻と組み合わせてハッシュ化されます。元の IP は保存しません。
時間単位の重複排除: 同じ訪問者が同じ 1 時間内に複数回訪問しても、訪問は 1 回として数えます。
クッキー不使用: 訪問者の追跡にクッキーは使いません。

流入元の追跡

URL パラメータで訪問者の流入元を追跡できます。

対応パラメータ

次のいずれかを URL に付けると、自動でリファラーとして記録されます:

パラメータ	用途	例 URL
`src`	一般的なソース	`example.com?src=newsletter`
`source`	一般的なソース	`example.com?source=twitter`
`ref`	紹介	`example.com?ref=partner`
`utm_source`	UTM キャンペーン	`example.com?utm_source=google`

使用例

ニュースレターからリンクする場合:

https://example.com/landing?src=newsletter

SNS で共有する場合:

https://example.com/blog/post?source=mastodon

パートナーサイトから:

https://example.com?ref=partner-website

ソース用パラメータがある場合は、HTTP Referer ヘッダーより優先されます。

クリック追跡

JavaScript API で特定のボタンやリンクのクリックを追跡できます。

基本的な使い方

window.PrivateStater.statsClick("button_id");

実用例

<button onclick="window.PrivateStater.statsClick('signup_button')">
  Sign Up
</button>

<a href="/pricing" onclick="window.PrivateStater.statsClick('pricing_link')">
  View Pricing
</a>

イベントリスナー方式

document.getElementById('cta-button').addEventListener('click', function() {
    window.PrivateStater.statsClick('cta_main');
});

ボタン ID のルール

英数字、ハイフン (-)、アンダースコア (_) のみ
スペースは不可
最大 100 文字

ダッシュボードでの統計閲覧

照会期間

ダッシュボードでは次の期間の統計を表示できます:

期間	説明
1 時間	直近 1〜2 時間
12 時間	直近 12 時間
1 日	直近 24 時間
3 日	直近 3 日
7 日	直近 1 週間
14 日	直近 2 週間
30 日	直近 1 か月
6 か月	直近 6 か月
1 年	直近 1 年

統計の種類

統計	説明
訪問者	時間帯別の訪問者数と比率
ブラウザ	ブラウザ別の訪問者数と比率
デバイス	Desktop / Mobile / Tablet の数と比率
言語	訪問者の言語の数と比率
ページ	閲覧ページの数と比率
リファラー	流入元の数と比率
クリック	クリック数と比率

ボット検出

PrivateStater は既知のボットを自動検出し、別枠で分類します:

検索エンジンクローラー (Googlebot, Bingbot など)
監視ツール (Pingdom, UptimeRobot など)
SNS プレビューボット (Mastodon, Twitter など)

ボットのトラフィックは通常の訪問者統計と分けられ、デバイス種別欄にボット名として表示されます。

トラブルシューティング

統計が表示されない

スクリプトが正しく設置されているか確認します。
YOUR_SITE_ID がダッシュボードのウェブサイト ID と一致しているか確認します。
ブラウザの開発者ツールのコンソールにエラーがないか確認します。
広告ブロッカーがスクリプトをブロックしていないか確認します。

localhost でテストできない

ローカル開発環境や非セキュア接続では統計は記録されません。
本番環境でのみ実際の統計が記録されます。