Découvrez les outils disponibles dans Chrome pour afficher des informations sur l'API Topics, comprendre comment les thèmes sont attribués et déboguer votre implémentation.
Afficher les informations concernant 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 thèmes observés pour votre navigateur
Les utilisateurs peuvent consulter les informations sur les thèmes observés dans leur navigateur pendant la période actuelle et la période précédente en accédant à chrome://topics-internals.
chrome://topics-internals affiche les ID des sujets, les attributions de sujets aléatoires et réelles, ainsi que les versions de taxonomie et de 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 de manière aléatoire, 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 par les domaines (hachés) indique la valeur hachée d'un nom d'hôte pour lequel un sujet 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.
chrome://topics-internals affiche les thèmes sélectionnés, les hôtes visités, la version du modèle et le chemin d'accès.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 déduits à partir du classificateur chrome://topics-internals. chrome://topics-internals affichera une erreur si vous tentez d'inclure un "/" dans le champ "Host".
Afficher les informations concernant 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'epoch, dans chrome://topics-internals. Ces valeurs reflètent les paramètres par défaut de l'API ou ceux définis avec succès à 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).
chrome://topics-internals affiche les fonctionnalités activées, la date et l'heure par epoch, le nombre d'époques à utiliser pour calculer les thèmes, la version de la taxonomie et d'autres paramètres.Les paramètres présenté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 dédiée à la configuration.
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
Colab
Exécutez 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 de présentation. Notez que cet atelier de programmation utilise l'ancienne version de la taxonomie.
Utiliser l'API Topics sur des sites Web à l'aide de prebid.js
Comme indiqué dans la version de Prebid 7, la communauté a activement développé une intégration de l'API Topics à l'aide d'un nouveau module. Ce module a été fusionné en décembre 2022. Consultez la documentation sur le module de l'API Topics de Prebid. Pour en savoir plus sur cette intégration, contactez Prebid.js par le biais du canal standard proposé.
Next steps
Control & transparency
Support
See also
Check out our resources to better understand the Topics API on the Web.
- Check out Topics demos, collab and walkthrough videos.
- See the list of Chrome flags that allow developers to customize the Topics API for testing.
- See how users and developers can control the API.
- Check out the resources for technical explainers and support. Ask questions, engage and share feedback.