[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, implementasi API di Chrome terus mengalami perkembangan. 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 tidak memiliki kredit.

Yang tidak berubah di Chrome 92 adalah kumpulan fitur yang didukung: laporan tingkat peristiwa, hanya untuk klik. Anda akan mendapatkan info terbaru tentang hal ini. Setelah perubahan ini, update dan fitur lainnya akan dirilis di versi Chrome mendatang.

Kapan perubahan ini berlaku?

Perubahan ini akan 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 berfungsi untuk klien Chrome yang lebih baru.
  • Opsi 2: Tunggu hingga update dan fitur lainnya dirilis di versi Chrome mendatang, dan buat 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 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

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 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 Anda

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 pengalihan pemicu atribusi.

⚠️ credit telah dihapus.

Attribution Reporting: semua referensi

Lihat Pelaporan Atribusi.