> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/rtb/fr/annonceurs/rtb-ouvert/adv-open-rtb-2.5-request.md). # Requête 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](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--user-agent-source-) 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) | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/rtb/fr/annonceurs/rtb-ouvert/adv-open-rtb-2.5-request.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.