Protected Audience fornisce una serie di API per partecipare e uscire segmenti di pubblico come parte del pacchetto android.adservices.customaudience. Per a scopo di debug, è possibile elencare e visualizzare i comandi dell'interfaccia a riga di comando segmenti di pubblico personalizzati. Questa guida illustra i passaggi che gli sviluppatori di ad tech devono: da seguire per esaminare lo stato dei segmenti di pubblico personalizzati uniti.
Configurazione
Per motivi di sicurezza e privacy, i segmenti di pubblico personalizzati non sono visibili per impostazione predefinita e possono essere ispezionate direttamente solo a scopo di debug. Sono visibili soltanto utilizzando questi comandi se i seguenti requisiti sono veri:
- Le opzioni sviluppatore a livello di sistema sono attivate
android:debuggable="true"
è dichiarato nel file AndroidManifest.xml della app da cui è stata stabilita la partecipazione aCustomAudience
(utilizzandojoinCustomAudience
ofetchAndJoinCustomAudience
)- Il consenso per gli annunci suggeriti dalle app è attivato
Attiva i comandi shell dei servizi annunci
- Riavvia il tuo dispositivo per terminare il processo
adservices
. - Verifica che
adservices
non sia in esecuzione. È previsto un output vuoto per .
adb shell ps -A | grep adservices
Quindi, per abilitare i comandi della shell di adservices
, esegui questi comandi:
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
Elenca segmenti di pubblico personalizzati
Per visualizzare uno specifico segmento di pubblico personalizzato, esegui il comando seguente specificando
owner
come pacchetto che ha creato il segmento di pubblico e buyer
come
identificatore per la rete pubblicitaria che gestisce il pubblico:
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
L'output sarà un oggetto JSON contenente un array custom_audiences
.
La struttura degli elementi all'interno dell'array corrisponde all'output della vista
il comando segmento di pubblico personalizzato
descritto di seguito.
Visualizzare un segmento di pubblico personalizzato specifico
Per visualizzare uno specifico segmento di pubblico personalizzato, esegui il comando seguente specificando
owner
come pacchetto che ha creato il segmento di pubblico, buyer
come
per la rete pubblicitaria che gestisce il pubblico e name
come
nome del segmento di pubblico:
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
Aggiornare un segmento di pubblico personalizzato specifico
Per visualizzare manualmente l'aggiornamento giornaliero dell'attivatore per uno specifico segmento di pubblico personalizzato, esegui la
seguente comando che specifica owner
come pacchetto che ha creato
pubblico, buyer
come identificatore della rete pubblicitaria che gestisce la
segmento di pubblico e name
come nome del segmento di pubblico:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.