Protected Audience menyediakan serangkaian API untuk bergabung dan membiarkan audiens kustom sebagai bagian dari paket android.adservices.customaudience. Untuk tujuan proses debug, terdapat perintah CLI yang tersedia untuk membuat listingan dan melihat audiens kustom. Panduan ini menguraikan langkah-langkah yang harus diikuti developer teknologi iklan untuk memeriksa status audiens kustom yang bergabung.
Penyiapan
Untuk alasan keamanan dan privasi, audiens kustom tidak terlihat secara default dan hanya dapat diperiksa langsung untuk tujuan proses debug. Pengujian tersebut hanya terlihat menggunakan perintah ini jika persyaratan berikut terpenuhi:
- Opsi developer seluruh sistem diaktifkan
android:debuggable="true"
dideklarasikan di file AndroidManifest.xml aplikasi tempatCustomAudience
digabungkan (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 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 sesuai dengan output perintah
audiens kustom tampilan yang dijelaskan berikutnya.
Melihat audiens kustom tertentu
Untuk melihat 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 view --owner <owner> --buyer <buyer> --name <name>
Memuat ulang audiens kustom tertentu
Untuk melihat pembaruan harian pemicu secara manual bagi 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.