Chrome バージョン 104 で Attribution Reporting の提案が変更され、新しい API メカニズムと機能が追加され、集計サービスが更新されました。
この更新の対象者は誰ですか?
これらの更新は、次の場合に適しています。
- すでに API に精通している場合。たとえば、WICG リポジトリのディスカッションを観察したり、ディスカッションに参加したりしていて、API に加えられた変更を理解したい場合。
- Attribution Reporting API をデモで使用しているか、オリジン トライアルでテストする予定である。
この API の使用を始めたばかりの場合や、まだ試していない場合は、API の概要に進んでください。
Attribution Reporting API の更新
Attribution Reporting のデモが更新され、Attribution Reporting クライアントサイド API に対する最新の変更が反映されました。
ほとんどの変更では、特に対応は必要ありません。実装のために更新が必要なものを以下に示します。
(要対応)登録用の統合ヘッダー
ヘッダーが統合されました。これで、JSON 形式のソースとトリガーのヘッダーが 1 つだけになりました。
- アトリビューション ソースを登録するには、ヘッダー
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 では、集計可能レポート内の一部の情報の形式が更新される予定です。Google では現在、集計サービスでこの変更のサポートを構築しています。変更がリリースされると、このドキュメントと変更履歴が更新されます。
概要レポートを生成する実践的なヒントと戦略をまとめたドキュメントです。以下のような情報が得られます。
- サマリー レポート生成におけるノイズの概要
- ディメンション、キー、値の詳細な説明
- キー構造マップを含む実際の集計キー
- 実際の集計可能な値と資金提供予算の影響
- イプシロンのテストガイド
更新内容の詳細
- API について知っておくべきことを確認する。
- Attribution Reporting のテスト: 概要レポートの戦略とヒントをご覧ください。
ヘッダー画像は、Diana Polekhina(Unsplash より)の投稿です。