このガイドでは、Attribution Reporting API を使用したイベントレベル レポートと概要アトリビューション レポートの概要と設定手順について説明します。
まず、以下について学びます。
Attribution Reporting API のレポートタイプを区別する
API の実装とレポート生成の手順を完了する
リファレンスとトラブルシューティング情報を確認する
レポートの種類を選択する
広告キャンペーンのパフォーマンスをさまざまなレベルの詳細とプライバシーで効果的に測定するために、Attribution Reporting API には次の 2 種類のレポートが用意されています。
イベントレベル レポート: 特定の広告クリックまたは広告視聴（ソース）と、対応するコンバージョン データ（トリガー）を関連付けた詳細なデータを提供します。イベントレベル レポートでは、コンバージョン データの量が制限され、レポートにノイズが追加されます。キャンペーンのリーチの測定など、個々のイベントのアトリビューションが重要なユースケースに最適です。
概要レポート: 集計されたユーザーデータを提供します。より詳細なコンバージョン情報も含まれますが、ノイズも追加されます。Attribution Reporting API と Private Aggregation API の両方を使用して、集計レポートから構築され、イベントレベル レポートよりも豊富なデータモデルを提供します。概要レポートは、コンバージョン値の計算や、ユーザー セグメント全体でのキャンペーンのパフォーマンスの分析など、集計された分析情報を必要とするシナリオに特に役立ちます。
実装の概要
以降のセクションでは、各タイプのレポートを生成するための概要を説明します。Attribution Reporting API のデモでは、プロセス全体をステップバイステップで確認できます。
前提条件: ソースとトリガーを登録してレポートを受信するには、サイトに SSL/TLS 証明書（HTTPS）が必要です。
イベントレベルのレポートの生成
イベントレベル レポートを生成する手順は次のとおりです。
ソースを登録する: 広告クリックまたは広告ビューをアトリビューション情報に関連付けます。詳しい手順については、アトリビューション ソースを登録するとアトリビューション ソースの登録をご覧ください。なお、登録プロセスはクリックと視聴で若干異なります。
トリガーを登録する: コンバージョン イベントを記録し、以前に登録したソースにリンクします。手順については、アトリビューション トリガーを登録するをご覧ください。
レポート エンドポイントを設定する: イベントレベル レポートを受信するエンドポイントをサーバーに作成します。エンドポイント 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 が有効になっていることを確認する
API を使用する前に、次のコードを使用して API が有効になっているかどうかを確認します。
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
このチェックは、現在のコンテキストで API が許可されているかどうかを示します。ただし、ユーザーのブラウザの設定やその他の要因により、API が使用できない場合があります。プライバシーに関する考慮事項により、API の使用可能性を明確に確認するプログラムによる方法はありません。
次のステップ
以降のセクションでは、アトリビューション レポートの利用を開始する方法について詳しく説明します。