Ressources d'assistance pour l'API Topics sur le Web

Découvrez des recommandations de débogage, de dépannage et des ressources d'assistance pour Topics sur le Web.

Dépannage

Si vous effectuez un appel document.browsingTopics() ou une requête fetch() avec l'en-tête Sec-Browsing-Topics défini, mais que vous recevez un tableau vide en réponse, vous pouvez suivre plusieurs étapes de débogage pour identifier l'origine du problème, à la fois dans votre environnement de développement local et dans le système en ligne.

Déboguer en local

Si vous effectuez des tests en local, assurez-vous d'exécuter Chrome avec les paramètres requis.

  • Pour contourner l'inscription, activez l'indicateur chrome://flags/#privacy-sandbox-enrollment-overrides et ajoutez l'URL du site qui appelle Topics.

  • Configurez l'API Topics pour les tests à l'aide des flags de fonctionnalité. Ces options vous permettent de modifier des paramètres tels que la durée de l'époque, le nombre de sujets principaux, etc., afin de pouvoir tester Topics en toute simplicité. Vous pouvez utiliser les options de fonctionnalité recommandées suivantes:

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

  • Avant d'exécuter Chrome avec des indicateurs, assurez-vous d'avoir fermé toutes les autres instances et tous les autres processus Chrome.

  • Faites les vérifications suivantes :

    • Vous utilisez Chrome 101 ou une version ultérieure.
    • Votre script a appelé l'API Topics pour observer les sujets. Lors des tests, vous pouvez simuler le comportement des utilisateurs en accédant aux sites sur lesquels votre script est intégré. Pour voir un exemple pratique, consultez la démonstration.
    • Vous n'utilisez pas de bloqueur de publicité ni d'application ou d'extension similaire.
    • Vous n'êtes pas en mode navigation privée.
    • Dans chrome://settings/trackingProtection, l'option Block all third-party cookies est désactivée.

Déboguer l'implémentation en direct

Si vous appelez l'API Topics à partir d'une application en ligne au cours de la première semaine d'observation d'un utilisateur, un résultat vide est attendu, car votre application n'a peut-être pas encore observé de thèmes pour un utilisateur. Vous pouvez déboguer votre solution en suivant nos recommandations.

  • Assurez-vous que votre site est inscrit à la Privacy Sandbox.
  • Testez votre code côté client pour vous assurer que votre code JavaScript fonctionne comme prévu.
  • Testez votre backend pour recevoir les résultats des thèmes.
    • N'oubliez pas de vérifier que les types de données et les paramètres de l'API backend sont correctement configurés.
    • Assurez-vous que votre backend est configuré pour évoluer de manière appropriée.
  • D'après notre expérience, vous devez attendre au moins trois semaines avant de commencer à obtenir des résultats plus pertinents.
  • Tous les utilisateurs n'auront pas Topics activé :
    • Les utilisateurs peuvent désactiver explicitement l'API Topics.
    • Les pages des éditeurs peuvent contrôler les règles d'autorisation et désactiver leurs sites.
  • Ajoutez des métriques et de l'observabilité à cet environnement. Vous en aurez besoin pour analyser les premiers résultats. Voici quelques exemples de métriques :
    • Latence des appels.
    • Erreurs HTTP sur les appels de sujets.
  • Essayez de limiter les modifications apportées à votre implémentation pendant les trois premières semaines.

Ressources