Demande d'enchère Open RTB 2.5

Cette page explique comment effectuer des demandes d'enchères.

En-têtes de demande d'enchère suggérés

• En-tête HTTP de version OpenRTB : x-openrtb-version: 2.5
• En-tête HTTP Keep-Alive : Connection: Keep-Alive
• JSON du contenu : Content-Type: application/json

Les objets suivants doivent être envoyés encodés en JSON dans le corps de la requête :

Objet de requête d'enchère

Attribut	Obligatoire ?	Description
à	Oui	Type d'enchère, premier prix = 1 (int)
id	Oui	ID unique de la requête d'enchère (chaîne)
imp	Oui	Tableau d'objets Imp représentant les impressions proposées (objet).
site	Oui	Détails sur le site web de l'éditeur (objet).
app	Oui	Détails sur l'application de l'éditeur (objet).
device	Oui	Détails sur l'appareil de l'utilisateur auquel l'impression sera diffusée (objet).
user	Non	Détails sur l'utilisateur humain de l'appareil ; l'audience publicitaire (objet).
ext	Non	Emplacement réservé aux extensions d'OpenRTB.

Un seul des objets {site, app} doit être présent dans chaque requête.

imp

Attribut	Obligatoire ?	Description
id	Oui	ID unique de l'impression dans cette requête d'enchère (chaîne)
bidfloor	Non	Offre minimale pour cette impression (CPM) / clic (CPC) et devise du compte (nombre à virgule flottante).
banner	Uniquement pour les impressions pleine page	Un objet bannière (objet).
secure	Non ; recommandé 1	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)

imp.banner

Attribut	Obligatoire ?	Description
w	Oui	Largeur de la bannière (entier)
h	Oui	Hauteur de la bannière (entier)
mimes	Oui	Types MIME - image/jpg, image/png, video/mp4 ou image/webp

imp.video

Attribut	Obligatoire ?	Description
mimes	Oui	Types MIME de contenu pris en charge (par ex. « video/mp4 ») (tableau de chaînes)
minduration	Non	Durée minimale de la publicité vidéo en secondes (entier)
maxduration	Non	Durée maximale de la publicité vidéo en secondes (entier)
protocols	Non	Tableau des protocoles vidéo pris en charge (entier)
linearity	Non	Indique si l'impression doit être linéaire, non linéaire, etc. Si rien n'est spécifié, supposez que tout est autorisé (entier)
boxingallowed	Non	Indique si le letterboxing d'un contenu 4:3 dans une fenêtre 16:9 est autorisé, où 0 = non, 1 = oui (entier)
pos	Non	Position de l'annonce à l'écran (entier)
h	Non	Largeur du lecteur vidéo en pixels indépendants de l'appareil (DIPS) (entier)
w	Non	Hauteur du lecteur vidéo en pixels indépendants de l'appareil (DIPS) (entier)
ext	Non	Emplacement réservé aux extensions spécifiques à l'échange d'OpenRTB (objet)

imp.video.ext

Attribut	Obligatoire ?	Description
zone_type	Non	Type de zone dans les formats publicitaires d'ExoClick (par ex. : video_slider)
cta	Non	Indique si la zone publicitaire affiche un composant CTA (entier)

site

Attribut	Obligatoire ?	Description
id	Recommandé	ID unique du site (chaîne)
name	Non	Nom du site (chaîne)
domain	Recommandé	Nom de domaine du site (chaîne)
cat	Non	ID de catégorie IAB (tableau de chaînes)
page	Recommandé	URL complète de la page où l'annonce sera affichée (chaîne)
keywords	Non	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

site.ext

Attribut	Obligatoire ?	Description
exchangecat	Non	ID de catégorie ExoClick personnalisé (entier)
idzone	Non	ID de zone ExoClick personnalisé (entier)

app

Attribut	Obligatoire ?	Description
id	Recommandé	ID d'application unique (chaîne)
name	Non	Nom de l'application (chaîne)
domain	Recommandé	Nom de domaine de l'application (chaîne)
cat	Non	ID de catégorie IAB (tableau de chaînes)
keywords	Non	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 (chaîne)
publisher	Non	Détails sur l'éditeur (objet)

device

Attribut	Obligatoire ?	Description
ua	Oui	Agent utilisateur du navigateur (chaîne)
sua	Non	Informations structurées sur l'agent utilisateur, pouvant être utilisées lorsqu'un client prend en charge les User-Agent Client Hints (objet)
geo	Non	Localisation de l'appareil supposée être la localisation actuelle de l'utilisateur, définie par un objet Geo.
ip	Oui	Adresse IPv4 de l'utilisateur (chaîne)*
ipv6	Oui	Adresse IPv6 de l'utilisateur (chaîne)*
language	Recommandé	Langue du navigateur (chaîne)
os	Non	Système d'exploitation (chaîne)
js	Non	Prise en charge de JavaScript, où 0 = non, 1 = oui (entier)
ext	Non	Espace réservé pour les extensions spécifiques à l'échange d'OpenRTB

Vous devez inclure soit ip soit ipv6 dans votre requête, pas les deux. Si vous utilisez ipv6, supprimez l'attribut ip, et vice versa. Inclure les deux peut provoquer des erreurs.

device.geo

Attribut	Obligatoire ?	Description
country	Non	Code pays ISO3

device.ext

Attribut	Obligatoire ?	Description
remote_addr	Non	Adresse IP principale de l'utilisateur (chaîne)
x_forwarded_for	Non	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.

Attribut	Obligatoire ?	Description
browsers	Recommandé	Les implémenteurs doivent envoyer les marques et versions dérivées de l'en-tête Sec-CH-UA-Full-Version-List. (Tableau de BrandVersion objets)
platform	Recommandé	Les implémenteurs doivent 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	Recommandé	Les implémenteurs doivent dériver cette valeur de l'en-tête Sec-CH-UA-Mobile. (entier)
architecture	Recommandé	Les implémenteurs doivent récupérer cette valeur à partir de l'en-tête Sec-CH-UA-Arch. (chaîne)
bitness	Recommandé	Les implémenteurs doivent récupérer cette valeur à partir de l'en-tête Sec-CH-UA-Bitness. (chaîne)
model	Recommandé	Les implémenteurs doivent récupérer cette valeur à partir de l'en-tête Sec-CH-UA-Model. (chaîne)
source	Recommandé	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

Attribut	Obligatoire ?	Description
brand	Requis	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	Recommandé	Une séquence de composants de version, dans l'ordre hiérarchique décroissant [majeur, mineur, micro, …] (tableau de chaînes)

user

Attribut	Obligatoire ?	Description
id	Non	ID utilisateur unique (chaîne)
ext	Non	Emplacement réservé aux extensions spécifiques à l'échange d'OpenRTB (objet)

user.ext

Attribut	Obligatoire ?	Description
consent	Non	Il s'agit de la chaîne de consentement requise par les normes IAB. Consentement négatif uniquement pour le moment (chaîne)

regs

Attribut	Obligatoire ?	Description
ext	Non	Emplacement réservé aux extensions spécifiques à l'échange d'OpenRTB (objet)

regs.ext

Attribut	Obligatoire ?	Description
gdpr	Non	C'est 0 si l'appelant estime que l'utilisateur n'est pas soumis au RGPD, et 1 si l'utilisateur est soumis au RGPD. Dans le cas contraire, ce paramètre sera indéfini.

ext

Attribut	Obligatoire ?	Description
sub	Non	Le Sub ID. Il doit s'agir d'un nombre de un à dix chiffres : n'utilisez pas de zéros au début des Sub IDs.