Présentation de l'API Topics pour mobile

bookmark_border Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Découvrez l'API Topics sur Android et la procédure d'implémentation. Vous pouvez également passer directement à la implémentation de sujets.

Fonctionnement de l'API Topics

L'API Topics permet d'observer et d'accéder aux thèmes qui semblent intéresser l'utilisateur en fonction de son activité. L'API Topics peut ensuite donner aux appelants de l'API (comme les plates-formes publicitaires) l'accès aux centres d'intérêt d'un utilisateur, mais sans révéler d'informations supplémentaires sur son activité.

Concepts clés

• Un thème est un sujet d'intérêt compréhensible pour l'utilisateur actuel. Il fait partie de la taxonomie Topics.
• Un appelant est une entité, telle qu'une application, un SDK tiers, un site Web ou un service, qui envoie une requête à l'API Topics pour observer ou accéder aux centres d'intérêt d'un utilisateur.
• Un thème est observé par un appelant s'il a effectué une requête API Topics à partir d'une page Web ou d'une application associée à ce thème au cours des trois dernières "epochs".
• Une epoch est une période de calcul thématique, qui est par défaut d'une semaine.
• Une taxonomie est une liste hiérarchisée de catégories, qui inclut, par exemple, les catégories /Arts & Entertainment/Music & Audio/Soul & R&B et /Business & Industrial/Business Services/Corporate Events.
• Les thèmes sont dérivés à l'aide d'un modèle de classificateur qui met en correspondance l'activité des utilisateurs avec zéro ou plusieurs thèmes.

Étapes principales du flux de l'API Topics

Le cycle de vie de l'API Topics comporte trois étapes principales:

• Observer l'activité des utilisateurs, par exemple lorsqu'ils accèdent à la page Web https://cats.example/tabby/index.html ou téléchargent l'application cats
• Déduire des thèmes à partir de l'activité des utilisateurs, par exemple /Pets & Animals/Pets/Cats.
• Thèmes d'accès précédemment observés pour l'utilisateur, par exemple pour sélectionner des annonces pertinentes (comme une promotion de nourriture pour chats).

Observer des sujets

Les appelants ne peuvent accéder qu'aux sujets d'intérêt qu'ils ont observés. Un appelant observe un thème lorsqu'il envoie une requête API Topics à partir d'un contexte associé à ce thème. Pour illustrer ce concept, prenons l'exemple simplifié suivant.

• Supposons qu'il existe deux appelants de l'API Topics: A et B.
• Il existe deux contextes :
  • Greenhouse, par exemple une application nommée Greenhouse ou un site Web greenhouse.example, associé au thème Home & Garden.
  • Exercices de tennis, par exemple une application nommée "Exercices de tennis" ou un site Web tennis.example, associé au sujet Sports/Tennis.
• Les appelants A et B sont tous deux présents dans le contexte de Greenhouse.
• Seul l'appelant B est présent dans le contexte des exercices de tennis.
• Par souci de simplicité, supposons qu'aucun sujet n'a été observé pour l'utilisateur avant l'époque 1.
• L'utilisateur accède à l'application Greenhouse, et les appelants A et B effectuent un appel d'API Topics pour enregistrer la visite de l'utilisateur sur la page ou l'application (consultez le guide d'implémentation suggéré dans la section Étapes suivantes pour savoir comment appeler l'API Topics). Cet enregistrement (un nom d'hôte ou des données d'application) est ensuite utilisé pour déduire les centres d'intérêt. L'API Topics marquera ensuite le thème Home & Garden comme observé par les deux appelants A et B.
• L'utilisateur accède à l'application Exercices de tennis. Seul l'appelant B envoie une requête API Topics. L'API Topics marquera ultérieurement le thème Sports/Tennis comme observé par l'appelant B.
• À la fin de l'epoch, l'API Topics actualise les principaux thèmes de l'utilisateur et détermine les appelants qui ont observé ces thèmes en fonction de l'activité de l'utilisateur.
• Plus tard, lorsque l'appelant B effectue un autre appel à l'API Topics, il peut obtenir le thème Home & Garden ou Sports/Tennis (ou, avec une probabilité de 5 %, un thème aléatoire) pour cet utilisateur dans le tableau de réponse.
• L'appelant A ne peut accéder qu'au thème Home & Garden, car il n'a jamais observé le thème Sports/Tennis. Cela signifie qu'un tiers ne connaîtra les centres d'intérêt d'un utilisateur que dans le contexte spécifique (application ou site Web) où ils sont présents.

Dégager des sujets

Topics déduit les centres d'intérêt des utilisateurs à partir de leur activité. Les thèmes sont sélectionnés à partir d'une taxonomie Open Source prédéfinie. Une fois par epoch, Topics actualise les cinq principaux thèmes de l'utilisateur et les appelants qui les ont observés au cours de l'epoch. Le modèle de classificateur de thèmes dérive les thèmes de l'activité des utilisateurs: nom d'hôte pour une visite de page Web, informations sur l'application sur Android.

L'appelant accède aux centres d'intérêt de l'utilisateur

L'API ne renvoie que les thèmes observés par l'appelant au cours des trois dernières époques. Un appelant peut recevoir jusqu'à trois thèmes,un pour chacune des trois epochs récentes (si l'appelant a observé des thèmes pour cette époque). L'appelant peut utiliser les thèmes renvoyés pour compléter les informations contextuelles et les combiner pour trouver une annonce plus pertinente pour l'utilisateur.

Époques

L'API Topics doit s'assurer que les thèmes d'intérêt qu'elle fournit sont à jour. Les thèmes sont inférés pour un utilisateur en fonction de son activité au cours d'une période appelée "epoch", une semaine par défaut. Chaque utilisateur a ses propres époques (elles sont "par utilisateur") et l'heure de début initiale est aléatoire.

Une fois par epoch, l'API Topics calcule les cinq principaux thèmes de l'utilisateur et détermine les appelants qui ont observé ces thèmes à l'aide des informations disponibles sur l'appareil. Le thème sélectionné pour chaque époque est choisi au hasard parmi les cinq thèmes principaux associés à l'utilisateur pour cette période. Pour renforcer la confidentialité et s'assurer que tous les thèmes peuvent être représentés, il y a 5% de chances que le thème soit sélectionné de manière aléatoire parmi tous les thèmes possibles de la taxonomie des centres d'intérêt.

Thèmes sur Android en pratique

L'API Topics sur Android est conçue pour prendre en charge les SDK publicitaires tiers qui fonctionnent généralement dans plusieurs applications. Topics fournit aux appelants des thèmes publicitaires d'intérêt plus précis en fonction de l'utilisation de l'application, sans s'appuyer sur des identifiants inter-applications. Ces thèmes peuvent être utilisés pour compléter les informations contextuelles relatives à l'application qui souhaitent diffuser une annonce. Ils peuvent également être combinés afin d'identifier une annonce appropriée pour l'utilisateur.

Dans le contexte de l'API Topics, les acheteurs et les annonceurs dépendent du côté vente. C'est le côté vendeur qui a une présence étendue sur les applications de l'éditeur et qui observe les sujets des utilisateurs, puis les partage avec les acheteurs pour les aider à sélectionner des annonces plus pertinentes. Pour obtenir des thèmes, les applications et les SDK côté vente doivent établir une empreinte en observant l'API Topics pendant au moins une epoch.

Reportez-vous au guide d'implémentation de l'API Topics pour obtenir des exemples de code qui montrent comment configurer l'extraction des thèmes pour la publicité ciblée par centres d'intérêt.

Intégration des thèmes par type d'activité

Activez la publicité ciblée par centres d'intérêt avec l'API Topics. Suivez les étapes en fonction de votre type d'entreprise de technologie publicitaire pour intégrer l'API Topics et vous préparer au lancement.

Pour toutes les technologies publicitaires

• Consultez la taxonomie Topics et envoyez vos commentaires.
• Possibilité de tester les applications exemples de l'API Topics pour identifier les données de thèmes renvoyées par le classificateur sur l'appareil
• Possibilité de mettre à jour les flux d'application et de SDK pour commencer à appeler l'API Topics
• Possibilité de mettre à jour les protocoles pour commencer à envoyer des thèmes dans des demandes d'annonce
• Possibilité d'inscrire votre technologie publicitaire à la Privacy Sandbox

Pour les technologies publicitaires côté vente

• Devenez un observateur pour établir une empreinte de l'API Topics. L'API Topics fournit un nouveau signal. Vous devez donc mettre à jour votre SDK pour commencer à l'appeler. Pour récupérer les thèmes de manière cohérente, votre SDK doit appeler l'API depuis les applications de l'éditeur au moins une fois par epoch. Il peut s'écouler jusqu'à quatre epochs avant que le nombre maximal de thèmes (trois thèmes) soit envoyé avec vos demandes d'annonces.
• Possibilité d'inclure des informations sur l'API Topics dans vos demandes d'annonces. Pour chaque demande d'annonce, commencez à partager vos données d'API Topics avec les partenaires côté achat. L'API Topics prévoit de compléter d'autres signaux (tels que les signaux de contexte) pour aider à trouver une publicité appropriée pour un visiteur donné.
• Possibilité de collaborer sur un protocole pour partager des thèmes avec vos partenaires côté acheteur. L'API Topics nécessite que chaque SDK collabore avec les partenaires en aval pour convenir du partage de ses données.

Pour les technologies publicitaires côté achat

• Possibilité de contacter les partenaires côté vente pour confirmer qu'ils envisagent d'observer les thèmes et de prendre une empreinte. Pour recevoir des thèmes, les fournisseurs côté vente doivent appeler l'API Topics au moins une fois par epoch.
• Possibilité de collaborer sur un protocole pour recevoir des thèmes de vos partenaires côté vente. L'API Topics est un nouveau signal qui sera partagé par les partenaires côté vente dans la demande d'annonce. Les consommateurs côté achat devront s'assurer qu'ils travaillent avec leurs partenaires en amont sur la façon dont les sujets seront partagés.
• Possibilité d'intégrer des thèmes dans les modèles d'enchères et d'optimisation. Il est prévu que l'API Topics complète d'autres signaux, comme les signaux de contexte, pour aider à trouver une publicité appropriée pour le visiteur.

Comment l'API déduit les thèmes d'une application

Sur Android, l'API Topics déduit les thèmes d'une application en fonction des informations sur l'application, à l'aide d'un modèle de classificateur. Dans l'implémentation actuelle, Topics utilise les noms des applications et des packages pour attribuer des thèmes d'intérêt à une application, mais cette fonctionnalité peut être étendue par la suite pour inclure d'autres informations telles que la description de l'application.

Classificateur de thèmes

Les thèmes d'intérêt sont issus d'un modèle de classificateur entraîné à partir d'informations sur les applications accessibles au public.

• Lorsque le modèle de classificateur est utilisé à des fins d'inférence pour calculer les thèmes pour une epoch donnée, l'ensemble de signaux utilisés reste sur l'appareil. Cet ensemble de signaux peut inclure des applications installées ou récemment utilisées. Il pourra être étendu par la suite pour inclure d'autres signaux.
• Le modèle V5 a été entraîné par Google sur 540 000 informations d'applications publiques étiquetées manuellement et 17 millions de fois étiquetées par le ML issues de plates-formes de téléchargement d'applications telles que le Google Play Store. Le modèle utilise les noms d'application et de package comme signaux d'entrée. Il est disponible gratuitement pour que les développeurs d'applications puissent le tester et déterminer les thèmes pertinents pour leur application.
• Il est possible qu'une application soit associée à plusieurs thèmes, à aucun thème ou qu'elle n'ajoute aucun thème à l'historique de l'utilisateur. Si une application correspond à plusieurs thèmes de la taxonomie, le nombre de thèmes choisis pour cette application est limité aux trois premiers.

Pour mieux comprendre le fonctionnement du modèle de classificateur, vous pouvez tester l'impact de différentes données d'application sur la classification à l'aide du colab sur les classificateurs de thèmes Android.

Taxonomie

Les thèmes sont sélectionnés à partir d'une taxonomie Open Source prédéfinie. La taxonomie est publique et susceptible d'être modifiée. Vous pouvez soumettre des suggestions de modifications à l'aide du bouton de commentaires situé en haut de cette page. Cette taxonomie est définie manuellement afin que les thèmes sensibles en soient exclus. Il sera adapté aux catégories d'annonces qui peuvent être diffusées dans les applications mobiles sur Android.

Thèmes sur Android en pratique

Supposons qu'un utilisateur ait sept applications installées sur son appareil : A, B, C, D, E, F et G. Supposons que la classification des thèmes pour l'application et pour les SDK de technologie publicitaire de ces applications soit la suivante :

Fin de la semaine 1 : l'API Topics génère les cinq principaux thèmes de l'utilisateur pour cette epoch.

Au cours de la deuxième semaine, si un appelant d'une application appelle l'API, la liste de thèmes renvoyée n'inclura que les thèmes pour lesquels l'appelant se trouve dans la catégorie "Appelants qui peuvent en savoir plus sur le sujet". pour ce thème et cette application pour cette epoch.

• La période d'historique prise en compte dans le calcul des thèmes disponibles pour chaque appelant est de trois epochs (ou trois semaines).
• Seuls les thèmes associés à des applications qui appellent l'API Topics via des SDK publicitaires sont utilisés. Cela signifie que si une application n'inclut aucun SDK publicitaire qui appelle l'API Topics, les thèmes associés à cette application ne contribuent pas à l'ensemble des thèmes accessibles par les SDK publicitaires.
• Une application peut également désactiver l'API Topics de manière déclarative. Les thèmes associés aux applications désactivées ne sont pas pris en compte dans le calcul hebdomadaire des thèmes. Ce document sera mis à jour pour inclure les détails d'implémentation associés.

Si l'utilisation des applications est insuffisante pour que la plate-forme puisse déduire cinq thèmes, elle peut envisager des options telles que la génération aléatoire de thèmes restants.

Chiffrement des sujets renvoyés

Les plates-formes de technologie publicitaire inscrites qui appellent l'API Topics doivent également fournir les éléments suivants : clés de chiffrement pour garantir que les sujets renvoyés sont lisibles uniquement par appelant.

La Privacy Sandbox extrait ces clés à partir du point de terminaison fourni par la technologie publicitaire. Mer il est recommandé de mettre à jour les clés régulièrement, mais pas au moins tous les six mois.

Lors du processus d'enregistrement, la Privacy Sandbox demandera aux technologies publicitaires de confirmer la disponibilité du point de terminaison qu'elles fournissent. Pour en savoir plus sur les actions requises par les technologies publicitaires actuelles et nouvellement enregistrées, consultez le guide d'inscription.

Étapes suivantes

Voir aussi

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

• Découvrez les exemples d'applications, les vidéos collaboratives et les tutoriels de Topics.
• Découvrez comment les utilisateurs et les développeurs peuvent contrôler l'API.
• Consultez les ressources d'assistance pour poser des questions, interagir et partager vos commentaires.