2022 年 6 月のアトリビューション レポートの更新

Attribution Reporting の提案が Chrome バージョン 104 - 新しい API のメカニズム、機能、アップデート 集計サービスに渡します

アップデートの対象者は誰ですか？

この更新は、次のような方を対象としています。

  • API についてすでによく理解しているはずです。たとえば、これまで ディスカッションに参加していて、 API に加えられた変更を理解する。
  • Attribution Reporting API をデモで使用しているか、 オリジン トライアル。

この API を使い始めたばかりの場合や、テストしたことがない場合 API を使用してください。

Attribution Reporting API の更新

Attribution Reporting のデモ Attribution Reporting の最新の変更内容を反映するため クライアントサイド API を提供します。

ほとんどの変更については、対応は不要です。アプリの更新が 下でハイライト表示されます。

（要対応）登録用の統合ヘッダー

ヘッダーが統一されました。現在は、ソースと 1 つのヘッダーに JSON 形式のトリガーです

  • アトリビューション ソースを登録するには、登録リクエストに応答できます ヘッダー Attribution-Reporting-Register-Source を使用します。
  • トリガーの登録を完了するには、 Attribution-Reporting-Register-Trigger ヘッダー。

この変更には対応が必要です。詳しくは、 API デベロッパー ガイド をご覧ください。

（要対応）集計キーは辞書になりました

アトリビューション ソースを登録する手順は次のとおりです。 引き続き aggregation_keys を使用しますが、代わりに JSON 辞書として保存されるようになりました 使用できます。

例:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

この変更には対応が必要です。詳しくは、 API ハンドブック をご覧ください。

レポートの生成

集計可能なレポートのみを生成することを選択できます。これは、集計可能で、 概要レポートに統合できますフィルタがどのイベント トリガーにも一致しない場合、 イベントレベルレポートが生成されます。

統合デバッグキーの設定

デバッグキーは、 分離できます詳しくは、デバッグ方法 レポートをご覧ください。

アトリビューション ソースを登録する

サポートと同様に、スクリプトタグを使用してアトリビューション ソースを登録できるようになりました。 <img> タグ。

その他の API の更新

他にも、次のような変更が行われ、API ハンドブックに引用されています。

  • ソースは JavaScript リクエスト API を使用して登録できます。
  • window.registerSource は削除されました。
  • 登録時に attributionsrc の値を含めるかどうかは任意になりました。 あります。
  • Attribution-Reporting-Eligible ヘッダーが受信ソースに追加されました サポートします。
  • encodeURIComponent に小さな変更が加えられました。
  • プライバシー バジェット キーが削除された 集計可能レポートの shared_info フィールドから値を取得します。

集計サービスのサポート

Chrome 104 では、 集計可能レポートなどがあります現在、この変更に対するサポートを 集約サービス。このドキュメントは更新され、 変更履歴、 変更の発送後に行われます

要約を生成するための実践的なヒントと戦略をまとめたドキュメント レポートをご覧ください。 次のような分析情報が得られます。

  • 概要レポートの生成におけるノイズの概要
  • ディメンション、キー、値の詳細な説明
  • キー構造マップを含む実際の集計キー
  • 実際の集計可能な値と資金提供予算の影響
  • イプシロンのテストに関するガイド

更新の詳細

ヘッダー画像は、Unsplash の Diana Polekhina によるものです。