Tester, déployer et faire évoluer une solution basée sur Topics

Cette page explique comment créer, tester et mettre à l'échelle une implémentation pour la production à l'aide de l'API Topics.

Implémentation du backend des thèmes

L'implémentation du backend dépend de la façon dont vous souhaitez utiliser les thèmes calculés dans le navigateur. Nous recommandons aux solutions de technologie publicitaire d'utiliser les thèmes comme signal supplémentaire pour l'IBA.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Utiliser les thèmes comme signal supplémentaire

Les données sur les thèmes peuvent être considérées comme un signal supplémentaire sur votre audience, en plus d'autres signaux tels que les URL, les mots clés ou d'autres métadonnées.

Comme expliqué dans Optimiser la pertinence des annonces après les cookies tiers, il existe plusieurs approches pour exploiter Topics afin de diffuser des annonces pertinentes. Certaines de ces approches consistent à utiliser les thèmes pour créer des audiences, tandis que d'autres suggèrent d'utiliser les thèmes comme un signal parmi d'autres pour entraîner des modèles de machine learning qui seront utilisés pour déduire d'autres centres d'intérêt de l'audience ou même pour optimiser la logique d'enchères.

Migration Build and Deploy

  1. Collectez des thèmes en observant les utilisateurs en production (temps d'implémentation estimé : environ une semaine) :
    • Découvrez vos options : comment appeler Topics avec des en-têtes HTTP ou iframe et JavaScript.
    • Définissez le domaine de l'iFrame qui appellera l'API Topics.
    • Créez votre solution en utilisant la démonstration d'en-tête ou la démonstration JavaScript comme référence de code.
    • Intégrez Topics dans le code que les éditeurs intègrent à leurs sites (par exemple, votre iFrame d'annonce). Veillez à appeler les thèmes à partir de l'intégration.
    • Pour commencer à observer les thèmes des utilisateurs, intégrez la dernière version de votre script sur vos sites Web de production. Nous vous recommandons de tester l'implémentation sur vos propres sites Web qui enregistrent un petit nombre de visites mensuelles. À ce stade, nous vous recommandons d'intégrer votre nouvelle solution basée sur les thèmes à au moins cinq sites.
    • À ce stade, l'API devrait renvoyer un tableau vide comme résultat. En effet, aucun thème n'a encore été observé pour l'utilisateur. Il peut s'écouler jusqu'à trois semaines avant que vous ne commenciez à recevoir des thèmes utilisateur.
    • Effectuez des tests fonctionnels et de validation. Vous pouvez tester votre solution manuellement ou automatiquement. Exemple :
      • Ouvrez votre navigateur avec des indicateurs et définissez l'époque sur 15 secondes afin que le navigateur recalcule les thèmes plus rapidement.
      • Accédez aux sites qui intègrent votre script.
      • Vérifiez si les thèmes sont observés par votre script sur chrome://topics-internals/.
      • Découvrez les résultats que vous pouvez attendre.
  2. Utiliser les données Topics avec d'autres signaux contextuels (URL, métadonnées, etc.) (temps estimé : environ trois jours).
    • Au bout de trois semaines en production, votre script devrait avoir observé les thèmes de certains utilisateurs. À ce stade, vous devriez pouvoir utiliser les données sur les thèmes comme signal supplémentaire.
    • Une fois que vous commencez à recevoir une liste de thèmes non vide, vous pouvez l'envoyer à votre backend avec d'autres signaux contextuels.

Déployer sur des sites cibles

Une fois que vous avez intégré un appel Topics à votre script, assurez-vous qu'il est intégré à certains sites de production pour un premier test. Assurez-vous que votre implémentation fonctionne comme prévu :

  • L'API Topics est appelée.
  • Les thèmes peuvent être observés dans cet environnement contrôlé.
  • Les thèmes sont accessibles (l'API renvoie les thèmes observés pour l'utilisateur).

Choisir des sites cibles

Avant de déployer votre solution sur les sites des éditeurs, nous vous recommandons de la tester dans un environnement contrôlé, sur les sites Web dont vous êtes propriétaire. Nous vous recommandons de choisir des sites Web cibles comme suit :

  • Le site reçoit un petit nombre de visites mensuelles (moins d'un million environ) : commencez par déployer l'API auprès d'une petite audience.
  • Vous êtes propriétaire du site et vous le contrôlez : si nécessaire, vous pouvez désactiver rapidement l'implémentation sans avoir à obtenir des approbations complexes.
  • Le site n'est pas essentiel pour l'activité : commencez par les sites cibles à faible risque.
  • Ne dépassez pas cinq sites au total : vous n'avez pas besoin de générer autant de trafic ni d'exposition pour le moment.
  • Les sites cibles représentent différents thèmes : choisissez des sites Web qui représentent différentes catégories (par exemple, un sur le sport, un sur l'actualité, un sur l'alimentation et les boissons). Vous pouvez utiliser l'outil de thèmes internes dans Chrome pour valider les domaines et la façon dont ils sont classés par le classificateur de machine learning Topics.

Tests et validation fonctionnels

Lorsque vous appelez l'API Topics dans cet environnement limité, vous pouvez vous attendre aux résultats suivants :

  • Un tableau de thèmes vide [], s'il s'agit du premier appel de cet appareil, pour ce site et cet appelant au cours des sept derniers jours.

  • Liste de zéro à trois thèmes représentant les centres d'intérêt de cet utilisateur. Au bout de sept jours d'observation, vous devriez recevoir :

    • Un thème sélectionné parmi les cinq principaux pour l'utilisateur, calculé à partir des noms d'hôte des pages où des thèmes ont été observés par l'appelant au cours de cette semaine.

  • La réponse de l'API est exactement la même que dans tous les appels précédents de l'API Topics. Pour le même appelant, le même utilisateur et le même site de premier niveau, l'API renverra les mêmes thèmes pour l'ensemble d'une epoch. Cela permet d'éviter d'exposer trop de centres d'intérêt de l'utilisateur. Pour en savoir plus, consultez GitHub.

  • Un nouveau thème remplaçant l'un des trois anciens si vous appelez Topics après quatre semaines d'observation.

  • Si vous n'avez pas observé de thèmes pour l'utilisateur au cours des trois semaines précédentes ou plus, l'API Topics renverra à nouveau un tableau vide [].

Recueillez des métriques de performances pour évaluer votre expérience utilisateur :

  • Le temps d'exécution des appels JavaScript à l'API Topics dans un iFrame d'origine croisée doit être mesuré pour être utilisé dans de futures analyses des performances.
  • Temps nécessaire pour créer un iFrame et des sujets postMessage() après réception des sujets.

Pour résoudre les problèmes, consultez la section Assistance.

Mettre à l'échelle vers la production

À ce stade, vous devriez avoir testé Topics dans un environnement contrôlé (sur certains sites dont vous êtes propriétaire). Si tout fonctionne comme prévu, il est temps de mettre à l'échelle cette implémentation. Déployez le même code sur d'autres sites Web cibles. Vous pourrez ainsi observer davantage d'utilisateurs, collecter plus de données sur les thèmes et mieux comprendre vos audiences.

Voici un résumé des étapes à suivre pour passer à la production :

  1. Testez votre solution basée sur les thèmes sur un volume de trafic plus élevé.
    • Ajoutez votre iFrame à d'autres sites dont vous êtes propriétaire et qui enregistrent un grand nombre de visites, puis suivez les instructions ci-dessous pour effectuer des tests de charge.
  2. Déployez votre solution sur les sites des éditeurs.
    • Une fois que votre solution fonctionne correctement dans votre propre environnement de test, collaborez avec les éditeurs pour intégrer votre iFrame à leurs sites Web. Par exemple, ils devront peut-être mettre à jour la bibliothèque qui inclut votre iFrame.
  3. Traitez et utilisez les données sur les thèmes (durée estimée : environ quatre semaines).
    • Intégrez les données sur les thèmes comme signal additif à d'autres données.
    • Trouvez des partenaires pour tester les enchères en temps réel.
    • Effectuez des tests d'utilité avec des thèmes comme signal additif à vos autres données.

Tests de charge

Pour vous assurer que votre système peut gérer le trafic, nous vous recommandons d'effectuer des tests de charge avant de déployer votre solution basée sur les thèmes sur les sites des éditeurs.

  1. Déployez-les progressivement sur un plus grand nombre de sites cibles dont vous êtes propriétaire, en particulier ceux qui enregistrent un volume de trafic plus important.
  2. Effectuez des tests de charge pour les données de vos thèmes, en fonction du trafic attendu.
    • Vous devrez envoyer les informations sur le thème de l'iFrame à votre backend. Cela vous permet de traiter plus en détail les résultats de l'API Topics et de les utiliser comme signal supplémentaire pour sélectionner des annonces plus pertinentes pour l'utilisateur. À mesure que d'autres sites intègrent votre élément intégré, le nombre d'appels à votre backend augmente considérablement. Vérifiez que votre backend peut gérer un grand nombre d'appels provenant de l'iFrame.
    • Configurez la collecte de métriques et les journaux pour l'analyse.
  3. Immédiatement après le déploiement de l'API Topics, vérifiez vos métriques pour détecter tout problème grave rencontré par les utilisateurs finaux. Vérifiez régulièrement vos métriques.
  4. En cas d'interruption ou de comportement inattendu, restaurez le déploiement et analysez vos journaux pour comprendre et résoudre le problème.

Voir aussi

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