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
- Content JSON: Content-Type: application/json
- Data Encoding Header: 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 | Details of the user’s device to which the impression will be delivered (object) |
| utilisateur | Details of the human user of the device; the advertising audience (object) |
| diablotin | Details of the ad placement or impression being auctioned (object) |
| regs | Details of any industry, legal, or governmental regulations in force for this request (object) |
| 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) |
*Exactly one of ip or ipv6 will be present in the bid request.
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
Structured User Agent information. device.sua is considered the more accurate representation of the device attributes.
| 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 | This is the consent string required by the IAB standards. Negative consent only for now (string) |
regs
| Attribut | Description |
|---|
| ext | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange. |
regs.ext
| Attribut | Description |
|---|
| gdpr | This is 0 if the caller believes that the user is not under GDPR, and 1 if the user is under GDPR. If neither, this parameter will be undefined. |
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 | Zone type within ExoClick's ad formats (e.g: video_slider) |