Démonstrations de l'API Topics

Faites des tests et découvrez comment les thèmes sont déduits des noms d'hôte avec une configuration minimale.

État de l'implémentation

La démonstration de l'API Topics montre comment les sujets sont déduits des noms d'hôte. Vous pouvez prévisualiser les sujets observés lorsque vous consultez un site de démonstration, qui nécessite très peu de configuration.

Notre démonstration est un aperçu qui présente la plupart des fonctionnalités de l'API Topics afin que vous puissiez vous familiariser avec son implémentation.

Vous pouvez également exécuter le colab Topics pour tester le modèle de classificateur Topics.

La vidéo suivante présente le fonctionnement de la démonstration.

Tester avec chrome://flags ou les flags de fonctionnalité

Il existe deux façons d'essayer l'API Topics en tant qu'utilisateur unique. Vous devez utiliser Chrome 101 ou une version ultérieure:

  • Activez l'API sur la page Chrome chrome://flags/#privacy-sandbox-ads-apis:

    Activer l'API Topics depuis la page chrome://flags/#privacy-sandbox-ads-apis
    Page chrome://flags/#privacy-sandbox-ads-apis sur laquelle vous pouvez activer ou désactiver l'API.

  • Exécutez Chrome à partir de la ligne de commande avec les indicateurs suivants:

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

Démonstration de l'API Topics

La démonstration Topics montre comment utiliser des indicateurs supplémentaires pour ajuster des paramètres, comme la durée de l'epoch. Si vous accédez à l'API Topics en exécutant Chrome avec des indicateurs de ligne de commande, ne définissez pas chrome://flags, car cela pourrait remplacer les paramètres de ligne de commande.

L'article Exécuter Chromium avec des indicateurs explique comment définir des indicateurs lorsque vous exécutez Chrome et d'autres navigateurs Chromium à partir de la ligne de commande, bien que cette démonstration soit spécifique à Google Chrome.

Démonstration des en-têtes d'API Topics

La démonstration disponible sur topics-fetch-demo.glitch.me montre comment utiliser les en-têtes de requête et de réponse fetch() pour accéder aux sujets et les marquer comme observés.

Accéder à l'en-tête de requête Sec-Browsing-Topics

Au lieu d'utiliser document.browsingTopics() à partir d'un iFrame pour afficher les sujets d'un utilisateur, les appelants d'API peuvent accéder aux sujets observés à partir de l'en-tête de requête Sec-Browsing-Topics d'une requête fetch() qui inclut {browsingTopics: true} dans son paramètre d'options ou à partir du même en-tête d'une requête XHR qui définit l'attribut deprecatedBrowsingTopics sur true.

Exemple :

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

Dans les navigateurs compatibles avec l'API, la requête fetch() inclut un en-tête Sec-Browsing-Topics qui répertorie les sujets observés pour le nom d'hôte de l'URL de la requête. Dans cet exemple, il s'agit de topics-server.glitch.me.

Si aucun sujet n'a été observé pour ce nom d'hôte et cet utilisateur, l'en-tête est inclus, mais la valeur est vide. En d'autres termes, l'en-tête Sec-Browsing-Topics d'une requête fetch() n'inclut que les sujets observés pour le navigateur de l'utilisateur actuel par un appelant dont l'origine correspond au nom d'hôte de l'URL de la requête. Cela revient à appeler document.browsingTopics() à partir d'un iFrame pour afficher les thèmes observés pour l'utilisateur actuel.

L'en-tête de requête est envoyé sur une requête à condition que la règle d'autorisation appropriée soit activée, que le contexte soit sécurisé et que les paramètres utilisateur le permettent. Les sujets ne sont pas fournis dans les en-têtes des requêtes de navigation.

L'en-tête de requête Topics se présente comme suit:

Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"

Cet exemple inclut deux thèmes de la taxonomie Topics (186 et 265), ainsi que les informations de version de chaque thème.

L'inclusion de l'en-tête "topics" dans les requêtes XHR n'est disponible que temporairement. Cette fonctionnalité sera supprimée à l'avenir.

Marquer les thèmes comme observés avec Observe-Browsing-Topics

Si une requête inclut un en-tête Sec-Browsing-Topics et que la réponse à cette requête inclut un en-tête Observe-Browsing-Topics: ?1, les sujets de l'en-tête de requête seront marqués par le navigateur comme observés. Les thèmes observés peuvent être calculés par l'API Topics. Ce mécanisme est conçu pour correspondre à la fonctionnalité fournie par l'API JavaScript à partir d'un iFrame.

La capture d'écran ci-dessous illustre les thèmes enregistrés lors de la visite des sites sur la page de démonstration de l'API.

Page de démonstration de l'API Topics sur glitch.me
La démonstration de glitch.me pour essayer l'API

Cette liste présente les sites de démonstration que vous pouvez consulter pour enregistrer les sujets qui vous intéressent. Comme vous pouvez le constater, la catégorie "Arts et divertissements/Humour" de la capture d'écran n'est pas le thème de l'un de ces sites Web. Ce thème enregistré a donc été ajouté en tant que sujet aléatoire pouvant atteindre 5 %.

  • pets-animals-pets-cats.glitch.me
  • cats-cats-cats-cats.glitch.me
  • cats-pets-animals-pets.glitch.me
  • cats-feline-meow-purr-whiskers-pet.glitch.

Vous pouvez vérifier quels sujets sont réels et quels sont les sujets aléatoires dans l'onglet "État des sujets" de la page chrome://topics-internals. Cette capture d'écran montre un exemple tiré de différentes sessions de navigation.

L'onglet d'état des thèmes fournit des informations sur les thèmes observés.
Onglet "État des sujets" affichant des sujets réels et aléatoires.

Étapes suivantes

Si vous êtes un développeur ad tech, testez l'API Topics et participez-y. Pour accéder à des ressources plus détaillées, consultez le guide du développeur.

Interagir et partager des commentaires