Halaman ini diterjemahkan oleh Cloud Translation API.

Attribution Reporting: ringkasan sistem lengkap

Ringkasan tingkat tinggi tentang layanan terhubung untuk Attribution Reporting, yang ditujukan bagi pengambil keputusan teknis.

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

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

Kepada siapa artikel ini?

Anda harus membaca artikel ini jika:

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

Dalam artikel ini, Anda akan membaca penjelasan secara garis besar mengenai bagaimana berfungsi untuk Attribution Reporting API. Jika Anda seorang teknisi Anda dapat bereksperimen dengan API ini secara lokal.

Ringkasan

Attribution Reporting API terdiri dari banyak layanan, yang memerlukan konfigurasi sisi klien, dan penerapan server. Untuk menentukan apa yang Anda perlukan, terlebih dahulu:

Membuat keputusan desain. Tentukan informasi yang ingin Anda kumpulkan, identifikasi konversi yang diharapkan dari kampanye tertentu, dan tentukan jenis laporan yang akan dikumpulkan. Hasil akhir adalah salah 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. Di beberapa berbasis cookie, informasi untuk konversi dan engagement iklan yang dilampirkan ke ID yang memungkinkan Anda atau layanan analisis untuk bergabung acara ini nanti. Dengan API ini, browser mengaitkan konversi dengan klik/penayangan iklan, berdasarkan petunjuk Anda, sebelum ditayangkan untuk analisis data. Oleh karena itu, kode rendering iklan dan tracking konversi Anda harus:
- Memberi tahu browser konversi mana yang harus diatribusikan ke iklan tertentu klik, atau tayangan iklan.
- Beri sinyal pada data lainnya untuk disertakan dalam laporan akhir.
Pengumpulan data. Anda memerlukan endpoint kolektor untuk menerima laporan, yang dibuat di browser. Output dari browser dapat berupa salah satu dari dua kemungkinan laporan: laporan tingkat peristiwa dan laporan gabungan (yang dienkripsi, digunakan untuk membuat laporan ringkasan).

Jika telah mengumpulkan laporan agregat, Anda memerlukan komponen ketiga:

Pembuatan laporan ringkasan. Kumpulan laporan agregat dan menggunakan Layanan Agregasi untuk memproses laporan untuk menghasilkan laporan ringkasan.

Keputusan desain

Prinsip utama Attribution Reporting adalah keputusan desain awal. Anda yang memutuskan data apa yang harus dikumpulkan dalam kategori apa dan seberapa sering harus diproses layanan otomatis dan data skalabel. Laporan hasil memberikan insight tentang kampanye atau bisnis Anda.

Laporan output dapat berupa:

Laporan tingkat peristiwa mengaitkan klik atau tampilan 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 data tersebut berisik (artinya, untuk sebagian kecil kasus, data acak yang dikirim, bukan laporan sebenarnya).
Laporan ringkasan tidak terikat dengan peristiwa tertentu di sisi iklan. Laporan ini menawarkan data konversi yang lebih detail dan fleksibilitas untuk menggabungkan data klik dan melihat dengan data konversi.

Pilihan laporan menentukan data yang harus Anda kumpulkan.

Anda juga dapat menganggap {i>output<i} akhir sebagai input untuk alat yang Anda gunakan untuk membuat keputusan. Misalnya, jika Anda membuat laporan ringkasan untuk menentukan cara banyak konversi yang menghasilkan total nilai pembelanjaan, yang dapat membantu tim Anda memutuskan target kampanye iklan Anda berikutnya untuk menghasilkan total pembelanjaan yang lebih tinggi.

Setelah memutuskan apa yang ingin Anda ukur, 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 sebuah situs penayang yang menampilkan iklan. Setiap pengiklan atau penyedia teknologi iklan ingin mempelajari interaksi dengan iklan mereka, dan mengatribusikan konversi ke iklan yang tepat. Laporan (baik tingkat peristiwa maupun 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 ini 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 ini contoh gambar yang akan menyebabkan pendaftaran sumber saat dilihat:
```
<img href="https://advertiser.example/landing" 
  attributionsrc="https://adtech.example/register-source?..."/>
```
Atau, sebagai ganti elemen HTML, panggilan JavaScript dapat digunakan.

Berikut adalah contoh JavaScript yang menggunakan window.open(). Perhatikan bahwa URL dienkode menggunakan 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 mengirimkan permintaan GET ke attributionsrc—biasanya, endpoint pengiklan atau penyedia teknologi iklan.
Setelah menerima permintaan ini, pengiklan atau penyedia teknologi iklan memutuskan untuk memerintahkan browser mendaftarkan peristiwa sumber untuk interaksi dengan iklan, sehingga konversi dapat diatribusikan ke iklan ini nantinya. Untuk melakukannya, pengiklan atau penyedia teknologi iklan menyertakan header HTTP khusus dalam responsnya. Konversi ini melekat ke data kustom header ini yang memberikan informasi tentang peristiwa sumber (tampilan atau klik iklan)—jika pada akhirnya konversi terjadi untuk iklan ini, data kustom ini pada akhirnya akan muncul 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. Fitur ini memutuskan untuk mengategorikannya sebagai konversi, sehingga pengguna perlu memerintahkan 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—pada perangkat lokal pengguna—menerima respons ini dan mencocokkan data konversi dengan peristiwa sumber asli (klik iklan atau penayangan). Pelajari lebih lanjut di Mencocokkan sumber dengan pemicu
Browser menjadwalkan laporan untuk dikirim ke attributionsrc. Laporan ini berisi:
1. Data konfigurasi atribusi khusus yang disertakan oleh penyedia teknologi iklan atau pengiklan ke peristiwa sumber di Langkah 3.
2. Set data konversi kustom di Langkah 6.
Kemudian, browser mengirimkan laporan ke endpoint yang ditentukan di attributionsrc, dengan beberapa keterlambatan dan derau. Laporan agregat dienkripsi, sedangkan laporan tingkat peristiwa tidak.

Pemicu atribusi (situs pengiklan)

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

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

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

Cocokkan sumber dengan pemicu

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

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

Filter (atau aturan kustom) dapat ditetapkan untuk menentukan kapan pemicu cocok ke sumber tertentu. Misalnya, tetapkan filter agar hanya menghitung konversi untuk kategori produk tertentu dan mengabaikan semua kategori lainnya. Filter dan memungkinkan pelaporan atribusi yang lebih canggih.

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

Pengumpulan data

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

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

Laporan tingkat peristiwa tertunda antara 2 hingga 30 hari. Laporan agregat adalah yang dikirim dengan penundaan acak dalam satu jam dan peristiwa harus muat dalam anggaran kontribusi. Pilihan ini melindungi privasi dan mencegah eksploitasi atas tindakan setiap pengguna.

Jika Anda hanya tertarik pada laporan tingkat peristiwa, ini adalah bagian terakhir dari infrastruktur yang Anda butuhkan. 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. Agregasi Layanan menambahkan derau untuk melindungi privasi pengguna dan menampilkan laporan ringkasan akhir.

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

Setelah mengelompokkan laporan agregat yang dikumpulkan, batch akan diproses oleh Layanan Agregasi. J koordinator memberikan kunci dekripsi hanya ke versi Agregasi yang disahkan Layanan. Layanan Agregasi kemudian membongkar enkripsi data, menggabungkan dan menambahkan noise sebelum menampilkan hasilnya sebagai laporan ringkasan.

Laporan agregat yang dikelompokkan

Sebelum diproses, laporan agregat harus dikelompokkan. Batch terdiri dari laporan agregat yang dikelompokkan secara strategis. Strategi Anda akan menghasilkan mungkin mencerminkan jangka waktu tertentu (seperti harian atau mingguan). Ini proses ini dapat berlangsung di server yang sama yang bertindak sebagai titik akhir pelaporan Anda.

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

Jangka waktu yang lebih besar akan menghasilkan tingkat noise yang lebih sedikit. — Bandingkan waktu tunggu 1 hari dan 1 minggu. Dalam 1 jam, Anda akan memiliki nilai ringkasan yang lebih kecil dengan hasil yang kemungkinan lebih berisik. Dalam satu hari, Anda akan memiliki nilai ringkasan yang lebih besar sehingga cenderung tidak terlalu berisik.

Periode batch dapat berubah kapan saja untuk memastikan Anda merekam peristiwa tertentu tempat Anda mengharapkan volume yang lebih tinggi, seperti untuk penjualan tahunan. Periode pengelompokan dapat diubah tanpa perlu mengubah sumber atau pemicu atribusi.

Layanan Agregasi

Layanan Agregasi bertanggung jawab untuk memproses laporan agregat untuk membuat laporan ringkasan. Laporan agregat dienkripsi dan hanya dapat dibaca oleh Layanan Agregasi, yang berjalan di lingkungan eksekusi tepercaya (TEE).

Layanan Agregasi meminta kunci dekripsi dari koordinator untuk membongkar enkripsi dan menggabungkan data. Setelah didekripsi dan diagregasikan, hasilnya derau untuk menjaga privasi dan ditampilkan sebagai laporan ringkasan.

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

Apa langkah selanjutnya?

Kami ingin berinteraksi dengan Anda untuk memastikan kami membangun API yang dapat digunakan oleh semua orang.

Mendiskusikan API

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

Bereksperimen dengan API

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