[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 dalam isi permintaan.
  • Konten laporan: credit telah dihapus, beserta laporan yang akan memiliki 0 kredit.

Yang tidak berubah di Chrome 92 adalah kumpulan 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 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 ke depan, idealnya sebelum pertengahan Juli 2021. Dengan cara ini, codebase Anda akan siap untuk perubahan mendatang dan akan terus berfungsi untuk klien Chrome yang lebih baru.
  • Opsi 2: Tunggu update dan fitur lainnya 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 di 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

Memperbarui 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'
);

Memperbarui URL dan parameter panggilan pendaftaran

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 di sumber atribusi.
trigger_data: sebelumnya conversion-data, set data 3-bit dalam pengalihan pemicu atribusi.

⚠️ credit telah dihapus.

Pelaporan Atribusi: semua resource

Lihat Pelaporan Atribusi.