For the complete documentation index, see llms.txt. This page is also available as Markdown.

Demande d'enchère Open RTB 2.5

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.5

  • En-tête HTTP Keep-Alive : Connection: Keep-Alive

  • JSON du contenu : Content-Type : application/json

  • En-tête d'encodage des données : Accept-Encoding

Demande d'enchère 2.5

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.

Attribut
Description

id

ID unique de la requête d'enchère (chaîne)

site

Détails via un objet Site sur le site web de l'éditeur (objet)

device

Détails de l'appareil de l'utilisateur auquel l'impression sera diffusée (objet)

user

Détails de l'utilisateur humain de l'appareil ; l'audience publicitaire (objet)

imp

Détails de l'emplacement publicitaire ou de l'impression mis aux enchères (objet)

regs

Détails de toute réglementation sectorielle, juridique ou gouvernementale en vigueur pour cette requête (objet)

ext

Espace réservé pour les extensions d'OpenRTB (objet)

site

Attribut
Description

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é aux extensions spécifiques à l’exchange (objet)

site.ext

Attribut
Description

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)

device

Attribut
Description

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

Emplacement de l'appareil supposé être la position actuelle de l'utilisateur, défini par un objet Geo

ip

Adresse IPv4 de l'utilisateur (chaîne)*

ipv6

Adresse IPv6 de l'utilisateur (chaîne)*

language

Langue du navigateur (chaîne)

os

Système d'exploitation (chaîne)

js

Prise en charge de JavaScript, où 0 = non, 1 = oui (entier)

ext

Emplacement réservé aux extensions spécifiques à l'échange d'OpenRTB (objet)

*Exactement l'une des valeurs ip ou ipv6 sera présente dans la requête d'enchère.

device.geo

Attribut
Description

country

Code pays ISO3

ipservice

Service ou fournisseur utilisé pour déterminer la géolocalisation à partir de l'adresse IP, le cas échéant (entier)

device.ext

Attribut
Description

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.

Attribut
Description

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

Attribut
Description

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

Attribut
Description

id

ID utilisateur unique (chaîne)

user.ext

Attribut
Description

consent

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
Description

ext

Espace réservé pour les extensions spécifiques à l'échange d'OpenRTB.

regs.ext

Attribut
Description

gdpr

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.

imp

Attribut
Description

id

Un identifiant unique pour cette impression dans le contexte de la demande d'enchère (chaîne)

instl

1 = la publicité est interstitielle ou plein écran, 0 = non interstitielle (entier)

video

Détails via un objet Video représentant une impression vidéo in-stream

secure

Indicateur signalant si l'impression nécessite une URL HTTPS sécurisée (entier)

ext

Emplacement réservé aux extensions spécifiques à l'échange d'OpenRTB (objet)

imp.video

Attribut
Description

mimes

Types MIME de contenu pris en charge (p. ex. « video/mp4 ») (tableau de chaînes )

minduration

Durée minimale de la publicité vidéo en secondes (entier)

maxduration

Durée maximale de la publicité vidéo en secondes (entier)

protocols

Tableau des protocoles vidéo pris en charge (entier)

linearity

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

Indique si le letterboxing d'un contenu 4:3 dans une fenêtre 16:9 est autorisé, où 0 = non, 1 = oui (entier)

pos

Position de l'annonce à l'écran (entier)

h

Largeur du lecteur vidéo en pixels indépendants de l'appareil (DIPS) (entier)

w

Hauteur du lecteur vidéo en pixels indépendants de l'appareil (DIPS) (entier)

ext

Emplacement réservé aux extensions spécifiques à l'échange d'OpenRTB (objet)

imp.video.ext

Attribut
Description

zone_type

Type de zone dans les formats publicitaires d'ExoClick (par ex. : video_slider)

Mis à jour

Ce contenu vous a-t-il été utile ?