Halaman ini diterjemahkan oleh Cloud Translation API.

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; 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 agregat. 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 ini berbeda untuk klik dan tampilan.
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 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:

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.
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 dan Wikipedia untuk mengetahui informasi selengkapnya tentang .well-known.
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

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

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 tidak menjamin API dapat digunakan pada halaman tersebut; pengguna mungkin telah menonaktifkan API menggunakan setelan browser, atau pengguna mungkin memiliki setelan lain yang mencegah API digunakan. Untuk melindungi privasi pengguna, tidak ada cara untuk memeriksa hal ini secara terprogram.