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

コンバージョン アトリビューションの測定には、パブリッシャー、広告主、広告配信技術（広告を配信するエンティティ）、測定プロバイダなど、複数の関係者が関与する可能性があります。このドキュメントでは、一般的なコンバージョン測定シナリオについて説明しますが、一般に、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 を適切な場所に設定し、リダイレクトが正しく構成されていることを確認する必要があります。また、配信広告テクノロジーと第三者測定プロバイダの両方が、登録済みであり、サーバーがアトリビューション レポート API リクエストを受信して応答する準備ができていることを確認する必要があります。

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

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

  2. 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 属性を使用して複数の広告テクノロジー サーバーをリストできます。

 一般的に、attributionsrc 属性がクリエイティブに追加されていれば、第三者リダイレクトは Attribution Reporting API 呼び出しを受け取ります。
ステップ 3: Attribution Reporting API リクエストのレスポンスを設定する Attribution Reporting API からレポートを受け取るエンティティ 広告主が使用する DSP と第三者測定プロバイダ

各ステップの詳細は、パブリッシャーのページでクリエイティブがどのようにレンダリングされ、配信されるか、また、アトリビューション レポート 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,
  },
  ...
};
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 レポート ワークレットのシグナルと広告クリエイティブ フレーム イベント ペイロードを関連付けることができます。

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

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

VAST 形式のアトリビューション レポートを有効にする

VAST は、動画広告インベントリの配信と測定に共通のフォーマットです。この標準で定義されているイベントの多くは、Attribution Reporting API で登録可能なソースイベントの候補と見なす必要があります。詳しくは、アトリビューション レポートのサポートに関する VAST 補遺をご覧ください。簡単に言うと、<Tracking>、<Impression>、<*ClickThrough>、<*ClickTracking> のすべてのイベントがアトリビューション ソース イベントになる可能性があります。すべての VAST 実装で、これらのイベントの登録資格範囲を提供する必要があります。

VAST 付録では、これらの要素に新しい属性を定義して、アトリビューション登録専用のセカンダリ URL を設定できるようにしています。イベントに attributiontype="DOUBLE_PING" と attributionsrc="[URL]" が含まれている場合、そのイベントをトリガーするコードは、アトリビューション レポート API を有効にする際に、attributionsrc 属性の値として [URL] を使用する必要があります。VAST 付録には、各シナリオの例が記載されています。

最大限の範囲をカバーするため、VAST 実装では、イベント ping が送信されたときに、デフォルトで、リストに記載されているすべてのイベントを登録対象にする必要があります。たとえば、<Impression> イベント URL を起動するときに、リクエストの送信に使用される <img> 要素（または fetch 呼び出しの同等のもの）で（空の）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 の一部として明示的に渡す必要があります。

次の例では、広告配信テクノロジー（serving-adtech.example）と第三者測定プロバイダ（3p-measurement.example）を、アトリビューション レポートの生成と受信を希望する 2 つの異なるエンティティとして使用します。この例の配信広告テクノロジーは、パブリッシャー サイトでクリエイティブをレンダリングし、独自のレポート サービスを備えている 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 をリストすることで、単一のピクセル要素から複数のトリガーを登録することもできます。同じオリジンによって生成されたソースイベントとトリガー イベントが照合されます。