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. Consultez le guide du développeur pour connaître le cycle de vie complet de l'API Protected Audience, et reportez-vous à la vidéo explicative 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 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 sur l'appareil de l'utilisateur et ne sont partagés avec le fournisseur du navigateur ni avec qui que ce soit d'autre.

Fonctions de l'API

`joinAdInterestGroup()`

La plate-forme côté demande 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é depuis un iFrame (par exemple, à partir d'une DSP), sauf si l'origine du propriétaire du groupe de centres d'intérêt correspond à l'origine 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 visité
Le propriétaire du groupe de centres d'intérêt

Autrement dit, malicious.example ne peut pas appeler joinAdInterestGroup() pour un groupe d'intérêt appartenant à dsp.example.com sans que dsp.example.com ne lui accorde l'autorisation.

Autorisation du site consulté

L'autorisation peut être accordée pour la même origine ou pour plusieurs origines. 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 frame de premier niveau de la page actuelle.

Exemple d'utilisation

L'exemple ci-dessous montre comment 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 Kio. Sinon, l'appel échoue. Le deuxième paramètre indique la durée du groupe d'intérêt, qui est limitée à 30 jours. Les appels successifs écrasent les valeurs précédemment stockées.

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 l'exécution du code JavaScript d'enchères dans le Worklet.
biddingWasmHelperUrl^{1, 2}: Exemple: https://dsp.example/bid/custom-bikes/bid.wasm; Rôle: URL du code WebAssembly généré par biddingLogicUrl.
updateUrl²: Exemple: https://dsp.example/bid/custom-bikes/update; Rôle: URL qui renvoie un fichier JSON pour mettre à jour les attributs du groupe de centres d'intérêt. Pour en savoir plus, consultez 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é-valeur envoyées au service clé-valeur approuvé de l'enchérisseur.
trustedBiddingSignalsKeys: Exemple: ['key1', 'key2' ...]; Rôle: clés des requêtes envoyées au service clé-valeur approuvé.
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 des annonces composées de plusieurs éléments.

¹ Les propriétés biddingLogicUrl et ads sont facultatives, mais obligatoires pour participer à une mise aux enchères. Il peut être utile de créer 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 souhaiter 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 ultérieure, ou son budget publicitaire peut être temporairement épuisé.

² 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 ne sont pas soumises à 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 la suppression d'un navigateur d'un groupe de centres d'intérêt. Le navigateur supprime le groupe de centres d'intérêt de sa liste d'adhésion.

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 du 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 conçues comme des garde-fous et ne doivent pas être atteintes en fonctionnement normal.

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

Comme indiqué dans l'explication publique, étant donné qu'un même groupe de centres d'intérêt peut diffuser plusieurs annonces, il aura la possibilité de définir une nouvelle enchère pour une autre de ses annonces afin qu'il serve d'annonce de remplacement. chaque fois que son choix préféré est inférieur au seuil. Cela signifie qu'une petite annonce spécialisée qui n'atteint pas le seuil de k-anonymat peut tout de même choisir de participer à des enchères. De plus, son groupe de centres d'intérêt a la possibilité de revenir à une annonce plus générique jusqu'à ce que l'annonce plus spécialisée ait une audience suffisamment large.

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

Pour qu'une nouvelle annonce soit diffusée, il vous suffit de l'utiliser pour définir des enchères aux cas 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 k-anon. Il est possible que votre annonce de remplacement ne soit pas "k-anon". Par conséquent, vous pouvez parfois envisager d'enchérir uniquement avec l'annonce de remplacement. Vous pouvez effectuer cette opération 1% du temps, par exemple si ce niveau est suffisant pour vous assurer que le remplacement ne dépasse pas le seuil.

Nous avons récemment discuté d'autres façons de fonctionner. Par conséquent, si vous avez un cas d'utilisation pour lequel ce mécanisme poserait problème, poursuivez la conversation publique sur les moyens d'améliorer l'API.

Toutes les références 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.