Memulai Attribution Reporting

Berikut langkah untuk memulai, termasuk penyiapan dan ringkasan singkat.

Pilih jenis laporan

Dengan menggunakan Attribution Reporting API, Anda dapat membuat dua jenis laporan: laporan tingkat peristiwa dan ringkasan. Laporan tingkat peristiwa memerlukan lebih sedikit penyiapan daripada laporan agregat atau ringkasan, sehingga laporan ini bisa menjadi titik awal yang baik. Laporan ringkasan memerlukan integrasi dengan Layanan Agregasi; tidak dapat dilakukan di laporan tingkat peristiwa.

Anda dapat menyiapkan pelaporan untuk laporan tingkat peristiwa dan ringkasan. Keduanya saling melengkapi.

Laporan tingkat peristiwa

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 datanya berisik.

Laporan ringkasan

Laporan ringkasan adalah jenis laporan Attribution Reporting API dan Private Agregasi API. Laporan ringkasan mencakup data pengguna gabungan dan dapat berisi data konversi mendetail, dengan derau yang ditambahkan. Laporan ringkasan terdiri dari laporan gabungan.

Penerapan

Anda dapat memulai dengan mencoba langkah-langkah berikut.

Perhatikan, untuk sumber peristiwa tertentu, Anda bisa menghasilkan tingkat peristiwa dan laporan agregat. Tujuan demo akan memandu Anda melalui prosesnya.

Pembuatan laporan tingkat peristiwa

Berikut adalah langkah-langkah minimum yang harus diikuti untuk membuat laporan tingkat peristiwa:

  1. Daftarkan sumber. Lihat Mendaftarkan sumber atribusi untuk mengetahui petunjuknya. Perhatikan bahwa langkah-langkah ini berbeda untuk klik dan tampilan.

  2. Daftarkan pemicu. Lihat Mendaftarkan pemicu atribusi untuk mengetahui petunjuknya.

  3. Siapkan endpoint dengan URL berikut:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution.
    Lihat kode contoh di adtech.js untuk melihat metode POST dan Wikipedia untuk mengetahui informasi selengkapnya tentang .well-known.

Detail selengkapnya tersedia di penjelasan laporan tingkat peristiwa.

Pembuatan laporan ringkasan

Untuk membuat laporan ringkasan, ikuti langkah-langkah tingkat tinggi berikut:

  1. Daftarkan sumber. Lihat Mendaftarkan sumber atribusi untuk mengetahui petunjuknya. Perhatikan bahwa langkah-langkah ini berbeda untuk klik dan tampilan. Detail tambahan dapat ditemukan di Pendaftaran sumber atribusi.

  2. Daftarkan pemicu. Lihat Mendaftarkan pemicu atribusi untuk mengetahui petunjuknya.

  3. Siapkan endpoint untuk laporan agregat dengan URL berikut:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution.
    Lihat kode contoh di adtech.js untuk melihat metode POST dan Wikipedia untuk mengetahui informasi selengkapnya tentang .well-known.

  4. Buat batch dan kirim laporan untuk diproses lebih lanjut oleh Layanan Agregasi yang akan menghasilkan laporan ringkasan. Lihat laporan agregat batch.

Detail selengkapnya tersedia di penjelasan laporan agregat.

Pelajari cara menyiapkan laporan debug dalam Rangkaian proses debug pelaporan atribusi.

Ringkasan melaporkan konsep tambahan

Selain memahami langkah-langkah penerapan di sini, konsep berikut akan membantu Anda merencanakan strategi pelaporan ringkasan:

Langkah opsional

  1. Menyiapkan filter (opsional):
    1. Ikuti petunjuk di Tentukan aturan kustom menggunakan filter.
    2. Tinjau detail khusus filter untuk laporan agregat di bagian {i>trigger<i} pada penjelasan kami.

Jangan lupa deteksi fitur

Sebelum menggunakan API, deteksi apakah API belum diblokir di halaman menggunakan kebijakan izin. Untuk melakukannya, jalankan kode berikut:

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

Jika pemeriksaan deteksi fitur ini menampilkan nilai benar, API akan diizinkan dalam konteks (halaman) tempat pemeriksaan dijalankan.

Perhatikan bahwa pemeriksaan ini saja bukan jaminan bahwa API dapat digunakan di halaman tersebut; pengguna mungkin telah menonaktifkan API menggunakan setelan browser mereka, atau mereka mungkin memiliki setelan lain yang mencegah API digunakan. Untuk melindungi privasi pengguna, tidak ada cara untuk memeriksa hal ini secara terprogram.

Langkah berikutnya

Jika Anda sudah siap memulai penerapan, lihat dokumen berikut:

Penyiapan

Latar belakang

Demo dan alat

Perencanaan

Jika Anda masih dalam tahap perencanaan, lihat dokumen-dokumen berikut: