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
- Content 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 | Details about the publisher’s website(object). |
| application | Oui | Details about the publisher’s app(object). |
| dispositif | Oui | Details about the user’s device to which the impression will be delivered(object). |
| utilisateur | Non | Details about the human user of the device; the advertising audience(object). |
| 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 | Minimum bid for this impression (CPM) / click (CPC) and account currency (float). |
| bannière | Only for fullpage imps | A banner object (object). |
| 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 | Zone type within ExoClick's ad formats (e.g: video_slider) |
| cta | Non | Specifies whether the ad zone shows a CTA component (integer) |
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 | Custom ExoClick Zone ID (integer) |
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 | IPv4 address of the user (string)* |
| ipv6 | Oui | IPv6 address of the user (string)* |
| 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: You only need to include either ip or ipv6 in your request, not both. If you use ipv6, remove the ip attribute, and vice versa. Including both can cause errors.
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
Structured User Agent information. device.sua is considered the more accurate representation of the device attributes.
| 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 | This is the consent string required by the IAB standards. Negative consent only for now (string) |
regs
| 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 | This is 0 if the caller believes that the user is not under GDPR, and 1 if the user is under GDPR. If neither, this parameter will be undefined. |
ext
| Attribut | Nécessaire ? | Description |
|---|
| sous | Non | Le Sub ID. Il s'agit d'un nombre compris entre six et dix chiffres : Ne pas utiliser de zéros au début des sous-identifiants. |