API Topics: outils de test et d'analyse

Découvrez les outils disponibles dans Chrome pour afficher des informations sur l'API Topics et comprendre comment les thèmes sont attribués.

Afficher des informations sur l'API Topics

La page chrome://topics-internals est disponible dans Chrome sur ordinateur une fois que vous avez activé l'API Topics. Cela affiche les thèmes pour l'utilisateur actuel, les thèmes inférés pour les noms d'hôte et des informations techniques sur l'implémentation de l'API. Nous itérons et améliorons la conception de la page en fonction des commentaires des développeurs. Vous pouvez façonner l'API Topics en envoyant vos commentaires en tant que bug Chromium.

Afficher les sujets observés pour votre navigateur

Les utilisateurs peuvent consulter des informations sur les thèmes observés pour leur navigateur au cours des époques actuelles et précédentes en accédant à chrome://topics-internals.

Page chrome://topics-internals avec le panneau "État des sujets" sélectionné.
Le panneau "État des sujets" de la page chrome://topics-internals affiche les ID des sujets, les attributions de sujets aléatoires et réelles, ainsi que les versions de la taxonomie et du modèle.

Cette capture d'écran montre que les sites récemment consultés incluent topics-demo-cats.glitch.me et cats-cats-cats-cats.glitch.me. L'API Topics sélectionne alors Pets et Cats comme deux des principaux thèmes de l'époque actuelle. Les trois thèmes restants ont été choisis au hasard, car l'historique de navigation (sur les sites qui observent les thèmes) n'est pas suffisant pour fournir cinq thèmes.

La colonne Domaines de contexte observés (hachage) fournit la valeur hachée d'un nom d'hôte pour lequel un thème a été observé.

Afficher les thèmes inférés pour les noms d'hôte

Vous pouvez également afficher les sujets inférés par le modèle de classificateur des sujets pour un ou plusieurs noms d'hôte dans chrome://topics-internals.

Page chrome://topics-internals avec le panneau "Classificateur" sélectionné.
Le panneau "Classificateur" de la page chrome://topics-internals affiche les thèmes sélectionnés, les hôtes visités, ainsi que la version et le chemin d'accès du modèle.

L'implémentation actuelle de l'API Topics déduit les thèmes à partir des noms d'hôte uniquement, et non à partir d'autres parties d'une URL.

Utilisez uniquement des noms d'hôte (sans protocole ni chemin d'accès) pour afficher les sujets inférés à partir du classificateur chrome://topics-internals. chrome://topics-internals affiche une erreur si vous essayez d'inclure un "/" dans le champ "Host".

Afficher des informations sur l'API Topics

Vous trouverez des informations sur l'implémentation et les paramètres de l'API Topics, comme la version de la taxonomie et la durée de l'ère, dans chrome://topics-internals. Ces valeurs reflètent les paramètres par défaut de l'API ou des paramètres correctement définis à partir de la ligne de commande. Cela peut être utile pour vérifier que les options de ligne de commande ont fonctionné comme prévu.

Dans l'exemple, time_period_per_epoch a été défini sur 15 secondes (la valeur par défaut est de sept jours).

Page chrome://topics-internals avec le panneau "Fonctionnalités et paramètres" sélectionné.
Le panneau chrome://topics-internals "Fonctionnalités et paramètres" affiche les fonctionnalités activées, le temps par époque, le nombre d'époques à utiliser pour calculer les thèmes, la version de la taxonomie et d'autres paramètres.

Les paramètres affichés dans la capture d'écran correspondent aux indicateurs pouvant être définis lorsque vous exécutez Chrome à partir de la ligne de commande. Découvrez comment contrôler l'API Topics avec des indicateurs Chrome dans la section de configuration dédiée.

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Colab

Exécutez le Colab pour découvrir comment charger le modèle TensorFlow Lite utilisé par Chrome pour inférer des sujets à partir d'hôtes. Vous trouverez les instructions dans la description du colab ou dans la vidéo de présentation. Notez que cet atelier de programmation utilise l'ancienne version de la taxonomie.

Utiliser l'API Topics sur les sites Web avec prebid.js

Comme indiqué lors de la sortie de Prebid 7, la communauté a activement développé une intégration avec l'API Topics à l'aide d'un nouveau module. Ce module a été fusionné en décembre 2022. Consultez la documentation du module de l'API Topics de Prebid. Pour en savoir plus sur l'intégration, contactez Prebid.js via le canal standard qu'il propose.

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.