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

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

変更内容

2021 年の最初の月に行われた API の提案の変更を受け、Chrome での API 実装は進化を続けています。変更点は次のとおりです。

  • API 名と権限ポリシー名。
  • HTML 属性名と .well-known URL。
  • レポートの形式。レポートがリクエスト本文で JSON として送信されるようになりました。
  • レポート（credit）のコンテンツと、クレジットが 0 だったレポートが削除されました。

Chrome 92 でも変更されないのは、クリックのみを対象とするイベントレベル レポートなどの機能です。 今後の最新情報をお待ちください。この変更後、Chrome の今後のバージョンで他のアップデートや機能がリリースされる予定です。

これらの料金改定はいつから適用されますか？

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

どうすればよいですか。

オリジン トライアルを実行しているか、この API のデモを実装している場合は、次の 2 つのオプションがあります。

  • オプション 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: すべてのリソース

Attribution Reporting をご覧ください。