Requête d'enchère Open RTB 2.4
Cette page décrit les différents composants des requêtes RTB que vous recevrez afin d'enchérir.
En-têtes de la requête d'enchère
En-tête HTTP de version OpenRTB:
x-openrtb-version: 2.4En-tête HTTP Keep-Alive:
Connection: Keep-AliveJSON du contenu:
Content-Type: application/jsonEn-tête d'encodage des données:
Accept-Encoding
Objet de requête d'enchère
Lors de la demande d'enchères pour un contexte spécifique, la plateforme effectuera une requête HTTP avec un délai d'attente de 300 ms et enverra dans le corps de la requête l'objet suivant encodé en JSON. HTTP est recommandé en raison de la latence supplémentaire lors de l'utilisation de HTTPS.
à
Type d'enchère, premier prix = 1 (int)
id
ID unique de la requête d'enchère (chaîne)
imp
Objet représentant l'impression proposée (objet).
site
Détails via un objet Site sur le site web de l'éditeur (objet).
device
Détails via un objet Device sur l'appareil de l'utilisateur auquel l'impression sera diffusée (objet).
user
Détails via un objet User sur l'utilisateur humain de l'appareil ; l'audience publicitaire (objet).
ext
Espace réservé pour les extensions spécifiques à l'échange.
imp
id
ID unique de l'impression dans cette requête d'enchère (chaîne)
bidfloor
Enchère minimale pour cette impression (CPM) / clic (CPC) et devise du compte, facultatif (float).
bidfloorcur
Devise de la valeur d'enchère minimale spécifiée à l'aide des codes alphabétiques ISO-4217, facultatif (chaîne)
native
Un objet Native ; requis si cette impression est proposée comme opportunité de publicité native (objet).
banner
Un objet banner ; requis si cette impression est proposée comme opportunité de bannière publicitaire (objet).
instl
Un objet interstitiel ; requis si cette impression est proposée comme opportunité publicitaire interstitielle ou popunder (objet).(objet).
secure
Indicateur précisant si l'impression nécessite des ressources créatives et un balisage URL HTTPS sécurisés, où 0 = non sécurisé, 1 = sécurisé. S'il est omis, l'état de sécurité est inconnu, mais le support de HTTP non sécurisé peut être supposé, facultatif (entier)
el
E-mail encodé en Base64 (chaîne)
imp.banner
w
Largeur de la bannière en pixels (entier).
h
Hauteur de la bannière en pixels (entier).
mimes
Types MIME pris en charge. Valeurs d'exemple : image/jpg, image/png, video/mp4, image/webp.
imp.instl
instl
Indicateur précisant si l'annonce est popunder/interstitielle (entier) : 1=vrai, 0=faux
imp.native (Native et notifications push)
request
Charge utile de la requête conforme à la spécification de publicité native - un chaîne encodée en JSON de la requête Native Ads incluant son native objet de niveau supérieur (objet JSON)
ver
Version de l'API Dynamic Native Ads à laquelle request est conforme (chaîne)
imp.native.request
ver
Version du balisage natif utilisée (chaîne)
context
Le contexte dans lequel l'annonce apparaît. Dans ce cas, il s'agit de 1 (un contexte centré sur le contenu tel qu'un fil d'actualité, un article, une galerie d'images, une galerie vidéo ou similaire), facultatif (entier)
plcmttype
La conception/le format/la disposition de l'unité publicitaire proposée. Actuellement, nous prenons en charge 4 (Widget de recommandation) et 500 (Push Notification) (entier)
plcmtcnt
Le nombre d'emplacements identiques dans cette mise en page (entier)
assets
Un tableau de objets Asset. Toute réponse d'enchère doit respecter le tableau d'éléments exprimé dans la requête d'enchère (tableau d'objets JSON)
seq
0 pour la première annonce, 1 pour la deuxième, et ainsi de suite. Notez que cela ne serait généralement PAS utilisé en combinaison avec plcmtcnt - soit vous enchérissez sur plusieurs emplacements identiques (dans ce cas plcmtcnt>1, seq=0), soit vous organisez des enchères séparées pour des éléments distincts du flux (dans ce cas plcmtcnt=1, seq=>=1)
imp.native.request.assets
id
ID d'actif unique, attribué par l'échange. Généralement un compteur pour le tableau (entier)
required
Défini sur 1 si l'actif est requis ou 0 si l'actif est facultatif** (entier)
plcmtcnt
Le nombre d'emplacements identiques dans cette mise en page (entier)
img
Objet Image pour les actifs d'image* (objet JSON)
title
Objet Titre pour les actifs de titre* (objet JSON)
data
Objet Data pour le nom de la marque, la description, les notes, les prix, etc.* (objet JSON)
video
Objet Vidéo pour les actifs vidéo. Voir la définition de l'objet de requête Video. Notez que les publicités vidéo in-stream (c.-à-d. pré-roll, etc.) ne font pas partie du format Native. Les publicités natives peuvent contenir une vidéo comme créatif publicitaire lui-même (objet).
* Un seul des objets {img, title, data} doit être présent dans chaque objet d'actif
** Les actifs sont signalés comme requis selon la configuration de la zone de l'éditeur où votre annonce peut être affichée
imp.native.request.assets.img
type
ID du type d'élément image pris en charge par l'éditeur. Nous prenons en charge : 1 (Image d'icône) (entier), 3 (Aperçu de grande image pour l'annonce) (entier)
w
Largeur de l'image en pixels, facultatif (entier)
h
Hauteur de l'image en pixels, facultatif (entier)
wmin
Largeur minimale demandée de l'image en pixels (entier)
hmin
Hauteur minimale demandée de l'image en pixels (entier)
imp.native.request.assets.title
len
Longueur maximale du texte dans l'élément de titre. (entier)
imp.native.request.assets.video
mimes
Liste des types MIME pris en charge (tableau de chaînes).
minduration
Durée minimale de l'annonce vidéo en secondes (entier).
maxduration
Durée maximale de l'annonce vidéo en secondes (entier).
protocols
Liste des protocoles de réponse aux enchères vidéo pris en charge (tableau d'entiers).
linearity
Indique si l'impression doit être linéaire, non linéaire, etc. (entier).
boxingallowed
Indique si le letter-boxing d'un contenu 4:3 dans une fenêtre 16:9 est autorisé (entier).
imp.native.request.assets.data
type
ID de type de l'élément pris en charge par l'éditeur (entier). Nous prenons en charge : 1 (sponsored - message « Sponsorisé par » où la réponse doit contenir le nom de la marque du sponsor), 2 (desc - texte descriptif associé au produit ou au service annoncé)
len
Longueur maximale du texte dans la réponse de l'élément (entier)
imp.video
mimes
Liste des types mime pris en charge (tableau de chaînes)
protocols
Liste des protocoles de réponse aux enchères vidéo pris en charge (tableau d'entiers)
skip
Indique si le lecteur permettra de sauter la vidéo, où 0 = non, 1 = oui
skipafter
Nombre de secondes pendant lesquelles une vidéo doit être lue avant que le saut ne soit activé ; applicable uniquement si l'annonce est skippable
skipmin
Les vidéos dont la durée totale est supérieure à ce nombre de secondes peuvent être skippables ; applicable uniquement si l'annonce est skippable
Si l'éditeur fournit « skip » dans la requête mais pas « skipafter », la vidéo sera skippable après 5 secondes. La réponse définira « skipoffset » sur 5. Si l'éditeur fournit « skip » mais pas « skipmin », la vidéo sera skippable quelle que soit sa durée.
site
id*
ID unique du site (chaîne)
domain*
Nom de domaine du site (chaîne)
cat
ID de catégorie IAB (tableau de chaînes)
page
URL complète de la page où l'annonce sera affichée (chaîne)
keywords
Les mots-clés peuvent être utilisés pour garantir que les zones publicitaires reçoivent le bon type de publicité. Les mots-clés doivent être une chaîne de mots séparés par des virgules
ext
Espace réservé pour les extensions spécifiques à l'échange d'OpenRTB.
*Ces attributs sont obligatoires pour les formats Direct Link et Email Clicks.
site.ext
exchangecat
ID de catégorie ExoClick personnalisé (entier)
idzone
ID de zone publicitaire ExoClick personnalisé (entier)
keyword
Mot-clé correspondant, le cas échéant (chaîne)
L'attribut idzone est utilisé pour identifier la source dans ExoClick d'où provient le trafic.
device
ua
Agent utilisateur du navigateur (chaîne)
sua
Informations structurées sur l'agent utilisateur, pouvant être utilisées lorsqu'un client prend en charge les User-Agent Client Hints (objet)
geo
Localisation de l'appareil supposée être la localisation actuelle de l'utilisateur, définie par un objet Geo.
ip
Adresse IP de l'utilisateur (chaîne)*
ipv6
Adresse IPv6 de l'utilisateur (chaîne)*
language
Langue du navigateur utilisant ISO-639-1 alpha-2 (chaîne)
os
Système d'exploitation (chaîne)
js
Prise en charge de JavaScript, où 0 = non, 1 = oui (entier)
ext
Espace réservé pour les extensions spécifiques à l'échange d'OpenRTB
*Exactement l'une des valeurs ip ou ipv6 sera présente dans la requête d'enchère.
device.geo
country
Code pays ISO3
device.ext
remote_addr
Adresse IP principale de l'utilisateur (chaîne)
x_forwarded_for
Adresse IP X-FORWARDED-FOR de l'utilisateur ou vide si non définie (chaîne)
device.sua
Informations structurées sur l'agent utilisateur. device.sua est considérée comme la représentation la plus précise des attributs de l'appareil.
browsers
Envoyer les marques et versions dérivées de l'en-tête Sec-CH-UA-Full-Version-List. (Tableau de BrandVersion objets)
platform
Envoyer une marque dérivée de l'en-tête Sec-CH-UA-Platform, et une version dérivée de l'en-tête Sec-CH-UA-Platform-Version. (BrandVersion Objet)
mobile
Dérivez cette valeur à partir de l'en-tête Sec-CH-UA-Mobile. (entier)
architecture
Récupérez cette valeur à partir de l'en-tête Sec-CH-UA-Arch. (chaîne)
bitness
Récupérez cette valeur à partir de l'en-tête Sec-CH-UA-Bitness. (chaîne)
model
Récupérez cette valeur à partir de l'en-tête Sec-CH-UA-Model. (chaîne)
source
La source des données utilisées pour créer cet objet, Liste : source de l'agent utilisateur dans AdCOM 1.0 (entier ; valeur par défaut 0)
device.sua.browsers | device.sua.platform
brand
La valeur peut provenir des en-têtes User-Agent Client Hints, représentant soit la marque de l'agent utilisateur (à partir de l'en-tête Sec-CH-UA-Full-Version) soit la marque de la plateforme (à partir de l'en-tête Sec-CH-UA-Platform). (chaîne)
version
Une séquence de composants de version, dans l'ordre hiérarchique décroissant [majeur, mineur, micro, …] (tableau de chaînes)
user
id
ID utilisateur unique (chaîne)
ext
sub
Non
Le sub sera un nombre entier représentant l'ID de la zone d'où la requête a été initialement envoyée.
regs.ext
dsaapply
Indicateur précisant si la DSA s'applique à la requête. 1 = requis (int)
dsa
Extension pour les informations de transparence DSA (objet)
regs.ext.dsa
required
Indicateur précisant si les informations DSA doivent être mises à disposition. 0 = non requis, 1 = pris en charge, les réponses d'enchère avec ou sans objet DSA seront acceptées, 2 = requis, les réponses d'enchère sans objet DSA ne seront pas acceptées, 3 = requis, les réponses d'enchère sans objet DSA ne seront pas acceptées, l'éditeur est une plateforme en ligne (int)
datatopub
L'éditeur peut avoir besoin des données de transparence à des fins d'audit. 0 = ne pas envoyer les données de transparence, 1 = facultatif d'envoyer les données de transparence, 2 = envoyer les données de transparence (int)
Si vous recevez dsaapply: 1 et required: 2 or 3, il est obligatoire d'ajouter dans la réponse des attributs dsa avec des valeurs, sinon la réponse sera rejetée.
Exemples
Vous pouvez trouver une liste complète de tous les types de requêtes que vous pouvez recevoir dans notre page d'exemple de requête Advertiser.
Mis à jour
Ce contenu vous a-t-il été utile ?