[廃止] 移行ガイド(Chrome 92): Conversion Measurement API から Attribution Reporting API へ

Conversion Measurement API が Chrome 92 で変更されます。

変更内容

API 提案の変更への対応 2021 年の最初の数か月間、Chrome での API 実装が進化を遂げています。変更点は次のとおりです。

  • API 名と権限ポリシー名。
  • HTML 属性名と .well-known URL。
  • レポートの形式。レポートがリクエスト本文の JSON として送信されるようになりました。
  • レポート「credit」の内容は、クレジットが 0 になるはずのレポートとともに削除されました。

Chrome 92 ではこれまでと変わらず、クリックのみを対象とするイベントレベル レポートといった一連の機能がサポートされています。 今後の最新情報をお待ちください。今回の変更後は、その他のアップデートや機能が今後の Chrome バージョンでリリースされる予定です。

変更はいつから適用されますか?

これらの変更は、Chrome 92 が 2021 年 7 月 20 日に安定版になりました。 Chrome 92 ベータ版は 2021 年 6 月 3 日にリリースされました。

どうすればよいですか。

オリジン トライアルを実施している場合、またはこの API のデモを実装している場合は、 オプション:

  • オプション 1(推奨): 今すぐ、または数週間以内に(理想的には 2021 年 7 月中旬に実施する予定ですそうすれば、コードベースが将来の変更に対応でき、 新しい Chrome クライアントでは引き続き機能します。
  • 方法 2: 今後の Chrome バージョンで追加のアップデートや機能がリリースされるまで待つ。 必要なすべてのコード変更を 一度に行うことができます

移行

移行の例

この pull リクエスト(ドラフト)で、小規模なデモアプリの移行例を確認できます。

権限ポリシーコードを更新する

以前のコード 新しいコード
allow='conversion-measurement' allow='attribution-reporting'

機能検出コードを更新する

以前のコード 新しいコード
document.featurePolicy.features()
.includes('conversion-measurement')
document.featurePolicy.features()
.includes('attribution-reporting')

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 が削除されました。

アトリビューション レポート: すべてのリソース

Attribution Reporting をご確認ください。