> 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.4-request.md). # Requête d'enchère Open RTB 2.4 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.4` * **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` ## Objet de requête d'enchère 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 | | -------- | ------------------------------------------------------------------------------------------------------ | | à | Type d'enchère, premier prix = 1 (int) | | id | ID unique de la requête d'enchère (chaîne) | | imp | Objet représentant l'impression proposée (objet). | | site | Détails via un objet Site sur le site web de l'éditeur (objet). | | device | Détails via un objet Device sur l'appareil de l'utilisateur auquel l'impression sera diffusée (objet). | | user | Détails via un objet User sur l'utilisateur humain de l'appareil ; l'audience publicitaire (objet). | | ext | Espace réservé pour les extensions spécifiques à l'échange. | ## imp | Attribut | Description | | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | ID unique de l'impression dans cette requête d'enchère (chaîne) | | bidfloor | Enchère minimale pour cette impression (CPM) / clic (CPC) et devise du compte, facultatif (float). | | bidfloorcur | Devise de la valeur d'enchère minimale spécifiée à l'aide des codes alphabétiques ISO-4217, facultatif (chaîne) | | native | Un objet Native ; requis si cette impression est proposée comme opportunité de publicité native (objet). | | banner | Un objet banner ; requis si cette impression est proposée comme opportunité de bannière publicitaire (objet). | | instl | Un objet interstitiel ; requis si cette impression est proposée comme opportunité publicitaire interstitielle ou popunder (objet).(objet). | | secure | 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) | | el | E-mail encodé en Base64 (chaîne) | ### imp.banner | Attribut | Description | | -------- | ------------------------------------------------------------------------------------------- | | w | Largeur de la bannière en pixels (entier). | | h | Hauteur de la bannière en pixels (entier). | | mimes | Types MIME pris en charge. Valeurs d'exemple : image/jpg, image/png, video/mp4, image/webp. | ### imp.instl | Attribut | Description | | -------- | --------------------------------------------------------------------------------------- | | instl | Indicateur précisant si l'annonce est popunder/interstitielle (entier) : 1=vrai, 0=faux | ### imp.native (Native et notifications push) | Attribut | Description | | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | request | Charge utile de la requête conforme à la spécification de publicité native - un **chaîne encodée en JSON** de la requête Native Ads incluant son **native** objet de niveau supérieur (objet JSON) | | ver | Version de l'API Dynamic Native Ads à laquelle **request** est conforme (chaîne) | ### imp.native.request | Attribut | Description | | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ver | Version du balisage natif utilisée (chaîne) | | context | Le contexte dans lequel l'annonce apparaît. Dans ce cas, il s'agit de **1** (*un contexte centré sur le contenu tel qu'un fil d'actualité, un article, une galerie d'images, une galerie vidéo ou similaire*), facultatif (entier) | | plcmttype | La conception/le format/la disposition de l'unité publicitaire proposée. Actuellement, nous prenons en charge **4** (*Widget de recommandation*) et **500** (*Push Notification*) (entier) | | plcmtcnt | Le nombre d'emplacements identiques dans cette mise en page (entier) | | assets | Un tableau de **objets Asset**. Toute réponse d'enchère doit respecter le tableau d'éléments exprimé dans la requête d'enchère (tableau d'objets JSON) | | seq | 0 pour la première annonce, 1 pour la deuxième, et ainsi de suite. Notez que cela ne serait généralement PAS utilisé en combinaison avec plcmtcnt - soit vous enchérissez sur plusieurs emplacements identiques (dans ce cas plcmtcnt>1, seq=0), soit vous organisez des enchères séparées pour des éléments distincts du flux (dans ce cas plcmtcnt=1, seq=>=1) | ### imp.native.request.assets | Attribut | Description | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | id | ID d'actif unique, attribué par l'échange. Généralement un compteur pour le tableau (entier) | | required | Défini sur **1** si l'actif est requis ou **0** si l'actif est facultatif\*\* (entier) | | plcmtcnt | Le nombre d'emplacements identiques dans cette mise en page (entier) | | img | Objet Image pour les actifs d'image\* (objet JSON) | | title | Objet Titre pour les actifs de titre\* (objet JSON) | | data | Objet Data pour le nom de la marque, la description, les notes, les prix, etc.\* (objet JSON) | | video | Objet Vidéo pour les actifs vidéo. Voir la définition de l'objet de requête Video. Notez que les publicités vidéo in-stream (c.-à-d. pré-roll, etc.) ne font pas partie du format Native. Les publicités natives peuvent contenir une vidéo comme créatif publicitaire lui-même (objet). | \* Un seul des objets {img, title, data} doit être présent dans chaque objet d'actif \*\* Les actifs sont signalés comme requis selon la configuration de la zone de l'éditeur où votre annonce peut être affichée ### imp.native.request.assets.img | Attribut | Description | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | ID du type d'élément image pris en charge par l'éditeur. Nous prenons en charge : **1** (*Image d'icône*) (entier), **3** (*Aperçu de grande image pour l'annonce*) (entier) | | w | Largeur de l'image en pixels, facultatif (entier) | | h | Hauteur de l'image en pixels, facultatif (entier) | | wmin | Largeur minimale demandée de l'image en pixels (entier) | | hmin | Hauteur minimale demandée de l'image en pixels (entier) | ### imp.native.request.assets.title | Attribut | Description | | -------- | ------------------------------------------------------------ | | len | Longueur maximale du texte dans l'élément de titre. (entier) | ### imp.native.request.assets.video | Attribut | Description | | ------------- | ----------------------------------------------------------------------------------------- | | mimes | Liste des types MIME pris en charge (tableau de chaînes). | | minduration | Durée minimale de l'annonce vidéo en secondes (entier). | | maxduration | Durée maximale de l'annonce vidéo en secondes (entier). | | protocols | Liste des protocoles de réponse aux enchères vidéo pris en charge (tableau d'entiers). | | linearity | Indique si l'impression doit être linéaire, non linéaire, etc. (entier). | | boxingallowed | Indique si le letter-boxing d'un contenu 4:3 dans une fenêtre 16:9 est autorisé (entier). | ### imp.native.request.assets.data | Attribut | Description | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | type | ID de type de l'élément pris en charge par l'éditeur (entier). Nous prenons en charge : **1** (*sponsored - message « Sponsorisé par » où la réponse doit contenir le nom de la marque du sponsor*), **2** (*desc - texte descriptif associé au produit ou au service annoncé*) | | len | Longueur maximale du texte dans la réponse de l'élément (entier) | ### imp.video | Attribut | Description | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | mimes | Liste des types mime pris en charge (tableau de chaînes) | | protocols | Liste des protocoles de réponse aux enchères vidéo pris en charge (tableau d'entiers) | | skip | Indique si le lecteur permettra de sauter la vidéo, où 0 = non, 1 = oui | | skipafter | Nombre de secondes pendant lesquelles une vidéo doit être lue avant que le saut ne soit activé ; applicable uniquement si l'annonce est skippable | | skipmin | Les vidéos dont la durée totale est supérieure à ce nombre de secondes peuvent être skippables ; applicable uniquement si l'annonce est skippable | {% hint style="info" %} Si l'éditeur fournit « skip » dans la requête mais pas « skipafter », la vidéo sera skippable après 5 secondes. La réponse définira « skipoffset » sur 5.\ Si l'éditeur fournit « skip » mais pas « skipmin », la vidéo sera skippable quelle que soit sa durée. {% endhint %} ## 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é pour les extensions spécifiques à l'échange d'OpenRTB. | \*Ces attributs sont obligatoires pour les formats Direct Link et Email Clicks. ### 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) | L'attribut idzone est utilisé pour identifier la source dans ExoClick d'où provient le trafic. ## 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 | Localisation de l'appareil supposée être la localisation actuelle de l'utilisateur, définie par un objet Geo. | | ip | Adresse IP de l'utilisateur (chaîne)\* | | ipv6 | Adresse IPv6 de l'utilisateur (chaîne)\* | | language | Langue du navigateur utilisant ISO-639-1 alpha-2 (chaîne) | | os | Système d'exploitation (chaîne) | | js | Prise en charge de JavaScript, où 0 = non, 1 = oui (entier) | | ext | Espace réservé pour les extensions spécifiques à l'échange d'OpenRTB | \*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 | ### 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) | ## ext | Attribut | Obligatoire ? | Description | | -------- | ------------- | ----------------------------------------------------------------------------------------------------- | | sub | Non | Le sub sera un nombre entier représentant l'ID de la zone d'où la requête a été initialement envoyée. | ## regs.ext | Attribut | Description | | -------- | ------------------------------------------------------------------------ | | dsaapply | Indicateur précisant si la DSA s'applique à la requête. 1 = requis (int) | | dsa | Extension pour les informations de transparence DSA (objet) | ### regs.ext.dsa | Attribut | Description | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | required | Indicateur précisant si les informations DSA doivent être mises à disposition. 0 = non requis, 1 = pris en charge, les réponses d'enchère avec ou sans objet DSA seront acceptées, 2 = requis, les réponses d'enchère sans objet DSA ne seront pas acceptées, 3 = requis, les réponses d'enchère sans objet DSA ne seront pas acceptées, l'éditeur est une plateforme en ligne (int) | | datatopub | L'éditeur peut avoir besoin des données de transparence à des fins d'audit. 0 = ne pas envoyer les données de transparence, 1 = facultatif d'envoyer les données de transparence, 2 = envoyer les données de transparence (int) | {% hint style="warning" %} Si vous recevez **dsaapply: 1** et **required: 2 or 3**, il est obligatoire d'ajouter dans la réponse des attributs dsa avec des valeurs, sinon la réponse sera rejetée. {% endhint %} ## Exemples Vous pouvez trouver une liste complète de tous les types de requêtes que vous pouvez recevoir dans notre [page d'exemple de requête Advertiser](/rtb/fr/annonceurs/rtb-ouvert/open-rtb-advertiser-code-examples.md). --- # 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.4-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.