セットアップや概要など、ここから始めましょう。
レポートタイプを選択する
Attribution Reporting API を使用すると、イベントレベル レポートと概要レポートの 2 種類のレポートを生成できます。イベントレベル レポートは、集計可能レポートや概要レポートよりも設定が少ないため、イベントレベル レポートから始めるのがよいでしょう。概要レポートは集計サービスとの統合が必要ですが、イベントレベル レポートは統合できません。
イベントレベル レポートと概要レポートの両方でレポートを設定できます。これらは補完的な関係にあります。
イベントレベル レポート
イベントレベル レポートでは、特定の広告クリックまたは広告ビュー(広告側)とコンバージョン側のデータが関連付けられます。サイト間でユーザー ID の結合を制限することで、ユーザーのプライバシーを保護するため、コンバージョン側のデータは非常に限定的であり、データにノイズが含まれます。
概要レポート
概要レポートは、Attribution Reporting API と Private Aggregation API のレポートタイプです。概要レポートには、集計されたユーザーデータが含まれ、ノイズが加えられた詳細なコンバージョン データが含まれる場合があります。サマリー レポートは、集計レポートで構成されています。
実装
次の手順をお試しください。
特定のイベントソースについて、イベントレベル レポートと集計可能レポートの両方を生成できます。デモで手順を確認できます。
イベントレベルのレポートの生成
イベントレベル レポートを生成するには、最小限の手順を実施する必要があります。
ソースを登録します。手順については、アトリビューション ソースを登録するをご覧ください。クリック数と視聴回数では手順が異なります。
トリガーを登録します。手順については、アトリビューション トリガーを登録するをご覧ください。
URL
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
を使用してエンドポイントを設定します。
POST
メソッドについては、adtech.js のサンプルコードをご覧ください。.well-known
について詳しくは、Wikipedia をご覧ください。
詳しくは、イベントレベル レポートの説明をご覧ください。
概要レポートの生成
概要レポートを生成する大まかな手順は次のとおりです。
ソースを登録します。手順については、アトリビューション ソースを登録するをご覧ください。クリック数と視聴回数では手順が異なります。詳しくは、アトリビューション ソースの登録をご覧ください。
トリガーを登録します。手順については、アトリビューション トリガーを登録するをご覧ください。
URL
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
を使用して、集計可能レポートのエンドポイントを設定します。
POST
メソッドについては、adtech.js のサンプルコードをご覧ください。.well-known
について詳しくは、Wikipedia をご覧ください。レポートをバッチ処理して送信し、集計サービスでさらに処理し、サマリー レポートを生成します。バッチ集計可能レポートをご覧ください。
詳しくは、集計可能レポートの説明をご覧ください。
デバッグ レポートの設定方法については、アトリビューション レポートのデバッグに関するシリーズをご覧ください。
概要レポートの追加コンセプト
ここで紹介する実装手順を理解したうえで、以下の概念を概要レポート戦略の計画にお役立てください。
省略可能なステップ
- フィルタを設定する(省略可):
- フィルタを使用してカスタムルールを定義するの手順に沿って操作します。
- 説明のトリガー セクションで、集計可能レポートのフィルタに固有の詳細を確認します。
機能検出をお忘れなく
API を使用する前に、権限ポリシーを使用してページでブロックされていないかどうかを確認します。これを行うには、次のコードを実行します。
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
この機能検出チェックで true が返された場合、チェックが実行されるコンテキスト(ページ)で API が許可されます。
なお、この確認を行っただけでは、該当ページで API が使用可能であることが保証されるわけではありません。ユーザーがブラウザの設定を使用して API を無効にしているか、他の設定で API の使用を妨げている可能性があります。ユーザーのプライバシーを保護するため、この確認をプログラムで行う方法はありません。
次のステップ
実装を開始する準備ができたら、以下のドキュメントをご覧ください。
セットアップ
背景情報
デモとツール
計画
まだ計画中の場合は、以下のドキュメントをご覧ください。