Spécifications des réponses aux appels d'offres RTB ouverts
La réponse à un appel d'offres doit avoir la structure suivante :
réponse
| Attribut | Nécessaire ? | Description |
|---|---|---|
| id | Oui | ID de l'appel d'offres pour lequel il s'agit d'une réponse (chaîne) |
| offre de places | Oui | Collection d'offres faites par le soumissionnaire au nom d'un siège spécifique (tableau) |
Note: L'identifiant doit correspondre à celui fourni dans la demande
offre de places
| Attribut | Nécessaire ? | Description |
|---|---|---|
| offre | Oui | Tableau de l'objet de l'offre lié à l'impression ciblée |
seatbid.bid
| Attribut | Nécessaire ? | Description |
|---|---|---|
| id | Oui | ID de l'objet de l'offre, utilisé pour le suivi (chaîne) |
| impide | Oui | ID de l'objet d'impression dans l'appel d'offres correspondant. |
| prix | Oui | Prix de l'offre en CPM ou CPC (flottant) |
| adm | Oui | XML/JSON balisage de l'annonce (chaîne) |
| nurl | Oui | URL de la notification de gain, il est recommandé d'utiliser HTTP sur HTTPS pour nurl (chaîne) |
| ronce | Non | URL de la notification de facturation, il est recommandé d'utiliser HTTP sur HTTPS pour nurl (chaîne) |
| crid | Recommandé | ID créatif pour faciliter le contrôle de la qualité des publicités (chaîne) |
| iurl | Recommandé | URL de la création |
| ext | Non | Extension spécifique ExoClick (objet) |
Remarques :
- L'impid doit correspondre à celui fourni dans la demande.
- L'adm doit être fournie en JSON ou XML en fonction du format publicitaire ciblé : JSON pour les publicités natives, In-Stream et les notifications push ; XML pour tous les autres formats.
- Le nURL doit être notifié afin d'assurer le plafonnement de la campagne et d'éviter de recevoir la même réponse à chaque fois.
- La bURL est appelée lorsque des impressions ou des clics ont été délivrés, en fonction du CPM ou du CPC indiqué dans le champ btype (CPM par défaut).
seatbid.bid.ext
| Attribut | Nécessaire ? | Description |
|---|---|---|
| btype | Recommandé | Modèle de tarification. Valeurs : 1 = CPM, 2 = CPC. Valeur par défaut = 1 (int). |
Note : Lorsque la réponse concerne une demande de zone de clics par courriel, 1 = Smart CPC.
seatbid.bid.ext.dsa
| Attribut | Nécessaire ? | Description |
|---|---|---|
| nom | Oui | Transparence de l'annonceur : Chaîne de texte UNICODE libre contenant un nom au nom duquel l'annonce est affichée. Maximum 100 caractères. (chaîne) |
| payé | Oui | Transparence de l'annonceur : Chaîne de texte UNICODE libre indiquant qui a payé la publicité. Doit toujours être inclus, même s'il est identique à celui qui figure dans l'attribut "nom". Maximum 100 caractères (chaîne) |
| s'adonner | Oui | Drapeau indiquant que l'acheteur/annonceur rendra ses propres informations de transparence DSA à l'intérieur de la création. 0 = l'acheteur/annonceur ne rendra pas, 1 = l'acheteur/annonceur rendra (int) |
seatbid.bid.dsa.transparency
| Attribut | Nécessaire ? | Description |
|---|---|---|
| domaine | Oui | Domaine de l'entité qui a appliqué les paramètres de l'utilisateur (chaîne) |
| paramètres | Oui | Tableau des paramètres de ciblage des utilisateurs appliqués par le côté acheteur (à l'aide de la liste fournie par le groupe de travail sur la transparence de l'ASD). Inclure la prise en charge de plusieurs fournisseurs qui peuvent ajouter leurs propres paramètres de ciblage de l'utilisateur. (int array) |
Pas de réponse à l'appel d'offres
Pour répondre à une demande d'offre sans faire d'offre réelle, un code de réponse HTTP 204 "Pas de contenu" doit être envoyé.
URL de notification des gains et de la facturation
Si les nURL ou bURL figurent dans la réponse à l'offre et sont des URL valides, la plate-forme ExoClick leur enverra une requête GET. Ces URL peuvent avoir quelques jetons à remplacer par ExoClick avant d'effectuer la requête GET :
${AUCTION_ID} - ID of the bid request; from "Bid Request Object -> id" attribute.
${AUCTION_BID_ID} - ID of the bid; from "Bid Response Object -> bidid" attribute.
${AUCTION_IMP_ID} - ID of the impression just won; from "Bid Request Object -> Impression Object -> id" attribute.
${AUCTION_SEAT_ID} - ID of the bidder seat for whom the bid was made; from "Bid Response Object -> Seat Bid Object -> Bid Object -> id" attribute.
${AUCTION_AD_ID} - ID of the ad markup the bidder wishes to serve; from "Bid Response Object -> Seat Bid Object -> Bid Object -> adid" attribute.
${AUCTION_PRICE} - Settlement price using the same currency and units as the account; from "Bid Response Object -> Seat Bid Object -> Bid Object -> price" attribute.
${AUCTION_CURRENCY} - The currency used in the bid (explicit or implied); for confirmation only.
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
Depending on the ad format, the adm parameter can contain a piece of XML or JSON. You can find detailed examples of adm structures in our examples page
Lors de la création de l'ADM, il convient de tenir compte des éléments suivants :
- les balises iFrame** (Banner, Fullpage Interstitial) doivent être activées dans votre compte ExoClick pour pouvoir être utilisées.
- les annonces In-Stream, Native et Push Notification ads** doivent contenir une chaîne encodée JSON dans l'adm.
- Le paramètre adm de In-Stream peut suivre l'une des deux structures suivantes : Remote VAST ou Local VAST. Dans le cas d'un VAST distant, il suffit de déclarer l'URL où se trouve le wrapper VAST, tandis que dans le cas d'un VAST local, vous devez déclarer tous les "trackingEvents " que vous souhaitez suivre en plus de l'"url vidéo" et de l'"url clic".
Actuellement, nous prenons en charge les événements impression, progression et complete. Les événements d'impression et de progression sont obligatoires, tandis que l'événement complet ne peut être ajouté que si vous utilisez VAST local.
The ADM must follow the same structure as shown in our example above.
En tant que paramètre facultatif, vous pouvez inclure crop_anchor_point dans la chaîne JSON de l'entrée Native Ads pour déterminer où se trouve le point d'ancrage de votre image native. Les valeurs disponibles sont les suivantes :
- CENTRE_MILIEU = 0,
- TOP_LEFT = 1,
- TOP_CENTER = 2,
- TOP_RIGHT = 3,
- MILIEU_GAUCHE = 4,
- MIDDLE_RIGHT = 5,
- BAS_GAUCHE = 6,
- BAS_CENTRE = 7,
- BOTTOM_RIGHT= 8
Voici une visualisation des points d'ancrage disponibles :
- Also, regarding Native Ads, make sure that you are adding your eventtrackers according to the latest native specification
Bien que nous autorisions les imptrackers dans les publicités natives, nous recommandons vivement d'utiliser les eventtrackers à la place.
- Les publicités par notification push n'autorisent qu'une seule image par notification. La largeur et la hauteur dépendent de la requête, qui peut être de 192x192 ou 720x480. Notez que l'adm doit également être une chaîne encodée en JSON car la demande provient d'un objet Native.
- Enfin, les publicités Push Notification n'autorisent qu'une seule URL "imptracker "
Exemples
You can find detailed examples from Bid responses and ADM structures in our Advertiser Response example page