> 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/editeurs/rtb-ouvert/pub-open-rtb-2.5-request.md). # Requête 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. | {% hint style="info" %} Un seul des objets `{site, app}` doit être présent dans chaque requête. {% endhint %} ## 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 | {% hint style="info" %} 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. {% endhint %} ### 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](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 | 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. | --- # 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/editeurs/rtb-ouvert/pub-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.