API Topics : guide d'intégration

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

L'API Topics pour Android est conçue pour prendre en charge la publicité ciblée par centres d'intérêt sans passer par les identifiants de plusieurs applications.

Les annonceurs s'efforcent de diffuser des annonces pertinentes correspondant aux centres d'intérêt des utilisateurs. Par exemple, un passionné de cuisine a plus de chances d'être interpellé par des annonces liées au monde culinaire que par des annonces qui n'ont aucun rapport avec ses centres d'intérêt.

La publicité ciblée par centres d'intérêt (également appelée IBA) est une forme de publicité personnalisée dans laquelle les annonces sont sélectionnées en fonction des centres d'intérêt de l'utilisateur. Avec la Privacy Sandbox sur Android, ces centres d'intérêt sont déduits des applications avec lesquelles l'utilisateur a interagi. Cette approche est différente de la publicité contextuelle, qui repose uniquement sur les centres d'intérêt dérivés du contenu actuellement consulté. La publicité ciblée par centres d'intérêt permet aux applications de diffuser des annonces plus pertinentes et intéressantes que les annonces contextuelles.

La publicité ciblée par centres d'intérêt implique généralement une communication entre les applications, les vendeurs et les acheteurs. Ce guide est destiné à toutes ces parties, y compris aux réseaux et aux AdTechs à la fois acheteurs et vendeurs.

L'API Topics déduit des signaux précis relatifs aux centres d'intérêt sur l'appareil à partir de l'utilisation de l'application. Ces signaux, appelés thèmes, sont partagés avec les annonceurs afin de faciliter les annonces ciblées par centres d'intérêt, sans suivre les utilisateurs individuels entre les applications.

Lorsque vous implémentez la publicité ciblée par centres d'intérêt avec l'API Topics, vous devez tenir compte d'un certain nombre de points généraux importants :

  • L'inférence des centres d'intérêt de l'utilisateur est traitée sur l'appareil : les informations de l'utilisateur concernant les applications installées sur son appareil restent sur celui-ci, protégeant ainsi la confidentialité. Ce modèle diffère du modèle couramment utilisé actuellement qui consiste à envoyer et traiter les données de plusieurs applications d'un utilisateur hors de l'appareil, sur des serveurs de technologie publicitaire. Certains types de traitements continueront à être réalisés sur les serveurs de technologie publicitaire, comme l'utilisation des signaux fournis par l'API Topics dans les modèles de personnalisation et d'optimisation pour la sélection des annonces.

  • Les acheteurs et les annonceurs dépendent du côté vente : 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 1 epoch.

Terminologie

  • Annonceur : entreprise qui interagit avec les utilisateurs via l'achat d'un inventaire publicitaire.
  • Éditeur : entreprise qui vend un inventaire publicitaire disponible, avec son contenu.
  • Acheteur (ou côté achat) : société AdTech qui aide les annonceurs à acheter des inventaires publicitaires.
  • Vendeur (ou côté vente) : société AdTech qui aide les éditeurs à vendre des inventaires publicitaires.
  • Réseau : société AdTech agissant à la fois en tant qu'acheteur et que vendeur.
  • Détenue et gérée : entreprise agissant en tant qu'éditeur, vendeur et acheteur.

Objectifs

Si la publicité ciblée par centres d'intérêt est importante pour votre entreprise, nous souhaitons que vous disposiez d'une version de l'API Topics qui fonctionne pour les cas d'utilisation de votre application. Nous pourrons ainsi recueillir vos commentaires et vous permettre d'améliorer l'API. Nous voulons nous assurer que vous êtes en mesure de résoudre les problèmes de conception et de développement pour être prêt à obtenir des thèmes lors du lancement de la version bêta.

À l'heure actuelle, les objectifs de la planification de l'intégration pour la Privacy Sandbox dans la preview développeur d'Android sont les suivants :

Pour toutes les AdTechs

  • Possibilité de consulter la classification des thèmes et d'envoyer des commentaires sur les thèmes inclus
  • 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 AdTech à la Privacy Sandbox

Pour les AdTechs côté vente

  • Possibilité de devenir un observateur pour établir une empreinte de l'API Topics. L'API Topics est 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, les applications doivent appeler l'API 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 AdTechs 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.

Prérequis et configuration

Les développeurs d'applications, les vendeurs et les acheteurs doivent suivre ces étapes pour configurer l'utilisation de l'API Topics.

Se familiariser avec l'API

  1. Commencez par lire la proposition de conception pour vous familiariser avec l'API Topics et ses fonctionnalités.
  2. Consultez le guide du développeur pour découvrir comment intégrer le code et les appels d'API dont vous avez besoin pour vos cas d'utilisation.
  3. Lisez la classification et envoyez vos commentaires sur les thèmes inclus dans la liste.
  4. Envoyez des commentaires sur la proposition de conception ou la documentation.
  5. Inscrivez-vous pour recevoir des informations sur l'API Topics. Vous serez ainsi notifié en cas d'ajout de fonctionnalités dans les futures versions.

Configurer et tester l'application exemple

  1. Suivez les instructions de cette page pour configurer la Privacy Sandbox sur le SDK Android dans Android Studio.
  2. Dupliquez et exécutez le code dans la version Java ou Kotlin de l'application exemple pour vous familiariser avec la récupération des thèmes sur un appareil.
  3. Lors des tests, testez plusieurs noms et descriptions pour l'application, afin de modifier les thèmes renvoyés par le classificateur sur l'appareil.
  4. Une fois que vous avez compris comment fonctionnent l'API cliente et les classifications sur l'appareil, aidez-vous de l'application exemple pour réaliser votre propre intégration.

Conseil : Examinez attentivement l'utilité des données sur les thèmes renvoyées pour votre application. Identifiez les manières d'améliorer la classification, et envoyez des commentaires si vous avez des recommandations sur la façon d'améliorer la classification.