アトリビューション レポートを使ってみる

設定や簡単な概要など、何から始めるかを紹介します。

レポートタイプを選択する

Attribution Reporting API を使用すると、イベントレベル レポートと概要レポートの 2 種類のレポートを生成できます。イベントレベル レポートは、集計レポートやサマリー レポートよりも設定作業が少ないため、まずはこちらをおすすめします。概要レポートには集計サービスとの統合が必要ですが、イベントレベル レポートには必要ありません。

イベントレベル レポートと概要レポートの両方にレポートを設定できます。これらは補完的な関係にあります。

イベントレベル レポート

イベントレベル レポートでは、特定の広告クリックまたは広告ビュー（広告側）とコンバージョン側のデータが関連付けられます。サイト間でユーザー ID の結合を制限することで、ユーザーのプライバシーを保護するため、コンバージョン側のデータは非常に限定的であり、データにノイズが含まれます。

概要レポート

概要レポートは、Attribution Reporting API と Private Aggregation API のレポートタイプです。概要レポートには、集計されたユーザーデータが含まれ、ノイズが加えられた詳細なコンバージョン データが含まれる場合があります。サマリー レポートは、集計レポートで構成されています。

実装

以下の手順をお試しください。

特定のイベントソースについて、イベントレベル レポートと集計可能レポートの両方を生成できます。このデモでは、このプロセスを確認できます。

イベントレベル レポートの生成

イベントレベル レポートを生成するには、最小限の手順が必要です。

  1. ソースを登録します。手順については、アトリビューション ソースを登録するをご覧ください。クリック数と視聴回数では、手順が異なります。

  2. トリガーを登録します。手順については、アトリビューション トリガーを登録するをご覧ください。

  3. 次の URL でエンドポイントをセットアップします。
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    post メソッドについては、adtech.js のサンプルコードをご覧ください。.well-known について詳しくは、こちらをご覧ください。

詳しくは、イベントレベル レポートをご覧ください。

概要レポートの生成

概要レポートを生成する手順は次のとおりです。

  1. ソースを登録します。手順については、アトリビューション ソースを登録するをご覧ください。クリック数と視聴回数では、手順が異なります。詳しくは、アトリビューション ソースの登録をご覧ください。

  2. トリガーを登録します。手順については、アトリビューション トリガーを登録するをご覧ください。

  3. 次の URL を使用して、集計可能レポートのエンドポイントを設定します。
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    post メソッドについては、adtech.js のサンプルコードをご覧ください。.well-known について詳しくは、こちらをご覧ください。

  4. レポートをバッチ処理して送信し、サマリー レポートを生成する集計サービスでさらに処理できるようにします。バッチ集計可能レポートをご覧ください。

詳しくは、概要レポートをご覧ください。

アトリビューション レポートのデバッグに関するシリーズで、デバッグ レポートの設定方法をご確認ください。

概要レポートのその他のコンセプト

ここで紹介した実装手順を理解したうえで、サマリー レポート戦略の計画に役立つ以下のコンセプトをご活用ください。

省略可能なステップ

  1. フィルタを設定する（省略可）:
    1. フィルタを使用してカスタムルールを定義するの手順に沿って操作します。
    2. 説明のトリガー セクションで、集計可能レポートのフィルタに固有の詳細を確認します。

機能検出を忘れないでください

API を使用する前に、Permissions-Policy を使用して、ページでブロックされていないかを検出します。これを行うには、次のコードを実行します。

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

この機能検出チェックが true を返した場合、チェックが実行されたコンテキスト（ページ）で API が許可されます。

このチェックだけでは、該当ページで API が使用可能であることが保証されるわけではありません。ユーザーがブラウザの設定で API を無効にしている場合や、他の設定で API の使用を妨げている場合もあります。ユーザーのプライバシーを保護するため、これをプログラムで確認する方法はありません。

次のステップ

実装を開始する準備ができたら、以下のドキュメントをご確認ください。

設定

背景

デモとツール

計画

まだ計画段階の場合は、次のドキュメントを参照してください。