このガイドでは、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 を使用する前に、次のコードを使用して有効になっているかどうかを確認します。
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
このチェックは、現在のコンテキストで API が許可されているかどうかを示します。ただし、ユーザーのブラウザ設定などの要因により、API の使用が妨げられる可能性はあります。プライバシー上の考慮事項により、API のユーザビリティを確実に確認するプログラムによる方法はありません。
次のステップ
以降のセクションでは、アトリビューション レポートの開始について詳しく説明します。