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 Topics

L'implémentation de votre backend dépend de la manière dont vous souhaitez utiliser les sujets calculés dans le navigateur. Nous recommandons aux solutions de technologie publicitaire d'utiliser Topics comme signal supplémentaire d'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 Topics comme signal supplémentaire

Les données sur les thèmes peuvent être considérées comme des signaux supplémentaires sur votre audience avec d'autres signaux comme les URL, les mots clés ou d'autres métadonnées.

Comme expliqué dans l'article Maximiser la pertinence des annonces après les cookies tiers, il existe plusieurs approches pour exploiter Topics afin de diffuser des annonces pertinentes. Certaines d'entre elles impliquent l'utilisation de Topics pour créer des audiences, tandis que d'autres suggèrent de l'utiliser comme signal parmi d'autres pour entraîner des modèles de machine learning qui seront utilisés pour déterminer les centres d'intérêt supplémentaires 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 les options qui s'offrent à vous: comment appeler des thèmes Topics avec des en-têtes HTTP ou iFrame et JavaScript.
    • Définissez le domaine de l'iFrame qui appelle l'API Topics.
    • Créez votre solution en utilisant la démo d'en-tête ou la démo JavaScript comme référence de code.
    • Intégrez des thèmes Topics dans le code que les éditeurs intègrent à leurs sites (par exemple, l'iFrame de votre annonce). Assurez-vous d'appeler les sujets à partir de l'intégration.
    • Pour commencer à observer les sujets des utilisateurs, intégrez la dernière version de votre script sur vos sites Web de production. Nous vous recommandons de commencer par tester l'implémentation sur vos propres sites Web qui enregistrent un faible nombre de visites mensuelles. À ce stade, nous vous recommandons d'intégrer votre nouvelle solution basée sur les thèmes sur au moins cinq sites.
    • À ce stade, l'API devrait renvoyer un tableau vide. En effet, aucun sujet n'a encore été observé pour l'utilisateur. Il peut s'écouler jusqu'à trois semaines avant que vous ne commenciez à obtenir les thèmes des utilisateurs.
    • Effectuez des tests et validations fonctionnels. Vous pouvez tester votre solution manuellement ou automatiquement. Exemple :
      • Ouvrez votre navigateur avec des indicateurs et définissez l'epoch sur 15 secondes pour que le navigateur calcule plus rapidement les sujets.
      • Rendez-vous sur les 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 auxquels vous pouvez vous attendre.
  2. Utiliser les données Topics avec d'autres signaux contextuels (URL, métadonnées, etc.) (délai estimé : environ trois jours).
    • Au bout de trois semaines de production, votre script aurait dû détecter les problèmes des sujets. À ce stade, vous devriez pouvoir utiliser les données de Topics comme signal supplémentaire.
    • Une fois que vous recevez une liste de sujets non vide, vous pouvez l'envoyer à votre backend avec d'autres signaux contextuels.

Déployer sur les sites cibles

Une fois que vous avez intégré un appel Topics dans 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 sujets peuvent être observés dans cet environnement contrôlé.
  • Vous pouvez accéder aux thèmes (l'API renvoie les thèmes observés pour l'utilisateur).

Choisir des sites cibles

Avant de déployer votre solution auprès des éditeurs nous vous recommandons de le tester dans un environnement contrôlé, sur vos sites Web. Nous vous recommandons de choisir des sites Web cibles comme suit :

  • Le site enregistre un petit nombre de visites mensuelles (moins d'un million de visites par mois): commencez par déployer l'API auprès d'une petite audience.
  • Vous détenez et contrôlez le site: si nécessaire, vous pouvez rapidement désactiver la mise en œuvre sans approbations complexes.
  • Le site n'est pas critique pour l'entreprise: commencez par des sites cibles présentant un risque faible.
  • Pas plus de cinq sites au total: vous n'aurez pas besoin d'un trafic ni d'une exposition aussi importants pour le moment.
  • Les sites cibles représentent des thèmes différents: choisissez des sites Web correspondant à différentes catégories (par exemple, l'un sur le sport, l'autre sur l'actualité et l'autre sur l'alimentation et les boissons). Vous pouvez utiliser l'outil Topics interne de Chrome pour valider les domaines et leur classement par le classificateur de machine learning Topics.

Tests fonctionnels et validation

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

  • Tableau vide d'éléments [], 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. Après sept jours d'observation, vous devriez obtenir:

    • Un thème, sélectionné dans le top 5 pour l'utilisateur, calculé à partir des noms d'hôte des pages sur lesquelles des thèmes ont été observés par l'appelant au cours de la semaine en question.

  • Exactement la même réponse d'API que dans tous les appels d'API Topics précédents. Pour le même appelant, le même utilisateur et le même site de premier niveau, l'API renvoie les mêmes thèmes pour toute une epoch. Cela permet d'éviter de révéler trop d'intérêts 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 depuis au moins trois semaines, l'API Topics renvoie à nouveau un tableau vide [].

Collectez des métriques de performances pour évaluer l'expérience utilisateur:

  • La durée d'exécution des appels JavaScript à l'API Topics dans un iFrame multi-origine doit être mesurée pour être utilisée dans une analyse des performances ultérieure.
  • Temps nécessaire pour créer un iframe et des sujets postMessage() après la réception des sujets.

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

Adaptation à la production

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

Voici un résumé détaillé du passage à la production:

  1. Testez votre solution basée sur des thèmes sur un volume de trafic plus élevé.
    • Ajoutez votre iFrame à d'autres sites dont vous êtes propriétaire et enregistrant un plus grand nombre de visites. Ensuite, 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 contient votre iFrame.
  3. Traiter et utiliser les données sur les thèmes (durée estimée: environ quatre semaines)
    • Intégrez les données sur les thèmes en tant que signal additif à d'autres données.
    • Trouver des partenaires de test des enchères en temps réel
    • Exécutez des tests d'utilité avec des thèmes pour ajouter un signal à 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 des thèmes dans de votre site Web.

  1. Déployez progressivement sur davantage de sites cibles que vous possédez, en particulier ceux qui enregistrent un volume de trafic plus important.
  2. Effectuez des tests de charge pour vos données de sujets, en fonction du trafic attendu.
    • Vous devrez envoyer les informations sur le sujet depuis l'iFrame vers votre backend. Vous pouvez ainsi traiter davantage les résultats de l'API Topics et les utiliser comme signal supplémentaire pour sélectionner les annonces les plus pertinentes pour l'utilisateur. À mesure que de plus en plus de sites intègrent votre élément intégré, le nombre d'appels vers votre backend augmentera considérablement. Vérifiez que votre backend peut gérer un grand volume d'appels à partir de l'iFrame.
    • Configurez la collecte des métriques et des journaux à des fins d'analyse.
  3. Immédiatement après avoir déployé l'API Topics, vérifiez vos métriques pour détecter d'éventuels problèmes graves pour les utilisateurs finaux. Continuez à vérifier régulièrement vos métriques.
  4. En cas de perturbation ou de comportement inattendu, annulez 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.