Chrome 92 で Conversion Measurement API が変更されます。
変更内容
2021 年の最初の数か月間に行われた API 提案の変更に伴い、Chrome での API の実装は進化しています。変更点は次のとおりです。
- API 名と権限ポリシー名。
- HTML 属性名と
.well-knownURL。 - レポートの形式。レポートはリクエスト本文で JSON として送信されるようになりました。
- 報告のコンテンツ:
creditは削除され、クレジットが 0 になる報告も削除されました。
Chrome 92 では、サポートされている機能セット（イベントレベルのレポート、クリックのみ）は変更されません。この点については、今後更新される予定です。この変更後、他のアップデートと機能は今後の Chrome バージョンでリリースされる予定です。
これらの変更の適用時期
これらの変更は、2021 年 7 月 20 日の Chrome 92 Stable 版から有効になります。Chrome 92 ベータ版は 2021 年 6 月 3 日にリリースされました。
どうすればよいですか。
オリジン トライアルを実施していた場合や、この API のデモを実装していた場合は、次の 2 つの方法があります。
- 方法 1（推奨）: 今すぐ、または今後数週間以内にコードを移行します（できれば 2021 年 7 月中旬までに）。これにより、コードベースは将来の変更に備えることができ、新しい Chrome クライアントでも引き続き機能します。
- オプション 2: 今後の Chrome バージョンでリリースされる更新と機能が追加されるのを待ってから、必要なコード変更をすべて一度に行う。
移行
移行の例
小規模なデモアプリの移行例については、こちらのプルリクエスト（ドラフト）をご覧ください。
権限ポリシー コードを更新する
| 以前のコード | 新しいコード |
|---|---|
allow='conversion-measurement' |
allow='attribution-reporting' |
特徴検出コードを更新する
| 以前のコード | 新しいコード |
|---|---|
document.featurePolicy.features() |
document.featurePolicy.features() |
HTML 属性を更新する
| 以前のコード | 新しいコード |
|---|---|
conversiondestination |
attributiondestination |
impressiondata |
attributionsourceeventid |
impressionexpiry |
attributionexpiry |
reportingorigin |
attributionreportto |
window.open() 引数を更新
window.open() によって開始されたナビゲーションにアトリビューション ソースを登録できます。window.open() を使用してアトリビューション ソースを登録している場合は、これらの呼び出しを更新します。
新しいコードは次のようになります（この名前変更は HTML 属性の名前変更に沿っています）。
window.open(
'https://dest.example',
'_blank',
'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);
登録呼び出しの URL とパラメータを更新する
| 以前のコード | 新しいコード |
|---|---|
.well-known/register-conversion?conversion-data={DATA} |
.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA} |
レポート エンドポイント コードを更新する
| 以前のコード | 新しいコード | |
|---|---|---|
| ブラウザから想定されるリクエスト | .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 |
.well-known/attribution-reporting/trigger-attribution |
| 受信した報告 | URL パラメータとして送信されます。 | リクエスト本文で JSON として送信されます。 レポートデータは、次のキーを使用してリクエスト本文に JSON オブジェクトとして含まれます。 source_event_id: 以前の impression-data。アトリビューション ソースに設定された 64 ビットのイベント ID。trigger_data: 以前の conversion-data。アトリビューション トリガーのリダイレクト内の 3 ビットのデータセット。⚠️ credit は削除されました。
|
アトリビューション レポート: すべてのリソース
アトリビューション レポートをご覧ください。