Controllare i segmenti di pubblico personalizzati sulla riga di comando

Protected Audience fornisce una serie di API per entrare a far parte di segmenti di pubblico personalizzati e abbandonarli nell'ambito del pacchetto android.adservices.customaudience. A scopo di debug, sono disponibili comandi CLI per 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.

Configurazione

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 utilizzando questi comandi solo se sono soddisfatti i seguenti requisiti:

  • Le opzioni sviluppatore a livello di sistema sono attive
  • android:debuggable="true" è dichiarato nel file AndroidManifest.xml dell'app da cui è stato eseguito l'accesso a CustomAudience (utilizzando joinCustomAudience o fetchAndJoinCustomAudience)
  • Il consenso per gli annunci suggeriti dalle app è attivato

Abilitare i comandi della shell adservices

  1. Riavvia il dispositivo per terminare il processo adservices.
  2. Verifica che adservices non sia in esecuzione. Per il seguente comando è previsto un output vuoto.
adb shell ps -A | grep adservices

Quindi, per abilitare i comandi della shell adservices, esegui i seguenti 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 un pubblico personalizzato specifico, esegui questo comando specificando owner come pacchetto che ha creato il pubblico e buyer come identificatore del network pubblicitario 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 di questo array corrisponde all'output del comando per visualizzare il segmento di pubblico personalizzato descritto di seguito.

Visualizzare un segmento di pubblico personalizzato specifico

Per visualizzare un pubblico personalizzato specifico, esegui questo comando specificando owner come pacchetto che ha creato il pubblico, buyer come identificatore della rete pubblicitaria che gestisce il pubblico e name come nome del pubblico:

adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>

Aggiornare un segmento di pubblico personalizzato specifico

Per visualizzare l'aggiornamento giornaliero del trigger manualmente per un segmento di pubblico personalizzato specifico, esegui il comando seguente 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 refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.