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

セットアップや概要など、ここから始めましょう。

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

Attribution Reporting API を使用すると、イベントレベル レポートと概要レポートの 2 種類のレポートを生成できます。イベントレベル レポートは、集計可能レポートや概要レポートよりも設定が少ないため、イベントレベル レポートから始めるのがよいでしょう。概要レポートには、集計サービスとの統合が必要です。イベントレベル レポートではサポートされていません。

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

イベントレベル レポート

Event-level reports associate a particular ad click or view (on the ad side) with data on the conversion side. To preserve user privacy by limiting the joining of user identity across sites, conversion-side data is very limited, and the data is noisy.

概要レポート

A summary report is an Attribution Reporting API and Private Aggregation API report type. A summary report includes aggregated user data and can contain detailed conversion data, with noise added. Summary reports are made up of aggregate reports. Summary reports allow for greater flexibility and a richer data model than event-level reporting, particularly for some use-cases like conversion values.

実装

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

なお、1 つのイベントソースに対して、 集計可能レポートを使用します「 デモで手順を確認できます。

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

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

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

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


  3. という URL を使用してエンドポイントを設定します。 {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution。
    POST メソッドについては、adtech.js のサンプルコードをご覧ください。.well-known について詳しくは、Wikipedia をご覧ください。

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

概要レポートの生成

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

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

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


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

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

詳しくは、集計可能レポートの説明をご覧ください。

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

概要レポートの追加コンセプト

ここで紹介する実装手順を理解したうえで、以下の概念を概要レポート戦略の計画にお役立てください。

省略可能なステップ

  1. フィルタを設定する（省略可）: <ph type="x-smartling-placeholder">
      </ph>
    1. 以下の手順に従います。 フィルタを使用してカスタムルールを定義します。
    2. 次の場所で集計可能レポートのフィルタに固有の詳細をご確認ください トリガーセクションで explainer。

機能検出をお忘れなく

API を使用する前に、権限ポリシーを使用してページでブロックされていないかどうかを確認してください。 これを行うには、次のコードを実行します。

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

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

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

次のステップ

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

セットアップ

背景

デモとツール

計画

まだ計画中の場合は、以下のドキュメントをご覧ください。