Cette page a été traduite par l'API Cloud Translation.

Définir les données d'audience

Découvrez comment définir une audience en créant un groupe de centres d'intérêt à l'aide de l'API Protected Audience. Lisez le guide du développeur pour découvrir le cycle de vie complet de l'API Protected Audience, et reportez-vous à la présentation de l'API Protected Audience pour découvrir en détail comment les navigateurs enregistrent les groupes de centres d'intérêt.

Vous n'êtes pas développeur ? Consultez la présentation de l'API Protected Audience.

Groupes de centres d'intérêt de l'API Protected Audience

Un groupe de centres d'intérêt de l'API Protected Audience représente un groupe de personnes ayant un centre d'intérêt commun, correspondant à une liste de remarketing. Chaque groupe de centres d'intérêt de l'API Protected Audience a un propriétaire.

Les propriétaires de groupes de centres d'intérêt agissent en tant qu'acheteurs dans les enchères publicitaires de l'API Protected Audience. Les groupes de centres d'intérêt sont stockés par le navigateur et sur l'appareil de l'utilisateur. Ils ne sont pas partagés avec le fournisseur du navigateur ni avec qui que ce soit.

Fonctions de l'API

`joinAdInterestGroup()`

La plate-forme côté demande (DSP) de l'annonceur ou l'annonceur lui-même appelle navigator.joinAdInterestGroup() pour demander au navigateur d'ajouter un groupe de centres d'intérêt à sa liste de membres.

L'origine du contexte d'appel pour joinAdInterestGroup() doit correspondre à celle du propriétaire du groupe de centres d'intérêt. joinAdInterestGroup() devra donc être appelé à partir d'un iFrame (par exemple, depuis une DSP), sauf si l'origine du propriétaire du groupe de centres d'intérêt correspond à celle du document actuel (par exemple, un site Web avec ses propres groupes de centres d'intérêt).

joinAdInterestGroup() a besoin de l'autorisation de:

Le site consulté
Le propriétaire du groupe de centres d'intérêt

Cela signifie qu'il n'est pas possible pour malicious.example d'appeler joinAdInterestGroup() pour un groupe de centres d'intérêt appartenant à dsp.example.com sans que dsp.example.com n'accorde l'autorisation.

Autorisation du site consulté

L'autorisation peut être accordée à partir de la même origine ou multi-origine. Par défaut, l'autorisation est accordée pour les appels joinAdInterestGroup() provenant de la même origine que le site consulté, c'est-à-dire de la même origine que le cadre supérieur de la page actuelle.

Exemples d'utilisation

Voici un exemple de la façon dont vous pouvez définir un groupe de centres d'intérêt et demander au navigateur de le rejoindre.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  updateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

La taille de l'objet interestGroup transmis à la fonction ne doit pas dépasser 50 Ko. Sinon, l'appel échouera. Le deuxième paramètre spécifie la durée du groupe de centres d'intérêt, limitée à 30 jours. Les appels successifs écrasent les valeurs stockées précédemment.

Important:Toutes les URL utilisées comme paramètres pour les méthodes de l'API Protected Audience doivent provenir d'origines sécurisées: toutes les ressources doivent être diffusées via des URL HTTPS. La section Utiliser HTTPS pour le développement local explique comment procéder lorsque vous exécutez l'API Protected Audience en local. De plus, biddingLogicUrl, decisionLogicUrl et trustedBiddingSignals nécessitent un en-tête de réponse HTTP X-Allow-FLEDGE: true.

Propriétés obligatoires

Les seules propriétés obligatoires pour les groupes de centres d'intérêt sont owner et name:

Propriété	Exemple	Rôle
`owner`	`https://dsp.example`	Origine du propriétaire du groupe de centres d'intérêt.
`name`	`custom-bikes`	Nom du groupe de centres d'intérêt.

Propriétés facultatives

Les autres propriétés sont facultatives:

biddingLogicUrl^{1, 2}: Exemple: https://dsp.example/bid/custom-bikes/bid.js; Rôle: URL pour le worklet d'exécution JavaScript d'enchères.
biddingWasmHelperUrl^{1, 2}: Exemple: https://dsp.example/bid/custom-bikes/bid.wasm; Rôle: URL pour le code WebAssembly généré à partir de biddingLogicUrl.
updateUrl²: Exemple: https://dsp.example/bid/custom-bikes/update; Rôle: URL qui renvoie au format JSON pour mettre à jour les attributs de groupes de centres d'intérêt. (voir Mettre à jour les données d'audience et actualiser les annonces).
trustedBiddingSignalsUrl²: Exemple: https://dsp.example/trusted/bidding-signals; Rôle: URL de base pour les demandes de clé-valeurs envoyées au service de clés-valeurs approuvé de l'enchérisseur.
trustedBiddingSignalsKeys: Exemple: ['key1', 'key2' ...]; Rôle: clés des requêtes envoyées au service clés-valeurs approuvées.
userBiddingSignals: Exemple: {...}; Rôle: métadonnées supplémentaires que le propriétaire peut utiliser lors des enchères.
ads¹: Exemple: [bikeAd1, bikeAd2, bikeAd3]; Rôle: annonces susceptibles d'être diffusées pour ce groupe de centres d'intérêt.
adComponents: Exemple: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]; Rôle: composants pour les annonces composées de plusieurs éléments.

¹ Les propriétés biddingLogicUrl et ads sont facultatives, mais requises pour participer à une mise aux enchères. Il peut y avoir des cas d'utilisation de la création d'un groupe de centres d'intérêt sans ces propriétés: par exemple, le propriétaire d'un groupe de centres d'intérêt peut vouloir ajouter un navigateur à un groupe de centres d'intérêt pour une campagne qui n'est pas encore diffusée, ou pour une autre utilisation future, ou il peut avoir temporairement épuisé son budget publicitaire.

² Dans l'implémentation actuelle de l'API Protected Audience, biddingLogicUrl, biddingWasmHelperUrl, updateUrl et trustedBiddingSignalsUrl doivent avoir la même origine que le propriétaire. Il ne s'agit peut-être pas d'une contrainte à long terme, et les URL ads et adComponents n'ont pas cette contrainte.

Spécifier des annonces pour un groupe de centres d'intérêt

Les objets ads et adComponents incluent une URL pour une création publicitaire et, éventuellement, des métadonnées arbitraires qui peuvent être utilisées au moment de l'enchère.

Exemple :

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

`leaveAdInterestGroup()`

Le propriétaire d'un groupe de centres d'intérêt peut demander à ce qu'un navigateur soit supprimé de celui-ci. Le navigateur supprime le groupe de centres d'intérêt de sa liste de membres.

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

Si un utilisateur revient sur le site qui a demandé au navigateur d'ajouter un groupe de centres d'intérêt, le propriétaire de ce groupe peut appeler la fonction navigator.leaveAdInterestGroup() pour demander au navigateur de supprimer le groupe de centres d'intérêt.

Le code d'une annonce peut également appeler cette fonction pour son groupe de centres d'intérêt.

Questions fréquentes

Quel est le nombre maximal de groupes de centres d'intérêt par propriétaire de groupe pour un même utilisateur ?

Chrome autorise jusqu'à 1 000 groupes de centres d'intérêt par propriétaire et jusqu'à 1 000 propriétaires de groupes de centres d'intérêt. Ces limites sont des garde-fous et ne doivent pas être atteintes en fonctionnement normal.

Comment maximiser les annonces liées à des groupes de centres d'intérêt qui atteignent les seuils de k-anon ?

Comme l'indique notre explication publique, étant donné qu'un même groupe de centres d'intérêt peut diffuser plusieurs annonces susceptibles d'être diffusées, le groupe aura la possibilité d'en définir une autre pour une autre de ses annonces afin qu'elle devienne une "annonce de remplacement" chaque fois que son choix le plus préféré est inférieur au seuil. Cela signifie qu'une petite annonce spécialisée qui est encore inférieure au seuil de k-anonymat peut tout de même décider de participer à des enchères. De plus, son groupe de centres d'intérêt peut passer à une annonce plus générique jusqu'à ce que l'annonce plus spécialisée dispose d'une audience suffisamment large.

D'un point de vue tactique, vous pouvez envisager ce qui suit:

Pour qu'une nouvelle annonce soit diffusée, commencez simplement par l'utiliser pour définir des enchères là où vous souhaitez qu'elle soit diffusée. Vous n'avez rien d'autre à faire.
Vous pouvez utiliser une annonce de remplacement lorsque les nouvelles annonces ne sont pas de ce type. Il existe un risque que votre annonce de remplacement ne soit pas la même. Par conséquent, vous pouvez parfois envisager de n'enchérir qu'avec cette annonce en premier lieu. Cette méthode peut être utilisée 1% du temps, par exemple si c'est un bon niveau pour vous assurer que la création de remplacement restera au-dessus du seuil.

D'autres façons de fonctionner ont été récemment évoquées. Par conséquent, si vous avez un cas d'utilisation pour lequel ce mécanisme poserait un problème, continuez à vous engager dans la conversation publique sur les façons dont l'API pourrait s'améliorer.

Toutes les documentations de référence de l'API Protected Audience

Des guides de référence de l'API sont disponibles:

Guide du développeur de l'API Protected Audience
Guide des acheteurs d'annonces pour les groupes de centres d'intérêt et la génération d'enchères de l'API Protected Audience
Guide des vendeurs publicitaires pour les enchères publicitaires Protected Audience
Guide sur la création de rapports sur les résultats des enchères
Bonnes pratiques concernant la latence des enchères publicitaires Protected Audience
Résoudre les problèmes liés à Protected Audience

L'article explicatif de l'API Protected Audience fournit également des informations détaillées sur la compatibilité des fonctionnalités et les contraintes.