Skip to content

アナリティクスイベントを収集する ​

公開済みの HTML ページには、すでに DECA Edge のアナリティクスビーコンが含まれています。サイトを仕上げる過程でデプロイメントパイプラインが挿入するため、スクリプトの設置も、第三者ホストへの送信も不要です。

ビーコンは同じ distribution の POST /_collect にページビューを送ります。成功すると 202 が返ります。

ページビューを確認する ​

公開中のサイトを開き、数ページ移動してから、コンソールの Analytics を開きます。直近のアクティビティはまず Realtime に現れます。集計パネルの更新には少し時間がかかることがあります。

ビーコンが記録するのは次のとおりです。

  • n — pageview
  • u — パスとクエリ文字列。アトリビューションパラメータはここから解析されます
  • r — 最初のヒットでは参照元ドメイン、それ以降は直前のパス
  • s — セッションシード。30 分の無操作、または UTC の午前 0 時で入れ替わります
  • p — イベントプロパティ

Edge はクライアント IP を取り除き、登録可能な参照元ドメインだけを保存し、永続的な訪問者 ID は作らず、識別に localStorage も使いません。訪問者ハッシュは毎日入れ替わります。

カスタムイベントを送る ​

ユーザーが対象の操作を完了したときに、ページから POST します。edge_s セッションクッキーを再利用すると、カスタムイベントは同じセッションのページビューと結びつきます。

javascript
function sessionSeed() {
  const match = document.cookie.match(/(?:^|; )edge_s=([^;]*)/);
  return match ? decodeURIComponent(match[1]) : '';
}

function track(name, properties = {}) {
  return fetch('/_collect', {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    credentials: 'same-origin',
    keepalive: true,
    body: JSON.stringify({
      n: name,
      u: location.pathname + location.search,
      r: document.referrer,
      s: sessionSeed(),
      p: properties
    })
  });
}

track('select_plan', { plan: 'pro' });

カスタムプロパティは、まず観測データとして受け付けられます。ゴールの述語やアナリティクスの内訳で使う前に、必要なものは宣言してください。アナリティクスプロパティを宣言する を参照してください。

イベント名、パス、プロパティにシークレットや個人データを送らないでください。Edge は distribution の PII ポリシーをプロパティに適用しますが、それはガードレールであり、不要なデータを集めてよい理由ではありません。

収集が公開しないもの ​

エージェントと API クライアントは集計済みアナリティクスを照会できますが、生の collect エンベロープを読むことも、MCP 経由でイベントを書き込むこともできません。イベントは distribution の /_collect 訪問者レーンから入ります。

収集は distribution あたり 256 KiB、毎分 60 リクエストまでです。制限 を参照してください。

次に読む ​