Cette page explique comment faire des appels d'offres
Suggestions d'en-têtes d'appels d'offres
- OpenRTB Version HTTP Header: x-openrtb-version : 2.5
- Keep-Alive HTTP Header: Connection : Keep-Alive
- Contenu JSON: Content-Type : application/json
Les objets suivants doivent être envoyés encodés en JSON dans le corps de la demande :
Demande d'offre
| Attribut | Nécessaire ? | Description |
|---|
| à | Oui | Type d'enchère, premier prix = 1 (int) |
| id | Oui | ID unique de l'appel d'offres (chaîne de caractères) |
| diablotin | Oui | Tableau d'objets Imp représentant les impressions proposées (objet). |
| site | Oui | Détails sur le(s) site(s) web de l'éditeur. |
| application | Oui | Détails sur l'application (objet) de l'éditeur. |
| dispositif | Oui | Détails sur l'appareil de l'utilisateur auquel l'impression sera délivrée (objet). |
| utilisateur | Non | Détails sur l'utilisateur humain de l'appareil ; l'audience publicitaire (objet). |
| ext | Non | Placeholder pour les extensions d'OpenRTB. |
Note : Un seul des objets {site, app} doit être présent dans chaque demande.
diablotin
| Attribut | Nécessaire ? | Description |
|---|
| id | Oui | ID unique de l'impression dans cet appel d'offres (chaîne) |
| plancher de soumission | Non | Enchère minimale pour cette impression (CPM) / clic (CPC) et devise du compte (float). |
| bannière | Uniquement pour les images de pleine page | Un objet de la bannière (objet). |
| sécurisé | Non ; Recommandé 1 | Indicateur permettant de savoir si l'impression nécessite des ressources créatives et des balises URL HTTPS sécurisées, où 0 = non sécurisé, 1 = sécurisé. En cas d'omission, l'état de sécurité est inconnu, mais la prise en charge HTTP non sécurisée peut être supposée, facultatif (nombre entier) |
bannière imp
| Attribut | Nécessaire ? | Description |
|---|
| w | Oui | Largeur de la bannière (entier) |
| h | Oui | Hauteur de la bannière (entier) |
| mimes | Oui | Types de mimes - image/jpg, image/png, vidéo/mp4 ou image/webp |
imp.video
| Attribut | Nécessaire ? | Description |
|---|
| mimes | Oui | Types MIME de contenu pris en charge (par exemple, "video/mp4") (tableau de chaînes) |
| minduration | Non | Durée minimale de la publicité vidéo en secondes (nombre entier) |
| maxduration | Non | Durée maximale de la publicité vidéo en secondes (nombre entier) |
| protocoles | Non | Tableau des protocoles vidéo pris en charge (nombre entier) |
| linéarité | Non | Indique si l'impression doit être linéaire, non linéaire, etc. Si rien n'est spécifié, on suppose que toutes sont autorisées (nombre entier) |
| boxe autorisée | Non | Indique si le letter-boxing d'un contenu 4:3 dans une fenêtre 16:9 est autorisé, où 0 = non, 1 = oui (nombre entier) |
| pos | Non | Position de l'annonce sur l'écran (nombre entier) |
| h | Non | Largeur du lecteur vidéo en pixels indépendants du périphérique (DIPS) (nombre entier) |
| w | Non | Hauteur du lecteur vidéo en pixels indépendants du périphérique (DIPS) (entier) |
| ext | Non | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange (objet) |
imp.video.ext
| Attribut | Nécessaire ? | Description |
|---|
| type de zone | Non | Type de zone dans les formats publicitaires d'ExoClick (par exemple : video_slider) |
| cta | Non | Indique si la zone publicitaire affiche un composant CTA (nombre entier) |
site
| Attribut | Nécessaire ? | Description |
|---|
| id | Recommandé | ID unique du site (chaîne de caractères) |
| nom | Non | Nom du site (chaîne) |
| domaine | Recommandé | Nom de domaine du site (chaîne) |
| chat | Non | ID de la catégorie IAB (tableau de chaînes) |
| page | Recommandé | URL complète de la page où l'annonce sera affichée (chaîne) |
| mots-clés | Non | Les mots-clés peuvent être utilisés pour s'assurer que les zones d'annonces 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 | Nécessaire ? | Description |
|---|
| chat d'échange | Non | ID de la catégorie ExoClick personnalisée (nombre entier) |
| idzone | Non | ID de la zone ExoClick personnalisée (nombre entier) |
application
| Attribut | Nécessaire ? | Description |
|---|
| id | Recommandé | ID unique de l'application (chaîne) |
| nom | Non | Nom de l'application (chaîne) |
| domaine | Recommandé | Nom de domaine de l'application (chaîne) |
| chat | Non | ID de la catégorie IAB (tableau de chaînes) |
| mots-clés | Non | Les mots-clés peuvent être utilisés pour s'assurer que les zones d'annonces 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) |
| éditeur | Non | Détails sur l'éditeur (objet) |
dispositif
| Attribut | Nécessaire ? | Description |
|---|
| ua | Oui | Agent utilisateur du navigateur (chaîne) |
| sua | Non | Informations structurées sur l'agent utilisateur, qui peuvent être utilisées lorsqu'un client prend en charge les User-Agent Client Hints (objet) |
| géo | Non | Emplacement de l'appareil supposé être l'emplacement actuel de l'utilisateur défini par un objet Geo. |
| ip | Oui | Adresse IPv4 de l'utilisateur (chaîne de caractères)* |
| ipv6 | Oui | Adresse IPv6 de l'utilisateur (chaîne)* |
| langue | 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 (nombre entier) |
| ext | Non | Placeholder pour les extensions d'OpenRTB spécifiques à la bourse |
Note: Vous ne devez inclure que ip ou ipv6 dans votre requête, pas les deux. Si vous utilisez ipv6, supprimez l'attribut ip, et vice versa. L'inclusion des deux peut provoquer des erreurs.
dispositif.geo
| Attribut | Nécessaire ? | Description |
|---|
| pays | Non | Pays ISO3 |
device.ext
| Attribut | Nécessaire ? | 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) |
dispositif.sua
Informations structurées de l'agent utilisateur. device.sua est considéré comme la représentation la plus précise des attributs de l'appareil.
| Attribut | Nécessaire ? | Description |
|---|
| navigateurs | Recommandé | Les implémenteurs doivent envoyer des marques et des versions dérivées de l'en-tête Sec-CH-UA-Full-Version-List. (tableau d'objets BrandVersion) |
| plateforme | 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. (Objet BrandVersion) |
| mobile | Recommandé | Les responsables de la mise en œuvre doivent dériver cette valeur de l'en-tête Sec-CH-UA-Mobile. (entier) |
| l'architecture | Recommandé | Les responsables de la mise en œuvre doivent extraire cette valeur de l'en-tête Sec-CH-UA-Arch. (chaîne) |
| bitume | Recommandé | Les responsables de la mise en œuvre doivent extraire cette valeur de l'en-tête Sec-CH-UA-Bitness. (chaîne) |
| modèle | Recommandé | Les responsables de la mise en œuvre doivent extraire cette valeur de l'en-tête Sec-CH-UA-Model. (chaîne) |
| source | Recommandé | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| Attribut | Nécessaire ? | Description |
|---|
| marque | Exigée | 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 plate-forme (à 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 [major, minor, micro, ...] (array of string) |
utilisateur
| Attribut | Nécessaire ? | Description |
|---|
| id | Non | Identifiant unique de l'utilisateur (chaîne) |
| ext | Non | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange (objet) |
utilisateur.ext
| Attribut | Nécessaire ? | Description |
|---|
| consentement | Non | Il s'agit de la chaîne de consentement requise par les normes de l'IAB. Consentement négatif uniquement pour l'instant (chaîne) |
règlements
| Attribut | Nécessaire ? | Description |
|---|
| ext | Non | Placeholder pour les extensions d'OpenRTB spécifiques à l'échange (objet) |
regs.ext
| Attribut | Nécessaire ? | Description |
|---|
| gdpr | Non | Cette valeur est 0 si l'appelant pense que l'utilisateur n'est pas soumis au GDPR, et 1 si l'utilisateur est soumis au GDPR. Dans le cas contraire, ce paramètre est indéfini. |
ext
| Attribut | Nécessaire ? | Description |
|---|
| sous | Non | Le Sub ID. Il s'agit d'un nombre compris entre un et dix chiffres : Ne pas utiliser de zéros au début des sous-identifiants. |