Protected Audience menyediakan serangkaian API untuk bergabung dan keluar dari project kustom audiens sebagai bagian dari paket android.adservices.customaudience. Sebagai Untuk tujuan {i>debugging<i}, ada perintah CLI yang tersedia untuk dicantumkan dan ditampilkan audiens kustom. Panduan ini menjelaskan langkah-langkah yang perlu dilakukan developer teknologi iklan ikuti untuk memeriksa status gabungan audiens kustom mereka.
Penyiapan
Untuk alasan keamanan dan privasi, audiens kustom tidak terlihat secara default dan hanya dapat diperiksa secara langsung untuk keperluan proses debug. Pesan hanya dapat dilihat menggunakan perintah ini jika persyaratan berikut terpenuhi:
- Opsi developer seluruh sistem diaktifkan
android:debuggable="true"
dideklarasikan di file AndroidManifest.xml dalam file aplikasi tempatCustomAudience
bergabung (menggunakanjoinCustomAudience
ataufetchAndJoinCustomAudience
)- Izin untuk iklan yang disarankan aplikasi diaktifkan
Mengaktifkan perintah shell adservices
- Mulai ulang perangkat untuk menghentikan proses
adservices
. - Pastikan
adservices
tidak berjalan. Output yang kosong diharapkan untuk perintah berikut.
adb shell ps -A | grep adservices
Kemudian, untuk mengaktifkan perintah shell adservices
, jalankan perintah berikut:
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
Membuat daftar audiens kustom
Untuk melihat audiens kustom tertentu, jalankan perintah berikut yang menentukan
owner
sebagai paket yang membuat audiens dan buyer
sebagai
ID untuk jaringan iklan yang mengelola audiens:
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
Outputnya akan berupa objek JSON yang berisi array custom_audiences
.
Struktur elemen dalam array ini cocok dengan output tampilan
perintah audiens kustom yang akan dijelaskan berikutnya.
Melihat audiens kustom tertentu
Untuk melihat audiens kustom tertentu, jalankan perintah berikut yang menentukan
owner
sebagai paket yang membuat audiens, buyer
sebagai
untuk jaringan iklan yang mengelola audiens, dan name
sebagai
nama audiens:
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
Memuat ulang audiens kustom tertentu
Untuk melihat pemicu pembaruan harian secara manual untuk audiens kustom tertentu, jalankan
perintah berikut yang menentukan owner
sebagai paket yang membuat
audiens, buyer
sebagai ID untuk jaringan iklan yang mengelola
audiens, dan name
sebagai nama audiens:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.