Mulai menggunakan pelaporan atribusi

Panduan ini memberikan ringkasan dan petunjuk penyiapan untuk laporan atribusi tingkat peristiwa dan ringkasan menggunakan Attribution Reporting API.

Untuk memulai, Anda akan mempelajari cara:

  • Membedakan antara jenis laporan Attribution Reporting API

  • Menyelesaikan langkah-langkah penerapan API dan pembuatan laporan

  • Menemukan informasi referensi dan pemecahan masalah

Memilih jenis laporan

Untuk mengukur performa kampanye iklan secara efektif dengan berbagai tingkat detail dan privasi, Attribution Reporting API menyediakan dua jenis laporan yang berbeda:

  • Laporan tingkat peristiwa: Memberikan data terperinci yang menautkan klik atau penayangan iklan tertentu (sumber) dengan data konversi yang sesuai (pemicu). Laporan tingkat peristiwa membatasi jumlah data konversi dan menambahkan derau ke laporan. Peristiwa ini ideal untuk kasus penggunaan yang memerlukan atribusi peristiwa individual, seperti mengukur jangkauan kampanye.

  • Laporan ringkasan: Menawarkan data pengguna gabungan dan dapat menyertakan informasi konversi yang lebih mendetail dengan derau tambahan. Dengan menggunakan Attribution Reporting API dan Private Aggregation API, laporan ini dibuat dari laporan gabungan dan menawarkan model data yang lebih lengkap daripada laporan tingkat peristiwa. Laporan ringkasan sangat berguna untuk skenario yang memerlukan insight gabungan, seperti menghitung nilai konversi atau menganalisis performa kampanye di seluruh segmen pengguna.

Ringkasan penerapan

Bagian berikut menguraikan langkah-langkah tingkat tinggi untuk membuat setiap jenis laporan. Anda juga dapat mengikuti Demo Attribution Reporting API untuk panduan langkah demi langkah tentang seluruh prosesnya.

Prasyarat: Situs Anda harus memiliki sertifikat SSL/TLS (HTTPS) sebelum Anda dapat mendaftarkan sumber, pemicu, dan menerima laporan.

Pembuatan laporan tingkat peristiwa

Langkah-langkah berikut menjelaskan cara membuat laporan tingkat peristiwa:

  1. Mendaftarkan sumber: Mengaitkan klik atau penayangan iklan dengan informasi atribusi. Lihat Mendaftarkan sumber atribusi dan Pendaftaran sumber atribusi untuk mengetahui petunjuk mendetail. Perhatikan bahwa proses pendaftaran sedikit berbeda untuk klik dan penayangan.

  2. Mendaftarkan pemicu: Mencatat peristiwa konversi dan menautkannya ke sumber yang terdaftar sebelumnya. Lihat Mendaftarkan pemicu atribusi untuk mengetahui petunjuknya.

  3. Siapkan endpoint pelaporan: Buat endpoint di server Anda untuk menerima laporan tingkat peristiwa. URL endpoint harus mengikuti format ini: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Lihat kode contoh di adtech.js untuk mengetahui contoh metode POST. Untuk mengetahui informasi selengkapnya tentang .well-known, lihat Wikipedia.

Untuk mengetahui laporan tingkat peristiwa lebih lanjut, lihat Penjelasan laporan tingkat peristiwa.

Pembuatan laporan ringkasan

  1. Mendaftarkan sumber: Sama seperti untuk laporan tingkat peristiwa. Lihat Mendaftarkan sumber atribusi dan Pendaftaran sumber atribusi untuk mengetahui detailnya.

  2. Mendaftarkan pemicu: Sama seperti untuk laporan tingkat peristiwa. Lihat Mendaftarkan pemicu atribusi.

  3. Menyiapkan endpoint pelaporan: Buat endpoint untuk menerima laporan gabungan. URL-nya harus: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Lihat adtech.js untuk contoh metode POST dan Wikipedia untuk informasi .well-known.

  4. Mengirim dan mengelompokkan laporan: Mengelompokkan laporan gabungan dan mengirimkannya ke Layanan Agregasi untuk diproses. Layanan Agregasi kemudian akan membuat laporan ringkasan. Lihat Strategi untuk pengelompokan untuk mengetahui informasi selengkapnya.

Untuk mengetahui laporan ringkasan lebih lanjut, lihat Penjelasan laporan agregat.

Selain langkah-langkah penerapan, topik berikut akan membantu Anda merencanakan strategi pelaporan ringkasan:

Menyiapkan filter (opsional)

Untuk mendapatkan kontrol yang lebih terperinci atas data atribusi yang Anda terima, Anda dapat menyiapkan filter.

Pemfilteran memberikan analisis data yang lebih baik yang mengisolasi subkumpulan data tertentu untuk analisis Anda, sehingga mengurangi derau. Hal ini juga membantu melacak performa kampanye iklan dan peristiwa konversi tertentu untuk pengukuran yang lebih akurat.

Untuk menyiapkan pemfilteran, lihat Menentukan aturan kustom menggunakan filter dan bagian pemicu di Pendaftaran pemicu atribusi untuk mengetahui detail khusus laporan gabungan.

Mengonfirmasi bahwa API sudah diaktifkan

Sebelum menggunakan API, periksa apakah API diaktifkan menggunakan kode berikut:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Pemeriksaan ini menunjukkan apakah API diizinkan dalam konteks saat ini. Namun, setelan browser pengguna atau faktor lainnya mungkin masih mencegah API digunakan. Karena pertimbangan privasi, tidak ada cara terprogram untuk mengonfirmasi kegunaan API secara pasti.

Langkah berikutnya

Bagian berikut memberikan informasi lebih lanjut tentang cara memulai pelaporan atribusi.

Penerapan

Latar belakang dan konsep

Demo dan alat

Perencanaan