For the complete documentation index, see llms.txt. This page is also available as Markdown.

Réponse à l'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)

Remarque : L'id doit correspondre à celui fourni dans la requête

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)

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).

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 :

Exemple :

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

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 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

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

Mis à jour

Ce contenu vous a-t-il été utile ?