Pembaruan Attribution Reporting pada Juni 2022

Proposal Pelaporan Atribusi diubah untuk versi Chrome 104, dengan mekanisme, fungsi, dan update API baru ke layanan agregasi.

Untuk siapa pembaruan ini ditujukan?

Pembaruan ini untuk Anda jika:

  • Anda sudah terbiasa dengan API ini—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 di uji coba origin lebih lanjut.

Jika Anda baru saja mulai menggunakan API ini dan/atau belum bereksperimen dengan langsung saja, buka langsung pengantar API sebagai gantinya.

Update Attribution Reporting API

Demo Pelaporan Atribusi telah diperbarui untuk mencerminkan perubahan terbaru pada Attribution Reporting API sisi klien.

Sebagian besar perubahan tidak memerlukan tindakan. Kampanye yang memerlukan pembaruan telah disoroti di bawah ini.

(Tindakan diperlukan) header terpadu untuk pendaftaran

Header telah digabungkan. Sekarang 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, setel atribut 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 menggunakan aggregation_keys, tetapi sekarang disimpan sebagai kamus JSON dari 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. Lihat Panduan API untuk 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, maka tidak laporan tingkat peristiwa akan dibuat.

Setelan kunci debug terpadu

Kunci debug kini seharusnya disetel di header sumber dan pemicu, bukan dengan {i>header<i} terpisah. Pelajari lebih lanjut cara men-debug laporan.

Mendaftarkan sumber atribusi

Tag skrip kini dapat digunakan untuk mendaftarkan sumber atribusi, mirip dengan tag 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 mendaftar sumber.
  • Header Attribution-Reporting-Eligible ditambahkan ke sumber masuk permintaan pendaftaran.
  • Ada perubahan kecil pada encodeURIComponent.
  • Kunci anggaran privasi telah dihapus dari kolom shared_info dalam laporan agregat.

Dukungan untuk Layanan Agregasi

Di Chrome 104, kami bermaksud memperbarui format beberapa informasi di dalam laporan gabungan. Saat ini kami sedang membangun dukungan untuk perubahan ini dalam Layanan Agregasi. Dokumen ini akan diperbarui serta log perubahan, setelah perubahan dikirimkan.

Kami telah mengumpulkan dokumen tips dan strategi praktis untuk membuat ringkasan laporan. Ada sejumlah wawasan, antara lain:

  • Ringkasan derau dalam pembuatan laporan ringkasan
  • Penjelasan terperinci tentang dimensi, kunci, dan nilai
  • Cara kerja kunci agregasi, termasuk peta struktur utama
  • Nilai agregat dalam praktiknya, dan implikasi anggaran kontribusi
  • Panduan untuk bereksperimen dengan epsilon

Baca selengkapnya tentang pembaruan ini

Gambar header berasal dari Diana Polekhina di Unsplash.