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() |
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 が削除されました。
|
アトリビューション レポート: すべてのリソース
Attribution Reporting をご確認ください。