Memeriksa audiens kustom di command line

Protected Audience menyediakan serangkaian API untuk bergabung dan keluar dari audiens kustom sebagai bagian dari paket android.adservices.customaudience. Untuk tujuan proses debug, tersedia perintah CLI untuk mencantumkan dan melihat audiens kustom. Panduan ini menguraikan langkah-langkah yang perlu diikuti developer teknologi iklan untuk memeriksa status audiens kustom gabungan mereka.

Penyiapan

Untuk alasan keamanan dan privasi, audiens kustom tidak terlihat secara default dan hanya dapat diperiksa secara langsung untuk tujuan proses debug. Perubahan ini hanya terlihat menggunakan perintah ini jika persyaratan berikut terpenuhi:

  • Opsi developer di seluruh sistem diaktifkan
  • android:debuggable="true" dideklarasikan dalam file AndroidManifest.xml aplikasi tempat CustomAudience bergabung (menggunakan joinCustomAudience atau fetchAndJoinCustomAudience)
  • Izin untuk iklan yang disarankan aplikasi diaktifkan

Mengaktifkan perintah shell adservices

  1. Mulai ulang perangkat Anda 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

Mencantumkan audiens kustom

Untuk melihat audiens kustom tertentu, jalankan perintah berikut dengan 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 perintah audiens kustom tampilan yang dijelaskan berikutnya.

Melihat audiens kustom tertentu

Untuk melihat audiens kustom tertentu, jalankan perintah berikut dengan 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 pemicu update harian secara manual untuk audiens kustom tertentu, jalankan perintah berikut dengan 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.