Les éditeurs diversifient généralement leurs sources de demande d'annonces afin d'optimiser leurs revenus. Ils font appel à plusieurs entreprises (par exemple, des plates-formes côté offre et côté demande, ainsi que des serveurs publicitaires d'éditeurs) pour déterminer la meilleure annonce pour un emplacement publicitaire donné sur la page. Les enchères d'en-tête permettent aux éditeurs de recueillir des enchères pour un emplacement publicitaire auprès de différentes sources de demande. Dans une configuration d'enchères séquentielles, la bibliothèque d'enchères d'en-tête peut être utilisée pour exécuter une enchère avec des données contextuelles, et Protected Audience est utilisé pour exécuter une enchère avec des données multisites.
Avant de commencer, découvrez les principes de base de l'API sur la page Protected Audience et le header bidding dans la documentation Prebid.js.
Définitions
Enchères
| Enchères | Définition |
|---|---|
| Enchères contextuelles | Enchères publicitaires qui utilisent les données disponibles dans le contexte d'exécution des enchères. Une enchère contextuelle peut contenir plusieurs enchères, comme les enchères d'en-tête et les enchères côté serveur. |
| Enchères Protected Audience | Enchères publicitaires impliquant d'enchérir sur un groupe d'intérêt créé sur un autre site. |
| Enchères multivendeurs Protected Audience | Enchères Protected Audience à deux niveaux qui impliquent d'abord plusieurs enchères de composants parallèles, puis l'annonce ayant obtenu le meilleur score est envoyée aux enchères de premier niveau finales. |
| Enchères de premier niveau | Mise aux enchères d'annonces finale dans une enchère multivendeur Protected Audience. Elle fournit le score des enchères gagnantes des enchères de composants. |
| Enchères de composants | Mise aux enchères imbriquée dans une mise aux enchères Protected Audience multivendeur, où chaque vendeur de composants exécute ses mises aux enchères de composants en parallèle. Les annonces ayant obtenu le meilleur score dans chaque enchère de composant sont transmises à l'enchère de premier niveau. |
| Configurer les enchères séquentielles | Configuration d'enchères publicitaires qui intègre des enchères contextuelles à des enchères Protected Audience et détermine un gagnant entre les deux enchères. |
Participants
| Participant | Définition |
|---|---|
| Annonceur | Partie qui souhaite un emplacement publicitaire et crée la création publicitaire. |
| Éditeur | Partie qui fournit l'inventaire publicitaire pour les enchères. |
| Revendeur | Partie qui soumet une offre lors d'une enchère pour acheter l'espace publicitaire d'un vendeur. Il s'agit généralement d'une plate-forme côté demande (DSP). |
| Ad server d'éditeur | Service utilisé par les éditeurs pour gérer et choisir les annonces à diffuser sur le site. Un serveur publicitaire d'éditeur peut combiner ses propres résultats d'enchères, les réponses des header bidders, l'inventaire vendu en direct et plus encore, afin de déterminer l'annonce qui générera le plus de revenus pour un éditeur. Un ad server d'éditeur peut fournir une bibliothèque côté client pour interagir avec le serveur. |
| Vendeur de premier niveau | Partie qui appelle (c'est-à-dire crée) les enchères multivendeurs Protected Audience et participe aux enchères de premier niveau. |
| Vendeur de composants | Partie qui exécute une enchère de composant dans l'enchère multiseller Protected Audience pour vendre l'espace publicitaire de l'éditeur aux acheteurs. Il s'agit généralement d'une plate-forme côté offre (SSP). |
Configurer les enchères séquentielles
Dans une configuration d'enchères séquentielles, les enchères contextuelles sont exécutées en premier, puis les enchères Protected Audience. Cette configuration permet aux éditeurs de maximiser leur potentiel de revenus en organisant une enchère avec les données contextuelles disponibles sur la page, ainsi qu'une enchère avec des données multisites dans un environnement sécurisé pour protéger la confidentialité des utilisateurs.
Une bibliothèque d'enchères d'en-tête peut être exécutée en premier sur la page pour collecter les enchères pour l'enchère contextuelle de l'ad server de l'éditeur. Le prix de l'enchère gagnante ajusté de l'enchère contextuelle peut ensuite être saisi dans l'enchère Protected Audience en tant que prix plancher. Lors de l'étape de notation, le vendeur de premier niveau peut faire passer les prix des offres d'enchères des composants en dessous du prix plancher en leur attribuant un score nul lors du calcul du score de désirabilité. Si aucune enchère de composant Protected Audience n'est supérieure au prix plancher, l'annonce gagnante de l'enchère contextuelle est diffusée à l'utilisateur. Si l'enchère Protected Audience est remportée, cela signifie que l'enchère est supérieure au prix plancher et que l'annonce gagnante Protected Audience est affichée à l'utilisateur.
Dans cet exemple de configuration d'enchères séquentielles, trois enchères majeures peuvent être exécutées sur la page dans l'ordre suivant : 1) enchères contextuelles par la bibliothèque d'enchères d'en-tête, 2) enchères contextuelles par l'ad server de l'éditeur et 3) enchères Protected Audience.
Description détaillée du diagramme :
- Avant l'enchère, l'utilisateur est ajouté à un groupe d'intérêt sur le site d'un annonceur.
- Lorsque l'utilisateur consulte la page de l'éditeur ultérieurement, Prebid.js exécute une enchère contextuelle pour collecter les réponses aux enchères des enchérisseurs d'en-tête. Au cours de cette étape, les acheteurs peuvent fournir les signaux et les vendeurs peuvent fournir les configurations d'enchères de composants à utiliser dans l'enchère Protected Audience suivante. Prebid.js fournit un module permettant de propager ces signaux et configurations à l'enchère Protected Audience.
- Les réponses aux enchères collectées par Prebid.js sont envoyées à l'ad server de l'éditeur pour une mise aux enchères contextuelle côté serveur.
- Le serveur publicitaire de l'éditeur peut combiner ses propres résultats d'enchères, les résultats des enchères d'en-tête, l'inventaire vendu directement et plus encore, afin de déterminer l'annonce qui générera le plus de revenus pour un éditeur. L'annonce gagnante est renvoyée à la bibliothèque côté client de l'ad server de l'éditeur.
- Le prix de l'enchère ajusté du gagnant de l'enchère contextuelle, ainsi que les signaux de l'acheteur (
perBuyerSignals) et les configurations d'enchères de composants du vendeur collectés par Prebid.js peuvent être transmis à l'enchère Protected Audience par la bibliothèque côté client de l'ad server de l'éditeur. - La mise aux enchères multivendeurs Protected Audience est exécutée par le vendeur de premier niveau. Lors de l'étape de notation du vendeur de premier niveau, il peut comparer le prix de l'enchère gagnante de chaque composant au prix de l'enchère gagnante ajusté du contexte. Si le prix de l'enchère du composant est inférieur à celui de l'enchère de l'enchère contextuelle, le vendeur de premier niveau renvoie le score d'attractivité
0. Si toutes les enchères sont évaluées à0, l'appelrunAdAuction()renvoienull, ce qui signifie que l'annonce gagnante de l'enchère contextuelle doit être affichée. - La bibliothèque côté client de l'ad server de l'éditeur affiche l'annonce Protected Audience ou l'annonce contextuelle gagnante, en fonction de ce qui a été renvoyé par l'appel
runAdAuction(). - L'annonce gagnante est affichée à l'utilisateur.
Avant la mise aux enchères
Avant l'enchère, lorsque l'utilisateur consulte la page d'un annonceur, l'acheteur et l'annonceur peuvent définir le groupe d'intérêt du site auquel appartient l'utilisateur, et ajouter des données contextuelles provenant du site de l'annonceur et des données first party à utiliser ultérieurement comme signaux pour l'enchère.
- L'utilisateur accède au site de l'annonceur.
- Le site de l'annonceur charge le script de chaque acheteur participant aux enchères à un moment ultérieur.
- Le script de l'acheteur contient l'appel
joinAdInterestGroup()pour ajouter l'utilisateur au groupe d'intérêt de l'acheteur.
Enchères contextuelles avec Prebid.js et l'ad server de l'éditeur
Dans une configuration d'enchères séquentielles, toutes les enchères contextuelles sont exécutées avant le lancement de l'enchère Protected Audience. Dans la configuration expliquée dans ce document, nous exécutons une enchère contextuelle d'enchères d'en-tête par Prebid.js qui alimente une enchère côté serveur par l'ad server de l'éditeur.
L'éditeur lance d'abord une enchère contextuelle d'enchères d'en-tête en appelant Prebid.js avec un indicateur pour indiquer qu'une enchère Protected Audience sera exécutée par la suite. Prebid.js collecte ensuite les réponses aux enchères et les envoie à l'ad server de l'éditeur pour une mise aux enchères contextuelle côté serveur. Lors de l'étape de collecte des réponses aux enchères, les acheteurs et les vendeurs ont la possibilité de fournir des configurations d'enchères de composants et des signaux d'acheteurs (perBuyerSignals) à utiliser pour l'enchère Protected Audience suivante, s'ils souhaitent y participer. Cette configuration d'enchères de composants sera ensuite transmise à l'enchère Protected Audience suivante.
- Initialisation des enchères contextuelles
L'utilisateur accède à la page de l'éditeur. - La page de l'éditeur charge la bibliothèque côté client du serveur publicitaire de l'éditeur et définit les espaces publicitaires.
- La page de l'éditeur charge Prebid et lance l'enchère contextuelle d'enchères d'en-tête.
- Enchères contextuelles du vendeur A
(exécutées en parallèle des enchères contextuelles du vendeur B)
Prebid.js envoie une demande d'enchère au vendeur A. - Le vendeur A récupère les réponses aux enchères et
perBuyerSignalsdes acheteurs. - Le vendeur A exécute une enchère contextuelle.
- Le vendeur A crée la configuration des enchères de composants avec
perBuyerSignalsinclus. - Le vendeur A répond à Prebid.js avec l'enchère gagnante et la configuration de l'enchère de ses composants.
- Enchères contextuelles du vendeur B
(exécutées en parallèle des enchères contextuelles du vendeur A)
Prebid.js envoie une demande d'enchère au vendeur B. - Le vendeur B récupère les réponses aux enchères et
perBuyerSignalsdes acheteurs. - Le vendeur B exécute une enchère contextuelle.
- Le vendeur B crée la configuration des enchères de composants avec
perBuyerSignalsinclus. - Le vendeur B répond à Prebid.js avec l'enchère gagnante et la configuration de l'enchère de composant.
- Enchères contextuelles de l'ad server de l'éditeur
: les réponses aux enchères collectées par Prebid.js sont envoyées à l'ad server de l'éditeur pour les enchères contextuelles. - Les configurations d'enchères de composants avec les signaux des acheteurs sont partagées avec la bibliothèque côté client du serveur publicitaire de l'éditeur.
- L'ad server de l'éditeur organise une mise aux enchères contextuelle pour déterminer la meilleure annonce parmi les campagnes vendues en direct, les enchères programmatiques, les enchères contextuelles de Prebid et les autres inventaires.
- L'ad server de l'éditeur renvoie l'enchère gagnante ajustée.
Enchères multivendeurs Protected Audience
À ce stade, les enchères contextuelles sont terminées. La bibliothèque côté client de l'ad server de l'éditeur peut transmettre au vendeur de premier niveau le prix d'enchère ajusté gagnant des enchères contextuelles, les configurations des enchères de composants et les signaux des acheteurs participant aux enchères Protected Audience. Le prix de l'enchère contextuelle peut être transmis à la configuration des enchères en tant que signal pour la notation au niveau supérieur des enchères.
Les enchères de composants sont exécutées en parallèle. Dans chaque enchère de composants, le navigateur génère des enchères à partir de la logique d'enchères de chaque acheteur participant à cette enchère de composants, attribue un score à chaque enchère à l'aide de la logique de scoring du vendeur de composants, puis renvoie l'annonce ayant obtenu le score le plus élevé à l'enchère de premier niveau.
- Le site de l'éditeur charge le script du vendeur de premier niveau.
- La bibliothèque côté client de l'ad server de l'éditeur fournit le prix d'enchère de l'enchère contextuelle, les configurations d'enchères de composants avec les signaux des acheteurs au vendeur de premier niveau. Le prix de l'enchère gagnante pour l'annonce contextuelle peut être transmis à la configuration des enchères en tant que signaux du vendeur (ce prix d'enchère devient disponible dans la fonction
scoreAd()du vendeur de premier niveau). - Le vendeur de premier niveau lance les enchères Protected Audience en appelant
runAdAuction(). - Enchères sur les composants du vendeur A
(exécutées en parallèle des enchères sur les composants du vendeur B)
Le navigateur lit les groupes d'intérêt de l'utilisateur pour tous les acheteurs participant aux enchères sur les composants du vendeur A. - Le navigateur récupère les scripts d'enchères et les signaux d'enchères fiables à partir des emplacements spécifiés dans les groupes d'intérêt des acheteurs participant aux enchères de composants.
- Le navigateur génère les enchères en exécutant la logique de génération d'enchères de chaque acheteur.
- Le navigateur récupère le script de notation et les signaux de notation fiables de chaque annonce du vendeur A.
- Le navigateur exécute la logique de scoring du vendeur A pour chaque enchère.
- Le navigateur choisit l'annonce ayant obtenu le score le plus élevé selon la logique de notation du marchand A.
- Enchères de composants du vendeur B
(exécutées en parallèle des enchères de composants du vendeur A)
Le navigateur lit les groupes d'intérêt de l'utilisateur pour tous les acheteurs participant aux enchères de composants du vendeur B. - Le navigateur récupère les scripts d'enchères et les signaux d'enchères fiables à partir des emplacements spécifiés dans les groupes d'intérêt des acheteurs participant aux enchères de composants.
- Le navigateur génère les enchères en exécutant la logique de génération d'enchères de chaque acheteur.
- Le navigateur récupère le script de scoring et les signaux de scoring fiables de chaque annonce du vendeur B.
- Le navigateur exécute la logique de scoring du vendeur B pour chaque enchère.
- Le navigateur choisit l'annonce ayant obtenu le score le plus élevé selon la logique de notation du vendeur B.
Évaluation des enchères et rendu des annonces de premier niveau
Une fois les enchères de composants de la section précédente exécutées, le navigateur exécute la logique de scoring du vendeur de premier niveau sur l'annonce gagnante de chaque enchère de composants. Dans la fonction scoreAd() du vendeur de premier niveau, le prix de l'enchère ajusté en fonction du contexte peut être disponible sous la forme sellerSignals. La logique de scoring peut comparer ce prix de l'enchère contextuelle au prix de l'enchère gagnante de l'enchère de composants Protected Audience.
Si le prix de l'enchère gagnante de l'enchère contextuelle est supérieur à celui de l'enchère de composant, la fonction scoreAd() peut renvoyer un score de désirabilité de 0. S'il n'existe aucune annonce dont le score de désirabilité est supérieur à 0, cela signifie que l'annonce gagnante de l'enchère contextuelle est plus intéressante que les annonces gagnantes des enchères de composants. La fonction runAdAuction() renvoie alors null.
Si les enchères Protected Audience n'ont aucun gagnant et renvoient null, la bibliothèque côté client de l'ad server de l'éditeur peut afficher le gagnant des enchères contextuelles dans un iFrame. Si l'enchère Protected Audience remporte la mise face à l'enchère contextuelle et renvoie un objet FencedFrameConfig ou un URN opaque, l'annonce gagnante de l'enchère Protected Audience peut être affichée dans un cadre clôturé ou un iFrame.
- Évaluation des annonces aux enchères de premier niveau
Le navigateur récupère le script d'évaluation auprès du vendeur de premier niveau, ainsi que les signaux d'évaluation fiables de chaque annonce. - Le navigateur exécute la logique de scoring du vendeur de premier niveau pour chaque enchère gagnante de toutes les enchères de composants. Dans le script
scoreAd()du vendeur de premier niveau, la logique a accès au prix de l'enchère gagnante ajusté en fonction du contexte, qui peut avoir été transmis en tant quesellerSignalsdans la configuration des enchères. Le script peut comparer le prix de l'enchère contextuelle gagnante avec le prix de l'enchère Protected Audience du composant et renvoyer un score de désirabilité de 0 si le prix contextuel est plus élevé. Sinon, le script calcule le score de désirabilité, probablement en fonction du prix d'enchère du composant Protected Audience. - Le navigateur choisit l'annonce ayant le score de désirabilité le plus élevé parmi celles envoyées par la logique de scoring du vendeur de premier niveau.
- Si l'enchère Protected Audience est remportée
L'enchère Protected Audience renvoie un objetFencedFrameConfigou un URN opaque à la bibliothèque côté client du serveur publicitaire de l'éditeur. - La bibliothèque côté client définit l'attribut
configdu frame clôturé sur l'objetFencedFrameConfigou définit l'attributsrcde l'iframe sur l'URN opaque de l'annonce Protected Audience gagnante. - Le navigateur récupère l'annonce gagnante des enchères Protected Audience auprès de l'acheteur.
- Le navigateur affiche l'annonce à l'utilisateur.
- Si l'enchère contextuelle est remportée :
l'enchère Protected Audience renvoienull. - Le navigateur définit l'attribut
srcde l'iFrame sur l'annonce contextuelle gagnante. - Le navigateur récupère l'annonce gagnante de l'enchère contextuelle auprès de l'acheteur.
- Le navigateur affiche l'annonce à l'utilisateur.
Interagir et envoyer des commentaires
Étape suivante
Nous souhaitons discuter avec vous d'une API adaptée à tous les utilisateurs.
Discuter de l'API
Comme d'autres API de la Privacy Sandbox, cette API est documentée et consultée publiquement.
Tester l'API
Vous pouvez tester l'API Protected Audience et y participer.