Memahami kunci agregasi untuk Pelaporan Atribusi

Pengertian kunci agregasi, cara menggunakannya di Attribution Reporting API, dan cara menerjemahkan sasaran menjadi kunci.

Sebagai perusahaan teknologi iklan yang menjalankan kampanye di beberapa lokasi untuk berbagai kategori produk, Anda ingin membantu pengiklan menjawab pertanyaan berikut:

1. Berapa banyak pembelian dari setiap kategori produk yang dihasilkan oleh setiap kampanye saya di setiap wilayah geografis?
2. Berapa pendapatan untuk setiap kategori produk yang dihasilkan oleh setiap kampanye saya di setiap wilayah geografis?

Meskipun banyak perusahaan teknologi iklan mendorong pengiklan untuk mengonfigurasi berbagai jenis konversi, berfokus pada konversi yang paling penting seperti pembelian adalah cara yang baik untuk memastikan bahwa hasil ringkasan mendetail dan akurat untuk peristiwa penting ini.

Untuk melakukannya, Anda harus memikirkan pertanyaan apa yang ingin Anda jawab sebelum data dikumpulkan.

Dimensi, kunci, dan nilai

Untuk menjawab pertanyaan ini, mari kita lihat dimensi, kunci, dan nilai.

Catatan: Kunci agregasi yang dibahas dalam dokumen ini khusus untuk Attribuion Reporting API.

Dimensi

Untuk memahami bagaimana kampanye Anda menghasilkan pendapatan, seperti yang dijelaskan di sini, Anda dapat melacak dimensi berikut:

• ID kampanye iklan: ID untuk kampanye tertentu.
• ID Geografi: wilayah geografis tempat iklan ditayangkan.
• Kategori produk: jenis produk seperti yang Anda tetapkan.

Meskipun dimensi ID Kampanye dan ID Geografi diketahui saat iklan ditayangkan (waktu penayangan iklan), kategori Produk akan diketahui dari peristiwa pemicu, saat pengguna menyelesaikan konversi (waktu konversi).

Catatan: Untuk diagram dalam dokumen ini, kami akan menampilkan dimensi sebagai berikut:

• Dimensi yang diketahui pada waktu penayangan iklan dengan latar belakang hijau.
• Dimensi yang diketahui pada waktu konversi dengan latar belakang kuning dan digarisbawahi.

Dimensi yang ingin Anda lacak untuk contoh ini adalah seperti yang ditunjukkan pada gambar berikut:

Dimensi untuk dilacak

Apa itu kunci agregasi (bucket)?

Istilah kunci agregasi dan bucket merujuk pada hal yang sama. Kunci agregasi digunakan di API browser yang digunakan untuk mengonfigurasi laporan. Istilah bucket digunakan dalam laporan agregat dan ringkasan, serta dalam API layanan agregasi.

Kunci agregasi (singkatnya) adalah bagian data yang mewakili nilai dimensi yang sedang dilacak. Data nantinya akan diagregasi bersama setiap kunci agregasi.

Misalnya, asumsikan Anda melacak dimensi Kategori produk, ID Geografi, dan ID Kampanye.

Saat pengguna yang berada di ID Geografi 7 melihat iklan untuk ID Kampanye 12, dan kemudian melakukan konversi dengan membeli produk dalam kategori Produk 25, Anda dapat menetapkan kunci agregasi yang terlihat seperti yang ada dalam gambar berikut:

Anda akan melihat nanti bahwa kunci agregasi tidak terlihat sama persis seperti ini dalam praktiknya, tetapi untuk saat ini mari kita fokus pada informasi yang terdapat dalam kunci.

Apa itu nilai agregat?

Untuk menjawab pertanyaan Anda mengenai dimensi yang telah kami uraikan, sebaiknya Anda mengetahui:

• Jumlah pembelian (jumlah pembelian). Setelah digabungkan dan disediakan dalam laporan ringkasan, metrik ini akan menjadi jumlah total pembelian (nilai ringkasan).
• Pendapatan untuk setiap pembelian (nilai pembelian). Setelah digabungkan dan tersedia dalam laporan ringkasan, metrik ini akan menjadi total pendapatan (nilai ringkasan).

Masing-masing—jumlah pembelian untuk satu konversi dan nilai pembelian untuk satu konversi—adalah nilai agregat. Anda dapat menganggap nilai agregat sebagai nilai sasaran pengukuran Anda.

Pertanyaan	Nilai gabungan = Sasaran pengukuran
		Berapa banyak pembelian...	Jumlah pembelian
Berapa pendapatan...	Nilai pembelian

Jika pengguna yang berada di ID Geografi 7 melihat iklan untuk ID Kampanye 12, lalu melakukan konversi dengan membeli produk kategori Produk 25 seharga Rp1.200.000 (dengan asumsi mata uang Anda adalah USD), Anda dapat menetapkan kunci agregasi dan nilai agregat yang terlihat seperti ini:

Kunci agregasi dan nilai agregat. Perhatikan bahwa nilai agregat dicetak tebal dengan latar belakang biru.

Nilai agregat dijumlahkan per kunci di banyak pengguna untuk menghasilkan insight gabungan, dalam bentuk nilai ringkasan dalam laporan ringkasan.

Nilai agregat dijumlahkan untuk menghasilkan insight gabungan untuk sasaran pengukuran Anda.

Perhatikan bahwa diagram ini menghilangkan dekripsi dan menampilkan contoh sederhana tanpa penerapan derau. Di bagian berikutnya, kita akan menguraikan contoh ini dengan derau.

Dari kunci dan nilai hingga laporan

Sekarang, mari kita bahas hubungan antara kunci dan nilai agregat dengan laporan.

Laporan agregat

Saat pengguna mengklik atau melihat iklan, lalu melakukan konversi, Anda menginstruksikan browser untuk menyimpan pasangan {aggregate key, aggregatable value}.

Catatan: Dalam penjelasan, pasangan {agregasi kunci, nilai agregat} juga disebut kontribusi histogram: ini mewakili bagaimana konversi ini—dan dimensi serta nilai yang terkait dengannya—berkontribusi pada laporan ringkasan.

Dalam contoh kami, saat pengguna mengklik atau melihat iklan, lalu melakukan konversi, Anda menginstruksikan browser untuk membuat dua kontribusi (satu per sasaran pengukuran).

Nantinya Anda akan melihat bahwa laporan agregat {agregasi, nilai agregat} tidak terlihat sama persis—tetapi untuk sekarang, mari kita fokus pada informasi yang terdapat dalam laporan.

Saat Anda memerintahkan browser untuk menghasilkan dua kontribusi, browser akan membuat laporan agregat (jika dapat mencocokkan konversi dengan tampilan atau klik sebelumnya).

Laporan agregat berisi:

• Kontribusi yang telah Anda konfigurasi.
• Metadata tentang peristiwa klik atau penayangan dan peristiwa konversi: situs tempat konversi terjadi, dan lainnya. Lihat semua kolom dalam laporan agregat.

Laporan agregat berformat JSON dan mencakup antara lain, kolom payload yang akan digunakan sebagai input data untuk laporan ringkasan akhir.

Payload berisi daftar kontribusi, masing-masing merupakan pasangan {agregasi kunci, nilai agregat}:

• bucket: kunci agregasi, dienkode sebagai bytestring.
• value: nilai agregat untuk sasaran pengukuran tersebut, yang dienkode sebagai bytestring.

Berikut contohnya:

{
  "data": [
    {
      "bucket": "111001001",
      "value": "11111010000",
    }
  ],
  "operation": "histogram"
}

Dalam praktiknya, laporan agregat dienkode dengan cara yang akan membuat bucket dan nilai terlihat berbeda dari contoh sebelumnya (yaitu, bucket mungkin terlihat seperti \u0000\u0000\x80\u0000). Bucket dan value adalah bytestring.

Laporan ringkasan

Laporan agregat digabungkan di banyak browser dan perangkat (pengguna) sebagai berikut:

• Teknologi iklan meminta laporan ringkasan untuk kumpulan kunci tertentu, dan kumpulan laporan agregat tertentu yang berasal dari berbagai browser (pengguna) yang berbeda.
• Laporan agregat didekripsi oleh layanan agregasi.
• Untuk setiap kunci, nilai agregat dari laporan agregat dijumlahkan.
• Derau ditambahkan ke nilai ringkasan.

Hasilnya adalah laporan ringkasan yang berisi kumpulan pasangan {agregasi kunci, nilai ringkasan}.

Laporan ringkasan berisi kumpulan key-value pair bergaya kamus JSON. Setiap pasangan berisi:

• bucket: kunci agregasi, dienkode sebagai bytestring.
• value: nilai ringkasan dalam desimal untuk sasaran pengukuran tertentu, diringkas dari semua laporan agregat yang tersedia, dengan tingkat derau tambahan.

Contoh:

[
  {"bucket": "111001001", "value": "2558500"},
  {"bucket": "111101001", "value": "3256211"},
  {...}
]

Dalam praktiknya, laporan ringkasan dienkode dengan cara yang akan membuat bucket dan nilai terlihat berbeda dari yang dinyatakan dalam contoh (yaitu, bucket mungkin terlihat seperti \u0000\u0000\x80\u0000). Bucket dan value adalah bytestring.

Cara kerja kunci agregasi

Kunci agregasi (bucket) ditentukan oleh perusahaan teknologi iklan, biasanya dalam dua langkah: saat iklan diklik atau dilihat, dan saat pengguna melakukan konversi.

Struktur kunci

Kita akan menggunakan istilah struktur kunci untuk menentukan kumpulan dimensi yang dienkode ke kunci.

Misalnya, ID Kampanye × GeoID × Kategori produk adalah struktur utama.

Jenis kunci

Nilai agregat dijumlahkan untuk kunci tertentu di beberapa pengguna/browser. Namun, kita telah melihat bahwa nilai agregat dapat melacak berbagai sasaran pengukuran, seperti nilai pembelian atau jumlah pembelian. Anda ingin memastikan bahwa layanan agregasi akan menjumlahkan nilai agregat dari jenis yang sama.

Untuk melakukannya, dalam setiap kunci, enkode sepotong data yang memberi tahu Anda apa yang diwakili oleh nilai ringkasan—sasaran pengukuran yang dirujuk oleh kunci ini. Salah satu cara untuk melakukannya adalah dengan membuat dimensi tambahan untuk kunci Anda yang mewakili jenis sasaran pengukuran.

Menggunakan contoh kita sebelumnya, jenis sasaran pengukuran ini akan memiliki dua kemungkinan nilai yang berbeda:

• Jumlah pembelian adalah jenis sasaran pengukuran pertama.
• Nilai pembelian adalah jenis sasaran pengukuran kedua.

Jika Anda memiliki n sasaran pengukuran, jenis sasaran pengukuran akan memiliki n jenis nilai yang berbeda.

Anda dapat menganggap dimensi kunci sebagai metrik. Misalnya, "jumlah pembelian produk tertentu per kampanye per geografi".

Ukuran kunci, ukuran dimensi

Ukuran kunci maksimum ditentukan dalam bit, yaitu jumlah nol dan satu dalam biner untuk membuat kunci lengkap. API ini mengizinkan panjang kunci sebesar 128 bit.

Ukuran ini memungkinkan kunci yang sangat terperinci, tetapi kunci yang lebih terperinci cenderung menghasilkan nilai yang lebih berisik. Anda dapat membaca selengkapnya tentang derau di Memahami derau.

Seperti yang diperkenalkan sebelumnya, dimensi dienkode ke kunci agregasi. Setiap dimensi memiliki kardinalitas tertentu—yaitu, jumlah nilai unik yang dapat diambil dimensi. Bergantung pada kardinalitasnya, setiap dimensi perlu diwakili oleh jumlah bit tertentu. Dengan n bit, Anda dapat mengekspresikan 2ⁿ opsi yang berbeda.

Misalnya, dimensi Negara mungkin memiliki kardinalitas 200, karena ada sekitar 200 negara di dunia. Berapa banyak bit yang diperlukan untuk mengenkode dimensi ini?

7 bit hanya akan menyimpan 2⁷ = 128 opsi berbeda, yang kurang dari 200 yang dibutuhkan.

8 bit akan menyimpan 2⁸ = 256 opsi berbeda, yang melebihi jumlah yang dibutuhkan 200, sehingga Anda dapat menggunakan n=8 bit untuk mengenkode dimensi ini.

Encoding kunci

Saat Anda menyetel kunci pada browser, kunci tersebut harus dienkode dalam heksadesimal. Dalam laporan ringkasan, kunci akan muncul dalam biner (dan diberi nama bucket).

Catatan: Data heksadesimal biasanya diawali dengan 0x. Misalnya, 0x19 adalah 19 dalam heksadesimal; itu 25 dalam desimal, bukan 19. Bilangan biner biasanya diawali dengan 0b Misalnya, 0b11001 adalah 11001 dalam biner; berarti 25 dalam desimal, bukan 11.001.

Menetapkan dua bagian kunci untuk kunci penuh

Anggaplah Anda menggunakan kunci untuk melacak dimensi berikut:

• ID kampanye
• ID Geografi
• Kategori produk

Meskipun dimensi ID Kampanye dan ID Geografi diketahui saat iklan ditayangkan (waktu penayangan iklan), kategori produk akan diketahui dari peristiwa pemicu, saat pengguna menyelesaikan konversi (waktu konversi).

Dalam praktiknya, Anda akan menetapkan kunci dalam dua langkah:

1. Anda akan menetapkan satu bagian kunci—ID Kampanye × ID Geografi—saat klik atau waktu tampilan.
2. Anda perlu menetapkan bagian kedua dari kunci—Kategori produk—saat konversi.

Bagian-bagian berbeda dari kunci ini disebut bagian kunci.

Peringatan: Dokumen ini salah menjelaskan bagian-bagian penting yang digabungkan menggunakan bitwise-XOR, meskipun sebenarnya digabungkan menggunakan bitwise-OR.

Kunci dihitung dengan mengambil XOR (^) dari bagian kuncinya.

Contoh:

• Bagian kunci sisi sumber = 0x159
• Bagian kunci sisi pemicu = 0x400
• Kunci = 0x159 ^ 0x400 = 0x559

Menyelaraskan bagian-bagian penting

Dengan dua buah kunci 64-bit yang diperluas hingga 128 bit menggunakan pengisi/offset 64-bit yang ditempatkan dengan hati-hati (enam belas angka nol), potongan kunci XOR-ing setara dengan menggabungkannya, yang lebih mudah untuk dipahami dan diverifikasi:

• Bagian kunci sisi sumber = 0xa7e297e7c8c8d0540000000000000000
• Bagian kunci sisi pemicu = 0x0000000000000000674fbe308a597271
• Kunci = 0xa7e297e7c8c8d0540000000000000000 ^ 0x0000000000000000674fbe308a597271 = 0xa7e297e7c8c8d054674fbe308a597271

Beberapa kunci per klik atau tampilan iklan

Dalam praktiknya, Anda dapat menetapkan beberapa kunci per peristiwa sumber atribusi (klik iklan atau penayangan). Misalnya, Anda dapat menetapkan:

• Kunci yang melacak ID Geografi × ID Kampanye.
• Kunci lain yang melacak Jenis Materi Iklan × ID Kampanye.

Lihat Strategi B untuk contoh lainnya.

Dimensi encoding ke dalam kunci

Saat meminta laporan ringkasan, Anda harus memberi tahu layanan agregasi metrik apa yang ingin Anda akses, dengan meminta laporan ringkasan untuk kumpulan kunci agregasi tertentu.

Laporan ringkasan berisi pasangan {key, summary value} mentah, dan tidak ada informasi tambahan tentang kunci. Hal ini berarti:

• Saat menetapkan kunci saat pengguna melihat atau mengklik iklan, lalu melakukan konversi, Anda perlu menetapkan kunci secara andal berdasarkan nilai dimensi yang diwakilinya.
• Saat menentukan kunci yang ingin Anda minta laporan ringkasannya, Anda harus membuat atau mengakses dengan cepat kunci yang sama dengan kunci yang ditetapkan saat pengguna melihat atau mengklik iklan dan melakukan konversi, berdasarkan nilai dimensi yang data gabungannya ingin Anda lihat.

Dimensi encoding menggunakan peta struktur kunci

Untuk mengenkode dimensi menjadi kunci, Anda dapat membuat dan mengelola peta struktur kunci terlebih dahulu, setelah menentukan kunci (sebelum waktu penayangan iklan).

Peta struktur utama mewakili setiap dimensi Anda dan posisinya dalam kunci.

Dalam praktiknya, membuat dan mempertahankan peta struktur kunci berarti Anda harus menerapkan dan memelihara logika decoder. Jika Anda mencari metode yang tidak mengharuskan Anda melakukannya, pertimbangkan untuk menggunakan pendekatan berbasis hash.

Berikut contohnya:

Anggaplah Anda berencana melacak pembelian dan nilai pembelian untuk kampanye, wilayah geografis, dan produk tertentu.

Kategori produk, ID geografi, dan ID kampanye harus merupakan dimensi dalam kunci Anda. Selain itu, karena Anda ingin melacak dua sasaran pengukuran yang berbeda—jumlah pembelian dan nilai pembelian—Anda perlu menambahkan satu dimensi dalam kunci untuk melacak jenis kunci. Tindakan ini akan memungkinkan Anda menentukan apa yang sebenarnya diwakili oleh nilai agregat setelah menerima pasangan {key, aggregatable value} dalam laporan ringkasan.

Dengan sasaran pengukuran ini, kunci Anda memiliki dimensi berikut:

• Kategori produk
• Jenis sasaran pengukuran
• ID Geografi
• ID kampanye

Sekarang, dengan melihat setiap dimensi, mari asumsikan untuk kasus penggunaan Anda, bahwa Anda perlu melacak hal berikut:

• 29 kategori produk yang berbeda.
• 8 wilayah geografis yang berbeda: Amerika Utara, Amerika Tengah, Amerika Selatan, Eropa, Afrika, Asia, Karibia, dan Oseania.
• 16 kampanye berbeda.

Berikut adalah jumlah bit yang Anda perlukan untuk mengenkode setiap dimensi dalam kunci Anda:

• Kategori produk: 5 bit (2⁵ = 32 > 29).
• Jenis sasaran pengukuran: 1 bit. Sasaran pengukurannya adalah jumlah pembelian atau nilai pembelian, yang berarti dua kemungkinan berbeda; oleh karena itu, satu bit sudah cukup untuk menyimpan ini.

• ID Geografi: 3 bit (2³ = 8). Anda juga akan menentukan peta dimensi untuk ID Geografi agar dapat mengetahui wilayah geografis yang diwakili oleh setiap nilai biner. Peta dimensi untuk dimensi ID Geografi Anda mungkin terlihat seperti ini:

  Nilai biner dalam kunci	Geografi
  000	Amerika Utara
  001	Amerika Tengah
  010	Amerika Selatan
  011	Eropa
  100	Afrika
  101	Asia
  110	Karibia
  111	Oseania

• ID Kampanye: 4 bit (2⁴ = 16)

Panjang kunci yang mengikuti struktur ini adalah 13 bit (5 + 1 + 3 + 4).

Untuk contoh ini, peta struktur kunci untuk kunci ini akan terlihat seperti ini:

Anda bebas menentukan urutan dimensi dalam kunci.

Untuk menggambarkan bagaimana dimensi membentuk struktur kunci, kita akan menggunakan representasi biner, itulah sebabnya ID Kampanye (bit pertama) adalah yang paling kanan, dan kategori produk (bit terakhir) adalah yang paling kiri.

Dalam setiap dimensi, bit yang paling signifikan—bit yang membawa nilai numerik terbesar—adalah bit paling kiri. Bit paling tidak signifikan—bit yang membawa nilai numerik terkecil—adalah bit paling kanan.

Mari kita lihat bagaimana Anda akan menggunakan peta struktur kunci untuk mendekode kunci.

Mari kita ambil 0b1100100111100 sebagai contoh kunci acak, dan anggaplah Anda memiliki cara untuk mengetahui bahwa kunci ini mengikuti peta struktur kunci dalam ilustrasi sebelumnya.

Menurut peta struktur kunci, kunci ini akan mendekode ke 11001 0 011 1100.

Jadi, kunci 0b1100100111100 mewakili jumlah pembelian kategori Produk 25, untuk ID Kampanye 12 yang diluncurkan di Eropa.

Dimensi encoding menggunakan fungsi hash

Daripada menggunakan peta struktur kunci, Anda dapat menggunakan fungsi hashing untuk membuat kunci secara dinamis dengan cara yang konsisten dan andal.

Cara kerjanya adalah sebagai berikut:

1. Pilih algoritma {i>hashing<i}.
2. Pada waktu penayangan iklan, buat string yang menyertakan semua dimensi yang ingin Anda lacak, beserta nilainya. Untuk membuat bagian kunci sisi sumber, lakukan hashing pada string ini dan sebaiknya tambahkan akhiran nol 64-bit untuk menyelaraskan dengan bagian kunci sisi pemicu dan membuat XOR lebih mudah untuk dipertimbangkan.
   • Bagian kunci sisi sumber
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
   • Perhatikan bahwa COUNT mengenkode hal yang sama seperti measurementGoalType=0 dalam pendekatan peta struktur kunci. COUNT sedikit lebih ramping dan lebih eksplisit.
3. Pada waktu konversi, buat string yang mencakup semua dimensi yang ingin Anda lacak, dan nilai-nilai mereka. Untuk membuat bagian kunci sisi pemicu, hash string ini dan tambahkan awalan nol 64-bit:
   • Bagian kunci sisi pemicu = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. Browser melakukan XOR bagian kunci ini untuk menghasilkan kunci.
   • Kunci agregasi 128-bit
     = <64-bit hex source-side key piece hash><64-bit hex source-side key piece hash>
5. Nanti, saat Anda sudah siap meminta laporan ringkasan untuk kunci ini, buat laporan tersebut dengan cepat:
   • Berdasarkan dimensi yang Anda minati, buat bagian kunci sisi sumber dan sisi pemicu seperti yang Anda lakukan sebelumnya.
     • Bagian kunci sisi sumber
       = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
     • Bagian kunci sisi pemicu
       = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
     • bagian kunci sisi pemicu = toHex(hash("productCategory=25"))
   • Sama seperti browser, lakukan XOR pada bagian-bagian kunci ini untuk menghasilkan kunci yang sama dengan yang telah dihasilkan oleh browser sebelumnya.
     • Kunci agregasi 128-bit
       = <64-bit source-side key piece hash><64-bit source-side key piece hash>

Beberapa tips praktis jika Anda menggunakan pendekatan berbasis hash ini:

• Selalu gunakan urutan dimensi yang sama. Dengan begitu, hash Anda dapat dibuat ulang dengan andal. ("COUNT, CampaignID=12, GeoID=7" tidak akan menghasilkan hash yang sama seperti "COUNT, GeoID=7, CampaignID=12"). Satu cara mudah untuk mencapainya adalah dengan mengurutkan dimensi secara alfanumerik. Inilah yang akan kita lakukan dalam contoh, kecuali bahwa kita akan selalu menjadikan COUNT atau VALUE item pertama dalam dimensi—ini adalah pilihan untuk keterbacaan, karena COUNT atau VALUE mengenkode informasi yang secara konseptual sedikit berbeda dari semua dimensi lainnya.
• Melacak kumpulan dimensi yang Anda gunakan dalam kunci. Sebaiknya hindari pembuatan kunci berdasarkan kumpulan dimensi yang belum pernah digunakan.
• Tabrakan hash jarang terjadi jika fungsi hash yang sesuai digunakan, tetapi memeriksa hash yang digunakan sebelumnya (yang harus disimpan untuk menafsirkan hasil dari layanan agregasi) dapat menghindari masuknya kunci baru yang bertabrakan dengan kunci yang lebih lama.

Lihat cara menggunakan kunci berbasis hash dalam satu konversi per klik atau lihat contoh.

Nilai agregat dalam praktik

Perusahaan teknologi iklan menetapkan nilai agregat saat pengguna melakukan konversi.

Untuk melindungi privasi pengguna, kontribusi dari setiap pengguna memiliki batas atas. Di semua nilai agregat yang terkait dengan satu sumber (penayangan atau klik iklan), tidak ada nilai yang dapat melebihi batas kontribusi tertentu.

Kita akan menyebut batas ini sebagai CONTRIBUTION_BUDGET. Dalam penjelasan, batas ini disebut anggaran L1, tetapi sama dengan CONTRIBUTION_BUDGET.

Untuk pembahasan mendalam tentang anggaran kontribusi, lihat Anggaran kontribusi untuk laporan ringkasan.

Contoh: satu konversi per klik atau penayangan

Untuk contoh ini, asumsikan bahwa Anda ingin menjawab pertanyaan-pertanyaan berikut:

• Kategori produk mana yang paling bernilai di setiap wilayah?
• Manakah strategi kampanye yang paling efektif di setiap wilayah?

Mari asumsikan juga bahwa untuk kasus penggunaan, Anda memerlukan insight mingguan.

Anda juga perlu melacak hal berikut:

• 16 kampanye berbeda.
• 8 wilayah geografis yang berbeda: Amerika Utara, Amerika Tengah, Amerika Selatan, Eropa, Afrika, Asia, Karibia, dan Oseania.
• 29 kategori produk yang berbeda.

Apa yang harus diukur

Meskipun banyak perusahaan teknologi iklan mendorong pengiklan untuk mengonfigurasi berbagai jenis konversi, berfokus pada konversi yang paling penting seperti pembelian adalah cara yang baik untuk memastikan bahwa hasil gabungan sudah mendetail dan akurat untuk peristiwa konversi penting ini. Bahkan, semakin banyak metrik yang Anda ukur, semakin kecil anggaran kontribusi Anda per metrik, dan oleh karena itu, kemungkinan tingkat derau setiap nilai akan semakin meningkat. Oleh karena itu, Anda perlu memilih dengan cermat apa yang akan diukur.

Dalam contoh ini, kami akan berfokus pada penyiapan kampanye yang hanya mengukur satu konversi per klik atau tampilan: pembelian.

Anda tetap dapat mengukur jumlah pembelian dan nilai pembelian, serta mengakses berbagai statistik gabungan yang penting seperti total nilai pembelian dan perincian geografis. Hal ini menjaga derau tetap masuk akal dan memastikan pendekatan penskalaan yang sederhana untuk anggaran kontribusi Anda.

Bagaimana dengan mata uang?

Menjalankan kampanye di berbagai wilayah menyiratkan bahwa mata uang harus diperhitungkan. Anda dapat:

• Jadikan mata uang sebagai dimensi khusus dalam kunci agregasi.
• Atau, tentukan mata uang dari ID kampanye, dan konversikan semua mata uang ke mata uang referensi.

Dalam contoh ini, kami akan mengasumsikan bahwa Anda dapat menyimpulkan mata uang dari ID kampanye. Dengan begitu, Anda dapat mengonversi nilai pembelian tertentu dari mata uang lokal pengguna ke mata uang referensi pilihan Anda. Anda juga dapat melakukan konversi tersebut dengan cepat, saat pengguna membeli barang.

Dengan teknik ini, semua nilai agregat menggunakan mata uang referensi yang sama, sehingga dapat dijumlahkan untuk menghasilkan total nilai pembelian gabungan, yakni nilai pembelian ringkasan.

Terjemahkan sasaran menjadi kunci

Dengan sasaran dan metrik pengukuran, Anda memiliki sejumlah opsi untuk strategi utama. Mari kita fokus pada dua strategi ini:

• Strategi A: satu struktur kunci terperinci.
• Strategi B: dua struktur utama yang bersifat umum.

Strategi A: satu pohon yang dalam (satu struktur kunci terperinci)

Dalam strategi A, Anda menggunakan satu struktur kunci terperinci, yang mencakup semua dimensi yang Anda perlukan:

Semua kunci Anda menggunakan struktur ini.

Anda membagi struktur kunci ini menjadi dua jenis kunci untuk mendukung dua pengukuran tujuan tersebut.

• Jenis kunci 0: jenis sasaran pengukuran = 0, yang Anda putuskan untuk didefinisikan sebagai jumlah pembelian.
• Jenis kunci 1: jenis sasaran pengukuran = 1, yang Anda putuskan untuk didefinisikan sebagai nilai pembelian.

Laporan ringkasan akan terlihat seperti berikut:

Anda dapat menganggap strategi A sebagai "satu pohon yang dalam" strategi:

• Setiap nilai ringkasan dalam laporan ringkasan dikaitkan dengan semua dimensi yang Anda lacak.
• Anda dapat menggabungkan nilai ringkasan ini di samping masing-masing dimensi ini, jadi penggabungan ini bisa sedalam jumlah dimensi yang Anda miliki.

Dengan strategi A, Anda akan menjawab pertanyaan sebagai berikut:

Pertanyaan	Jawaban
Kategori produk mana yang paling bernilai di setiap wilayah?	Menjumlahkan jumlah dan nilai pembelian ringkasan yang ada di ringkasan laporan, di semua kampanye. Hal ini memberi Anda jumlah dan nilai pembelian per ID Geografis × Produk kategori. Untuk setiap wilayah, bandingkan nilai pembelian dan jumlah kategori produk.
Manakah strategi kampanye yang paling efektif di setiap wilayah?	Menjumlahkan jumlah dan nilai pembelian ringkasan yang ada di ringkasan di semua kategori produk. Hal ini menunjukkan jumlah dan nilai pembelian per ID Kampanye × ID Geografis. Untuk setiap wilayah, bandingkan nilai pembelian dan jumlah untuk berbagai kampanye.

Dengan strategi A, Anda juga dapat langsung menjawab pertanyaan ketiga ini:

"Berapa banyak pendapatan untuk setiap produk yang dilakukan setiap kampanye saya di setiap lokasi geografis buat region?"

Meskipun nilai ringkasan akan berisik, Anda dapat menentukan kapan perbedaan nilai yang diukur di antara setiap kampanye bukan disebabkan oleh derau sendirian. Pelajari cara melakukannya dalam Memahami derau.

Strategi B: dua pohon dangkal (dua struktur kunci kasar)

Dalam strategi B, Anda menggunakan dua struktur kunci kasar, masing-masing mencakup dimensi yang Anda perlukan:

Anda membagi masing-masing struktur kunci ini menjadi dua jenis kunci untuk mendukung dua tujuan pengukuran.

• Jenis sasaran pengukuran = 0, yang Anda putuskan sebagai pembelian jumlah.
• Jenis sasaran pengukuran = 1, yang Anda putuskan sebagai pembelian nilai.

Anda akan memiliki empat jenis kunci:

• Jenis kunci I-0: Struktur kunci I, jumlah pembelian.
• Jenis kunci I-1: Struktur kunci I, nilai pembelian.
• Jenis kunci II-0: Struktur kunci II, jumlah pembelian.
• Jenis kunci II-1: Struktur kunci II, nilai pembelian.

Laporan ringkasan akan terlihat seperti berikut:

Anda dapat menganggap strategi B sebagai "dua pohon dangkal" strategi:

• Nilai ringkasan dalam laporan ringkasan dipetakan ke salah satu dari dua kumpulan kecil dimensi kustom.
• Anda dapat menggabungkan nilai ringkasan ini di samping masing-masing dimensi di kumpulan ini—ini berarti penggabungan ini tidak sedalam opsi A, karena ada lebih sedikit dimensi untuk digabungkan.

Dengan strategi B, Anda akan menjawab pertanyaan Anda sebagai berikut:

Pertanyaan	Jawaban
Kategori produk mana yang paling bernilai di setiap wilayah?	Mengakses langsung jumlah dan nilai pembelian ringkasan yang ada di laporan ringkasan.
Manakah strategi kampanye yang paling efektif di setiap wilayah?	Mengakses langsung jumlah dan nilai pembelian ringkasan yang ada di laporan ringkasan.

Keputusan: Strategi A

Strategi A lebih sederhana; semua data mengikuti struktur kunci yang sama, yang juga berarti Anda hanya memiliki satu struktur kunci untuk dipelihara.

Namun, dengan strategi A, Anda perlu menjumlahkan nilai ringkasan yang diterima dalam laporan ringkasan untuk menjawab beberapa pertanyaan Anda. Setiap nilai ringkasan ini bersifat berisik. Dengan meringkas data itu, Anda juga menjumlahkan derau.

Hal ini tidak terjadi dengan strategi B, dengan nilai ringkasan ditampilkan dalam ringkasan laporan telah memberikan informasi yang Anda butuhkan. Ini berarti strategi B akan menghasilkan dampak yang lebih kecil dari derau dibandingkan strategi A.

Bagaimana sebaiknya Anda menentukan strategi yang akan digunakan? Untuk pengiklan yang sudah ada atau kampanye, Anda dapat mengandalkan data historis untuk menentukan apakah volume konversi yang lebih sesuai untuk strategi A atau strategi B. Namun, untuk pengiklan atau kampanye, Anda dapat memutuskan untuk:

• Mengumpulkan data selama sebulan dengan kunci terperinci (Strategi A). Karena Anda memperpanjang durasi pengumpulan data, nilai ringkasan akan lebih tinggi dan noise akan relatif lebih rendah.
• Menilai dengan cukup akurat jumlah konversi mingguan dan nilai pembelian.

Catatan: Jangan mengandalkan jumlah laporan atau data yang hanya tersedia melalui laporan debug sebagai sumber kebenaran dalam desain Anda. Di masa depan, data yang tersedia dalam laporan debug akan berubah dan laporan berisik akan dihasilkan bersama dengan laporan nyata, jadi sinyal ini harus digunakan hanya untuk memvalidasi strategi penerapan dan pengujian.

Dalam contoh ini, anggaplah bahwa jumlah pembelian dan nilai pembelian mingguan cukup tinggi sehingga strategi A akan menghasilkan persentase derau yang Anda anggap dapat diterima untuk kasus penggunaan Anda.

Karena strategi A lebih sederhana dan menyebabkan dampak gangguan yang tidak mempengaruhi kemampuan Anda untuk mengambil keputusan, Anda memutuskan untuk menggunakan strategi A.

Memilih algoritma hashing

Anda memutuskan untuk menggunakan pendekatan berbasis hash untuk membuat kunci Anda. Untuk melakukannya, Anda perlu memilih algoritma {i>hashing <i}untuk mendukung pendekatan itu.

Anggaplah Anda telah memilih SHA-256. Anda juga bisa menggunakan metode lain yang aman, seperti MD5.

Di browser: setel kunci dan nilai

Sekarang setelah Anda memutuskan struktur kunci dan algoritma {i>hashing<i}, Anda menyiapkan kunci dan nilai saat pengguna mengklik atau melihat iklan, lalu mengonversi.

Berikutnya adalah ringkasan tentang {i>header<i} yang akan Anda tetapkan untuk mendaftarkan kunci dan nilai di browser:

Menetapkan bagian kunci sisi sumber

Peringatan: Format header di bagian ini sudah tidak digunakan lagi. Lihat Penjelasan Laporan Gabungan untuk panduan saat ini hingga bagian ini diperbarui.

Saat pengguna mengklik atau melihat iklan, tetapkan kunci agregasi di Header Attribution-Reporting-Register-Aggregatable-Source. Pada tahap ini, untuk setiap kunci, Anda hanya dapat menetapkan bagian kunci, atau bagian kunci, yang dikenal pada waktu penayangan iklan.

Mari kita buat bagian utama:

Bagian kunci sisi sumber untuk ID kunci...	String yang berisi nilai dimensi yang ingin Anda tetapkan	Hash {i>string<i} ini sebagai {i>hex<i}, dipangkas ke 64 bit pertama (64/4 = 16 karakter^1)	Hash heksadesimal dengan tambahan angka nol untuk menyederhanakan XOR-ing. Ini adalah bagian kunci sisi sumber.
key_purchaseCount	COUNT, CampaignID=12, GeoID=7	0x3cf867903fbb73ec	0x3cf867903fbb73ec0000000000000000
key_purchaseValue	VALUE, CampaignID=12, GeoID=7	0x245265f432f16e73	0x245265f432f16e730000000000000000

¹Setiap digit heksadesimal mewakili empat bit (digit biner).

Sekarang mari kita tetapkan bagian penting:

// Upon receiving the request from the publisher site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Source",
  JSON.stringify([
    {
      "id": "key_purchaseCount",
      "key_piece": "0x3cf867903fbb73ec0000000000000000"
    },
    {
      "id": "key_purchaseValue",
      "key_piece": "0x245265f432f16e730000000000000000"
    }
  ])
);

Perhatikan bahwa ID kunci tidak akan muncul dalam laporan akhir. Hanya digunakan saat menyetel kunci di browser, sehingga kunci sisi sumber dan sisi pemicu satu sama lain dapat dipetakan dan digabungkan menjadi kunci penuh.

Opsional: laporan tingkat peristiwa

Jika Anda perlu menggunakan laporan tingkat peristiwa bersama laporan agregat, pastikan bahwa untuk sumber tertentu, data tingkat peristiwa (ID peristiwa sumber dan data pemicu) dan dan kunci agregasi dapat dicocokkan.

Anda dapat menggunakan kedua laporan tersebut jika, misalnya, Anda berencana menggunakan laporan tingkat peristiwa untuk menjalankan model mengenai jenis iklan yang cenderung menghasilkan jumlah pembelian terbesar.

Pengguna melakukan konversi

Saat pengguna melakukan konversi, permintaan piksel biasanya dikirim ke server teknologi iklan. Setelah menerima permintaan ini:

• Tetapkan bagian kunci sisi konversi (sisi pemicu) untuk menyelesaikan kunci. Anda akan menetapkan bagian kunci ini melalui {i>header<i} Attribution-Reporting-Register-Aggregatable-Trigger-Data.
• Menetapkan nilai agregat untuk konversi tersebut, melalui header Attribution-Reporting-Register-Aggregatable-Values.

Tetapkan bagian kunci sisi pemicu untuk menyelesaikan kunci

Peringatan: Format header di bagian ini sudah tidak digunakan lagi. Lihat Penjelasan Laporan Gabungan untuk panduan saat ini hingga bagian ini diperbarui.

Mari kita buat bagian utama:

Bagian kunci sisi pemicu untuk ID kunci...	String yang berisi nilai dimensi yang ingin Anda tetapkan	Hash {i>string<i} ini sebagai {i>hex<i}, dipangkas ke 64 bit pertama (64/4 = 16 karakter^1)	Hash heksadesimal dengan tambahan angka nol untuk menyederhanakan XOR-ing. Ini adalah bagian kunci sisi sumber.
key_purchaseCount	ProductCategory=25	0x1c7ce88c4904bbe2	0x0000000000000000f9e491fe37e55a0c
key_purchaseValue	(sama)	(sama)	(sama)

¹Setiap digit heksadesimal mewakili empat bit (digit biner).

Sekarang mari kita tetapkan bagian penting:

// Upon receiving the pixel request from the advertiser site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Trigger-Data",
  JSON.stringify([
    // Each dictionary independently adds pieces to multiple source keys
    {
      "key_piece": "0x0000000000000000f9e491fe37e55a0c",
      "source_keys": ["key_purchaseCount", "key_purchaseValue"]
    },
  ])
);

Perhatikan bagaimana Anda menambahkan bagian kunci yang sama ke beberapa kunci, dengan mencantumkan beberapa ID tombol di source_keys—bagian kunci akan ditambahkan ke kedua kunci.

Menetapkan nilai agregat

Sebelum menetapkan nilai agregat, Anda perlu meningkatkan skalanya untuk mengurangi noise.

Anggaplah satu pembelian dilakukan untuk tipe produk 25 seharga $52.

Anda tidak akan menetapkannya secara langsung sebagai nilai agregat:

• key_purchaseCount: 1 konversi
• key_purchaseValue: $52

Sebelum mendaftarkan nilai agregat ini, Anda harus skala mereka untuk meminimalkan derau.

Anda memiliki dua sasaran untuk membelanjakan anggaran kontribusi, jadi Anda mungkin memutuskan untuk membagi anggaran kontribusi menjadi dua.

Dalam hal ini, setiap sasaran diberi alokasi maksimum CONTRIBUTION_BUDGET/2 (=65.536/2=32.768).

Anggaplah nilai pembelian maksimum untuk satu pengguna, berdasarkan pembelian historis di semua pengguna situs, adalah $1.500. Mungkin ada {i>outlier<i}, karena misalnya sangat sedikit pengguna yang berbelanja di atas jumlah itu, tetapi Anda dapat memutuskan untuk mengabaikan {i>outlier <i}ini.

Faktor penskalaan Anda untuk nilai pembelian adalah:

((CONTRIBUTION_BUDGET/2) / 1.500) = 32.768/1.500 = 21,8 ≈ 22

Faktor penskalaan Anda untuk jumlah pembelian adalah 32.768/1 = 32.768, karena Anda memutuskan untuk melacak maksimal satu pembelian per klik iklan atau penayangan (peristiwa sumber).

Sekarang Anda dapat menetapkan nilai berikut:

• key_purchaseCount: 1 × 32.768 = 32.768
• key_purchaseValue: 52 × 22 = 1.144

Dalam praktiknya, Anda akan mengaturnya sebagai berikut, menggunakan {i>header <i}khusus Attribution-Reporting-Register-Aggregatable-Values:

// Instruct the browser to schedule-send a report
res.set(
  "Attribution-Reporting-Register-Aggregatable-Values",
  JSON.stringify({
    "key_purchaseCount": 32768,
    "key_purchaseValue": 1144,
  })
);

Laporan agregat dibuat

Browser mencocokkan konversi dengan tampilan atau klik sebelumnya, lalu menghasilkan laporan agregat, yang mencakup payload terenkripsi di samping laporan {i>metadata<i}.

Berikut ini contoh data yang dapat ditemukan dalam payload laporan gabungan jika dapat dibaca dalam cleartext:

[
  {
    key: 0x3cf867903fbb73ecf9e491fe37e55a0c, // = source-side key piece XOR conversion-side key piece for the key key_purchaseCount
    value: 32768 // the scaled value for 1 conversion, in the context of [CONTRIBUTION_BUDGET/2]
  },
  {
    key: 0x245265f432f16e73f9e491fe37e55a0c, // source-side key piece XOR conversion-side key piece for the key key_purchaseValue
    value: 1144 // the scaled value for $52, in the context of [CONTRIBUTION_BUDGET/2]
  },
]

Di sini, Anda dapat melihat dua kontribusi terpisah dalam satu laporan.

Meminta laporan ringkasan

• Batch laporan agregat. Ikuti saran yang ditawarkan di Pengelompokan.
• Buat kunci yang datanya ingin Anda lihat. Misalnya, untuk melihat ringkasan data untuk COUNT (jumlah total pembelian) dan VALUE (total nilai pembelian) untuk ID Kampanye 12 × ID Geografi 7 × Kategori produk 25:
  • Buat bagian kunci sisi sumber, seperti yang Anda lakukan saat menyetelnya di browser.
  • Buat bagian kunci sisi pemicu, seperti yang Anda lakukan saat menyetelnya di browser.

Metrik yang ingin Anda minta^1	Bagian kunci sisi sumber	Bagian kunci sisi pemicu	Kunci untuk meminta ke layanan agregasi^2
Jumlah total pembelian (COUNT)	0x3cf867903fbb73ec 0000000000000000	0x00000000000000 00f9e491fe37e55a0c	0x3cf867903fbb73 ecf9e491fe37e55a0c
Total nilai pembelian (VALUE)	0x245265f432f16e73 0000000000000000	0x0000000000000000 f9e491fe37e55a0c	0x245265f432f16e73 f9e491fe37e55a0c

¹Metrik yang ingin Anda minta (untuk ID Kampanye 12 × ID Geografi 7 × Kategori produk 25). ²Kunci untuk meminta ke layanan agregasi = Bagian kunci sisi sumber XOR Bagian kunci pemicu.

• Minta data ringkasan ke layanan agregasi untuk kunci ini.

Menangani laporan ringkasan

Pada akhirnya, Anda akan menerima laporan ringkasan yang mungkin terlihat seperti ini:

[
  {"bucket": "00111100111110000110011110010000001111111011101101110011111011001111100111100100100100011111111000110111111001010101101000001100",
    "value": "2558500"},
  {"bucket": "00100100010100100110010111110100001100101111000101101110011100111111100111100100100100011111111000110111111001010101101000001100",
    "value": "687060"},
  …
]

Bucket pertama adalah kunci COUNT dalam biner. Bucket kedua adalah kunci VALUE dalam biner. Perlu diketahui bahwa meskipun kunci bersifat heterogen (COUNT versus VALUE), kunci tersebut akan terdapat dalam laporan yang sama.

Catatan: Pada praktiknya, laporan ringkasan dienkode dengan cara yang akan bucket dan nilai terlihat berbeda dari yang baru saja Anda lihat (yaitu, mungkin terlihat seperti \u0000\u0000\x80\u0000). Bucket dan value adalah bytestring. Contohnya dapat ditemukan di sini.

Menurunkan skala nilai

• 2.558.500 mengacu pada jumlah pembelian untuk kunci ini, ditingkatkan oleh faktor penskalaan yang telah dihitung sebelumnya. Faktor penskalaan untuk jumlah pembelian sebesar 32.768. Bagi 2.558.500 dengan kontribusi sasaran anggaran: 2.558.500/32.768 = 156,15 pembelian.
• 687.060 → 687.060/22 = $31.230 total nilai pembelian.

Hasilnya, laporan ringkasan memberi Anda insight berikut:

• Dalam jangka waktu pelaporan, kampanye #12 berjalan di Eropa mendorong sekitar 156 pembelian (± noise) untuk kategori produk #25.
• Dalam jangka waktu pelaporan, kampanye #12 yang berjalan di Eropa mendorong pembelian sebesar $31.230 (± noise) untuk kategori produk #25.