コンバージョン アトリビューションの測定には、パブリッシャー、広告主、配信広告テクノロジー（広告を配信するエンティティ）、測定プロバイダなど、複数の関係者が関与することがあります。このドキュメントでは、一般的なコンバージョン測定シナリオを例に挙げていますが、一般に Attribution Reporting API（ARA）からアトリビューション レポートを受け取るには、このドキュメントに記載されている統合手順を実施していることを確認する必要があります。
たとえば、パブリッシャーが広告配信を担当する広告テクノロジーは一般的に、クリエイティブのマークアップを提供する当事者、クリエイティブのインプレッションまたはトラッキング ピクセルを提供する当事者、パブリッシャーのページの広告スロットの SDK またはタグを提供する当事者が含まれます。これらの広告テクノロジーは、ARA からアトリビューション レポートを受け取れる場合もあれば、受けたくない場合もありますが、ダウンストリームの広告テクノロジーがアトリビューション レポートを受け取れるようにします。
また、広告主は、クロスネットワーク アトリビューションやその他のレポート機能でサードパーティのコンバージョン測定プロバイダを使用している場合もあります。広告主はこのデータを使用して、複数の固有のパブリッシャーとチャネルにおける広告費用対効果を把握します。そのため、こうしたユースケースをサポートするために Attribution Reporting API を有効化する方法を DSP または広告サーバーが理解することが重要です。広告主様がサードパーティを利用したい場合は、サードパーティの測定プロバイダを利用するか、API からレポートを登録して受信する社内サーバーをセットアップすることで、引き続きご利用いただけます。
Attribution Reporting API を使用すると、複数の広告テクノロジーが同じインプレッションまたはコンバージョンのアトリビューション ソースとトリガーを登録し、API から個別のレポートを受け取ることができます。たとえば、DSP は Attribution Reporting API から独自のアトリビューション レポートを取得できるほか、広告主の第三者測定プロバイダ向けに個別のレポートを提供することもできます。広告テクノロジーが API からレポートを受け取るには、アトリビューション ソースとトリガーの両方を登録する必要があります。アトリビューションは、広告テクノロジーが個別に API に登録したアトリビューション ソースとトリガー間で行われます。
一般的なコンバージョン測定シナリオ
このセクションでは、コンバージョン測定の一般的な 2 つのシナリオを見ていきます。
シナリオ 1: 配信中の広告テクノロジーとサードパーティの測定プロバイダの両方が Attribution Reporting API からレポートを受け取る必要がある
広告主は、サードパーティの測定プロバイダを使用して広告枠にコンバージョンを関連付けたいと考えています。また、クリエイティブをホストする広告テクノロジーは、広告枠にコンバージョンを関連付けたいと考えています。これは、広告クリエイティブのマークアップを提供し、独自のアトリビューション レポートを作成し、サードパーティの測定プロバイダや分析プロバイダと統合している広告主と連携する DSP または広告主の広告サーバー（第三者広告サーバー - 3PAS）によく見られます。
この場合、配信広告テクノロジーは、現在の設定でクリック イベントとインプレッション イベントを発生させる当事者でもあります。配信広告テクノロジーは、新しい attributionsrc を適切な場所に設定し、リダイレクトが正しく設定されるようにする必要があります。また、配信広告テクノロジーと第三者測定プロバイダの両方で、両者が登録されており、サーバーが Attribution Reporting API のリクエストを受信して応答する準備ができていることを確認する必要があります。
一般的なキャンペーン設定は次のようになります。
広告主の広告サーバー（3PAS）は、広告クリエイティブのマークアップを DSP に提供します。このマークアップには、第三者測定プロバイダのインプレッション トラッキング ピクセルとクリック トラッキング ピクセルが含まれます。広告サーバーでは、広告クリエイティブのマークアップに
attributionsrcが含まれていることを確認する必要があります。DSP には、インプレッション トラッキング ピクセルとクリック トラッキング ピクセルを追加する機能があり、入札に使用する最終的な広告クリエイティブ マークアップに
attributionsrcが含まれていることを確認します。
シナリオ 2: Attribution Reporting API からレポートを受け取る必要があるのは第三者測定プロバイダのみ
広告主は、サードパーティの測定プロバイダを使用して広告枠にコンバージョンを関連付けることを希望していますが、クリエイティブをホストする広告テクノロジーにはアトリビューション測定の要件がありません。これは、クリエイティブをホストし、アトリビューション レポートを使用する予定がなく、DSP パートナーまたは測定タグ付け会社（第三者広告サーバー、測定プロバイダ、分析プロバイダなど）のために Attribution Reporting API を有効にしたいと考えているパブリッシャー、SSP、パブリッシャー広告サーバーによく見られます。
この場合、現在の設定でクリック イベントとインプレッション イベントの配信担当者は、新しい attributionsrc 属性をクリエイティブに追加して、リダイレクトが意図したとおりに動作するようにする必要があります。これは各パブリッシャーの統合に大きく依存しますが、クリック イベントの場合は、SSP、配信広告テクノロジー、またはパブリッシャー自体で発生する可能性があります。インプレッション イベントの場合、第三者測定プロバイダが一般的です。
シナリオ 1 の一般的なキャンペーン設定の例では、パブリッシャーの広告サーバー、SSP、パブリッシャー自身が、DSP から提供された attributionsrc 属性をパブリッシャーのページに設定するだけで済みます。
実装の詳細
次の表に、Attribution Reporting API の実装手順の概要を示します。
| 歩数 | 仕事の責任 | 例 |
|---|---|---|
| ステップ 1: 既存のクリエイティブと測定コードでアトリビューション ソースを有効にする | インプレッション イベントの呼び出しやクリック イベントの処理を行うエンティティが attributionsrc 属性を追加します。 |
クリック イベントの場合、通常はクリエイティブをレンダリングする購入者（DSP/広告主の広告サーバー）が属性を追加します。
インプレッション イベントの場合、デマンドサイド プラットフォーム（DSP）、サプライサイド プラットフォーム（SSP）、パブリッシャー、広告サーバー、測定プロバイダがこの属性を追加します。この属性は、パブリッシャーの設定に依存します。 VAST 形式を使用する動画広告の場合は、パブリッシャーと動画 SDK が属性を追加します。 |
| ステップ 2: サードパーティのオリジンのアトリビューション レポートを有効にする | 既存のリダイレクト パスを 302 リダイレクトとともに使用している場合、これは追加の設定なしですぐに機能します。 302 リダイレクトを使用できない場合は、 |
通常は、attributionsrc 属性がクリエイティブに追加されている限り、第三者のリダイレクトは Attribution Reporting API の呼び出しを受け取ります。 |
| ステップ 3: Attribution Reporting API リクエストに対するレスポンスを設定する | Attribution Reporting API からレポートを受け取るエンティティ | 広告主がご利用の DSP と第三者測定プロバイダ |
各ステップの詳細は、パブリッシャーのページでクリエイティブがどのようにレンダリングされて配信されるかと、Attribution Reporting API から送信されたレポートを受け取る広告テクノロジー エンティティによって異なります。
ステップ 1: 既存のクリエイティブと測定コードでアトリビューション ソースを有効にする
最初のステップでは、アトリビューション ソースを有効にします。
attributionsrc 属性の仕組み
新しい attributionsrc 属性は、Attribution Reporting API リクエストの送信先を指定します。インプレッション イベントとクリック イベントを発生させるエンティティは、attributionsrc 属性を使用してクリエイティブを更新する必要があります。attributionsrc は、既存のクリック イベントとインプレッション イベントに追加する必要があります。空にすることも、空にすることもできます。
リダイレクトを使用するクリック イベントの場合は、attributionsrc 属性をナビゲーションに追加する必要があります。ナビゲーション後の 302 リダイレクトでは、attributionsrc 属性を追加する必要はなく、最初のナビゲーションで attributionsrc が追加されている限り、ARA の対象となります。
attributionsrc が空の場合、ARA リクエストはアンカータグの href 属性で定義された URL（リンク先 URL）に送信されます。attributionsrc 属性が定義されている場合、ARA リクエストは attributionsrc 属性で定義された URL に送信されます。リンク先 URL でもソースを登録できます。
通常、リンク先 URL をホストするサーバーが Attribution Reporting API のリクエストを受信して応答できる場合は、空の attributionsrc 属性を使用します。Attribution Reporting API リクエストを別のサーバーに送信する場合は、独自の attributionsrc URL を定義します。
空の attributionsrc 属性の例:
| 既存の設定 | ARA を統合した場合 |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
attributionsrc 属性が空の場合、Attribution Reporting API リクエストはアンカータグの href 属性で定義された URL に送信されます。
空でない attributionsrc 属性の例:
| 既存の設定 | ARA を統合した場合 |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>
|
attributionsrc が空でない場合、Attribution Reporting API リクエストは attributionsrc タグで定義された URL に送信されます。リンク先 URL でもソースを登録できます。
クリック イベントとインプレッション イベント用の attributionsrc を追加
- クリック イベント:
attributionsrcの追加を担当するエンティティは通常、配信広告テクノロジーです。- クリック イベントを含むアンカータグには、
attributionsrc属性を追加する必要があります window.openを使用したクリックでは、window.open呼び出しのwindowFeatures引数を使用してアトリビューション ソースを指定する必要があります。
- インプレッション イベント:
attributionsrcを追加するエンティティは通常、配信広告テクノロジーと測定プロバイダです。<img>タグまたは<script>タグから配信されたインプレッション イベントには、attributionsrc属性を含める必要があります。- Fetch API を使用したインプレッション イベントでは、fetch API 呼び出しに渡される options 引数に
attributionReportingオブジェクトを含める必要があります。
クリック イベントとインプレッション イベントに必要な変更の概要については、次の表をご覧ください。
| イベント | タグ | 既存の設定 | ARA 統合後 |
|---|---|---|---|
| 。 | HTML |
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
| JavaScript | window.open('[CLICKTHROUGH_URL]', '_blank'); |
window.open('[CLICKTHROUGH_URL]', '_blank', 'attributionsrc'); |
|
| インプレッション | HTML <img> タグ |
<img src="[IMPRESSION_URL]" />
|
<img src="[IMPRESSION_URL]" attributionsrc />
|
| HTML <script> タグ |
<script src="[IMPRESSION_URL]"></script>
|
<script src="[IMPRESSION_URL]" attributionsrc></script>
|
|
| JavaScript |
const options = {...}window.fetch("[IMPRESSION_URL]", options);
|
const options = { attributionReporting: { eventSourceEligible: true, triggerEligible: false, }, // ...}
|
Protected Audience オークションでアトリビューション ソースの登録を有効にする
Protected Audience のオークションでコンバージョンを測定する場合、attributionsrc を使用する代わりに、registerAdBeacon/registerAdMacro および setReportEventDataForAutomaticBeacons/reportEvent を使用してアトリビューション ソースの登録を有効にできます。
Protected Audience シグナルのレポートの場合、registerAdBeacon 関数はレポート ワークレット内で、registerAdMacro は購入者の成約レポート ワークレット内で利用できます。その後、Fenced Frame Ads Reporting API の reportEvent 関数と setReportEventDataForAutomaticBeacons 関数を使用して、広告フレーム内のイベントデータを登録済みのビーコンとマクロに追加できます。これにより、Protected Audience レポート ワークレットのシグナルと広告クリエイティブ フレーム イベント ペイロードを相互に関連付けられるようになります。
フレームからの reportEvent 呼び出しによってビーコンとマクロがトリガーされた場合、またはブラウザにより自動ビーコンがトリガーされたときに、Attribution-Reporting-Eligible HTTP ヘッダーがリクエストに追加されます。ビーコンのレスポンスを使用して、アトリビューション ソースを登録できます。第三者による測定を許可するため、ビーコンのリクエストはリダイレクトされることがあります。
詳しくは、Fenced Frame Ad Reporting API の説明ページの Attribution Reporting のサポートセクションをご覧ください。
VAST フォーマットのアトリビューション レポートを有効にする
VAST は、動画広告枠の配信と測定のための一般的なフォーマットです。この標準で定義されているイベントの多くは、Attribution Reporting API への登録の対象となるソースイベントとしてみなすことができます。詳しくは、アトリビューション レポートのサポートに関する VAST の追加条項をご覧ください。簡単に言うと、<Tracking>、<Impression>、<*ClickThrough>、<*ClickTracking> イベントはすべて、潜在的なアトリビューション ソース イベントです。すべての VAST の実装において、これらのイベントの登録資格要件に対応する必要があります。
VAST の追加条項では、これらの要素の新しい属性が定義されており、アトリビューション登録専用のセカンダリ URL を設定できます。イベントに attributiontype="DOUBLE_PING" と attributionsrc="[URL]" が含まれている場合、そのイベントを配信するコードでは、Attribution Reporting API を有効にする際に attributionsrc 属性の値として [URL] を使用する必要があります。VAST の追加条項には各シナリオの例が記載されています。
最大限のカバレッジを確保するため、VAST 実装では、イベント ping の呼び出し時に、リストにあるすべてのイベントがデフォルトで登録有効になるようにする必要があります。たとえば、<Impression> イベント URL を呼び出す場合、リクエストの送信に使用される <img> 要素（またはフェッチ呼び出しの同等の要素）で（空の）attributionsrc 属性を使用し、受信側が常にそのイベントを Attribution Reporting API に登録できるようにします。
ステップ 2: サードパーティのオリジンのアトリビューション レポートを有効にする
サードパーティが Attribution Reporting API を使用できるようにするには、既存のリダイレクトを使用するか、サードパーティのリストを attributionsrc 属性に追加します。ほとんどの場合、広告テクノロジーごとに独自のインプレッション トラッカーを使用するため、クリック トラッカーにはリダイレクトの方が重要です。
既存のリダイレクト チェーン内のサードパーティのオリジンを処理する
一般的な広告のクリックスルーでは、多くのクリック トラッカーが、最終的なランディング ページへのナビゲーションの一環として 302 リダイレクトのチェーンとして存在することがあります。元のクリック ターゲットに attributionsrc アノテーションが付いているか、Protected Audience API の registerAdBeacon/registerAdMacro に登録されている場合、リダイレクト チェーン内のすべてのリクエストは Attribution Reporting API に登録できます。リダイレクト チェーンの広告テクノロジーも登録する必要があります。
最初のリクエストの本文はリダイレクトでは送信されません。Protected Audience オークションでは、reportEvent に渡された eventData と setReportEventDataForAutomaticBeacons をリダイレクトの一部として使用する必要がある場合は、リダイレクト URL の一部として明示的に渡す必要があります。
次の例では、アトリビューション レポートの生成と受信を行う 2 つの異なるエンティティとして、配信広告テクノロジー（serving-adtech.example）と第三者測定プロバイダ（3p-measurement.example）を使用します。この例の配信広告テクノロジーは、パブリッシャーのサイトにクリエイティブを表示する DSP で、独自のレポート プロダクトがあります。第三者測定プロバイダは、広告主がコンバージョン レポートに使用するエンティティである場合があります。
ソースの登録時に、次の手順が行われます。
serving-adtech.exampleがクリエイティブにattributionsrc属性を設定します。ユーザーがパブリッシャーのページにアクセスすると、ブラウザがserving-adtech.example.にリクエストを送信します。serving-adtech.exampleは、Attribution-Reporting-Register-SourceヘッダーとLocationヘッダーを返します。serving-adtech.exampleは、Attribution-Reporting-Register-Sourceヘッダーを使用して、登録するソースに関するメタデータで応答します。serving-adtech.exampleは、Locationヘッダーを使用して3p-measurement.exampleへのリダイレクトをインクルードします。第三者への302リダイレクトをサポートするために、既存のクリック トラッキング フローでLocationヘッダーがすでに使用されている可能性があります。
- ブラウザは
serving-adtech.exampleからレスポンスを受け取り、Attribution-Reporting-Register-Sourceヘッダーを解析します。ブラウザは、serving-adtech.exampleをレポート元として使用してソースイベントを保存します。 - このリクエストはリダイレクトであるため、ブラウザは
3p-measurement.exampleに対しても新しいリクエストを行います。 3p-measurement.exampleは、Attribution-Reporting-Register-Sourceヘッダーを含むレスポンスを返します。- ブラウザは
3p-measurement.exampleからこのレスポンスを受け取り、Attribution-Reporting-Register-Sourceを読み取ります。ブラウザは、3p-measurement.exampleをレポート元として使用してソースイベントを保存します。
リダイレクト チェーンにないサードパーティのオリジンには attributionsrc を使用する
複数のレポーターオリジンがナビゲーション イベントでソースを登録する必要があるものの、なんらかの理由でリダイレクト チェーンに追加できない場合は、代わりに attributionsrc で複数のサイトをアトリビューション ソースとしてリストできます。
| 既存の設定 | ARA 変更あり |
|---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]"></a>
|
この例では、Attribution Reporting API 対応のリクエストが REPORTING_URL_1 と REPORTING_URL_2 の両方に送信されます。リンク先 URL に送信されるナビゲーション リクエストでも、アトリビューション ソースを登録できます。
ステップ 3: Attribution Reporting API リクエストに対するレスポンスを設定する
Attribution Reporting API リクエストを受け取るすべてのオリジンについて、サーバーが適切な Attribution-Reporting-Register-Source ヘッダーで応答していることを確認します。レスポンスの作成方法については、ソースの登録に関するガイドと説明をご覧ください。
複数のトリガーを登録する
複数のアトリビューション トリガーを登録するには、コンバージョン側に複数のピクセル要素を追加します（トリガーごとに 1 つ）。attributionsrc 要素は、トリガーの登録では省略可能です。
1 つのピクセル要素から複数のトリガーを登録するには、リダイレクト リクエストを使用するか、ソース登録の場合と同じように attributionsrc 要素に複数の URL を指定します。同じオリジンによって生成されたソースイベントとトリガー イベントが照合されます。