広告のクリックや表示がコンバージョン(広告主サイトでの購入など)につながった場合を測定します。
対象者
ここでは、Attribution Reporting の基本と基本的な概念について説明しますが、技術的な詳細はあまり説明していません。
- 広告技術または広告技術に従事している場合は、サードパーティ Cookie によって実現される機能をこの API がどのように提供するかについて学びます。API のユースケースで、レポートの生成方法の詳細をご確認ください。
- デベロッパーまたはソフトウェア エンジニアの方は、システム全体の概要をご覧になるか、API をテストして利用してください。
コンバージョンの測定に広告テクノロジー プラットフォームを使用している広告主やパブリッシャーは、API を直接使用する必要はありません。ご利用の広告テクノロジーがこの API との統合を計画している場合は、Attribution Reporting の仕組みを理解しておくことをおすすめします。
Attribution Reporting API とは
現在、広告のコンバージョンの測定は、多くの場合サードパーティ Cookie に依存しています。サードパーティ Cookie を使用するとサイトをまたいでユーザーをトラッキングしたり、ユーザーのプライバシーを妨げたりする可能性があるため、ブラウザはサードパーティ Cookie へのアクセスを制限しています。
Attribution Reporting API を使用すると、サードパーティ Cookie を使用せずに、プライバシーに配慮した方法でこれらの測定を行うことができます。
この API を使用すると、広告主と広告技術プロバイダは、次の場合にコンバージョンを測定できます。
- 広告のクリック数と視聴回数。
- サードパーティの iframe 内の広告(サードパーティの広告技術プロバイダを使用しているパブリッシャー サイト上の広告など)。
- ソーシャル ネットワークや検索エンジンの検索結果ページに表示される広告や、パブリッシャーが独自の広告を配信するなど、ファーストパーティのコンテキストの広告。
これらの用語や概念に詳しくない場合は、プライバシー サンドボックスの用語集をご覧ください。
Try the API
- ブラウザでローカルにテストします。フラグを設定して、特定の試験運用版機能を有効にするよう Chrome ブラウザに指示します。
API を使ったテストに関心をお持ちの場合は、Attribution Reporting: テストと参加をご覧ください。
API の変更
- API の変更を追跡します。
- 2023 年上半期に Attribution Reporting API をリリースした理由をご覧ください。
可用性
Proposal | Status |
---|---|
Conversion journey: app-to-web Web explainer and Android explainer Mailing list announcement |
Available in Chrome and Android for origin trial |
Conversion journey: cross-device Explainer |
This proposal has been archived. There are no current plans for implementation. |
Preventing invalid aggregatable reports using report verification Explainer |
Expected in Chrome in H1 2024 |
Default allowlist for the Attribution Reporting API Permissions-Policy will remain * Mailing list announcement |
Available in Chrome in Q1 2023 |
Configurable Event-Level reporting epsilon GitHub issuek |
Available in Chrome in Q4 2023 |
Padding for Aggregatable reports payload Updated explainer |
Available in Chrome in Q4 2023 |
Phase 1 Lite Flexible Event-Level Flexible event-level configurations explainer |
Available in Chrome in Q4 2023
The ability to customize the number of attribution reports and the number/length of reporting windows. Available in Chrome in Q1 2024 The ability to customize the number of bits of trigger data. |
Support for Attribution Reporting debugging after third-party cookie deprecation Seeking feedback on GitHub |
Expected in Chrome in H1 2024 |
Support for Attribution Reporting API and Aggregation Service for Google Cloud Attribution Reporting API Explainer Aggregation Service Explainer |
Available in Chrome in H2 2023 |
ユースケースと機能
Attribution Reporting API では、広告主またはサードパーティの広告技術プロバイダに提出できる 2 種類のレポートを使用して、さまざまな種類の分析情報にアクセスできます。この 2 種類のレポートは同時に使用でき、補完的です。
- イベントレベル レポートでは、広告側の特定の広告クリックやビューが、コンバージョン側のデータと関連付けられます。コンバージョン側のデータは非常に限定的で、データにノイズが発生します(ごく一部のケースでは、実際のレポートの代わりにランダムなデータが送信されます)。これにより、サイト間でのユーザー ID の結合を防ぐことで、ユーザーのプライバシーが保護されます。プライバシー保護を強化するために、報告は遅れて送信されます。
- 概要レポートは、広告側の特定のイベントに関連付けられません。これらのレポートでは、イベントレベル レポートよりも豊富で忠実度の高いコンバージョン データが提供されます。プライバシー手法を組み合わせることで、サイトをまたいで ID が参加するリスクを軽減できます。
イベントレベル レポート
イベントレベルのレポートでは、広告のクリックや表示に大まかなコンバージョン データが関連付けられます。
![イベントレベルのレポート](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=6&hl=ja)
news.example
のクリック ID 200400600(news.example
のユーザー ID Bob_Doe に付加)が shop.example
での購入につながった。イベントレベル レポートの用途:
- 最適化。「費用対効果を改善するにはどうすればよいですか?」などの質問に回答します。特に、レポート内で広告側の一意の ID を使用できるため、広告のプレースメントの最適化に活用できます。イベントレベル レポートでは、機械学習モデルのトレーニング データを確認できます。
- 大まかなレポート。コンバージョンに関する情報がほとんど必要ない場合。現在のところ、クリックのコンバージョン データの上限は 3 ビットです。つまり、コンバージョンには 8 つのカテゴリのいずれか、ビューには 1 ビットを割り当てることができます。イベントレベル レポートでは、特定の価格やコンバージョンの日時など、詳細なコンバージョン側のデータのエンコードはサポートされていません。
- 不正行為の検出。一部のレポートのデータは、スパム行為や無効なアクティビティの特定に使用できるパターンを理解することで、広告の不正行為の検出と分析に役立ちます。
概要レポート
概要レポート(旧称: 集計レポート)では、より詳細なコンバージョン データが提供されます。クリックやビューのデータとコンバージョン データをより柔軟に結合できます。
詳しくは、概要レポートをご覧ください。
![概要レポートの分析情報の例。](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=6&hl=ja)
news.example
のキャンペーン ID 1234567 は、shoes.example
で 518 件のコンバージョンにつながり、合計費用は 38, 174 ドルでした。コンバージョンの半数は、米国のニューヨーク市のユーザーによるものです。概要レポートはレポート作成のユースケースに最適です。このレポートは、「投資収益率は?」といった疑問の解決に役立ちます。
概要レポートを最適化(コンバージョン データが大まかすぎるため)イベントレベル レポートではサポートされない購入額を最適化するなど、最適化のためには概要レポートの使用が積極的に研究されています。
その他の特徴
この API には他にも次のような機能があります。
- アプリからウェブのアトリビューション: アプリ内の広告を表示またはクリックし、ウェブ上でコンバージョンを達成します。
ブラウザ サポート
- Firefox と Edge ではシグナルを共有していません。
- Safari と Webkit はネガティブであり、広告コンバージョンを測定するための別の API(プライベート クリック測定)を提案しています。
2 つの API は異なりますが、Chrome と WebKit は、デベロッパー エクスペリエンスを簡素化するために、たとえば属性名とレポートの JSON 構造を調整するなどしてオープンに連携しています。
Attribution Reporting API の機能セットは、Safari と WebKit が提案した Private Click Measurement API の機能セットとは異なります。特に注目すべき点は、Attribution Reporting API です。
- ビュースルー測定がサポートされています。
- イベントレベルのレポートを提供できる。
- 概要レポートには、クリック/ビュー側とコンバージョン側の両方に関する豊富な情報が含まれます。
- 広告テクノロジー プラットフォームなどのサードパーティは、パブリッシャーや広告主に代わってレポートを受け取ることができます。
ブラウザの設定
- ユーザーは、
chrome://settings/adPrivacy
のユーザー設定で API をオプトアウトできます。 - シークレット モードでは、API は有効になりません。
- サードパーティ Cookie が無効になっている場合、API は有効になりません。
サイトがアクセスを制御するにはどうすればよいですか?
特定のブラウザで API を使用できる場合、任意のサイト(最上位のドキュメントとスクリプトの両方、同一オリジンの iframe)で API をデフォルトで使用できます。
任意の第三者(たとえば、トップレベル権限を持つスクリプトによってページに追加されていないクロスオリジン広告 iframe など)は、パブリッシャーや広告主が認識していない限り API を使用できません。これらの iframe では、権限ポリシーに基づいて Attribution Reporting API を明示的に有効にする必要があります。
<iframe src="..." allow="attribution-reporting"></iframe>
トップレベルへのアクセス権を持ち、ページにクロスオリジンの iframe を追加するサードパーティも、権限ポリシーを使用して Attribution Reporting API を有効にできます。
サイトは、次のように HTTP レスポンス ヘッダーを送信することで、すべての関係者(最上位レベルのアクセス権を持つスクリプトを含む)に対して Attribution Reporting API を無効にできます。
Permissions-Policy: attribution-reporting=()
Attribution Reporting API の仕組み
Attribution Reporting API を使用すると、相互にリンクされた 2 つのイベント(ユーザーによる広告の表示やクリックなど、パブリッシャーのウェブサイト上のイベントと、その後の広告主サイトでのコンバージョン)を測定できます。
イベントレベル レポート
![イベントレベル レポート](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=6&hl=ja)
ブラウザは、広告テクノロジーが定義したコンバージョン データとクリックまたはビューを照合します。
その後、ブラウザは生成されたレポートを、ある程度遅延とノイズを加えて事前定義されたエンドポイントに送信します。
概要レポート
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=6&hl=ja)
概要レポートは次のように生成されます。
- ユーザーが特別に設定された広告をクリックまたは表示した場合。このイベントは、ユーザーのローカル デバイス上のブラウザが、事前に指定されたアトリビューション設定データとともに記録します。
- その後、ユーザーがコンバージョンに至ると、ブラウザは、この詳細なクリックまたは表示イベント(アトリビューション ソース イベント)と詳細なコンバージョン データ(アトリビューション トリガー データ)を照合します。取得される詳細ディメンションは広告テクノロジー企業によって事前定義され、ブラウザは広告テクノロジーが定義した特定のロジックに従います。ブラウザは、このデータを集計可能レポートに出力します。
- 集計可能レポートはブラウザによって暗号化され、広告テクノロジー サーバーに送信されます。広告テクノロジー サーバーから集計可能レポートは集計サービスに送信され、概要レポートが生成されます。
- その後、広告テクノロジーでサマリー レポートが利用可能になります。サマリー レポートの遅延は、イベントレベル レポートほど遅延しません。
詳しくは概要レポートをご覧ください。
プライバシー
サードパーティ Cookie とは異なり、Attribution Reporting API を使用すると、広告会社はサイトをまたいで個人のアクティビティをトラッキングすることなく、コンバージョンに関する分析情報を取得できます。
Bob という名前の人物について考えてみましょう。ユーザー A が news.example
でニュースを読んでいるときに目にしたのは、1 週間後、ユーザー A が shoes.example
で靴を購入します。
現在、このコンバージョンは、クロスサイト識別子として使用されているサードパーティ Cookie でトラッキングされていました。サードパーティ Cookie を使用すると、広告テクノロジー企業は、news.example
と shoes.example
での Bob のアクティビティに関する多くの詳細にアクセスできます。広告テクノロジーはこれらの情報を結合して、ボブの位置情報、閲覧習慣、news.example
での優先的な閲覧など、ボブの詳細なプロフィールを作成できます。このプロファイルには、shoes.example
での購入、アクティビティ、クレジット カード情報も含まれます。このクロスサイト結合は、広告コンバージョンの測定に役立ちます。ユーザーのプライバシーを阻害します。ボブさんのアクティビティはサイト間で非常に詳細にトラッキングされるため、
![今日のウェブ(統合された ID)と将来のウェブ(分割された ID)を並べて表示](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=6&hl=ja)
少量の情報がサイト間で結合されるため、コンバージョンを測定するには十分ですが、サイト間でのボブさんのアクティビティを詳細にトラッキングするには不十分です。Bob の news.example
と shoes.example
のアクティビティは分離されます。
各レポートタイプの保護設定
イベントレベル レポートは、広告側の識別子とコンバージョン側の少量のデータをリンクします。コンバージョンに関するクロスサイト情報は提供されますが、コンバージョン側の情報は大まかすぎるため、サイト間でユーザー ID を結び付けることはできません。
概要レポートでは、詳細な分析情報が提供されますが、これは集計レベルに限られます。これらの集計可能レポートのコンテンツは広告テクノロジーに送信されるときに暗号化されるため、広告テクノロジーは集計サービスを使用せずにレポートから情報を取得できません。集計サービスは、ノイズの多い集計にのみアクセスします。
イベントレベル レポートと集計レポートの両方で、レート制限などの追加のプライバシー保護が適用されます。
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=6&hl=ja)
詳細: イベントレベル レポートとプライバシー
イベントレベルのレポートでは、次のプライバシー メカニズムに従って、サイトをまたいでユーザーをトラッキングすることなく、コンバージョンに関する分析情報を得ることができます。
- クロスサイト識別子は使用されず、詳細なクロスサイト閲覧アクティビティがデバイスから外部に送信されることもありません。
- イベントレベルのレポートでは、広告側の 64 ビットの情報(
news.example
)をコンバージョン側の 1 ビットまたは 3 ビット(shop.example
)にのみ関連付けます。64 ビットの情報は個々のユーザー ID にマッピングするのに十分なものですが、この 64 ビットはクロスサイト情報が非常に少ない(1 ビットまたは 3 ビットで識別子を保持するには不十分です)ため、十分ではありません。- 広告側の 64 ビットは新しい情報ではありません。ユーザー ID は広告側ですでに利用可能です
news.example
またはadtech.example
は、news.example
での特定のユーザーのアクティビティをすでに認識しています。
- 広告側の 64 ビットは新しい情報ではありません。ユーザー ID は広告側ですでに利用可能です
- 不正行為とクロスサイト トラッキングを防ぐため、追加の保護機能が適用されます。
- 報告は遅れて送信されます。
- コンバージョン データはノイズ処理が施されます。つまり、一定の割合で偽のレポートが生成されます。
- 貢献度が割り当てられたコンバージョン レポートの数は、クリックまたはビューごとに制限されます。
詳細: 概要レポートとプライバシー
概要レポートでは、クリックまたは表示イベントと詳細なコンバージョン データが関連付けられます。 次のプライバシー メカニズムを使用して、サイトをまたいでユーザーをトラッキングすることなく、コンバージョンに関する分析情報を提供します。
- クロスサイト識別子は使用されない。
- 各アトリビューションは、結果のサマリー レポートに複数の貢献を行うことができます。どのユーザーも、特定のクリック(またはビュー)やコンバージョンに対して複数のアトリビューションをトリガーできます。
- データは多くのイベント(多くのユーザー)のレベルまで集計され、個々のイベントを正確に観測することはできません。集計データを確認すると、詳細レベルが高くなると、そのデータの相対的なノイズも増加します。多数のイベントとユーザーを集約したスライスは、有用性を維持するために精度が高くなります。
- 詳細なクリック イベントまたは表示イベントと詳細なコンバージョン データを関連付ける未加工レポートは暗号化され、広告テクノロジー企業は読み取ることができません。このデータを読み取ることができるのは、集計サービスだけです。
- 不正行為とクロスサイト トラッキングを防ぐため、追加の保護機能が適用されます。
- レポートはランダムに遅れて送信されます。
- データのさまざまなスライスに対するクエリにはレート制限があります。
対応してフィードバックを共有する
- API に関する質問については、API リポジトリでイシューを作成してください。
- Attribution Reporting メーリング リストで API の更新とお知らせをご確認ください。
- 技術的なご質問がある場合は、Chromium のバグを報告してください。
- 実装、統合、一般的なベスト プラクティスに関する質問: プライバシー サンドボックス デベロッパー サポート リポジトリでイシューを作成します。