Attribution Reporting API: panduan integrasi

Attribution Reporting API dirancang untuk memberikan privasi pengguna yang lebih baik dengan menghapus ketergantungan pada ID pengguna lintas pihak, dan untuk mendukung kasus penggunaan utama untuk atribusi dan pengukuran konversi di berbagai aplikasi. Dokumen ini berisi panduan untuk membantu Anda menyiapkan integrasi Attribution Reporting API.

Panduan ini berupaya memberikan tampilan yang komprehensif, yang dapat mencakup fitur yang belum diimplementasikan pada tahap Privacy Sandbox saat ini di Pratinjau Developer Android. Dalam kasus ini, detail yang terkait akan ditandai sebagai belum diimplementasikan.

Sasaran integrasi

Pada tahap Pratinjau Developer Sandbox Privasi ini, sasaran perencanaan integrasi meliputi:

Dukungan saat ini dan yang akan datang

Kasus penggunaan dan fitur yang saat ini didukung dalam rilis Pratinjau Developer terbaru mencakup:

  • Atribusi yang terakhir diprioritaskan dan atribusi pasca-penginstalan yang diprioritaskan dari sumber.
  • Mendaftarkan sumber atribusi aplikasi dan pemicu aplikasi.
  • Menerima laporan tingkat peristiwa.
  • Menerima laporan agregasi yang tidak dienkripsi.

Rilis Pratinjau Developer mendatang berencana menambahkan dukungan untuk kasus penggunaan tambahan dan fitur teknis berikut. Dengan tersedianya fitur-fitur tersebut, panduan ini akan diperbarui untuk mencerminkan detail yang relevan.

  • Pendaftaran platform teknologi iklan.
  • Dukungan proses debug, untuk membantu developer membandingkan laporan gabungan dengan laporan dari mekanisme yang ada.
  • Daftarkan sumber atribusi web dan pemicu web, untuk mendukung atribusi aplikasi ke web.
  • Menerima laporan agregasi terenkripsi dari API dan mengirim batch ke layanan agregasi.
  • Menerima laporan ringkasan dari layanan agregasi.
  • Penggunaan API akan memerlukan izin normal baru.

Audiens sasaran teknologi iklan

Untuk menerima laporan dari Attribution Reporting API, platform teknologi iklan harus mendaftarkan sumber atribusi dan pemicu. Setidaknya, untuk mengaktifkan pengujian menyeluruh, baik partner teknologi iklan dan pengukuran seluler penayangan harus bekerja sama untuk memanggil API untuk pengiklan yang sama, dan mungkin perlu menggunakan pengalihan dalam panggilan pendaftaran. Anda mungkin juga harus bekerja sama dengan aplikasi penayang atau pengiklan.

Untuk pendaftaran sumber atribusi, panggilan API biasanya akan dimulai oleh SDK teknologi iklan yang digunakan untuk menayangkan iklan dalam aplikasi penayang, meskipun API tersebut juga dapat dipanggil langsung oleh aplikasi.

Untuk pendaftaran pemicu, panggilan API biasanya akan dimulai oleh SDK partner pengukuran seluler di aplikasi pengiklan, atau dari aplikasi pengiklan itu sendiri.

Prasyarat

Langkah-langkah integrasi

Untuk bersiap mengintegrasikan Attribution Reporting API ke dalam solusi Anda, selesaikan langkah-langkah yang dijelaskan di bagian berikut.

Memverifikasi kebenaran teknis di lingkungan pengujian

  • Buat aplikasi pengujian untuk membiasakan diri Anda dengan Privacy Sandbox di Android Attribution Reporting API. Pada tahap ini, Anda juga dapat memulai dengan aplikasi contoh di GitHub.
  • Siapkan endpoint server tiruan, atau gunakan server contoh kami, untuk memahami tanda tangan REST API yang digunakan oleh API klien Pelaporan Atribusi.
  • Daftarkan peristiwa, termasuk peristiwa penayangan, klik, dan konversi (pemicu).
  • Untuk tujuan pengujian, tugas pelaporan yang dijalankan otomatis, menggunakan perintah ADB yang sesuai, untuk mengurangi jangka waktu penerimaan data laporan untuk laporan tingkat peristiwa dan gabungan.
  • Evaluasi penerapan tanda tangan API untuk technology stack Anda saat ini. Ini mencakup parameter input dan nilai return. Identifikasi celah dalam aliran data dan mitigasi.

Memverifikasi kompatibilitas dengan infrastruktur teknis yang ada

  • Lingkungan dan codebase pengembangan sisi klien:
    • Setelah Pratinjau Developer, Privacy Sandbox di Android akan memerlukan API level target minimum 33. Identifikasi jalur migrasi untuk codebase yang ada. Evaluasi kompatibilitas aplikasi atau SDK Anda dengan perubahan lain yang diperkenalkan di Android 13.
  • Sisi server:
    • Tambahkan endpoint stub API ke infrastruktur teknis yang ada untuk menemukan dan memverifikasi batasan teknis.
    • Tambahkan callback untuk menerima laporan ke infrastruktur teknis yang ada.

Menentukan dan memverifikasi persyaratan integrasi

  • Verifikasi—baik log maupun data server—bahwa laporan berisi data dari tampilan, klik, dan konversi.
  • Verifikasi laporan tingkat peristiwa dan tingkat gabungan.