Pembaruan Attribution Reporting pada Juni 2022

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

Gambar header berasal dari Diana Polekhina di Unsplash.