Halaman ini diterjemahkan oleh Cloud Translation API.

Attribution Reporting: ringkasan sistem lengkap
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Ringkasan tingkat tinggi tentang layanan terhubung untuk Pelaporan Atribusi, yang ditujukan bagi pengambil keputusan teknis.

Attribution Reporting API memungkinkan teknologi iklan dan pengiklan mengukur kapan tampilan atau klik iklan menghasilkan konversi, seperti pembelian. API ini mengandalkan kombinasi integrasi sisi klien dan sisi server, bergantung pada kebutuhan bisnis Anda.

Sebelum melanjutkan, pastikan untuk membaca ringkasan Pelaporan Atribusi. Hal ini akan membantu Anda memahami tujuan API dan alur berbagai laporan output (laporan tingkat peristiwa dan laporan ringkasan). Jika Anda menemukan istilah yang tidak dikenal, lihat glosarium Privacy Sandbox.

Untuk siapa artikel ini?

Anda harus membaca artikel ini jika:

Anda adalah pengambil keputusan teknis teknologi iklan atau pengiklan. Anda mungkin bekerja di bagian operasi, DevOps, ilmu data, IT, pemasaran, atau peran lain yang memungkinkan Anda membuat keputusan penerapan teknis. Anda ingin mengetahui cara kerja API untuk pengukuran yang menjaga privasi.
Anda adalah praktisi teknis (seperti developer, operator sistem, arsitek sistem, atau data scientist) yang akan menyiapkan eksperimen dengan lingkungan API dan Layanan Agregasi ini.

Dalam artikel ini, Anda akan membaca penjelasan menyeluruh dan menyeluruh tentang cara kerja layanan untuk Attribution Reporting API. Jika Anda adalah praktisi teknis, Anda dapat bereksperimen dengan API ini secara lokal.

Ringkasan

Attribution Reporting API terdiri dari banyak layanan, yang memerlukan penyiapan, konfigurasi sisi klien, dan deployment server tertentu. Untuk menentukan apa yang Anda perlukan, pertama-tama:

Membuat keputusan desain. Tentukan informasi yang ingin Anda kumpulkan, identifikasi konversi yang Anda harapkan dari kampanye tertentu, dan tentukan jenis laporan yang akan dikumpulkan. Output akhir adalah satu atau kedua jenis laporan: laporan tingkat peristiwa dan laporan ringkasan.

Selalu ada dua (dan terkadang tiga) komponen yang bekerja sama untuk mendukung pelaporan:

Komunikasi situs ke browser. Dalam sistem berbasis cookie, informasi untuk konversi dan engagement iklan disertakan ke ID yang memungkinkan Anda atau layanan analisis bergabung dengan peristiwa ini nanti. Dengan API ini, browser mengaitkan konversi dengan tayangan/klik iklan, berdasarkan petunjuk Anda, sebelum dikirim untuk analisis. Oleh karena itu, kode rendering iklan dan tracking konversi Anda harus:
- Beri tahu browser konversi mana yang harus diatribusikan ke klik atau tayangan iklan mana.
- Tandai data lain yang akan disertakan dalam laporan akhir.
Pengumpulan data. Anda memerlukan endpoint kolektor untuk menerima laporan yang dihasilkan di browser pengguna. Output dari browser dapat berupa salah satu dari dua kemungkinan laporan: laporan tingkat peristiwa dan laporan agregat (yang dienkripsi, digunakan untuk membuat laporan ringkasan).

Jika mengumpulkan laporan gabungan, Anda memerlukan komponen ketiga:

Pembuatan laporan ringkasan. Gabungkan laporan agregat dan gunakan Layanan Agregasi untuk memproses laporan guna membuat laporan ringkasan.

Keputusan desain

Prinsip utama Pelaporan Atribusi adalah keputusan desain awal. Anda memutuskan data apa yang akan dikumpulkan dalam kategori apa dan seberapa sering memproses data tersebut. Laporan output memberikan insight tentang kampanye atau bisnis Anda.

Laporan output dapat berupa:

Laporan tingkat peristiwa mengaitkan klik atau penayangan iklan tertentu (di sisi iklan) dengan data di sisi konversi. Untuk menjaga privasi pengguna dengan membatasi penggabungan identitas pengguna di seluruh situs, data sisi konversi sangat terbatas, dan datanya berisi derau (artinya, untuk sebagian kecil kasus, data acak dikirim, bukan laporan sebenarnya).
Laporan ringkasan tidak terikat dengan peristiwa tertentu di sisi iklan. Laporan ini menawarkan data konversi yang lebih mendetail dan fleksibilitas untuk menggabungkan data klik dan tampilan dengan data konversi.

Pilihan laporan Anda menentukan data yang perlu dikumpulkan.

Anda juga dapat menganggap output akhir sebagai input untuk alat yang Anda gunakan untuk mengambil keputusan. Misalnya, jika Anda membuat laporan ringkasan untuk menentukan jumlah konversi yang menghasilkan beberapa nilai total pembelanjaan, hal ini dapat membantu tim Anda memutuskan target kampanye iklan berikutnya untuk menghasilkan total pembelanjaan yang lebih tinggi.

Setelah memutuskan hal yang ingin diukur, Anda dapat menyiapkan sisi klien untuk Attribution Reporting API.

Komunikasi situs ke browser

Sumber atribusi di situs penayang terhubung dengan pemicu di situs pengiklan.

Alur peristiwa atribusi

Bayangkan situs penayang yang menampilkan iklan. Setiap pengiklan atau penyedia teknologi iklan ingin mempelajari interaksi dengan iklan mereka, dan mengatribusikan konversi ke iklan yang benar. Laporan (tingkat peristiwa dan agregat) akan dibuat sebagai berikut:

Di situs penayang, elemen iklan (tag <a> atau <img>) dikonfigurasi dengan atribut khusus attributionsrc. Nilainya adalah URL, misalnya https://adtech.example/register-source/ad_id=....

Berikut adalah contoh link yang akan mendaftarkan sumber setelah diklik:
```
<a href="https://shoes.example/landing" 
  attributionsrc="http://adtech.example/register-source?..."
  target="_blank">
Click me</a>
```
Berikut adalah contoh gambar yang akan menyebabkan pendaftaran sumber saat dilihat:
```
<img href="https://advertiser.example/landing" 
  attributionsrc="https://adtech.example/register-source?..."/>
```
Atau, panggilan JavaScript dapat digunakan, bukan elemen HTML.

Berikut adalah contoh JavaScript yang menggunakan window.open(). Perhatikan bahwa URL dienkode ke URL untuk menghindari masalah dengan karakter khusus.
```
const encodedUrl = encodeURIComponent(
  'https://adtech.example/attribution_source?ad_id=...');
window.open(
  "https://shoes.example/landing",
  "_blank",
  attributionsrc=${encodedUrl});
```

Saat pengguna mengklik atau melihat iklan, browser akan mengirim permintaan GET ke attributionsrc—biasanya, endpoint pengiklan atau penyedia teknologi iklan.
Setelah menerima permintaan ini, pengiklan atau penyedia teknologi iklan memutuskan untuk menginstruksikan browser untuk mendaftarkan peristiwa sumber untuk interaksi dengan iklan, sehingga konversi nantinya dapat diatribusikan ke iklan ini. Untuk melakukannya, pengiklan atau penyedia teknologi iklan menyertakan header HTTP khusus dalam responsnya. Data ini dilampirkan ke data kustom header yang memberikan informasi tentang peristiwa sumber (klik atau tampilan iklan). Jika konversi akhirnya terjadi untuk iklan ini, data kustom ini pada akhirnya akan ditampilkan dalam laporan atribusi.
Kemudian, pengguna mengunjungi situs pengiklan.
Di setiap halaman situs pengiklan yang relevan—misalnya, halaman konfirmasi pembelian, atau halaman produk—piksel konversi (elemen <img>) atau panggilan JavaScript membuat permintaan ke https://adtech.example/conversion?param1=...&param2=....
Layanan di URL ini—biasanya, pengiklan atau penyedia teknologi iklan—menerima permintaan. Sistem ini memutuskan untuk mengategorikan tindakan ini sebagai konversi, sehingga perlu menginstruksikan browser untuk mencatat konversi—yaitu untuk memicu atribusi. Untuk melakukannya, pengiklan atau penyedia teknologi iklan menyertakan header HTTP khusus yang menyertakan data kustom tentang konversi dalam responsnya terhadap permintaan piksel.
Browser—di perangkat lokal pengguna—menerima respons ini, dan mencocokkan data konversi dengan peristiwa sumber asli (tampilan atau klik iklan). Pelajari lebih lanjut di Mencocokkan sumber dengan pemicu
Browser menjadwalkan laporan untuk dikirim ke attributionsrc. Laporan ini mencakup:
1. Data konfigurasi atribusi kustom yang dilampirkan oleh penyedia teknologi iklan atau pengiklan ke peristiwa sumber di Langkah 3.
2. Data konversi kustom yang ditetapkan pada Langkah 6.
Kemudian, browser akan mengirimkan laporan ke endpoint yang ditentukan di attributionsrc, dengan beberapa penundaan dan derau. Laporan agregat dienkripsi, sedangkan laporan tingkat peristiwa tidak.

Pemicu atribusi (situs pengiklan)

Pemicu atribusi adalah peristiwa yang memberi tahu browser untuk merekam konversi.

Sebaiknya catat konversi yang paling penting bagi pengiklan, seperti pembelian. Beberapa jenis konversi dan metadata dapat diambil dalam laporan ringkasan.

Hal ini memastikan hasil gabungannya mendetail dan akurat untuk peristiwa ini.

Mencocokkan sumber dengan pemicu

Saat browser menerima respons pemicu atribusi, browser akan mengakses penyimpanan lokal untuk menemukan sumber yang cocok dengan origin pemicu atribusi dan eTLD+1 URL halaman tersebut.

Misalnya, saat browser menerima pemicu atribusi dari adtech.example di shoes.example/shoes123, browser akan mencari sumber di penyimpanan lokal yang cocok dengan adtech.example dan shoes.example.

Filter (atau aturan kustom) dapat ditetapkan untuk menentukan kapan pemicu dicocokkan dengan sumber tertentu. Misalnya, tetapkan filter untuk hanya menghitung konversi untuk kategori produk tertentu dan abaikan semua kategori lainnya. Filter dan model prioritas memungkinkan pelaporan atribusi yang lebih canggih.

Jika beberapa sumber atribusi ditemukan di penyimpanan lokal, browser akan memilih sumber yang terakhir disimpan. Dalam beberapa kasus saat sumber atribusi diberi prioritas, browser akan memilih sumber dengan prioritas tertinggi.

Pengumpulan data

Bersama-sama, pemicu atribusi yang dicocokkan dengan sumber yang sesuai, dikirim sebagai laporan oleh browser ke endpoint pelaporan di server milik teknologi iklan (terkadang disebut sebagai endpoint pengumpulan atau layanan pengumpulan). Laporan ini dapat berupa laporan tingkat peristiwa atau laporan agregat.

Laporan agregat digunakan untuk membuat laporan ringkasan. Laporan gabungan adalah kombinasi data yang dikumpulkan dari iklan (di situs penayang) dan data konversi (dari situs pengiklan) yang dibuat dan dienkripsi oleh browser di perangkat pengguna sebelum dikumpulkan oleh teknologi iklan.

Laporan tingkat peristiwa tertunda antara 2 hingga 30 hari. Laporan gabungan dikirim dengan penundaan acak dalam waktu satu jam dan peristiwa harus sesuai dengan anggaran kontribusi. Pilihan ini melindungi privasi dan mencegah eksploitasi tindakan setiap pengguna.

Jika Anda hanya tertarik dengan laporan tingkat peristiwa, ini adalah bagian terakhir dari infrastruktur yang Anda perlukan. Namun, jika ingin membuat laporan ringkasan, Anda harus memproses laporan agregat dengan layanan tambahan.

Pembuatan laporan ringkasan

Untuk membuat laporan ringkasan, Anda akan menggunakan Layanan Agregasi (dioperasikan oleh teknologi iklan) untuk memproses laporan agregat. Layanan Agregasi menambahkan derau untuk melindungi privasi pengguna dan menampilkan laporan ringkasan akhir.

Laporan agregat dikumpulkan, dikelompokkan, dan dikirim ke lingkungan teknologi iklan. — Diagram ini menunjukkan alur data asinkron dari endpoint pengumpulan, laporan pengelompokan, hingga pemrosesan di Layanan Agregasi milik teknologi iklan.

Setelah mengelompokkan laporan gabungan yang dikumpulkan, batch akan diproses oleh Layanan Agregasi. Koordinator hanya memberikan kunci dekripsi ke versi Layanan Agregasi yang diautentikasi. Layanan Agregasi kemudian mendekripsi data, menggabungkannya, dan menambahkan derau sebelum menampilkan hasilnya sebagai laporan ringkasan.

Laporan gabungan dalam batch

Sebelum diproses, laporan gabungan harus dikelompokkan. Batch terdiri dari laporan gabungan yang dikelompokkan secara strategis. Strategi Anda kemungkinan besar akan mencerminkan jangka waktu tertentu (seperti harian atau mingguan). Proses ini dapat dilakukan di server yang sama yang berfungsi sebagai endpoint pelaporan Anda.

Batch harus berisi banyak laporan untuk memastikan rasio sinyal-derau tinggi.

Jangka waktu yang lebih besar akan menghasilkan hasil yang lebih sedikit derau. — Bandingkan menunggu 1 hari dan 1 minggu. Dalam 1 jam, Anda akan memiliki nilai ringkasan yang lebih kecil dengan hasil yang mungkin lebih berisi derau. Dalam satu hari, Anda akan memiliki nilai ringkasan yang lebih besar sehingga kemungkinan akan lebih sedikit derau.

Periode batch dapat berubah kapan saja untuk memastikan Anda menangkap peristiwa tertentu yang volumenya lebih tinggi, seperti untuk promo tahunan. Periode pengelompokan dapat diubah tanpa perlu mengubah sumber atau pemicu atribusi.

Layanan Agregasi

Layanan Agregasi bertanggung jawab memproses laporan gabungan untuk membuat laporan ringkasan. Laporan gabungan dienkripsi dan hanya dapat dibaca oleh Layanan Agregasi, yang berjalan di trusted execution environment (TEE).

Layanan Agregasi meminta kunci dekripsi dari koordinator untuk mendekripsi dan menggabungkan data. Setelah didekripsi dan digabungkan, hasil akan ditambahkan derau untuk menjaga privasi dan ditampilkan sebagai laporan ringkasan.

Praktisi dapat membuat laporan cleartext gabungan untuk menguji Layanan Agregasi secara lokal. Atau, Anda dapat menguji dengan laporan terenkripsi di AWS dengan Nitro Enclaves.

Apa langkah selanjutnya?

Kami ingin berdiskusi dengan Anda untuk memastikan kami membuat API yang berfungsi bagi semua orang.

Membahas API

Seperti Privacy Sandbox API lainnya, API ini didokumentasikan dan dibahas secara publik.

Bereksperimen dengan API

Anda dapat bereksperimen dan berpartisipasi dalam percakapan tentang Attribution Reporting API.