> 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-response.md). # Réponse d'enchère Open RTB 2.4 La réponse à une demande d'enchère doit avoir la structure suivante : ## Objet de réponse à l'enchère | Attribut | Obligatoire ? | Description | | -------- | ------------- | ------------------------------------------------------------------------------------------------- | | id | Oui | ID de la demande d'enchère à laquelle il s'agit d'une réponse (chaîne) | | seatbid | Oui | Collection d'enchères effectuées par l'enchérisseur pour le compte d'un seat spécifique (tableau) | {% hint style="info" %} **Remarque :** L'id doit correspondre à celui fourni dans la requête {% endhint %} ### seatbid | Attribut | Obligatoire ? | Description | | -------- | ------------- | ------------------------------------------------------ | | bid | Oui | Tableau de l'objet d'enchère lié à l'impression ciblée | ### seatbid.bid | Attribut | Obligatoire ? | Description | | -------- | ------------- | ------------------------------------------------------------------------------------------------------------- | | id | Oui | ID de l'objet d'enchère, utilisé pour le suivi (chaîne) | | impid | Oui | ID de l'objet impression dans la demande d'enchère associée. | | price | Oui | Prix de l'enchère en CPM ou CPC (flottant) | | adm | Oui | Balise publicitaire XML/JSON (chaîne) | | nurl | Oui | URL de notification de gain, il est recommandé d'utiliser **HTTP** plutôt que HTTPS pour nurl (chaîne) | | burl | Non | URL de notification de facturation, il est recommandé d'utiliser **HTTP** plutôt que HTTPS pour burl (chaîne) | | crid | Recommandé | ID créatif pour aider à la vérification de la qualité de l'annonce (chaîne) | | iurl | Recommandé | URL du créatif | | ext | Non | Extension spécifique à ExoClick (objet) | {% hint style="info" %} **Remarques :** * Nous prenons en charge la vidéo dans les emplacements banner et interstitial. * L'impid doit correspondre à celui fourni dans la requête. * L'adm doit être fourni au format JSON ou XML selon le format publicitaire ciblé : JSON pour Native, In-Stream et Push Notifications ; XML pour tous les autres formats. * La nURL doit être notifiée afin de garantir le plafonnement de la campagne et d'éviter d'obtenir la même réponse à chaque fois. * La bURL est appelée lorsque des impressions ou des clics ont été diffusés, selon le CPM ou le CPC du champ btype (CPM par défaut). {% endhint %} ### seatbid.bid.ext | Attribut | Obligatoire ? | Description | | -------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | btype | Recommandé | Modèle de tarification. Valeurs : 1 = CPM, 2 = CPC. Par défaut = 1 (entier). Lorsque la réponse concerne une requête de zone Email Clicks, 1 = Smart CPC. | | | | **Remarque**: Seuls les Push Notification, les annonces Native, Direct Link et Email Clicks peuvent enchérir avec le modèle de tarification CPC. | ### seatbid.bid.ext.dsa | Attribut | Obligatoire ? | Description | | -------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | behalf | Oui | Transparence de l'annonceur : chaîne de texte UNICODE libre avec le nom de la personne au nom de laquelle l'annonce est affichée. Maximum 100 caractères. (chaîne) | | paid | Oui | Transparence de l'annonceur : chaîne de texte UNICODE libre indiquant qui a payé l'annonce. Doit toujours être incluse même si c'est la même que celle indiquée dans l'attribut behalf. Maximum 100 caractères (chaîne) | | adrender | Oui | Indicateur pour signaler que l'acheteur/l'annonceur rendra ses propres informations de transparence DSA dans le créatif. 0 = l'acheteur/l'annonceur ne rendra pas, 1 = l'acheteur/l'annonceur rendra (entier) | ### seatbid.bid.dsa.transparency | Attribut | Obligatoire ? | Description | | -------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | domain | Oui | Domaine de l'entité qui a appliqué les paramètres utilisateur (chaîne) | | params | Oui | Tableau de ciblage des paramètres utilisateur appliqués côté achat (en utilisant la liste fournie par la DSA Transparency Taskforce). Inclure la prise en charge de plusieurs fournisseurs qui peuvent ajouter leurs propres paramètres de ciblage utilisateur. (tableau d'entiers) | ## Réponse sans enchère Pour répondre à une demande d'enchère sans faire d'enchère réelle, un code de réponse HTTP 204 "No Content" doit être envoyé. ## URLs de notification de gain et de facturation Si l'un des **nURL** ou le **bURL** se trouve dans la réponse à l'enchère et qu'il s'agit d'URLs valides, la plateforme ExoClick enverra une requête GET vers celles-ci.\ Ces URLs peuvent contenir quelques jetons à remplacer par ExoClick avant d'effectuer le GET : ``` ${AUCTION_ID} - ID de la demande d'enchère ; à partir de l'attribut "Bid Request Object -> id". ${AUCTION_BID_ID} - ID de l'enchère ; à partir de l'attribut "Bid Response Object -> bidid". ${AUCTION_IMP_ID} - ID de l'impression tout juste gagnée ; à partir de l'attribut "Bid Request Object -> Impression Object -> id". ${AUCTION_SEAT_ID} - ID du seat de l'enchérisseur pour lequel l'enchère a été effectuée ; à partir de l'attribut "Bid Response Object -> Seat Bid Object -> Bid Object -> id". ${AUCTION_AD_ID} - ID du balisage publicitaire que l'enchérisseur souhaite diffuser ; à partir de l'attribut "Bid Response Object -> Seat Bid Object -> Bid Object -> adid". ${AUCTION_PRICE} - Prix de règlement utilisant la même devise et les mêmes unités que le compte ; à partir de l'attribut "Bid Response Object -> Seat Bid Object -> Bid Object -> price". ${AUCTION_CURRENCY} - La devise utilisée dans l'enchère (explicite ou implicite) ; à titre de confirmation uniquement. ``` Exemple : ``` https://mysite.com/my_notification_url?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}¤cy=${AUCTION_CURRENCY} ``` Si vous utilisez à la fois **nURL** et **bURL**, ExoClick fera un appel aux deux. ## Structure de l'ADM Selon le format publicitaire, le **adm** paramètre peut contenir un morceau de XML ou de JSON. Vous pouvez trouver des exemples détaillés de structures d'adm dans notre [**page d'exemples**](/rtb/fr/annonceurs/rtb-ouvert/open-rtb-advertiser-code-examples.md) Lors de la création de l'ADM, veuillez garder à l'esprit les points suivants : * **Balises iFrame** (Banner, Fullpage Interstitial) doivent être activées dans votre compte ExoClick afin de pouvoir les utiliser. * **In-Stream, Native** et **annonces Push Notification** doit contenir une chaîne encodée en JSON dans l'adm. * Le paramètre adm de **In-Stream** peut suivre l'une de deux structures : **VAST distant** ou **VAST local**. Dans le VAST distant, il vous suffit de déclarer l'URL où se trouve le VAST Wrapper, tandis que dans le VAST local, vous devez déclarer tout **"trackingEvents"** que vous souhaitez suivre en plus de "videoURL" et "clickURL". Actuellement, nous prenons en charge les événements **impression**, **progression** et **completion** . Les événements d'impression et de progression sont **obligatoires**, tandis que completion ne peut être ajouté que si vous utilisez le VAST local. L'ADM **doit** suivre la même structure que celle illustrée dans notre [exemple](/rtb/fr/annonceurs/rtb-ouvert/open-rtb-advertiser-code-examples.md) ci-dessus. * En tant que paramètre facultatif, vous pouvez inclure **crop\_anchor\_point** dans la chaîne JSON de l' **annonce Native** ADM afin de déterminer où se situe le point d'ancrage de votre image native. Les valeurs disponibles sont : * MIDDLE\_CENTER = 0, * TOP\_LEFT = 1, * TOP\_CENTER = 2, * TOP\_RIGHT = 3, * MIDDLE\_LEFT = 4, * MIDDLE\_RIGHT = 5, * BOTTOM\_LEFT = 6, * BOTTOM\_CENTER = 7, * BOTTOM\_RIGHT = 8 Voici une visualisation des points d'ancrage disponibles : ![point d'ancrage du recadrage](/files/e457b273ce12ae7333b554d72c1fe60b32d30b88) * Aussi, concernant **annonce Native**, assurez-vous d'ajouter vos **eventtrackers** conformément à la [dernière spécification native](https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf) Notez que, bien que nous autorisions également les **imptrackers** dans les annonces Native, nous recommandons fortement d'utiliser **eventtrackers** à la place. * **Push Notification** les annonces n'autorisent qu'un seul asset image par notification. La largeur et la hauteur dépendent de ce qui provient de la requête, qui peut être 192x192 ou 720x480. Notez que l'adm doit également être une chaîne encodée en JSON, car la requête proviendra d'un objet Native. * Enfin, **Push Notification** les annonces n'autorisent qu'un seul **URL "imptracker"** ## Exemples Vous pouvez trouver des exemples détaillés de réponses aux enchères et de structures ADM dans notre [page d'exemples de réponses de l'annonceur](/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-response.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.