アトリビューション レポート: システム全体の概要

技術的な意思決定者を対象とした、アトリビューション レポートの連携サービスの概要。

広告テクノロジーと広告主は Attribution Reporting API を使用して、 広告のクリックや表示が、購入などのコンバージョンにつながる。この API は クライアントサイドとサーバーサイドの統合を組み合わせます。 対応できます。

続行する前に、 Attribution Reporting の概要 これにより、API の目的とさまざまな出力レポートのフローを理解できます。 （イベントレベル レポート 概要レポートなど）を確認できます。 見慣れない用語を見つけた場合は、 プライバシー サンドボックスの用語集

この記事の対象者

次の場合は、この記事をお読みください。

  • 広告テクノロジーまたは広告主の技術的な意思決定者である場合。あなたなら働くかもしれない 運用、DevOps、データ サイエンス、IT、マーケティングなど、 実装の技術的な意思決定を行う 必要があるからですプライバシー保護の測定において API がどのように機能するか、
  • 技術担当者（デベロッパー、システム オペレータ、 システム アーキテクト、データ サイエンティストなど）に 集約サービス環境を構築できます。

この記事では、 Attribution Reporting API と連携します。技術系のエンジニアや 医療従事者であれば、 この API を試す 説明します。

概要

Attribution Reporting API は多くのサービスで構成されており、それぞれ固有の セットアップ、クライアントサイドの構成、サーバーデプロイの 3 つです。Google Cloud の まず、

  • デザイン上の意思決定を行う。収集する情報を定義し、特定のキャンペーンで期待されるコンバージョンを特定し、収集するレポートの種類を決定します。最終的な出力は、2 種類のレポート（イベントレベル レポートと概要レポート）のいずれかまたは両方です。

レポートの作成をサポートするコンポーネントは常に 2 つ（場合によっては 3 つ）あります。

  • ウェブサイトとブラウザ間の通信。イン Cookie ベースのシステムの場合、コンバージョンや広告エンゲージメントに関する情報は、 識別子に付けられた識別子（ID）によって、 できます。この API では、ブラウザはコンバージョンを 指定した内容に基づき配信される前に、広告のクリック数/視聴回数 分析できます広告レンダリング コードとコンバージョン トラッキングは次の条件を満たす必要があります。 <ph type="x-smartling-placeholder">
      </ph>
    • どのコンバージョンをどの広告に関連付けるかをブラウザに伝える クリック数またはインプレッション数です
    • 最終レポートに含めるその他のデータを伝えます。
  • データの収集。外部 IP アドレスを持つ VM を ユーザー インターフェースで作成されたレポートをできます。ブラウザからの出力 イベントレベル レポートと集計可能レポートのいずれかになります。 レポート（暗号化され、概要レポートの生成に使用されます）

集計可能レポートを収集する場合は、3 つ目のコンポーネントが必要です。

  • 概要レポートの生成。バッチ 集計可能レポートを作成し、集計サービスを使用してそのレポートを 概要レポートを生成できます

設計上の意思決定

アトリビューション レポートの主な原則は、初期の設計上の決定事項です。決定 収集するデータをどのカテゴリで、どのくらいの頻度で処理するか 分析できます出力レポートでは、キャンペーンやビジネスに関する分析情報を確認できます。

出力レポートは次のいずれかです。

  • イベントレベル レポートでは、広告側の特定の広告クリックや表示が、コンバージョン側のデータと関連付けられます。サイト間でのユーザー ID の結合を制限してユーザーのプライバシーを保護するため、コンバージョン側のデータは非常に限定的であり、データのノイズが多くなります（ごく一部のケースでは、実際のレポートの代わりにランダムなデータが送信されます）。
  • 概要レポートは、広告側の特定のイベントに関連付けられていません。これらのレポートでは、より詳細なコンバージョン データが提供されるため、クリックと視聴のデータをコンバージョン データと柔軟に結合できます。

選択したレポートによって、収集する必要があるデータが決まります。

最終出力は、テストに使用するツールの入力と考えることもできます。 決定を下します。たとえば、概要レポートを生成して、 総費用につながりそうなコンバージョンが多いため、 次の広告キャンペーンの目標を設定することをおすすめします

測定対象が決まったら 説明します

ウェブサイトとブラウザ間の通信

<ph type="x-smartling-placeholder">
</ph> パブリッシャーのウェブサイト上のアトリビューション ソースは、広告主のウェブサイトのトリガーと関連付けられます。
パブリッシャー様のウェブサイト上のアトリビューション ソースが、広告主様のウェブサイトのトリガーと関連付けられます。

アトリビューション イベントのフロー

広告を表示するパブリッシャー サイトを想像してみてください。広告主や広告技術プロバイダは、広告のインタラクションを把握して、コンバージョンを適切な広告に結び付けたいと考えています。この場合、レポート（イベントレベルと集計可能）は次のように生成されます。

  1. パブリッシャー サイトでは、広告要素（<a> または <img> タグ）に特別な属性 attributionsrc が設定されています。値は URL です（例: https://adtech.example/register-source/ad_id=...）。

    クリックされるとソースが登録されるリンクの例を以下に示します。

    <a href="https://shoes.example/landing" 
  attributionsrc="http://adtech.example/register-source?..."
  target="_blank">
Click me</a>

    次に、表示時にソースの登録を引き起こす画像の例を示します。

    <img href="https://advertiser.example/landing" 
  attributionsrc="https://adtech.example/register-source?..."/>

    あるいは、HTML 要素の代わりに JavaScript 呼び出しを使用することもできます。

    window.open() を使用した JavaScript の例を次に示します。特殊文字に関する問題を避けるため、URL は URL エンコードされます。

    const encodedUrl = encodeURIComponent(
  'https://adtech.example/attribution_source?ad_id=...');
window.open(
  "https://shoes.example/landing",
  "_blank",
  attributionsrc=${encodedUrl});
  1. ユーザーが広告をクリックまたは表示すると、ブラウザから GET リクエストが attributionsrc（通常は広告主または広告技術プロバイダのエンドポイント）に送信されます。

  2. このリクエストを受け取った広告主または広告技術プロバイダは、後でコンバージョンをこの広告に結び付けることができるように、広告インタラクションのソースイベントを登録するようにブラウザに指示します。これを行うために、広告主または広告技術プロバイダはレスポンスに特別な HTTP ヘッダーを含めます。このヘッダーには、ソースイベント（広告のクリックや表示）に関する情報を提供するカスタムデータが付加されます。この広告でコンバージョンが発生した場合、このカスタムデータは最終的にアトリビューション レポートに表示されます。

    広告を表示またはクリックします。

  3. その後、このユーザーは広告主のサイトにアクセスします。

  4. 広告主のサイトの関連ページ（購入確認ページや商品ページなど）で、コンバージョン ピクセル（<img> 要素）または JavaScript の呼び出しにより、https://adtech.example/conversion?param1=...&param2=... へのリクエストが行われます。

  5. この URL のサービス（通常は広告主または広告技術プロバイダ）がリクエストを受け取ります。モデルはこれをコンバージョンとして分類するので、ブラウザにコンバージョンを記録する（つまりアトリビューションをトリガー）するよう指示する必要があります。そのためには、広告主または広告技術プロバイダがピクセル リクエストへのレスポンスに、コンバージョンに関するカスタムデータを含む特別な HTTP ヘッダーを含めます。

  6. ユーザーのローカル デバイスのブラウザはこのレスポンスを受け取り、コンバージョン データと元のソースイベント（広告のクリックまたは表示）を照合します。詳しくは、ソースとトリガーをマッチングするをご覧ください。

  7. ブラウザは、レポートを attributionsrc に送信するようにスケジュールします。このレポートには次のものが含まれます。

    1. 広告技術プロバイダまたは広告主がステップ 3 でソースイベントに付加したカスタム アトリビューション設定データ。
    2. ステップ 6 で設定したカスタム コンバージョン データセット
    コンバージョン。

  8. その後、ある程度の遅延とノイズを加えて、ブラウザは attributionsrc で定義されたエンドポイントにレポートを送信します。集計可能レポートは暗号化されますが、イベントレベルのレポートは暗号化されません。

アトリビューション トリガー（広告主様のウェブサイト）

アトリビューション トリガー ブラウザにコンバージョンの取得を指示するイベントです。

特に重要なコンバージョンを捕捉することをおすすめします 広告主（購入など）コンバージョンの種類とメタデータは複数でも 概要レポートで確認できます

これにより、これらのイベントの詳細な集計結果が正確になります。

ソースとトリガーを照合する

アトリビューション トリガーのレスポンスを受信したブラウザは、 ローカル ストレージを使用して、アトリビューション トリガーの 元のページ URL が eTLD+1

たとえば、ブラウザがアトリビューション トリガーを shoes.example/shoes123 の adtech.example の場合、ブラウザは以下でソースを検索します。 adtech.example と shoes.example の両方に一致するローカル ストレージ。

フィルタ（またはカスタムルール）を設定して、トリガーが一致するタイミングを指定できます。 特定のソースに絞り込むことができますたとえば、特定のコンバージョンのみをカウントするフィルタを 除外し、その他すべてのカテゴリは無視します。フィルタと 優先順位付けモデルを使用すると、より高度なアトリビューション レポートが可能になります。

ローカル ストレージに複数のアトリビューション ソースが見つかった場合、ブラウザは 最も最近保存されたものになりますアトリビューションソースが 優先度が最も高いソースが選択されると、ブラウザは最も高い あります。

データ収集

対応するソースに一致するアトリビューション トリガーは、 広告テクノロジーが所有するサーバーのレポート エンドポイントにブラウザから報告されるレポート （収集エンドポイントまたは収集サービスと呼ばれることもあります）。これらの レポートには、イベントレベル レポートまたは集計可能レポートがあります。

集計可能レポート 概要レポートの生成に使用されます集計可能レポートは （パブリッシャー様のサイト上の）広告から収集されたデータと、 （広告主のサイト）に表示される URL です。 広告テクノロジーによって収集される前にユーザーの デバイスに配信されます

イベントレベル レポートには 2 ～ 30 日の遅延があります。集計可能レポートは 送信され、イベントが一定の時間内に収まる必要があります。 資金提供の予算。 この選択により、プライバシーを保護し、個々のユーザーのアクションの悪用を防ぐことができます。

イベントレベル レポートのみを確認したい場合は、 必要なインフラストラクチャを構築できます。概要レポートを生成する場合は 追加サービスで集計可能レポートを処理する必要があります

概要レポートの生成

概要レポートを生成するには、 集計サービス （広告テクノロジーが運用）を使用して集計可能レポートを処理します。集約 サービスはユーザーのプライバシーを保護するためにノイズを追加し、最終的な概要レポートを返します。

<ph type="x-smartling-placeholder">
</ph> 集計可能レポートは、収集、バッチ処理されて、広告テクノロジー環境に送信されます。
この図は Google Cloud の非同期フローを バッチ処理、レポートの実行など、 集計処理を実行します

収集された集計可能レポートをバッチ処理した後、バッチが処理される 集計サービスによって行われます コーディネーター 認証されたバージョンの集計データのみに復号鍵を 。その後、集計サービスはデータを復号し、 ノイズを追加してから、概要レポートとして結果を返します。

一括集計可能レポート

集計可能レポートは、処理前にバッチ処理する必要があります。バッチ 戦略的にグループ化された集計可能レポートで構成されます戦略は、 特定の期間（毎日、毎週など）を反映している可能性が高いです。この 各プロセスは、レポート エンドポイントとして機能する同じサーバーで実行できます。

バッチには多数のレポートを含めて、信号対雑音比を高くする必要があります。

<ph type="x-smartling-placeholder">
</ph> 期間が長いほど、ノイズが少なくなります。
1 日と 1 週間の待機時間を比較します。1 時間後には、要約値が小さくなり、ノイズの多い結果になります。1 日のうちにサマリー値が大きくなるため、ノイズの少ない可能性が高くなります。

特定のイベントを確実にキャプチャするために、バッチの期間はいつでも変更できます 年 1 回のセールなど、販売数が多くなると見込まれる地域。バッチ処理期間 アトリビューション ソースやトリガーを変更せずに変更できる。

集計サービス

集計サービスは、集計可能レポートを処理して、 概要レポートを生成します集計可能レポートは暗号化され 高信頼実行環境で実行される集計サービスによる読み取り （TEE）。

集約サービスがコーディネーターに復号鍵をリクエストする データを復号して集約します復号して集計すると プライバシーを保護するためノイズが付けられ、概要レポートとして返されます。

実務担当者は、集計可能なクリアテキスト レポートを生成して、 集計サービスをローカルでテストします。 または、Nitro Enclaves を使用して AWS で暗号化されたレポートを使用してテストできます。

次のステップ

お客様と対話し、Google がユーザーの期待に応える API 役立ちます

API についてディスカッションする

他のプライバシー サンドボックス API と同様に、この API はドキュメント化され、 一般に議論されます。

API で試す

テストと参加が可能です。 詳しくご説明いたします。