Ispezionare i segmenti di pubblico personalizzati dalla riga di comando

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 a 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 .
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.