Inspecter les audiences personnalisées via la ligne de commande

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 laquelle CustomAudience a été joint (avec joinCustomAudience ou fetchAndJoinCustomAudience)
  • Le consentement pour les annonces suggérées par les applis est activé

Activer les commandes shell adservices

  1. Redémarrez votre appareil pour arrêter le processus adservices.
  2. 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.