Inspecter les audiences personnalisées via la ligne de commande

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 laquelle CustomAudience a été joint (à l'aide de 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 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.