Protected Audience fournit une série d'API permettant de rejoindre et de quitter des audiences personnalisées dans le package android.adservices.customaudience. À des fins de débogage, des commandes CLI permettent de répertorier et d'afficher les audiences personnalisées. Ce guide décrit les étapes à suivre par les développeurs de technologies publicitaires pour inspecter l'état des audiences personnalisées qu'ils ont rejointes.
Préparation
Pour des raisons de sécurité et de confidentialité, les audiences personnalisées ne sont pas visibles par défaut et ne peuvent être directement inspectées qu'à des fins de débogage. Elles ne sont visibles à l'aide de ces commandes que si les conditions suivantes sont remplies:
- Les options pour les développeurs au niveau du système sont activées
android:debuggable="true"
est déclaré dans le fichier AndroidManifest.xml de l'application à partir de laquelleCustomAudience
a été joint (à l'aide dejoinCustomAudience
oufetchAndJoinCustomAudience
).- Le consentement pour les annonces suggérées par les applis est activé
Activer les commandes shell adservices
- Redémarrez votre appareil pour arrêter le processus
adservices
. - Vérifiez que
adservices
n'est pas en cours d'exécution. Un résultat vide est attendu pour la commande suivante.
adb shell ps -A | grep adservices
Ensuite, pour activer les commandes shell adservices
, exécutez les commandes suivantes:
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
Répertorier les audiences personnalisées
Pour afficher une audience personnalisée spécifique, exécutez la commande suivante en spécifiant owner
en tant que package qui a créé l'audience et buyer
en tant qu'identifiant du réseau publicitaire qui gère l'audience:
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
La sortie sera un objet JSON contenant un tableau custom_audiences
.
La structure des éléments de ce tableau correspond à la sortie de la commande "View Custom Audience" décrite ci-dessous.
Afficher une audience personnalisée spécifique
Pour afficher une audience personnalisée spécifique, exécutez la commande suivante en spécifiant owner
comme package ayant créé l'audience, buyer
comme identifiant pour le réseau publicitaire qui gère l'audience et name
comme nom de l'audience:
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
Actualiser une audience personnalisée spécifique
Pour afficher manuellement les mises à jour quotidiennes des déclencheurs pour une audience personnalisée spécifique, exécutez la commande suivante en spécifiant owner
en tant que package qui a créé l'audience, buyer
en tant qu'identifiant pour le réseau publicitaire qui gère l'audience et name
en tant que nom de l'audience:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.