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.
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
2- 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
2- 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
1- 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.
1 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é.
2 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.