Proposal Attribution Reporting berubah untuk Chrome versi 104, dengan mekanisme API, fungsi, dan update yang baru pada layanan agregasi.
Untuk siapa pembaruan ini?
Pembaruan ini untuk Anda jika:
- Anda sudah memahami API—misalnya, jika Anda telah mengamati atau berpartisipasi dalam diskusi di repositori WICG dan ingin memahami perubahan yang dilakukan pada API.
- Anda menggunakan Attribution Reporting API dalam demo atau berencana melakukan pengujian dalam uji coba origin.
Jika Anda baru saja memulai API ini dan/atau belum bereksperimen dengannya, buka langsung pengantar API.
Update Attribution Reporting API
Demo Pelaporan Atribusi telah diperbarui untuk mencerminkan perubahan terbaru pada API sisi klien Attribution Reporting.
Sebagian besar perubahan tidak memerlukan tindakan. Hal yang memerlukan update untuk implementasi Anda telah ditandai di bawah.
(Tindakan diperlukan) header terpadu untuk pendaftaran
Header telah disatukan. Kini hanya ada satu header untuk sumber dan satu untuk pemicu, yang diformat dalam JSON.
- Untuk mendaftarkan sumber atribusi, Anda dapat merespons permintaan pendaftaran
dengan header
Attribution-Reporting-Register-Source
. - Untuk menyelesaikan pendaftaran pemicu, tetapkan
header
Attribution-Reporting-Register-Trigger
.
Perubahan ini memerlukan tindakan. Lihat panduan developer API untuk informasi selengkapnya.
(Tindakan diperlukan) kunci agregasi sekarang menjadi kamus
Untuk mendaftarkan sumber atribusi,
terus gunakan aggregation_keys
, tetapi sekarang disimpan sebagai kamus JSON, bukan
daftar.
Contoh:
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
Perubahan ini memerlukan tindakan. Baca panduan API untuk mengetahui informasi selengkapnya.
Pembuatan laporan
Anda dapat memilih untuk hanya membuat laporan agregat, yang dapat digabungkan menjadi laporan ringkasan. Jika filter Anda tidak cocok dengan pemicu peristiwa apa pun, tidak ada laporan tingkat peristiwa yang akan dibuat.
Setelan kunci debug terpadu
Kunci debug kini ditetapkan dalam header sumber dan pemicu, bukan dengan header terpisah. Pelajari lebih lanjut cara men-debug laporan.
Mendaftarkan sumber atribusi
Tag skrip sekarang dapat digunakan untuk mendaftarkan sumber atribusi, mirip dengan dukungan
untuk tag <img>
.
Update API lainnya
Perubahan lain yang telah dibuat dan dikutip dalam panduan API meliputi:
- Sumber dapat didaftarkan dengan API permintaan JavaScript.
window.registerSource
telah dihapus.- Sekarang Anda dapat menyertakan nilai untuk
attributionsrc
saat mendaftarkan sumber. - Header
Attribution-Reporting-Eligible
ditambahkan ke permintaan pendaftaran sumber yang masuk. - Ada perubahan kecil pada
encodeURIComponent
. - Kunci anggaran privasi dihapus
dari kolom
shared_info
dalam laporan gabungan.
Dukungan untuk Layanan Agregasi
Di Chrome 104, kami ingin memperbarui format beberapa informasi di dalam laporan agregat. Kami sedang membangun dukungan untuk perubahan ini di Layanan Agregasi. Dokumen ini dan log perubahan akan diperbarui setelah perubahan dikirimkan.
Kami telah mengumpulkan dokumen tips dan strategi praktis untuk membuat laporan ringkasan. Ada sejumlah insight, termasuk:
- Ringkasan derau dalam pembuatan laporan ringkasan
- Penjelasan terperinci tentang dimensi, kunci, dan nilai
- Dalam praktiknya kunci agregasi, termasuk peta struktur kunci
- Nilai gabungan dalam praktiknya, dan implikasi anggaran kontribusi
- Panduan untuk bereksperimen dengan epsilon
Baca selengkapnya tentang pembaruan ini
- Baca Hal yang harus Anda ketahui tentang API.
- Baca Bereksperimen dengan Pelaporan Atribusi: Strategi dan tips untuk laporan ringkasan.
Gambar header berasal dari Diana Polekhina di Unsplash.