[Sudah tidak berlaku] Panduan migrasi (Chrome 92): Conversion Measurement API ke Attribution Reporting API

Conversion Measurement API berubah di Chrome 92.

Apa yang berubah?

Mengikuti perubahan proposal API pada beberapa bulan pertama tahun 2021, implementasi API di Chrome akan terus berkembang. Berikut yang akan berubah:

  • Nama API dan nama kebijakan izin.
  • Nama atribut HTML dan URL .well-known.
  • Format laporan. Laporan kini dikirim sebagai JSON dalam isi permintaan.
  • Konten laporan: credit telah dihapus, bersama dengan laporan yang seharusnya memiliki 0 kredit.

Yang tidak berubah di Chrome 92 adalah serangkaian fitur yang didukung: laporan tingkat peristiwa, untuk klik saja. Dapatkan info terbaru terkait hal ini. Setelah perubahan ini, update dan fitur lainnya akan dirilis di versi Chrome mendatang.

Kapan perubahan ini berlaku?

Perubahan ini berlaku mulai Chrome 92, stabil pada 20 Juli 2021. Chrome 92 beta dirilis pada 3 Juni 2021.

Apa yang perlu Anda lakukan?

Jika Anda menjalankan uji coba origin atau telah menerapkan demo untuk API ini, Anda memiliki dua opsi:

  • Opsi 1 (direkomendasikan): migrasikan kode Anda sekarang atau dalam beberapa minggu berikutnya, idealnya sebelum pertengahan Juli 2021. Dengan cara ini, codebase Anda akan siap untuk perubahan mendatang dan akan terus bekerja untuk klien Chrome yang lebih baru.
  • Opsi 2: Tunggu hingga update dan fitur lainnya dirilis di versi Chrome mendatang, dan membuat semua perubahan kode yang diperlukan sekaligus.

Migrasi

Contoh migrasi

Anda dapat melihat contoh migrasi untuk aplikasi demo kecil dalam permintaan pull (draf) ini.

Memperbarui kode kebijakan izin

Kode lama Kode baru
allow='conversion-measurement' allow='attribution-reporting'

Memperbarui kode deteksi fitur

Kode lama Kode baru
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

Memperbarui atribut HTML

Kode lama Kode baru
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

Perbarui window.open() argumen

Sumber atribusi dapat didaftarkan untuk navigasi yang dimulai oleh window.open(). Perbarui panggilan ini jika Anda menggunakan window.open() untuk mendaftarkan sumber atribusi.

Kode baru Anda akan terlihat seperti berikut (penggantian nama ini mengikuti atribut HTML mengganti nama):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

Memperbarui URL dan parameter panggilan pendaftaran Anda

Kode lama Kode baru
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Memperbarui kode endpoint pelaporan

Kode lama Kode baru
Permintaan yang diharapkan dari browser .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Laporan masuk Dikirim sebagai parameter URL. Dikirim sebagai JSON dalam isi permintaan.

Data laporan disertakan dalam isi permintaan sebagai objek JSON dengan kunci berikut:
source_event_id: sebelumnya impression-data, ID peristiwa 64-bit yang ditetapkan pada sumber atribusi.
trigger_data: sebelumnya conversion-data, set data 3-bit dalam pemicu atribusi pengalihan.

⚠️ credit telah dihapus.

Attribution Reporting: semua resource

Lihat Pelaporan Atribusi.