Memeriksa audiens kustom pada command line

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 tempat CustomAudience digabungkan (menggunakan joinCustomAudience atau fetchAndJoinCustomAudience)
  • Izin untuk iklan yang disarankan aplikasi diaktifkan

Mengaktifkan perintah shell adservices

  1. Mulai ulang perangkat untuk menghentikan proses adservices.
  2. 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.