Protected Audience fornisce una serie di API per partecipare e uscire dai segmenti di pubblico personalizzati all'interno del pacchetto android.adservices.customaudience. Per il debug sono disponibili comandi dell'interfaccia a riga di comando che consentono di elencare e visualizzare i segmenti di pubblico personalizzati. Questa guida illustra i passaggi che gli sviluppatori di tecnologie pubblicitarie devono seguire per esaminare lo stato dei segmenti di pubblico personalizzati uniti.
Imposta
Per motivi di sicurezza e privacy, i segmenti di pubblico personalizzati non sono visibili per impostazione predefinita e possono essere ispezionati direttamente solo a scopo di debug. Sono visibili solo tramite questi comandi se i seguenti requisiti sono veri:
- Le opzioni sviluppatore a livello di sistema sono attivate
android:debuggable="true"
è stato dichiarato nel file AndroidManifest.xml dell'app da cui è stato unitoCustomAudience
(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 il comando seguente.
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 questo comando specificando owner
come pacchetto che ha creato il segmento di pubblico e buyer
come identificatore della rete pubblicitaria che gestisce il segmento di 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 di questo array corrisponde all'output del comando view
custom audience descritto di seguito.
Visualizzare un segmento di pubblico personalizzato specifico
Per visualizzare uno specifico segmento di pubblico personalizzato, esegui questo comando specificando owner
come pacchetto che ha creato il segmento di pubblico, buyer
come identificatore della rete pubblicitaria che gestisce il segmento di 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 del trigger per uno specifico segmento di pubblico personalizzato, esegui questo comando specificando owner
come pacchetto che ha creato il segmento di pubblico, buyer
come identificatore della rete pubblicitaria che lo gestisce 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.