Inspecter les audiences personnalisées dans la ligne de commande

Protected Audience fournit une série d'API pour rejoindre et quitter des audiences personnalisées dans le cadre du package android.adservices.customaudience. À des fins de débogage, des commandes CLI sont disponibles pour lister et afficher les audiences personnalisées. Ce guide décrit la procédure que les développeurs de technologies publicitaires doivent suivre pour inspecter l'état de leurs audiences personnalisées associées.

Configuration

Pour des raisons de sécurité et de confidentialité, les audiences personnalisées ne sont pas visibles par défaut. Elles ne peuvent être inspectées directement 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 à l'échelle 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é rejoint (à 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 mettre fin au 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

Lister les audiences personnalisées

Pour afficher une audience personnalisée spécifique, exécutez la commande suivante en spécifiant owner comme package ayant créé l'audience et buyer comme identifiant du réseau publicitaire qui gère l'audience :

adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>

Le résultat sera un objet JSON contenant un tableau custom_audiences. La structure des éléments de ce tableau correspond à la sortie de la commande permettant d'afficher l'audience personnalisée décrite ci-après.

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 du 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 la mise à jour quotidienne du déclencheur manuellement pour une audience personnalisée spécifique, exécutez la commande suivante en spécifiant owner comme package ayant créé l'audience, buyer comme identifiant du réseau publicitaire qui gère l'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.