Halaman ini diterjemahkan oleh Cloud Translation API.

Memulai Attribution Reporting

Di sinilah cara memulainya, termasuk penyiapan dan ringkasan singkat.

Pilih jenis laporan

Dengan Attribution Reporting API, Anda dapat membuat dua jenis laporan: laporan tingkat peristiwa dan ringkasan. Laporan tingkat peristiwa memerlukan lebih sedikit penyiapan dibandingkan laporan gabungan atau ringkasan, sehingga bisa menjadi titik awal yang bagus. Laporan ringkasan memerlukan integrasi dengan Layanan Agregasi; laporan tingkat peristiwa tidak.

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 bahwa untuk sumber peristiwa tertentu, Anda dapat membuat laporan tingkat peristiwa dan laporan gabungan. Demo akan memandu Anda melalui prosesnya.

Pembuatan laporan tingkat peristiwa

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

Daftarkan sumber. Lihat Mendaftarkan sumber atribusi untuk mengetahui petunjuknya. Perhatikan bahwa langkah-langkah untuk klik dan tampilan berbeda.
Daftarkan pemicu. Lihat Mendaftarkan pemicu atribusi untuk mengetahui petunjuknya.
Siapkan endpoint dengan URL berikut:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
Lihat kode contoh di adtech.js untuk melihat metode post. Informasi selengkapnya tentang .well-known ada di sini.

Lihat detail selengkapnya tentang laporan tingkat peristiwa di sini.

Pembuatan laporan ringkasan

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

Daftarkan sumber. Lihat Mendaftarkan sumber atribusi untuk mengetahui petunjuknya. Perhatikan bahwa langkah-langkah untuk klik dan tampilan berbeda. Detail tambahan dapat ditemukan di Pendaftaran sumber atribusi.
Daftarkan pemicu. Lihat Mendaftarkan pemicu atribusi untuk mengetahui petunjuknya.
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. Informasi selengkapnya tentang .well-known ada di sini.
Mengelompokkan dan mengirim laporan untuk diproses lebih lanjut oleh Layanan Agregasi yang akan menghasilkan laporan ringkasan. Lihat laporan agregat dalam batch.

Lihat detail selengkapnya tentang laporan ringkasan di sini.

Pelajari cara menyiapkan laporan debug dalam Seri 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-langkah opsional

Menyiapkan filter (opsional):
1. Ikuti petunjuk dalam artikel Menentukan aturan kustom menggunakan filter.
2. Tinjau detail khusus filter untuk laporan agregat di bagian pemicu pada penjelasan.

Jangan lupakan deteksi fitur

Sebelum Anda menggunakan API, deteksi apakah API belum diblokir di halaman menggunakan Kebijakan Izin. Caranya, 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 tidak menjamin 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.