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

Conversion Measurement API berubah di Chrome 92.

Apa yang berubah?

Setelah perubahan proposal API pada bulan-bulan pertama tahun 2021, penerapan API di Chrome 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 di isi permintaan.
Isi laporan: credit telah dihapus, beserta laporan yang akan memiliki 0 kredit.

Yang tetap tidak berubah di Chrome 92 adalah serangkaian fitur yang didukung: laporan tingkat peristiwa, hanya untuk klik. Nantikan info terbarunya. Setelah perubahan ini, update dan fitur lainnya akan dirilis di Chrome versi mendatang.

Kapan perubahan ini mulai berlaku?

Perubahan ini berlaku mulai dari Chrome 92, yang stabil pada 20 Juli 2021. Beta Chrome 92 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 mendatang, sebaiknya sebelum pertengahan Juli 2021. Dengan cara ini, codebase Anda akan siap menghadapi perubahan mendatang dan akan terus berfungsi untuk klien Chrome yang lebih baru.
Opsi 2: Tunggu hingga lebih banyak update dan fitur dirilis di versi Chrome mendatang, dan lakukan semua perubahan kode yang diperlukan sekaligus.

Migrasi

Contoh migrasi

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

Memperbarui kode kebijakan izin Anda

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 argumen `window.open()`

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 penggantian nama atribut HTML):

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

Perbarui 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 di 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 pengalihan pemicu atribusi. ⚠️ `credit` telah dihapus.

Attribution Reporting: semua resource

Lihat Attribution Reporting.