Memeriksa audiens kustom pada command line

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 tempat CustomAudience bergabung (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 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.