Protected Audience fournit une série d'API pour rejoindre et quitter des audiences personnalisées dans le package android.adservices.customaudience. Pour à des fins de débogage. Des commandes CLI sont disponibles pour répertorier et afficher les audiences personnalisées. Ce guide décrit les étapes nécessaires aux développeurs de technologies publicitaires pour suivre pour inspecter l'état des audiences personnalisées qu'elle a rejointes.
Configuration
Pour des raisons de sécurité et de confidentialité, les audiences personnalisées ne sont pas visibles par défaut et ne peut être directement inspectée qu'à des fins de débogage. Ils ne sont visibles que à l'aide de ces commandes 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 du fichier l'application à partir de laquelleCustomAudience
a été joint (avecjoinCustomAudience
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 le
owner
en tant que package ayant créé l'audience et buyer
en tant que
pour le 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 vue
d'audience personnalisée 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 le
owner
en tant que package ayant créé l'audience, buyer
en tant que
pour le réseau publicitaire qui gère l'audience, et le name
en tant que
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 du déclencheur pour une audience personnalisée spécifique, exécutez la
en spécifiant owner
comme package à l'origine de la création du
audience, buyer
en tant qu'identifiant du réseau publicitaire qui gère le
audience et name
comme nom de l'audience:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.