Cette page décrit les différents éléments des demandes RTB que vous recevrez pour enchérir.
En-têtes de l'appel d'offres
- OpenRTB Version HTTP Header: x-openrtb-version : 2.5
- Keep-Alive HTTP Header: Connection : Keep-Alive
- Contenu JSON : Content-Type: application/json
- En-tête de codage des données: Accept-Encoding
Appel d'offres 2.5
Lors de la demande d'offres pour un contexte spécifique, la plateforme effectuera une requête HTTP avec un délai d'attente de 300ms et enverra l'objet suivant encodé en JSON dans le corps de la requête. Il est recommandé d'utiliser le protocole HTTP en raison du temps de latence supplémentaire lors de l'utilisation du protocole HTTPS.
| Attribut | Description |
|---|
| id | ID unique de l'appel d'offres (chaîne de caractères) |
| site | Détails via un objet Site sur le site web de l'éditeur (objet) |
| dispositif | Détails de l'appareil de l'utilisateur auquel l'impression sera délivrée (objet) |
| utilisateur | Détails de l'utilisateur humain de l'appareil ; l'audience publicitaire (objet) |
| diablotin | Détails de l'emplacement publicitaire ou de l'impression mis aux enchères (objet) |
| règlements | Détails de toute réglementation industrielle, juridique ou gouvernementale en vigueur pour cette demande (objet) |
| ext | Placeholder pour les extensions d'OpenRTB (objet) |
site
| Attribut | Description |
|---|
| id | ID unique du site (chaîne de caractères) |
| domaine | Nom de domaine du site (chaîne) |
| chat | ID de la catégorie IAB (tableau de chaînes) |
| page | URL complète de la page où l'annonce sera affichée (chaîne) |
| mots-clés | Les mots-clés peuvent être utilisés pour s'assurer que les zones d'annonces 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 | Emplacement pour les extensions spécifiques à l'échange (objet) |
site.ext
| Attribut | Description |
|---|
| chat d'échange | ID de la catégorie ExoClick personnalisée (nombre entier) |
| idzone | ID de la zone publicitaire ExoClick personnalisée (entier) |
| mot-clé | Mot-clé correspondant s'il y en a un (chaîne) |
dispositif
| Attribut | Description |
|---|
| ua | Agent utilisateur du navigateur (chaîne) |
| sua | Informations structurées sur l'agent utilisateur, qui peuvent être utilisées lorsqu'un client prend en charge les User-Agent Client Hints (objet) |
| géo | Emplacement de l'appareil supposé être l'emplacement actuel 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)* |
| langue | Langue du navigateur (chaîne) |
| os | Système d'exploitation (chaîne) |
| js | Prise en charge de JavaScript, où 0 = non, 1 = oui (nombre entier) |
| ext | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange (objet) |
*L'appel d'offres doit contenir exactement l'une des deux options suivantes : ip ou ipv6.
dispositif.geo
| Attribut | Description |
|---|
| pays | Pays ISO3 |
| ipservice | Service ou fournisseur utilisé pour déterminer la géolocalisation à partir de l'adresse IP, le cas échéant (nombre 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) |
dispositif.sua
Informations structurées de l'agent utilisateur. device.sua est considéré comme la représentation la plus précise des attributs de l'appareil.
| Attribut | Description |
|---|
| navigateurs | Envoyer les marques et les versions dérivées de l'en-tête Sec-CH-UA-Full-Version-List. (tableau d'objets BrandVersion) |
| plateforme | 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. (Objet BrandVersion) |
| mobile | Cette valeur est dérivée de l'en-tête Sec-CH-UA-Mobile. (entier) |
| l'architecture | Récupérer cette valeur de l'en-tête Sec-CH-UA-Arch. (chaîne) |
| bitume | Récupérer cette valeur de l'en-tête Sec-CH-UA-Bitness. (chaîne) |
| modèle | Récupérer cette valeur de l'en-tête Sec-CH-UA-Model. (chaîne) |
| source | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| Attribut | Description |
|---|
| marque | 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 plate-forme (à 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 [major, minor, micro, ...] (array of string) |
utilisateur
| Attribut | Description |
|---|
| id | Identifiant unique de l'utilisateur (chaîne) |
utilisateur.ext
| Attribut | Description |
|---|
| consentement | Il s'agit de la chaîne de consentement requise par les normes de l'IAB. Consentement négatif uniquement pour l'instant (chaîne) |
règlements
| Attribut | Description |
|---|
| ext | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange. |
regs.ext
| Attribut | Description |
|---|
| gdpr | Cette valeur est 0 si l'appelant pense que l'utilisateur n'est pas soumis au GDPR, et 1 si l'utilisateur est soumis au GDPR. Dans le cas contraire, ce paramètre est indéfini. |
diablotin
| Attribut | Description |
|---|
| id | Identifiant unique pour cette impression dans le contexte de l'appel d'offres (chaîne) |
| instl | 1 = l'annonce est interstitielle ou plein écran, 0 = pas interstitielle (nombre entier) |
| vidéo | Détails via l'objet vidéo qui représente une impression vidéo en cours de diffusion |
| sécurisé | Drapeau indiquant si l'impression nécessite une URL HTTPS sécurisée (nombre entier) |
| ext | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange (objet) |
imp.video
| Attribut | Description |
|---|
| mimes | Types MIME de contenu pris en charge (par exemple, "video/mp4") (tableau de chaînes) |
| minduration | Durée minimale de la publicité vidéo en secondes (nombre entier) |
| maxduration | Durée maximale de la publicité vidéo en secondes (nombre entier) |
| protocoles | Tableau des protocoles vidéo pris en charge (nombre entier) |
| linéarité | Indique si l'impression doit être linéaire, non linéaire, etc. Si rien n'est spécifié, on suppose que toutes sont autorisées (nombre entier) |
| boxe autorisée | Indique si le letter-boxing d'un contenu 4:3 dans une fenêtre 16:9 est autorisé, où 0 = non, 1 = oui (nombre entier) |
| pos | Position de l'annonce sur l'écran (nombre entier) |
| h | Largeur du lecteur vidéo en pixels indépendants du périphérique (DIPS) (nombre entier) |
| w | Hauteur du lecteur vidéo en pixels indépendants du périphérique (DIPS) (entier) |
| ext | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange (objet) |
imp.video.ext
| Attribut | Description |
|---|
| type de zone | Type de zone dans les formats publicitaires d'ExoClick (par exemple : video_slider) |