Consultez la spécification OpenRTB 2.6 en même temps que cette page.
Display & Video 360 n'est pas compatible avec tous les champs de la spécification OpenRTB. Des nuances peuvent s'appliquer. Certaines sections de ce document contiennent des informations et des recommandations spécifiques à l'implémentation de Display & Video 360. Vous devez également suivre les consignes présentées dans la spécification OpenRTB, sauf indication contraire.
Certains champs ne sont pas compatibles, mais sont quand même analysés. Ces champs doivent être correctement mis en forme, mais n'auront aucune incidence sur le résultat des enchères.
Spécification des demandes d'enchères
Une demande d'enchère est une requête HTTP POST dont le corps est un objet de demande d'enchère. Le format du corps est défini dans l'en-tête Content-Type
.
La réponse correspondante est soit une réponse HTTP 204 sans corps pour une absence d'enchère, soit une réponse HTTP 200 avec un corps de réponse d'enchère.
Si une demande d'enchère est mal formée, une réponse HTTP 200 avec un corps de réponse d'enchère et le champ nbr
renseigné peut être renvoyée.
Le format de la réponse est contrôlé par l'en-tête Accept
.
Format JSON
Le format par défaut est utilisé lorsqu'aucun type MIME accepté n'est fourni.
Les requêtes et réponses JSON suivent la spécification OpenRTB 2.6 de l'IAB. La documentation suivante décrit les extensions et la compatibilité des champs.
L'en-tête Content-Type
: application/json
indique une demande d'enchère JSON,
Accept
: application/json
indique que les réponses aux enchères doivent être au format JSON.
Format Protobuf
REMARQUE : La compatibilité avec Protobuf est en version bêta. Veuillez contacter DV360 si vous êtes intéressé.
Les requêtes et réponses JSON suivent la spécification Protobuf OpenRTB 2.6 de l'IAB.
La compatibilité des extensions est limitée. Contactez DV360 si vous êtes intéressé.
Envoyez l'en-tête Content-Type
: application/x-protobuf
pour indiquer une demande d'enchère Protobuf et définissez Accept
: application/x-protobuf
pour recevoir des réponses aux enchères Protobuf.
Objet de demande d'enchère
Champ | Type | Détails |
---|---|---|
id |
Chaîne | Obligatoire. ID unique de la demande d'enchère. Cet ID peut être utilisé pour identifier des requêtes individuelles pendant une durée très limitée après leur diffusion. |
imp |
Tableau Imp | Vous devez ajouter au moins un objet imp .
Pour les pods audio, plusieurs objets |
site |
Site | Obligatoire pour les demandes concernant un site Web.site et app s'excluent mutuellement. |
app |
Application | Obligatoire pour les demandes d'applications.app et site s'excluent mutuellement. |
device |
Appareil | Obligatoire. |
user |
Utilisateur | Obligatoire. |
test |
Nombre entier | Non compatible |
at |
Nombre entier |
1 : enchères au premier prix où l'annonceur est facturé du montant de son enchère.2 (par défaut) : enchères au second prix où l'annonceur est facturé juste au-dessus de la deuxième enchère la plus élevée.3 : le prix plancher figure dans la demande et n'a rien à voir avec les enchères concurrentes.
|
tmax |
Nombre entier | Facultatif. La valeur par défaut est personnalisée pour chaque intégration. |
wseat |
Tableau de chaînes | Liste des sièges d'acheteur autorisés. Recommandé, sauf si tous les annonceurs sont autorisés à enchérir. Si la valeur n'est pas définie, cela signifie qu'il n'y a aucune restriction. |
bseat |
Tableau de chaînes | Liste des sièges d'acheteur dont les enchères doivent être bloquées. Les acheteurs listés ne pourront pas enchérir sur les accords ni sur les enchères ouvertes. |
allimps |
Nombre entier | Non compatible |
cur |
Tableau de chaînes | Facultatif, mais fortement recommandé. La valeur par défaut est par intégration. La devise de la demande d'enchère doit correspondre à l'une des devises enregistrées lors de l'intégration. Il est vivement recommandé de n'accepter qu'une seule devise par plate-forme d'échange. |
wlang |
Tableau de chaînes | Non compatible |
bcat |
Tableau de chaînes | Catégories d'annonceurs bloquées à l'aide des catégories de contenu de l'IAB. "Non défini" signifie qu'aucune catégorie n'est bloquée. |
badv |
Tableau de chaînes | Spécifiez l'annonceur bloqué en fonction du domaine fourni par l'annonceur. Unset is no blocked advertisers. |
bapp |
Tableau de chaînes | Non compatible |
source |
Source | Semi-obligatoire pour schain . |
regs |
Regs | Facultatif. |
ext |
Extensions de demande d'enchère | Facultatif. |
Objet des extensions de demande d'enchère
Champ | Type | Détails |
---|---|---|
schain |
La chaîne d'approvisionnement |
Les nouvelles intégrations doivent utiliser le champ BidRequest.source.schain dans Source.
|
purch |
Nombre entier |
Le paramètre "Trafic acheté" correspond au trafic redirigé à partir de propriétés autres que celles détenues, acquises ou obtenues par le biais de mesures incitatives. Cela correspond à la nouvelle spécification MRC IVT 2.0.
Dans les rapports destinés aux acheteurs, cette dimension sera appelée Source de trafic de l'éditeur et aura l'une des valeurs suivantes : |
gdemsignals |
Chaîne | Blob de signal de l'API SCAR provenant du SDK GMA. Recommandé si le trafic provient du SDK GMA, interdit dans le cas contraire. |
disable_gma_format |
int |
Facultatif si gdemsignals est fourni, interdit dans le cas contraire.0 (par défaut) : lorsque gdemsignals est renseigné, l'adm de la réponse aux enchères est un blob JSON.1 : une balise publicitaire sera également fournie à la place du blob JSON. |
Objet source
Champ | Type | Détails |
---|---|---|
fd |
Nombre entier | Entité responsable de la décision finale de vente d'impression0 (par défaut) : l'échange décide.1 : une source en amont décide.
|
tid |
Chaîne | Non compatible |
pchain |
Chaîne | Non compatible |
schain |
La chaîne d'approvisionnement |
Obligatoire dans presque tous les cas.
Il est préférable de fournir |
ext |
Extensions de source | Facultatif. |
Objet des extensions sources
Cette extension est fortement recommandée, car elle a un impact sur la façon dont les mesures de visibilité sont communiquées au client dans DV3. Si le nom du partenaire OMID ne figure PAS sur la liste de certification de l'IAB, nous sommes tenus par le MRC de signaler les métriques de visibilité séparément des métriques certifiées par le MRC. En savoir plus
Champ | Type | Détails |
---|---|---|
omidpn |
Chaîne | Identifiant de l'intégration du SDK OM. Il s'agit du même paramètre "name" que celui de l'objet partenaire OMID. |
omidpv |
Chaîne | Version de l'intégration du SDK OM. Identique au paramètre "versionString" de l'objet partenaire OMID. |
schain |
La chaîne d'approvisionnement |
Les nouvelles intégrations doivent utiliser le champ schain dans Source.
|
Objet Regs
Champ | Type | Détails |
---|---|---|
coppa |
Nombre entier | 0 (par défaut) : la loi COPPA ne s'applique pas à cette demande.1 : cette requête est soumise à la loi COPPA. |
ext |
Extensions Regs | Facultatif. |
Objet d'extensions Regs
Champ | Type | Détails |
---|---|---|
gdpr |
Nombre entier | Indique si la demande d'enchères provient de la région EEE.0 (par défaut) : région hors EEE.1 : région de l'EEE,Pour en savoir plus, consultez Solution de fournisseur ayant obtenu le consentement pour le RGPD. |
us_privacy |
Chaîne | Veuillez suivre les spécifications techniques fournies par l'IAB Tech Lab pour implémenter la chaîne us_privacy .
Lorsque nous recevons la chaîne |
Objet d'impression
Champ | Type | Détails |
---|---|---|
id |
Chaîne | Identifiant unique de cette impression dans le contexte de la demande d'enchères (la valeur commence généralement par 1 et augmente jusqu'à n pour n impressions). |
metric |
Objet | Non compatible |
banner |
Banner | Obligatoire pour les opportunités d'annonces display. |
video |
Vidéo | Obligatoire pour les opportunités d'annonces vidéo. |
audio |
Audio | Obligatoire pour les opportunités d'annonces audio. |
native |
Natif | Obligatoire pour les opportunités d'annonces natives. |
pmp |
Pmp | Accords de place de marché privée en vigueur pour cette impression. |
displaymanager |
Chaîne | Nom du partenaire de médiation publicitaire, de la technologie SDK ou du lecteur responsable du rendu de l'annonce (généralement vidéo ou mobile). Utilisé par certains ad servers pour personnaliser le code publicitaire par partenaire. Recommandé pour les vidéos et/ou les applications. |
displaymanagerver |
Chaîne | Version du partenaire de médiation publicitaire, de la technologie SDK ou du lecteur responsable du rendu de l'annonce (généralement vidéo ou mobile). Utilisé par certains ad servers pour personnaliser le code publicitaire par partenaire. Recommandé pour les vidéos et/ou les applications. |
instl |
Nombre entier |
0 (par défaut) : non interstitiel.1 : l'annonce est interstitielle ou en plein écran.
|
tagid |
Chaîne | Identifiant de l'emplacement d'annonce ou de la balise publicitaire spécifiques utilisés pour lancer l'enchère. Cela peut être utile pour résoudre les problèmes ou pour l'optimisation par l'acheteur. |
bidfloor |
Float | Enchère minimale pour cette impression, exprimée en CPM. |
bidfloorcur |
Chaîne |
Devise spécifiée à l'aide des codes alphabétiques ISO-4217. |
clickbrowser |
Nombre entier |
Indique le type de navigateur qui s'ouvre lorsque l'utilisateur clique sur la création dans une application. Notez que le contrôleur de vue Safari dans les appareils iOS 9.x est considéré comme un navigateur natif pour ce champ. |
secure |
Nombre entier |
Si cette impression nécessite une URL HTTPS sécurisée ou une URL HTTP non sécurisée.0 (par défaut) : insecure1 : secure
|
iframebuster |
Tableau de chaînes | |
exp |
Nombre entier | L'expiration des enchères est définie par DV360, sans tenir compte de la valeur envoyée par un partenaire dans ce champ. Les événements d'impression reçus après le délai d'obsolescence des impressions (généralement une heure) sont considérés comme obsolètes et ne sont pas facturables par DV360. |
rwdd |
Nombre entier |
Indique si l'utilisateur reçoit ou non une récompense pour avoir vu l'annonce.0 (par défaut) : non récompensé1 : récompensé
En général, les implémentations d'annonces vidéo permettent aux utilisateurs de lire un article de presse supplémentaire sans frais, de recevoir une vie supplémentaire dans un jeu ou de bénéficier d'une session musicale sponsorisée sans publicité. La récompense est généralement distribuée une fois l'annonce vidéo terminée. |
Objet d'extension d'impression
Champ | Type | Détails |
---|---|---|
bcrid |
Chaîne | Liste des ID de créations à bloquer. |
Objet de bannière
Champ | Type | Détails |
---|---|---|
format |
Tableau Format | Liste des formats acceptés. |
w |
Nombre entier |
format à la place.
|
h |
Nombre entier |
format à la place.
|
wmax |
Nombre entier | Non compatible |
hmax |
Nombre entier | Non compatible |
wmin |
Nombre entier | Non compatible |
hmin |
Nombre entier | Non compatible |
btype |
Tableau d'entiers |
Voici la liste des types de bannières publicitaires bloqués :
|
battr |
Tableau d'entiers | Les valeurs suivantes sont acceptées :
|
pos |
Nombre entier |
Position de l'annonce :
|
mimes |
Tableau de chaînes |
Non compatible
DV360 utilisera text/html pour toutes les créations bannière. |
topframe |
Nombre entier |
0 (par défaut) : la bannière est diffusée dans un iFrame.1 : Incompatible : la bannière est diffusée dans le frame supérieur.
|
expdir |
Tableau d'entiers |
1 : Gauche2 : Droite3 : Haut4 : Bas5 : Plein écran extensible
|
api |
Tableau d'entiers |
Frameworks API compatibles
|
id |
Chaîne |
Identifiant de l'objet de bannière. Il doit être unique dans l'impression.
Recommandé lorsque des objets |
vcm |
Nombre entier |
Ne s'applique qu'à un 0 : la bannière est visible en même temps que la création vidéo.1 : la bannière est une fiche de fin de vidéo.
|
Objet de format
Champ | Type | Détails |
---|---|---|
w |
Nombre entier | Largeur en pixels indépendants de la densité (DIPS). |
h |
Nombre entier | Hauteur en pixels indépendants du périphérique (DIP). |
wratio |
Nombre entier | Non compatible |
hratio |
Nombre entier | Non compatible |
wmin |
Nombre entier | Non compatible |
Objet vidéo
Nous vous recommandons vivement de spécifier l'emplacement vidéo dans la demande d'enchères. Un champ d'emplacement manquant est classé comme emplacement inconnu. Pour en savoir plus, consultez l'article sur le ciblage par position.
Champ | Type | Détails |
---|---|---|
mimes |
Tableau de chaînes |
Vous devez indiquer au moins un type MIME.
|
minduration |
Nombre entier | Durée minimale de la vidéo en secondes (aucune durée minimale par défaut). |
maxduration |
Nombre entier | Durée maximale d'une vidéo en secondes (aucune durée maximale par défaut). |
protocols |
Tableau d'entiers |
Vous devez indiquer au moins un protocole compatible.
|
w |
Nombre entier | Largeur du lecteur vidéo en pixels indépendants de la densité (DIPS). |
h |
Nombre entier | Hauteur du lecteur vidéo en pixels indépendants de la densité (DIPS). |
startdelay |
Nombre entier | Délai de démarrage en secondes pour les emplacements d'annonces pré-roll, mid-roll ou post-roll. |
placement |
Nombre entier | Nous vous recommandons vivement de spécifier l'emplacement (plcmt) et/ou l'emplacement de la vidéo dans la demande d'enchères.
Si les deux champs sont manquants, l'emplacement sera classé comme inconnu.
|
plcmt |
Nombre entier | Nous vous recommandons vivement de spécifier l'emplacement (plcmt) et/ou l'emplacement de la vidéo dans la demande d'enchères.
Si les deux champs sont manquants, l'emplacement sera classé comme inconnu.
Remarque : Pour être considérées comme InStream (emplacement ou type d'emplacement 1), les impressions/emplacements vidéo doivent être définis sur "son activé" et correctement signalés dans la méthode de lecture (les valeurs 1, 3, 4 et 5 sont toutes acceptées).
Remarque : Si vous fournissez à la fois plcmt: Accompanying Content (2) est considéré comme placement: In Article (3) plcmt: No Content/Standalone (4) est considéré comme placement: In feed (4) placement: In Banner n'a pas de mappage dans plcmt
|
linearity |
Nombre entier | Non compatible |
skip |
Nombre entier |
Indique si le lecteur vidéo permet d'ignorer l'annonce.
|
skipmin |
Nombre entier | Non compatible |
skipafter |
Nombre entier | Non compatible |
sequence |
Nombre entier | Si plusieurs impressions d'annonces sont proposées dans la même demande d'enchère, le numéro de séquence permettra la diffusion coordonnée de plusieurs créations. |
battr |
Tableau d'entiers | Attributs de création bloqués. |
maxextended |
Nombre entier |
Durée maximale de l'annonce vidéo étendue, si l'extension est autorisée.
|
minbitrate |
Nombre entier | Débit minimal en Kbits/s. |
maxbitrate |
Nombre entier | Débit maximal en Kbits/s. |
boxingallowed |
Nombre entier |
Indique si le letterboxing du contenu au format 4:3 dans une fenêtre au format 16:9 est autorisé.
|
playbackmethod |
Tableau d'entiers |
Méthodes de lecture pouvant être utilisées. Si aucune n'est spécifiée, n'importe quelle méthode peut être utilisée.
|
playbackend |
Nombre entier |
Événement qui provoque la fin de la lecture.
|
delivery |
Tableau d'entiers | Modes de diffusion acceptés. Si aucune valeur n'est spécifiée, tous les types sont supposés être acceptés.
|
pos |
Nombre entier |
Position de l'annonce à l'écran.
|
companionad |
Tableau Banner | Annonces associées, si disponibles. |
api |
Tableau d'entiers |
|
companiontype |
Tableau d'entiers | Non compatible |
maxseq |
Nombre entier | Nombre maximal d'annonces à renvoyer dans une série d'annonces vidéo dynamique. |
poddur |
Tableau d'entiers | Durée maximale d'une série d'annonces vidéo dynamiques (en secondes). |
Extension acceptée pour l'objet vidéo
Champ | Type | Détails |
---|---|---|
rewarded |
Nombre entier | Ce champ permet d'indiquer si les demandes sont récompensées ou non. Cette valeur doit être envoyée sous la forme d'un nombre entier.
|
Objet audio
Champ | Type | Détails |
---|---|---|
mimes |
Tableau de chaînes |
Vous devez indiquer au moins un type MIME.
|
minduration |
Nombre entier | Durée minimale de l'annonce en secondes. |
maxduration |
Nombre entier | Durée maximale de l'annonce en secondes. |
protocols |
Tableau d'entiers |
|
startdelay |
Nombre entier | Délai de démarrage en secondes pour les emplacements publicitaires pré-roll, mid-roll ou post-roll.
|
sequence |
Nombre entier | Non compatible |
battr |
Tableau d'entiers | Non compatible |
maxextended |
Nombre entier | Non compatible |
minbitrate |
Nombre entier | Débit minimal en Kbits/s. |
maxbitrate |
Nombre entier | Débit maximal en Kbits/s. |
delivery |
Tableau d'entiers | Non compatible |
companionad |
Tableau Banner object | Tous les emplacements de créations associées de type bannière. |
api |
Tableau d'entiers |
Liste des frameworks d'API compatibles avec cette impression.
|
companiontype |
Tableau d'entiers | Non compatible |
maxseq |
Tableau d'entiers | Non compatible |
feed |
Nombre entier |
Type de flux audio.
|
stitched |
Nombre entier | Non compatible |
nvol |
Nombre entier | Non compatible |
Objet natif
Pour en savoir plus, consultez les spécifications des annonces natives DV360.
Champ | Type | Détails |
---|---|---|
request |
Chaîne | Objet JSON natif encodé sous forme de chaîne. |
ver |
Chaîne |
1.0 : Non compatible1.1 : Non compatible1.2
|
api |
Tableau d'entiers |
Liste des frameworks d'API compatibles avec cette impression.
|
battr |
Tableau d'entiers | Non compatible |
Objet PMP
Champ | Type | Détails |
---|---|---|
private_auction |
Nombre entier |
0 (par défaut) : toutes les enchères sont autorisées1 : offres uniquement
|
deals |
Tableau Deal object | Offres à inclure. |
Objet "Opportunité"
Champ | Type | Détails |
---|---|---|
id |
Chaîne | Un objet PMP ne peut pas contenir plusieurs objets d'accord par ID. |
bidfloor |
Double |
Enchère minimale pour cette impression en CPM.
Obligatoire si |
bidfloorcur |
Chaîne |
Devise spécifiée à l'aide des codes alphabétiques ISO-4217.
Si aucune valeur n'est spécifiée, la devise de la demande d'enchères est utilisée par défaut. |
at |
Nombre entier |
La valeur par défaut est bid_request.at si aucune valeur n'est spécifiée.
|
wseat |
Tableau de chaînes |
ID des partenaires éligibles à l'accord.
"Aucun siège" signifie qu'il n'y a aucune restriction de siège. |
wadomain |
Tableau de chaînes |
Domaines d'annonceurs autorisés à enchérir sur cet accord.
Aucun siège n'implique aucune restriction de domaine. |
guar |
Nombre entier |
Ce champ permet d'indiquer si l'accord est garanti. Cette valeur doit être envoyée sous la forme d'un nombre entier.
Une place de marché doit être ajoutée à la liste d'autorisation pour que DV360 accepte les accords garantis. Contactez-nous pour en faire la demande. Si votre place de marché utilise actuellement un autre mécanisme pour signaler les deals garantis avec DV360, contactez-nous pour discuter de la possibilité de passer à cette extension recommandée.
|
ext |
Extensions d'offres | Facultatif. |
Extension acceptée pour l'objet "deal"
Champ | Type | Détails |
---|---|---|
guaranteed |
Nombre entier |
Ce champ permet d'indiquer si l'accord est garanti. Cette valeur doit être envoyée sous la forme d'un nombre entier.
Une place de marché doit être ajoutée à la liste d'autorisation pour que DV360 accepte les accords garantis. Contactez-nous pour en faire la demande. Si votre place de marché utilise actuellement un autre mécanisme pour signaler les deals garantis avec DV360, contactez-nous pour discuter de la possibilité de passer à cette extension recommandée.
Nous vous recommandons d'utiliser |
Objet Site
Champ | Type | Détails |
---|---|---|
id |
Chaîne | ID du site sur la place de marché. |
name |
Chaîne | Non compatible |
domain |
Chaîne |
Domaine du site.
Nous vous recommandons d'envoyer une URL complète dans site.page plutôt que de renseigner uniquement site.domain. |
cat |
Tableau de chaînes | Non compatible |
sectioncat |
Tableau de chaînes | Non compatible |
pagecat |
Tableau de chaînes | Non compatible |
page |
Chaîne |
URL complète où l'impression doit être diffusée.
Nous vous recommandons d'envoyer l'URL complète à des fins de ciblage. |
ref |
Chaîne | URL de provenance ayant entraîné la navigation vers la page actuelle. |
search |
Chaîne | Non compatible |
mobile |
Nombre entier | Non compatible |
privacypolicy |
Nombre entier | Non compatible |
publisher |
Objet Publisher | Informations sur l'éditeur du site. |
content |
Objet de contenu | Informations sur le contenu d'un site. |
keywords |
Chaîne (format CSV) | Non compatible |
ext |
Extensions de site | Extensions pour l'objet site. |
Objet d'extension de site
Champ | Type | Détails |
---|---|---|
inventorypartnerdomain |
Chaîne | Utilisé pour le partage d'inventaire de TV connectée. Consultez l'explication de l'IAB sur les fichiers app-ads.txt pour TV connectée. |
Objet d'application
Champ | Type | Détails |
---|---|---|
id |
Chaîne | ID de l'application sur la plate-forme d'échange. |
name |
Chaîne |
Noms des applications, qui peuvent être des alias à la demande des éditeurs.
Les éditeurs peuvent fournir directement les noms d'applications pour les demandes sans SDK (principalement pour les téléviseurs connectés). |
bundle |
Chaîne |
Obligatoire.
Pour iOS, il doit s'agir de l'ID numérique de l'App Store. Nous n'acceptons pas l'ID de bundle de style DNS inverse. Pour une application CTV, nous vous recommandons de transmettre l'identifiant d'application défini par la plate-forme de téléchargement. Veuillez respecter les consignes de l'IAB concernant les ID attribués par les plates-formes pour services de distribution par contournement et TV connectées récemment publiées. |
domain |
Chaîne | Le domaine, par exemple mygame.foo.com |
storeurl |
Chaîne | Obligatoire pour la validation app-ads.txt et la validation de la plate-forme de téléchargement d'applications pour TV connectée. |
cat |
Tableau de chaînes | Non compatible |
sectioncat |
Tableau de chaînes | Non compatible |
pagecat |
Tableau de chaînes | Non compatible |
ver |
Chaîne | Non compatible |
privacypolicy |
Nombre entier | Non compatible |
paid |
Nombre entier | Non compatible |
publisher |
Objet Publisher | Informations sur l'éditeur de l'application. |
content |
Objet de contenu | Informations sur le contenu de l'application. |
keywords |
Chaîne (format CSV) | Non compatible |
ext |
Extensions d'application | Extensions pour l'objet app. |
Objet d'extension d'application
Champ | Type | Détails |
---|---|---|
inventorypartnerdomain |
Chaîne | Utilisé pour le partage d'inventaire de TV connectée. Consultez l'explication de l'IAB sur les fichiers app-ads.txt pour TV connectée. |
Objet de contenu
Nous vous recommandons de transmettre ces attributs lorsqu'ils sont disponibles.
Champ | Type | Détails |
---|---|---|
id |
Chaîne | ID identifiant le contenu de manière unique. |
episode |
Nombre entier | Numéro de l'épisode du contenu (normalement pour le contenu vidéo). |
title |
Chaîne | Recommandé pour les demandes concernant la TV connectée, les vidéos et l'audio. |
series |
Chaîne | Recommandé pour les demandes concernant la TV connectée, les vidéos et l'audio. |
season |
Chaîne | Libellé de la saison du contenu. |
artist |
Chaîne | Artiste crédité pour le contenu. |
genre |
Chaîne | Genre qui décrit le mieux le contenu. DV360 recommande de fournir ce signal pour les demandes concernant la TV connectée, les vidéos et l'audio.
DV360 accepte plusieurs taxonomies de valeurs de genre vidéo pour ce champ :
|
album |
Chaîne | Album auquel appartient le contenu, généralement pour l'audio. |
isrc |
Chaîne | Code ISRC (International Standard Recording Code) conforme à la norme ISO-3901. |
producer |
Objet producteur | Informations sur le producteur du contenu. |
url |
Chaîne | URL du contenu. |
cat |
Tableau de chaînes | Catégories de contenu de l'IAB qui décrivent le contenu. |
prodq |
Nombre entier |
Qualité de la production :
|
videoquality |
Nombre entier | Non compatible |
context |
Nombre entier |
Type de contenu :
|
contentrating |
Chaîne | Recommandé pour l'audio et la vidéo/CTV, car nous commencerons à prendre des décisions sur cet attribut. |
userrating |
Chaîne | Nombre d'étoiles, de "J'aime", etc. |
qagmediarating |
Nombre entier |
Classification du contenu multimédia selon les [consignes du QAG](http://www.iab.net/ne_guidelines).
|
keywords |
Chaîne (format CSV) | Non compatible |
livestream |
Nombre entier |
Si le contenu est un flux en direct.
|
sourcerelationship |
Nombre entier |
|
len |
Nombre entier |
Durée du contenu en secondes.
Recommandé pour les demandes d'annonces CTV/vidéo et audio. |
language |
Chaîne (ISO-639-1-alpha-2) | Langue du contenu. |
embeddable |
Nombre entier |
Indique si le contenu est intégrable (par exemple, un lecteur vidéo intégrable).
|
data |
Tableau d'objets de données | Données supplémentaires. |
Objet producteur
Champ | Type | Détails |
---|---|---|
id |
Chaîne | Non compatible |
name |
Chaîne | Non compatible |
cat |
Tableau de chaînes | Non compatible |
domain |
Chaîne | Domaine de premier niveau du producteur. |
Objet de données
Champ | Type | Détails |
---|---|---|
id |
Chaîne | ID du fournisseur de données. |
name |
Chaîne | Nom de l'échange pour le fournisseur de données. |
segment |
Tableau d'objets Segment | Valeurs de données réelles. |
ext |
Extensions de données | Extensions pour l'objet Data. |
Extensions compatibles pour l'objet de données
Champ | Type | Détails |
---|---|---|
segtax |
Nombre entier | ID de taxonomie. Pour en savoir plus, consultez Taxonomies des segments. |
segclass |
Chaîne | Version du classificateur qui a produit les ID de segment dans la taxonomie. |
Objet Segment
Champ | Type | Détails |
---|---|---|
id |
Chaîne | ID du segment de données spécifique au fournisseur de données. |
name |
Chaîne | Nom du segment de données. |
value |
Chaîne | Valeur du segment de données. |
Objet Publisher
Champ | Type | Détails |
---|---|---|
id |
Chaîne | Obligatoire. |
name |
Chaîne | Non compatible |
cat |
Tableau de chaînes | Non compatible |
domain |
Chaîne | Non compatible |
Objet Device
Champ | Type | Détails |
---|---|---|
ua |
Chaîne | Obligatoire. |
sua |
Objet UserAgent | Informations structurées sur l'agent utilisateur. |
geo |
Objet géographique | Emplacement de l'appareil. |
dnt |
Nombre entier |
Indicateur "Ne pas suivre" tel qu'il est défini dans l'en-tête du navigateur.
|
lmt |
Nombre entier |
Le signal "Limiter le suivi des annonces" est approuvé commercialement.
|
ip |
Chaîne |
Obligatoire si IPv4.
Si l'adresse IP est tronquée, elle doit être déclarée dans |
ipv6 |
Chaîne |
Obligatoire si IPv6.
Si l'adresse IP est tronquée, elle doit être déclarée dans |
devicetype |
Nombre entier | Fortement recommandé pour tous les types d'inventaire. Utilisé pour améliorer la reconnaissance du type d'appareil. |
make |
Chaîne | |
model |
String | |
os |
Chaîne |
Système d'exploitation de l'appareil.
Ce champ n'est pas sensible à la casse. |
osv |
Chaîne | Non compatible |
hwv |
Chaîne | Version matérielle de l'appareil. |
h |
Nombre entier | Hauteur physique de l'écran en pixels. |
w |
Nombre entier | Largeur physique de l'écran en pixels. |
ppi |
Nombre entier | Non compatible |
pxratio |
Double | Rapport entre les pixels physiques et les pixels indépendants de l'appareil. |
js |
Nombre entier | Non compatible |
geofetch |
Nombre entier | Non compatible |
flashver |
Chaîne | Non compatible |
language |
Chaîne (ISO-639-1-alpha-2) | Langue de l'appareil. |
carrier |
Chaîne | Non compatible |
mccmnc |
Chaîne | Non compatible |
connectiontype |
Nombre entier | Type de connexion réseau |
ifa |
Chaîne | ID autorisé pour l'annonceur à utiliser en clair. |
didsha1 |
Chaîne | Non compatible |
didmd5 |
Chaîne | Non compatible |
dpidsha1 |
Chaîne | Non compatible |
dpidmd5 |
Chaîne | Non compatible |
macsha1 |
Chaîne | Non compatible |
macmd5 |
Chaîne | Non compatible |
ext |
Extensions d'appareil | Extensions pour l'objet device. |
Extension acceptée pour l'objet appareil
Si ip
est modifié ou tronqué, nous vous recommandons vivement d'envoyer les extensions suivantes pour éviter que le trafic ne soit déclaré comme incorrect.
Champ | Type | Détails |
---|---|---|
truncated_ip |
Nombre entier |
Indique si l'adresse IP figurant dans le champ device.ip de la demande d'enchère est tronquée.
La valeur par défaut est "false" (non tronquée). Elle est obligatoire si l'adresse IP est tronquée. Si elle n'est pas déclarée, la demande d'enchère peut être classée comme trafic incorrect. |
ifa_type |
Chaîne |
Indiquez l'origine du champ device.ifa, qu'il provienne de l'appareil lui-même ou qu'il ait été généré par l'éditeur ou la SSP dans la supply chain.
|
attestation_token |
Chaîne (encodage Base64) | Jeton d'attestation basé sur l'appareil pour les plates-formes d'échange qui acceptent ce niveau de validation des appareils. |
atts |
Nombre entier |
(iOS uniquement) Entier transmis pour représenter l'état d'autorisation du suivi de l'application.
|
cdep |
Chaîne |
Libellé de l'arrêt des cookies tiers dans Chrome.
Consultez Tests facilités par Chrome et la spécification de la communauté IAB. |
Objet UserAgent
Champ | Type | Détails |
---|---|---|
browsers |
Tableau d'objets BrandVersion | Chaque objet BrandVersion identifie un navigateur ou un composant logiciel similaire. |
platform |
Objet BrandVersion | Identifie la plate-forme. |
mobile |
Nombre entier |
0 (par défaut) : l'agent préfère le contenu "desktop" ou "full".
1 : l'agent préfère le contenu "mobile".
|
architecture |
Chaîne | Architecture de l'appareil, par exemple "x86" ou "arm". |
bitness |
Chaîne | Nombre de bits de l'appareil (par exemple, "64" pour une architecture 64 bits). |
model |
Chaîne | Modèle de l'appareil. |
source |
Nombre entier | Source de données utilisée pour créer cet objet. Pour en savoir plus, consultez Liste : source de l'user-agent. Recommandé lors de la transmission de l' objet UserAgent. |
Objet BrandVersion
Champ | Type | Détails |
---|---|---|
brand |
Chaîne | Identifiant de la marque, par exemple "Chrome" ou "Windows". Obligatoire. |
version |
Tableau de chaînes | Séquence de composants de version, dans l'ordre hiérarchique décroissant (majeur, mineur, micro, etc.). |
Objet géographique
Champ | Type | Détails |
---|---|---|
lat |
Double | Non compatible |
lon |
Double | Non compatible |
type |
Nombre entier | Non compatible |
accuracy |
Nombre entier | Non compatible |
lastfix |
Nombre entier | Non compatible |
ipservice |
Nombre entier | Non compatible |
country |
Chaîne | Non compatible |
region |
Chaîne | Non compatible |
regionfips104 |
Chaîne | Non compatible |
metro |
Chaîne | Non compatible |
city |
Chaîne | Non compatible |
zip |
Chaîne | Non compatible |
utcoffset |
Nombre entier | Non compatible |
Objet utilisateur
Champ | Type | Détails |
---|---|---|
id |
Chaîne | Compatible si Google héberge la table de mise en correspondance des identifiants. |
buyeruid |
Chaîne | Prise en charge si la SSP héberge la table de correspondance des ID. |
yob |
Nombre entier | Recommandé pour le ciblage démographique. |
gender |
Chaîne | Recommandé pour le ciblage démographique. |
keywords |
Chaîne (CSV) | Non compatible |
customdata |
Chaîne | Non compatible |
geo |
Objet géographique | Non compatible |
data |
Tableau d'objets de données | Données supplémentaires. |
eids |
Tableau d'objets d'ID étendus | Instances d'ID étendus fournies par la place de marché. |
ext |
Extensions utilisateur | Extensions pour l'objet utilisateur. |
Extensions compatibles pour l'objet utilisateur
Champ | Type | Détails |
---|---|---|
consent |
Chaîne (base64 compatible avec le Web) |
Chaîne de consentement IAB.
Contient des métadonnées sur les informations que l'utilisateur a accepté de partager et sur les fournisseurs autorisés à les utiliser. La valeur est une chaîne binaire encodée en base64 adaptée au Web à l'aide d'un format binaire personnalisé. |
us_privacy |
Chaîne | Si l'utilisateur a vu les informations sur la conformité avec la loi CCPA ou des lois similaires. |
consented_providers_settings .consented_providers |
Objet externe (consented_providers_settings) contenant un tableau d'entiers interne (consented_providers). | Lorsque le consentement RGPD est recueilli via le TCF, ce champ liste les fournisseurs de technologie publicitaire ayant obtenu le consentement de l'utilisateur, mais qui ne participent pas au TCF. Consultez la spécification technique de Google concernant le consentement supplémentaire. |
eids |
Tableau d'objets d'ID étendus | Instances d'ID étendus fournies par la place de marché. |
Objet ID étendu
Champ | Type | Détails |
---|---|---|
source |
Chaîne | Fournisseur de l'identifiant |
uids |
Tableau d'objets UID d'ID étendus | Identifiants réels |
Objet UID d'ID étendu
Champ | Type | Détails |
---|---|---|
id |
Chaîne | Identifiant lui-même. |
atype |
Nombre entier | Type d'agent utilisateur associé à cet ID. |
Objet de la chaîne d'approvisionnement
Champ | Type | Détails |
---|---|---|
complete |
Nombre entier | 0 (par défaut) : la chaîne d'approvisionnement est incomplète.1 : la chaîne d'approvisionnement est complète jusqu'à l'éditeur.
|
ver |
Chaîne | Obligatoire. La valeur est au format "major.minor". Par exemple, la version 1.0 correspond à la chaîne "1.0". |
nodes |
Tableau Supply chain node | Obligatoire. Dans une chaîne d'approvisionnement complète, le premier nœud représente le système publicitaire et l'ID de vendeur initiaux impliqués dans la transaction, c'est-à-dire le propriétaire du site, de l'application ou d'un autre support. Dans une supply chain incomplète, il représente le premier nœud connu. Le dernier nœud représente l'entité qui envoie cette demande d'enchère. |
Objet de nœud de la chaîne d'approvisionnement
Champ | Type | Détails |
---|---|---|
asi |
Chaîne | Nom de domaine canonique du système auquel les enchérisseurs se connectent (par exemple, SSP, place de marché ou header wrapper). Vous pouvez indiquer le domaine d'exploitation du système (s'il est différent du domaine parent de l'entreprise) pour faciliter la consultation des informations WHOIS et la recherche IP inversée de sorte que la propriété du système délégué soit clairement établie.
Cette valeur doit être identique à celle utilisée pour identifier les vendeurs dans un fichier ads.txt, le cas échéant. |
sid |
Chaîne | Identifiant associé au compte du vendeur ou du revendeur dans le système publicitaire. Il doit contenir la même valeur que celle utilisée dans les transactions (c'est-à-dire les demandes d'enchères OpenRTB) dans le champ spécifié par la SSP/place de marché.
Généralement, dans OpenRTB, il s'agit de publisher.id. et dans OpenDirect, de l'identifiant de l'entreprise de l'éditeur. Ne doit pas dépasser 64 caractères. |
rid |
Chaîne | RequestId OpenRTB de la demande émise par ce vendeur. |
name |
Chaîne | Nom de l'entreprise (entité juridique) payée pour l'inventaire ayant fait l'objet de transactions sous l'ID de vendeur donné. Cette valeur est facultative et ne doit PAS être incluse si elle existe dans le fichier sellers.json du système publicitaire. |
domain |
Chaîne | Nom de domaine de l'entité représentée par ce nœud.
Cette valeur est facultative et ne doit PAS être incluse si elle existe dans le fichier sellers.json du système publicitaire. |
hp |
Nombre entier | Indique si ce nœud sera impliqué dans le flux de paiement pour l'inventaire.
Pour la version 1.0 de SupplyChain, cette propriété doit toujours être définie sur 1. Il doit être inclus de manière explicite, car les futures versions de la spécification devraient introduire des nœuds de gestion non liés au paiement. Les responsables de l'implémentation doivent s'assurer qu'ils prennent en charge ce champ et qu'ils le propagent lors de la construction d'objets SupplyChain dans les demandes d'enchères envoyées à un système publicitaire en aval. |
Spécification des réponses aux enchères
Objet BidResponse
Attribut | Compatible | Détails de mise en œuvre | Toujours réussi |
---|---|---|---|
id | En cas d'erreur d'analyse, cette valeur peut être "0" au lieu de l'ID de la demande d'enchère. | Oui | |
seatbid | |||
bidid | |||
cur | Si une erreur d'analyse se produit, elle n'est pas transmise. Pour le trafic de demandes d'enchères valides, la devise est toujours fournie. | Oui | |
customdata | |||
nbr |
Cette section n'est incluse que si un problème a été détecté dans la demande d'enchère. Les valeurs possibles sont les suivantes :2 : Demande non valide12 : Non-respect de l'autorisation ads.txt16 : SupplyChain incomplète17 : Nœud SupplyChain bloquéRemarque : Lorsqu'un non-respect spécifique d'app-ads.txt ou de SupplyChain est détecté, l'un des codes 12, 16 ou 17 est renseigné dans une fraction (1 %) des réponses. Le code 2 sera renseigné pour toutes les autres demandes non valides. Les demandes incluant NBR ressembleront à ceci : { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } } |
||
ext | En cas de problème avec l'extension de la demande d'enchère, celle-ci peut contenir des informations permettant de diagnostiquer l'erreur, le cas échéant. |
Extensions compatibles pour l'objet BidResponse
Attribut | Détails de mise en œuvre |
---|---|
err | Description de l'erreur liée à la demande d'enchères, dans un format lisible. Voici quelques exemples de cas de réponse :
|
errHelp | Un lien vers cette page. |
Objet Seatbid
Attribut | Compatible | Détails de mise en œuvre | Toujours réussi |
---|---|---|---|
enchère | oui | ||
siège | oui | ||
groupe |
Objet d'enchère
Attribut | Compatible | Détails de mise en œuvre | Toujours réussi |
---|---|---|---|
id | oui | ||
impid | oui | ||
price | oui | ||
nurl | |||
ronce | |||
lurl | |||
adm | |||
adid | |||
adomain | |||
bundle | |||
iurl | |||
cid | oui | ||
crid | oui | ||
stratégie | |||
cat | |||
attr | |||
api | |||
protocol | |||
qagmediarating | |||
language | |||
dealid | |||
w | |||
h | |||
wratio | |||
hratio | |||
exp |
Extensions compatibles pour l'objet d'enchère
Attribut | Détails de mise en œuvre |
---|---|
apis |
DV360 enverra seatbid.bid.apis si OMID et MRAID sont tous deux acceptés. DV360 définira OMID_1 et MRAID comme un tableau d'entiers. |
Options de diffusion des annonces
La section 4.3 de la spécification OpenRTB propose deux options de diffusion différentes :
- Balisage diffusé sur la notification de gain
- Balisage diffusé dans l'enchère
DV360 accepte les deux options.
- Pour les bannières publicitaires, DV360 renvoie toujours le balisage dans le champ
adm
. Le balisage affiché sur la notification de gain est facultatif. - Pour les annonces vidéo/audio utilisant le protocole VAST, DV360 permet de renvoyer le fichier XML VAST dans le champ
adm
ou dans la réponse de la notification de gain en fonction des exigences des partenaires d'échange.
Consultez la spécification OpenRTB pour connaître les avantages et les inconvénients de ces deux options.
Bonnes pratiques
Nous vous recommandons vivement d'utiliser l'ID de partenaire Display & Video 360 comme ID de siège. Nous vous déconseillons d'utiliser des ID de siège spécifiques aux places de marché.
Assurez-vous que vos éditeurs disposent de fichiers ads.txt ou d'applications associées à des fichiers app-ads.txt, et qu'ils vous y indiquent comme vendeur ou revendeur autorisé. En savoir plus
Veillez également à ce que les informations transmises dans les demandes d'enchères soient cohérentes. Par exemple, app.bundle
doit être cohérent avec les informations sur l'appareil mobile et app.storeurl
.
TV connectée
Respectez les consignes de l'IAB concernant les identifiants publicitaires sur les services de distribution par contournement lorsque vous transmettez device.ifa
et device.lmt
. Vous devez également implémenter device.ext.ifa_type
pour respecter les consignes. Toutes nos fonctionnalités de limitation de la fréquence et de ciblage d'audience sur CTV nécessiteront la présence d'un IFA.
Respectez également les Directives de l'IAB sur les ID attribués par les plates-formes de téléchargement d'applications pour appareils OTT/TV connectées récemment publiées. Elles définissent la façon dont app.bundle
doit être transmis pour les applications CTV, en utilisant principalement l'ID défini par la plate-forme de téléchargement d'applications.
Mesure Active View
Active View est une technologie Google qui permet de mesurer si une impression était visible et pendant combien de temps. Active View utilise OMID pour les annonces display et vidéo. Pour activer la mesure à l'aide d'OMID, les plates-formes d'échange doivent ajouter les champs suivants dans les requêtes OpenRTB afin que DV360 connaisse la compatibilité OMID du client.
- Obligatoire : ajoutez un framework d'API (
Video.api=7
pourOMSDK
) aux demandes d'enchères. Cette étape est obligatoire pour qu'Active View puisse effectuer des mesures à l'aide d'OMID. - Recommandation : il est vivement recommandé d'ajouter
omidpn
etomidpv
àSource.Ext
, car cela aura un impact sur la façon dont les mesures de visibilité sont communiquées au client dans DV360. Si le nom du partenaire OMID ne figure pas dans la liste des certifications de l'IAB, le MRC nous oblige à indiquer les métriques de visibilité séparément des métriques certifiées par le MRC. En savoir plus
Questions fréquentes
- DV360 est-il compatible avec les extensions personnalisées des places de marché ?
- Oui. En plus des extensions listées dans cette spécification, Display & Video 360 peut également accepter des extensions personnalisées au cas par cas. Nous vous recommandons de spécifier et de tester l'extension personnalisée pendant la période d'intégration.
- DV360 est-il compatible avec les vidéos avec récompense ?
- Oui, envoyez-nous l'extension pour les annonces vidéo avec récompense.
- Une grande partie de mon inventaire est associée à des données démographiques inconnues. Comment améliorer la couverture démographique ?
- Renseignez
user.yob
etuser.gender
dans les demandes d'enchères envoyées à DV360 pour augmenter la couverture. - DV360 dispose-t-il de points de terminaison pour chaque région ?
- Non, nous utilisons un seul point de terminaison au niveau mondial et nous acheminons automatiquement les requêtes vers le centre de données le plus proche. Nous ne pouvons donc pas fournir de point de terminaison spécifique à une région.
- Quelles sont les exigences concernant les requêtes de serveur à serveur (s2s) ?
- Contactez-nous pour demander l'ajout à notre liste d'autorisation. L'User-Agent du client doit être transféré et les cookies doivent être désactivés/ignorés dans la réponse à une récupération VAST s2s.
- DV360 est-il compatible avec OMID ?
- Nous pouvons mesurer la visibilité à l'aide d'OMID, à condition qu'il soit déclaré comme compatible avec OMID au moment de la demande d'enchère. Pour en savoir plus, consultez les pages 24 et 25.
- Quelle version de Native est compatible ? Avez-vous des exigences concernant les annonces natives ?
- Nous n'acceptons que Native V1.2. Spécifications des annonces natives.
- DV360 accepte-t-il les demandes d'enchères envoyées au format GZIP ?
- DV360 peut recevoir des demandes d'enchères compressées au format gzip et répondra avec des réponses compressées au format gzip si l'en-tête Accept-Encoding indique que ce format est accepté.
- DV360 est-il compatible avec DBURL ?
- Pas pour le moment.
- DV360 est-il compatible avec les notifications de gain/perte ?
- Pas pour le moment. Si vous pensez qu'il nous serait utile de le prendre en charge, veuillez nous contacter pour nous en dire plus.
- DV360 exige-t-il un nom d'application pour le ciblage ?
- Non, DV360 utilise App.name comme référence, mais ce n'est pas obligatoire pour le ciblage.
App.bundle
est utilisé pour le ciblage. - DV360 peut-il accepter plusieurs tailles d'annonces envoyées dans une même demande d'enchère ?
- Oui, nous prendrons en compte toutes les tailles de créations éligibles dans banner.format.
- DV360 prend-il en charge plusieurs formats dans la même demande d'enchère ?
- Nous ne prenons en charge que partiellement les demandes d'enchères multiformat, mais nous travaillons à l'amélioration de cette fonctionnalité. Nous acceptons les formats display et vidéo pour les interstitiels, mais pas les formats display et natif pour le moment. Si vous envoyez des demandes d'enchères multiformat, veuillez nous contacter pour demander un test.
- DV360 accepte-t-il les types d'impression mixtes dans une même demande ?
- Nous n'acceptons actuellement que les interstitiels vidéo/bannières. Nous travaillons sur les formats natif/bannière et vidéo/bannière. Si vous constatez d'autres combinaisons, veuillez contacter notre équipe.
- Plusieurs sièges peuvent-ils envoyer chacun plusieurs enchères pour une ou plusieurs de ces opportunités d'impression dans la même demande ?
- Oui.
- DV360 a-t-il une solution ou un besoin particulier concernant la limitation ou l'affichage du même annonceur pour plusieurs opportunités d'impression de ce type dans la même demande ?
- DV360 applique la règle selon laquelle un annonceur ne peut enchérir que sur une seule opportunité d'impression par demande. Nous attendons des SSP qu'ils regroupent les objets d'impression de manière pertinente (par exemple, tous sur la même page, tous dans la même application, etc.).
- DV360 accepte-t-il plusieurs impressions dans la même demande d'enchère ?
- DV360 est actuellement compatible avec plusieurs objets audio d'impression. Toutefois, nous devrons tester/activer chaque plate-forme d'échange qui souhaite utiliser cette fonctionnalité. Pour en savoir plus, consultez les spécifications des demandes d'enchères. Nous travaillons à étendre cette fonctionnalité à d'autres formats :
{ id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38", seatbid { bid { id: "0", impid: "234232", price: 41.373926619828261, adid: "123", adm: "...", adomain: "xxx.com", cid: "0", crid: "123", dealid: "sample-deal-id-1", language: "xx", }, bid { id: "1", impid: "234255", price: 2.34192037470726, adid: "234", adm: "...", adomain: "xyz.com", cid: "0", crid: "234", dealid: "sample-deal-id-2", language: "xx", }, seat: "123456" }, cur: "EUR" }
Nous contacter
Si vous avez des questions ou des problèmes, contactez notre équipe d'assistance pour les plates-formes d'échange.