API Topics: outils de test et d'analyse

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

Afficher les 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. Cette page affiche les thèmes de 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 améliorons la conception de la page en fonction des commentaires des développeurs. Vous pouvez contribuer à l'amélioration de l'API Topics en envoyant vos commentaires sous forme de bug Chromium.

Afficher les thèmes observés pour votre navigateur

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

Page chrome://topics-internals avec le panneau "Topics State" (État des thèmes) sélectionné.
Le panneau "État des thèmes" de la page chrome://topics-internals affiche les ID de thèmes, les attributions de thèmes 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 visité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 pour l'époque actuelle. Les trois autres thèmes ont été choisis au hasard, car l'historique de navigation (sur les sites qui observent les thèmes) est insuffisant pour fournir cinq thèmes.

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

Afficher les thèmes déduits pour les noms d'hôte

Vous pouvez également consulter les thèmes inférés par le modèle de classification de Topics pour un ou plusieurs noms d'hôte dans chrome://topics-internals.

Page chrome://topics-internals avec le panneau "Classifier" sélectionné.
Le panneau "Classificateur de pages" 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 uniquement à partir des noms d'hôte, et non à partir d'une autre partie d'une URL.

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

Afficher les informations sur l'API Topics

Vous trouverez des informations sur l'implémentation et les paramètres de l'API Topics, tels que la version de la taxonomie et la durée de l'époque, dans chrome://topics-internals. Ces valeurs reflètent les paramètres par défaut de l'API ou les paramètres définis avec succès à partir de la ligne de commande. Cela peut être utile pour vérifier que les indicateurs 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 à des indicateurs qui peuvent être définis lors de l'exécution de Chrome à partir de la ligne de commande. Pour savoir comment contrôler l'API Topics avec les flags Chrome, consultez 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 notebook Colab pour découvrir comment charger le modèle TensorFlow Lite utilisé par Chrome pour déduire des thèmes à partir de noms d'hôte. Vous trouverez les instructions dans la description du notebook Colab ou dans la vidéo explicative. Notez que ce notebook Colab utilise l'ancienne version de la taxonomie.

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

Comme indiqué dans la version 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 Topics API de Prebid. Pour en savoir plus sur l'intégration, contactez Prebid.js via le canal standard qu'il propose.

Étapes suivantes

Découvrez comment les utilisateurs et les développeurs peuvent gérer et personnaliser l'API Topics en fonction de leurs préférences et de leurs besoins.
Consultez nos ressources pour résoudre les problèmes, obtenir une assistance technique, signaler des bugs et poser des questions.

Voir aussi

Consultez nos ressources pour mieux comprendre l'API Topics sur le Web.