API Topics pour mobile: présentation

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

How the Topics API works

The Topics API can be used to observe and provide access to topics that appear to be of interest to the user, based on their activity. The Topics API can then give API callers (such as ad tech platforms) access to a user's topics of interest, but without revealing additional information about the user's activity.

Key concepts

• A topic is a human-readable topic of interest for the current user and is part of the Topics taxonomy.
• A caller is an entity, such as an app, a third-party SDK, a website, or service, that makes a request to the Topics API to observe or access a user's interests.
• A topic is observed by a caller, if the caller made a Topics API request from a web page or app associated with this topic during the past three epochs.
• An epoch is a period of topic computation, which defaults to one week.
• A taxonomy is a hierarchical list of categories, which includes, for example, such categories as /Arts & Entertainment/Music & Audio/Soul & R&B and /Business & Industrial/Business Services/Corporate Events.
• Topics are derived using a classifier model that maps user activity to zero or more topics.

Topics API flow core steps

The Topics API lifecycle has three main steps:

• Observe user activity, such as when they visit the web page https://cats.example/tabby/index.html or download the app cats.
• Derive topics from user activity, for example /Pets & Animals/Pets/Cats.
• Access topics previously observed for the user, for example as a signal to select relevant advertising (such as a cat food promotion).

Observe topics

Callers can only access topics of interest that they've observed. A caller observes a topic when they make a Topics API request from a context associated with this topic. To illustrate this concept, consider the following simplified example.

• Suppose there are two Topics API callers: A and B.
• There are two contexts:
  • Greenhouse, for example an app named Greenhouse or a website greenhouse.example, associated with the topic Home & Garden.
  • Tennis exercises, for example an app named Tennis Exercises or a website tennis.example, associated with the topic Sports/Tennis.
• Both caller A and B are present in the context of Greenhouse.
• Only the caller B is present in the context of Tennis exercises.
• Assume that no topics were observed for the user before epoch 1, for the sake of simplification.
• The user visits the Greenhouse app, and callers A and B make a Topics API call to record the user visit to the page or app (see the implementation guide suggested in Next steps to find out how to call the Topics API). This record (a hostname or app data) is later used to derive topics of interest. The Topics API will later mark the topic Home & Garden as observed by both callers A and B.
• The user visits the Tennis exercises app. Only the caller B sends a Topics API request. The Topics API will later mark the topic Sports/Tennis as observed by the caller B.
• By the end of the epoch, the Topics API refreshes the user's top topics and determines the callers that observed these topics based on user activity.
• Later, when the caller B makes another Topics API call, it can get either Home & Garden or Sports/Tennis topic (or, with a 5% chance, a random topic) for this user in the response array.
• Caller A can only access the topic Home & Garden, as it has never observed the topic Sports/Tennis. This means that a third-party will only learn about a user's topic of interest within the specific context (app or website) where it is present.

Derive topics

Topics derives topics of interest from user activity. The topics are selected from a predefined open-source taxonomy. Once per epoch, Topics refreshes the user's top five topics and the callers that observed them during the epoch. The Topics classifier model derives topics from user activity: hostname for a web page visit, app information on Android.

Caller accesses user's topics of interest

The API returns only topics that have been observed by the caller within the most recent three epochs. A maximum of three topics may be returned to a caller,one topic for each of the three recent epochs (if the caller observed topics for that epoch). The returned topics can be used by the caller to supplement any contextual information and can be combined to help find a more relevant ad for the user.

Epochs

The Topics API must ensure that the topics of interest it provides are kept up to date. The topics are inferred for a user based on their activity during a period of time known as an epoch, one week by default. Each user has their own epochs (epochs are "per user") and the initial start time is randomized.

Once each epoch, the Topics API computes the user's top five topics and determines which callers observed those topics using on-device information. The topic selected for each epoch is randomly selected from the user's top five topics for that time period. To further enhance privacy and ensure that all topics may be represented, there is a 5% chance the topic is randomly selected from all possible topics in the taxonomy of interests.

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 par l'utilisateur, sans passer par les identifiants de plusieurs 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'établissement

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 des thèmes 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 à partir des 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) ne 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 les données de votre API Topics avec les partenaires côté acheteur. Il est prévu que l'API Topics complète d'autres signaux (comme les signaux de contexte) afin de 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 définir le 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 doivent collaborer avec leurs partenaires en amont sur la manière dont les thèmes 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 infère des thèmes pour 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 classification. Dans l'implémentation actuelle, Topics utilise les noms d'application et de package pour attribuer des thèmes d'intérêt à une application. Cette fonctionnalité pourra toutefois être étendue à d'autres informations, comme 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 accessibles à tous sur l'application.

• Lorsque le modèle de classificateur est exploité à 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 à l'aide de 540 000 informations sur les applications accessibles au public, libellées manuellement et 17 millions d'informations libellées par l'IA, provenant 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 sans frais 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 dans 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 des 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 accessible au public et peut ê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 gérée par l'humain afin que les thèmes sensibles en soient exclus. Elle sera adaptée aux catégories d'annonces qui peuvent être diffusées dans les applications mobiles 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 au niveau d'une application appelle l'API, la liste des thèmes renvoyés n'inclura que ceux pour lesquels l'appelant figure dans la colonne "Appelants qui peuvent se renseigner sur le sujet" correspondant à ce thème pour cette application et 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. Autrement dit, si une application n'inclut aucun SDK publicitaire qui appelle l'API Topics, les thèmes associés à cette application ne contribuent pas au pool de 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éterminer 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 ad tech enregistrées qui appellent l'API Topics doivent également fournir des clés de chiffrement pour s'assurer que les thèmes renvoyés ne sont lisibles que par l'appelant.

La Privacy Sandbox extrait ces clés à partir du point de terminaison fourni par la technologie publicitaire . Bonnes pratiques : il est recommandé de mettre à jour les clés régulièrement, 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

Implémenter des sujets

Découvrez les détails de l'implémentation et des exemples de code permettant aux appelants d'observer et d'accéder aux sujets.

Contrôle et transparence

Découvrez comment les utilisateurs et les développeurs peuvent gérer et personnaliser l'API Topics en fonction de leurs préférences et de leurs besoins.

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.