コンバージョン測定を有効にする

コンバージョン アトリビューションの測定には、パブリッシャー、広告主、配信アドテック（広告を配信する事業者）、測定プロバイダなど、複数の関係者が関与する場合があります。このドキュメントでは、一般的なコンバージョン測定シナリオについて説明します。ただし、一般に、Attribution Reporting API（ARA）からアトリビューション レポートを受け取るすべての事業者は、このドキュメントに記載されている統合手順に沿って操作する必要があります。

たとえば、パブリッシャーが広告の配信を担当する 1 つ以上の広告テクノロジーを導入している場合、クリエイティブのマークアップを提供する事業者、クリエイティブのインプレッションまたはトラッキング ピクセルを提供する事業者、パブリッシャーのページの広告スロット用に SDK またはタグを提供する事業者などがこれに該当します。これらの広告テクノロジーは、ARA からアトリビューション レポートを受け取るかどうかは任意ですが、ダウンストリームの広告テクノロジーがアトリビューション レポートを受け取れるようにする役割を担っています。

また、広告主は、クロスネットワーク アトリビューションやその他のレポート機能のために、サードパーティのコンバージョン測定プロバイダを使用している場合もあります。広告主は、このデータを使用して、複数のユニークなパブリッシャーとチャネルにまたがる広告投資の費用対効果を把握します。そのため、DSP または広告サーバーが、これらのユースケースをサポートするために Attribution Reporting API を有効にする方法を理解することが重要です。サードパーティを使用する広告主様は、サードパーティの測定プロバイダを使用するか、レポートの登録と API からの受信を行うための社内サーバーをセットアップすることで、引き続きサードパーティを使用できます。

Attribution Reporting API を使用すると、複数の広告テクノロジーが同じインプレッションまたはコンバージョンのアトリビューション ソースとトリガーを登録し、API から個別のレポートを受け取ることができます。たとえば、DSP は Attribution Reporting API から独自のアトリビューション レポートを受信できるほか、広告主のサードパーティ測定プロバイダの個別のレポートも許可できます。広告テクノロジーは、API からレポートを受け取るために、アトリビューション ソースとトリガーの両方を登録する必要があります。アトリビューションは、広告テクノロジーが API に個別に登録したアトリビューション ソースとトリガーの間で行われます。

コンバージョン測定の一般的なシナリオ

このセクションでは、コンバージョン測定の一般的なシナリオを 2 つ紹介します。

シナリオ 1: 配信広告テクノロジーと第三者測定プロバイダの両方が Attribution Reporting API からレポートを受け取る必要がある

広告主様がサードパーティ測定プロバイダを使用して広告枠のコンバージョンをアトリビューションし、クリエイティブをホストする広告テクノロジーが広告枠のコンバージョンをアトリビューションしたいと考えています。これは、広告クリエイティブのマーカーを提供したり、独自のアトリビューション レポートを実行したり、サードパーティの測定プロバイダや分析プロバイダと統合している広告主と連携したりする DSP や広告主の広告サーバー（サードパーティ広告サーバー - 3PAS）によく見られます。

この場合、現在の設定では、クリック イベントとインプレッション イベントの発生もサービング広告テクノロジーが行っています。配信広告テクノロジーは、新しい attributionsrc を適切な場所に設定し、リダイレクトが正しく構成されていることを確認する必要があります。また、配信広告テクノロジーとサードパーティ測定プロバイダの両方が登録されており、サーバーが Attribution Reporting API リクエストを受信して応答する準備ができていることを確認する必要があります。

一般的なキャンペーン設定は次のようになります。

  1. 広告主の広告サーバー（3PAS）は、広告クリエイティブのマークアップを DSP に提供します。これには、第三者測定プロバイダのインプレッション トラッキング ピクセルやクリック トラッキング ピクセルが含まれます。広告サーバーは、広告クリエイティブ マークアップに attributionsrc が含まれていることを確認する必要があります。

  2. DSP には、インプレッションとクリックのトラッキング ピクセルを追加する機能が備わっています。入札に使用する最終的な広告クリエイティブ マークアップに attributionsrc が含まれていることを確認してください。

シナリオ 2: サードパーティ測定プロバイダのみが Attribution Reporting API からレポートを受け取る必要がある

広告主様がサードパーティ測定プロバイダを使用して広告枠のコンバージョンをアトリビューションしたいが、クリエイティブをホストしている広告テクノロジーにアトリビューション測定要件がない。これは、クリエイティブをホストするパブリッシャー、SSP、パブリッシャー広告サーバーにおいて、アトリビューション レポートを自社で使用することはないが、DSP パートナーまたは測定タグ設定会社（サードパーティ広告サーバー、測定プロバイダ、分析プロバイダなど）向けに Attribution Reporting API を有効にすることを検討している場合によく見られます。

この場合、現在の設定でクリック イベントとインプレッション イベントを発生させる担当者は、新しい attributionsrc 属性をクリエイティブに追加し、リダイレクトが意図したとおりに機能するようにする必要があります。これは各パブリッシャーの統合に大きく依存しますが、クリック イベントの場合は、SSP、配信広告テクノロジー、パブリッシャー自身が送信元となる場合があります。インプレッション イベントの場合、これは通常サードパーティ測定プロバイダです。

シナリオ 1 の一般的なキャンペーン設定例では、パブリッシャーの広告サーバー、SSP、またはパブリッシャー自身が、DSP から提供された attributionsrc 属性がパブリッシャーのページに表示されるようにするだけで済む場合があります。

実装の詳細

次の表に、Attribution Reporting API の実装手順の概要を示します。

手順 業務の責任 例
ステップ 1: 既存のクリエイティブと測定コードでアトリビューション ソースを有効にする インプレッション イベントの発行またはクリック イベントの処理を担当するエンティティが attributionsrc 属性を追加します。 クリック イベントの場合、通常はクリエイティブをレンダリングする購入者（DSP/広告主の広告サーバー）が属性を追加します。

インプレッション イベントの場合、デマンドサイド プラットフォーム（DSP）、サプライサイド プラットフォーム（SSP）、パブリッシャー、広告サーバー、測定プロバイダが属性を追加します。これはパブリッシャーの設定によって異なります。

VAST 形式を使用する動画広告の場合、パブリッシャーと動画 SDK が属性を追加します。
ステップ 2: サードパーティ オリジンのアトリビューション レポートを有効にする これは、302 リダイレクトで既存のリダイレクト パスを使用している場合に、すぐに機能します。

302 リダイレクトを使用できない場合は、attributionsrc 属性を使用して複数の広告テクノロジー サーバーをリストできます。

 通常、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 呼び出しに渡される オプション引数に 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,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Protected Audience オークションでアトリビューション ソースの登録を有効にする

Protected Audience のオークションでコンバージョンを測定するには、attributionsrc ではなく、registerAdBeacon/registerAdMacro と setReportEventDataForAutomaticBeacons/reportEvent を使用して、アトリビューション ソースの登録を有効にします。

Protected Audience シグナルのレポートでは、レポート ワークレット内で registerAdBeacon 関数を使用できます。registerAdMacro は、購入者の落札レポート ワークレット内で使用できます。その後、Fenced Frame Ads Reporting API の reportEvent 関数と setReportEventDataForAutomaticBeacons 関数を使用して、広告フレーム内のイベントデータを登録済みのビーコンとマクロに追加できます。これにより、Protected Audience レポート ワークレットのシグナルと広告クリエイティブ フレーム イベント ペイロードを相互に関連付けることができます。

Attribution-Reporting-Eligible HTTP ヘッダーは、フレームからの reportEvent 呼び出しによってビーコンとマクロがトリガーされた場合、または自動ビーコンがブラウザによってトリガーされた場合にリクエストに追加されます。ビーコンのレスポンスを使用して、アトリビューション ソースを登録できます。ビーコン リクエストは、サードパーティ測定を可能にするためにリダイレクトされる場合があります。

詳しくは、Fenced Frame Ad Reporting API の説明のアトリビューション レポートのサポートをご覧ください。

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 実装では、イベント ピングを送信する際に、リスト内のすべてのイベントがデフォルトで登録対象になるようにする必要があります。たとえば、<Impression> イベント URL をトリガーする場合は、リクエストの送信に使用した <img> 要素（またはフェッチ呼び出しの同等の要素）に（空の）attributionsrc 属性を使用して、受信側がそのイベントを Attribution Reporting API に登録できるようにする必要があります。

ステップ 2: サードパーティ オリジンのアトリビューション レポートを有効にする

サードパーティが Attribution Reporting API を使用できるようにするには、既存のリダイレクトを使用するか、サードパーティのリストを attributionsrc 属性に追加します。ほとんどの場合、各広告テクノロジーには独自の独立したインプレッション トラッカーがあるため、リダイレクトはクリック トラッカーに関連性が高いものです。

既存のリダイレクト チェーンでサードパーティのオリジンを処理する

一般的な広告のクリックスルーでは、最終的なランディング ページへのナビゲーションの一環として、302 リダイレクトのチェーンとして多くのクリック トラッカーが存在する場合があります。リダイレクト チェーン内のすべてのリクエストは、元のクリック ターゲットに attributionsrc がアノテーションされているか、Protected Audience API の registerAdBeacon/registerAdMacro に登録されている場合、Attribution Reporting API に登録できます。リダイレクト チェーン内の広告テクノロジーも登録されている必要があります。

リダイレクトでは、最初のリクエストの本文は送信されません。Protected Audience オークションの場合、eventData が reportEvent に渡され、setReportEventDataForAutomaticBeacons をリダイレクトの一部として使用する必要がある場合は、リダイレクト URL の一部として明示的に渡す必要があります。

次の例では、アトリビューション レポートの生成と受信を目的とする 2 つの異なるエンティティとして、配信広告テクノロジー（serving-adtech.example）とサードパーティ測定プロバイダ（3p-measurement.example）を使用します。この例の配信広告テクノロジーは、パブリッシャーのサイトでクリエイティブをレンダリングし、独自のレポート プロダクトを持つ DSP です。第三者測定プロバイダは、広告主がコンバージョン レポートに使用する事業者です。

ファーストパーティがソースを登録し、サードパーティが

ソースの登録時に、次の手順が実行されます。

  1. serving-adtech.example はクリエイティブに attributionsrc 属性を設定します。ユーザーがパブリッシャーのページにアクセスすると、ブラウザが serving-adtech.example. にリクエストを送信します。
  2. serving-adtech.example は、Attribution-Reporting-Register-Source ヘッダーと Location ヘッダーで応答します。
    1. serving-adtech.example は Attribution-Reporting-Register-Source ヘッダーを使用して、登録するソースに関するメタデータで応答します。
    2. serving-adtech.example は Location ヘッダーを使用して、3p-measurement.example へのリダイレクトを追加します。Location ヘッダーは、サードパーティへの 302 リダイレクトをサポートするために、既存のクリック トラッキング フローですでに使用されている可能性があります。
  3. ブラウザは serving-adtech.example からレスポンスを受信し、Attribution-Reporting-Register-Source ヘッダーを解析します。ブラウザは、serving-adtech.example をレポート送信元として使用して、ソースイベントを保存します。
  4. このリクエストはリダイレクトであるため、ブラウザは 3p-measurement.example に対して新しいリクエストも送信します。
  5. 3p-measurement.example は、Attribution-Reporting-Register-Source ヘッダーを含むレスポンスで応答します。
  6. ブラウザは 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 要素は、トリガーの登録では省略可能です。

ソースの登録と同様に、リダイレクト リクエストを使用するか、attributionsrc 要素に複数の URL をリストすることで、1 つのピクセル要素から複数のトリガーを登録することもできます。同じオリジンによって生成されたソースイベントとトリガー イベントは一致します。