Ispezionare i segmenti di pubblico personalizzati dalla riga di comando

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 unito CustomAudience (utilizzando joinCustomAudience o fetchAndJoinCustomAudience)
  • Il consenso per gli annunci suggeriti dalle app è attivato

Attiva i comandi shell dei servizi annunci

  1. Riavvia il tuo dispositivo per terminare il processo adservices.
  2. 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.