Demande d’offre sortante aux soumissionnaires

Remarque

Ceci décrit l’intégration du protocole OpenRTB 2.4.

Cette demande de soumission est envoyée aux soumissionnaires chaque fois qu’un appel publicitaire atteint le bus d’impression. Il contient toutes les informations nécessaires pour qu’un soumissionnaire produise un prix de soumission et un créatif à servir.

La demande d’offre inclut des informations des vendeurs qui spécifient quels annonceurs et créatifs sont autorisés à gagner une vente aux enchères et à s’exécuter sur une page.

Remarque

Vous ne souhaiterez peut-être pas recevoir toutes les demandes d’enchères qui transitent par notre plateforme. Vous pouvez limiter les demandes d’un certain pourcentage, ou filtrer les requêtes en fonction de critères prédéfinis tels que la géographie.

Implémentation

Reportez-vous aux tables pour localiser les détails d’implémentation tels que les objets et les en-têtes sur lesquels vous avez besoin d’informations supplémentaires.

En-têtes de demande d’enchère

Champ	Type	Description
Content-Length	int	Longueur du corps de la requête HTTP (qui inclut tous les champs décrits ci-dessous).
Host	string	Adresse IP à laquelle la demande d’offre a été envoyée.
Connection	string	Toujours défini sur "keep-alive" pour garantir la persistance des connexions TCP.
Content-Type	string	Type de contenu transmis dans la demande. Toujours défini sur "application/json".
x-openrtb-version	string	Version openrtb prise en charge dans la demande d’enchère. Actuellement défini sur 2.4.

Objet de demande d’enchère

Xandr prend en charge les champs suivants dans l’objet de demande d’enchère de niveau supérieur :

Champ	Type	Description
id	string	(Obligatoire) Identificateur unique de la demande d’enchère.
imp	tableau d’objets	(Obligatoire) Les impressions offertes dans cette demande d’offre. Consultez l’objet Impression ci-dessous.
site	objet	Spécifie des informations sur le site web ou le sous-ensemble de l’inventaire (groupe de placement) pour les impressions. Applicable pour les impressions de site web. Consultez l’objet Site ci-dessous.
app	objet	Spécifie des informations sur l’application pour les impressions. Applicable aux impressions d’application. Voir Objet d’application ci-dessous.
device	objet	Spécifie des informations sur l’appareil de l’utilisateur sur lequel ces impressions seront remises. Consultez l’objet Device ci-dessous.
user	objet	Spécifie des informations sur la personne à qui les impressions seront remises. Voir Objet utilisateur ci-dessous.
test	entier	Indique que cette enchère est en mode test et n’est pas facturable. S’il n’est pas présent, la valeur par défaut est utilisée. - 0: mode en direct ; facturable (par défaut). - 1: mode test ; non facturable.
at	entier	Spécifie le type d’enchère. S’il n’est pas présent, la valeur par défaut est utilisée. - 1: Premier prix. - 2: Deuxième prix plus un centime (valeur par défaut).
wseat	tableau de chaînes	Spécifie un tableau représentant une liste d’autorisation des sièges d’acheteur autorisés à enchérir sur cette impression.
tmax	entier	Spécifie la durée maximale (en millisecondes) d’envoi d’une enchère avant expiration.
cur	tableau de chaînes	Spécifie un tableau des devises autorisées pour les enchères sur cette demande d’offre à l’aide de codes alphabétiques ISO-4217. La valeur par défaut est USD.
bcat	tableau de chaînes	Spécifie une liste de catégories de contenu bloquées. Inclut les catégories IAB (répertoriées dans la section 5.1 de la spécification). Bcat n’est pas un champ obligatoire et est envoyé uniquement si des catégories bloquées sont associées à la demande d’offre. Si aucune catégorie bloquée n’est associée, nous n’envoyons pas ce champ.
badv	tableau de chaînes	Spécifie une liste de domaines publicitaires de niveau supérieur bloqués qui correspondent aux URL de marque dans notre système. Par exemple : ["company1.com","company2.com"]. Pour plus d’informations, consultez Brand Service. Un maximum de 64 valeurs est envoyé.
regs	objet	Spécifie des informations sur une réglementation industrielle, légale ou gouvernementale en vigueur pour cette demande. Consultez l’objet Regs ci-dessous.
source	objet	Fournit des données sur la source d’inventaire et sur l’entité qui prend la décision finale. Consultez l’objet Source ci-dessous.
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme de la demande d’enchère OpenRTB. Consultez l’objet Extension de demande d’enchère ci-dessous.

Objet d’extension de demande d’enchère

Nous prenons en charge les objets suivants dans l’objet ext pour prendre en charge les extensions spécifiques à la plateforme ainsi que les signaux de chaîne d’approvisionnement :

Champ	Type	Description
appnexus	objet	Spécifie les extensions spécifiques à la plateforme de la demande d’enchère OpenRTB.
schain	objet	Spécifie les champs SupplyChain inclus dans la demande d’enchère OpenRTB pour la transparence du chemin d’approvisionnement. Consultez L’objet Schain ci-dessous.

Objet Schain

Nous prenons en charge les champs suivants dans l’objet schain (Supply Chain) :

Champ	Type	Description
ver	string	Version de la spécification de la chaîne d’approvisionnement utilisée, au format « major.minor ». Actuellement en utilisant la version 1.0 de la spécification.
complete	enum	Indicateur indiquant si la chaîne contient tous les nœuds impliqués dans la transaction menant au propriétaire du site, de l’application ou d’un autre support de l’inventaire, où 0 = non, 1 = oui.
nodes	objet	Tableau d’objets SupplyChainNode dans l’ordre de la chaîne. Dans une chaîne d’approvisionnement complète, le premier nœud représente le système de publicité initial et l’ID de vendeur impliqués dans la transaction, c’est-à-dire le propriétaire du site, de l’application ou d’un autre support. Dans une chaîne d’approvisionnement incomplète, elle représente le premier nœud connu. Le dernier nœud représente l’entité qui envoie cette demande d’enchère, qui est le nœud Xandr. Nous prenons en charge les champs suivants dans l’objet nœuds : - asi (string) : nom de domaine canonique du système SSP, Exchange, Wrapper d’en-tête, etc. auquel les soumissionnaires se connectent. Il doit s’agir de la même valeur que celle utilisée pour identifier les vendeurs dans un fichier ads.txt s’il en existe un. Pour le nœud Xandr, ce domaine sera appnexus.com - sid (string) : identificateur associé au compte vendeur ou revendeur dans le système de publicité. - rid (string) : OpenRTB RequestId de la demande telle qu’elle est émise par le vendeur. - hp (integer) : indique si ce nœud est impliqué dans le flux de paiement de l’inventaire. Pour la version 1.0 de SupplyChain, cette propriété doit toujours être 1.

Objet de demande d’enchère

Nous prenons en charge les champs suivants dans l’objet d’extension appnexus pour l’objet de demande d’enchère :

Champ	Type	Description
seller_member_id	entier	Spécifie l’ID du membre qui vend l’inventaire. Consultez Platform Member Service pour trouver les noms de membres correspondants.
spend_protection	Valeur booléenne	Déconseillé (octobre 2018).
publisher_integration	objet	Fournit des détails sur l’intégration de l’éditeur.
ext_inv_code	entier	Valeur prédéfinie transmise à la chaîne de requête qui peut être utilisée dans la création de rapports. La valeur doit être entrée dans le système avant d’être journalisée. Pour plus d’informations, consultez External Inventory Code Service. Exemple : ext_inv_code=10039

Objet d’intégration de serveur de publication

Nous prenons en charge les champs suivants dans l’objet publisher_integration :

Champ	Type	Description
is_header	valeur booléenne	- 0: il ne s’agit pas d’une intégration d’enchères d’en-tête. - 1: intégration dans un wrapper.
bid_shading_high	double	Déconseillé (octobre 2018).
bid_shading_medium	double	Déconseillé (octobre 2018).
bid_shading_low	double	Déconseillé (octobre 2018).

Objet Impression

Nous prenons en charge les champs suivants dans l’objet imp , qui décrivent l’impression mise aux enchères. Une seule demande d’enchère peut contenir un tableau avec plusieurs imp objets.

Champ	Type	Description
id	string	(Obligatoire) Spécifie un identificateur unique pour cette impression dans le contexte de la demande d’offre. Définissez sur la valeur de auction_id_64.
banner	objet	Obligatoire si cette impression est proposée sous forme de bannière publicitaire. Consultez l’objet Bannière ci-dessous.
video	objet	Obligatoire si cette impression est proposée sous la forme d’une publicité vidéo. Voir Video Object ci-dessous.
audio	objet	Obligatoire si cette impression est proposée sous forme de publicité audio. Consultez l’objet Audio ci-dessous.
native	objet	Obligatoire si cette impression est proposée en tant que publicité native. Voir l’objet natif ci-dessous
instl	entier	Indique si l’impression est interstitielle ou en plein écran. Nous ne prenons en charge que « 0 » pour l’instant. - 0: l’impression n’est pas interstitielle ou plein écran. - 1: l’impression est interstitielle ou plein écran.
tagid	string	Spécifie un identificateur pour le placement publicitaire ou la balise publicitaire spécifique qui a été utilisé pour lancer la vente aux enchères. Il s’agit de l’ID de placement de notre plateforme. Omis si les paramètres de visibilité du vendeur interdisent le partage.
bidfloor	float	Offre minimale pour cette impression exprimée en CPM. Xandr envoie le prix plancher brut du marché ouvert de l’éditeur dans le champ dans les bidfloor demandes d’offre sortantes aux fournisseurs de services de sécurité en aval. (Cela inclut les frais de vendeur et d’acheteur Xandr pertinents). Cela s’applique lorsque est bidfloor défini sur la demande de publicité entrante de l’éditeur et/ou lorsque le prix de réserve de placement d’un éditeur est défini.
bidfloorcur	string	Devise spécifiée à l’aide des codes alpha ISO-4217. Cela peut être différent de la devise de soumission retournée par le soumissionnaire si cela est autorisé par l’échange.
secure	entier	Indique si l’impression nécessite des ressources créatives et un balisage d’URL HTTPS sécurisés. En cas d’omission, l’état sécurisé est inconnu, mais la prise en charge http non sécurisée peut être supposée. - 0: l’impression n’est pas sécurisée. - 1: l’impression est sécurisée.
pmp	objet	Spécifie des informations sur une transaction de place de marché privée qui est en vigueur pour cette impression. Consultez l’objet Place de marché privée ci-dessous.
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme d’OpenRTB pour l’objet d’impression. Voir Impression Extension Object ci-dessous.

Objet Bannière

Pour les impressions de bannière, nous prenons en charge les champs suivants :

Champ	Type	Description
w	entier	(Recommandé) Spécifie la largeur exacte de la bannière en pixels.
h	entier	(Recommandé) Spécifie la hauteur exacte de la bannière en pixels.
id	string	Spécifie un identificateur unique pour l’objet bannière. Utile pour le suivi de plusieurs objets de bannière (par exemple, avec un tableau de bannières complémentaire). En règle générale, la première bannière du tableau est 1 et les objets suivants s’incrémentent à partir de là. Actuellement codé en dur en 1.
btype	tableau d’entiers	Spécifie les types créatifs de bannière à bloquer. Reportez-vous à la section 5.2 de la spécification IAB pour obtenir la liste des types.
battr	tableau d’entiers	Spécifie les attributs créatifs de bannière à bloquer. Reportez-vous à la section 5.3 de la spécification IAB pour obtenir la liste des attributs.
pos	entier	Spécifie la position de la bannière sur l’écran. - 0: Inconnu (par défaut) - 1: au-dessus du pli - 3: sous le pli
api	tableau d’entiers	Spécifie les frameworks d’API pris en charge pour cette impression. Si une API n’est pas répertoriée explicitement, elle est supposée ne pas être prise en charge. Reportez-vous à la section 5.6 de la spécification IAB pour obtenir la liste des frameworks d’API.
format	tableau d’objets	Objets format qui représentent les tailles de bannière autorisées. Voir Format, objet ci-dessous. Note: Les tailles de bannières mises en évidence dans l’objet de format ne sont pas représentatives des tailles autorisées via des transactions.
ext	objet	Non prise en charge.

Objet Format

Nous prenons en charge le champ suivant dans l’objet format de l’objet banner :

Champ	Type	Description
w	entier	Spécifie la largeur du créatif, en pixels.
h	entier	Spécifie la hauteur du créatif, en pixels.

Objet vidéo

Pour les impressions vidéo, nous prenons en charge les champs suivants :

Champ	Type	Description
mimes	tableau de chaînes	(Obligatoire) Spécifie les types MIME de contenu vidéo pris en charge ; par exemple, video/x-ms-wmv et video/x-flv.
minduration	entier	(Recommandé) Spécifie la durée minimale de la publicité vidéo, en secondes.
maxduration	entier	(Recommandé) Spécifie la durée maximale de la publicité vidéo, en secondes.
w	entier	(Recommandé) Spécifie la largeur du lecteur vidéo, en pixels.
h	entier	(Recommandé) Spécifie la hauteur du lecteur vidéo, en pixels.
startdelay	entier	(Recommandé) Spécifie le délai de début de l’annonce vidéo : - > 0: pour les valeurs supérieures à zéro, délai avant le début de la vidéo, en secondes. - 0: Pré-roll. - -1: mid-roll générique. - -2: post-roll générique.
battr	tableau d’entiers	Spécifie les attributs créatifs vidéo à bloquer. Reportez-vous à la section 5.3 de la spécification IAB pour obtenir la liste des attributs.
minbitrate	entier	Débit binaire minimal, en kilo-octets par seconde.
maxbitrate	entier	Débit binaire maximal, en kilo-octets par seconde.
playbackmethod	tableau d’entiers	Spécifie les méthodes de lecture autorisées. S’il n’est pas spécifié, tous sont supposés être autorisés. Les valeurs actuellement prises en charge sont les suivantes : - 1: Lecture automatique, son activé. - 2: Lecture automatique, son off. - 3: cliquez pour jouer. - 4: Passez la souris pour jouer.
api	tableau d’entiers	Spécifie les frameworks d’API pris en charge pour cette impression. Si une API n’est pas répertoriée explicitement, elle est supposée ne pas être prise en charge. Les valeurs actuellement prises en charge sont les suivantes : - 1: VPAID 1.0 - 2: VPAID 2.0 - 3: MRAID-1 - 4: ORMMA - 5: MRAID-2 - 6: MRAID-3 - 7: OMID-1
protocols	tableau d’entiers	Tableau de protocoles vidéo pris en charge. Les valeurs actuellement prises en charge sont les suivantes : - 1: VAST 1.0 - 2: VAST 2.0 - 3: VAST 3.0 - 4: wrapper VAST 1.0 - 5: wrapper VAST 2.0 - 6: wrapper VAST 3.0 - 7: VAST 4.0 - 8: DAAST 1.0
placement	entier	Type de placement pour l’impression. Options possibles : - 1: In-Stream - 2: Dans la bannière - 3: Dans l’article - 4: Dans le flux - 5: Interstitial/Slider/Floating
linearity	entier	Indique si l’impression doit être linéaire, non linéaire, etc. Si aucune valeur n’est spécifiée, supposons que tous sont autorisés. - 1: Linéaire / In-Stream - 2: non linéaire/superposition
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme d’OpenRTB pour l’objet vidéo. Voir Video Extension Object ci-dessous.

Objet d’extension vidéo

Nous prenons en charge un seul objet dans l’objet ext pour prendre en charge les extensions spécifiques à Xandr à l’objet video :

Champ	Type	Description
appnexus	objet	Spécifie les extensions spécifiques à la plateforme de l’objet vidéo.

Objet Video AppNexus

Nous prenons en charge les champs suivants dans l’objet appnexus d’extension de l’objet video :

Champ	Type	Description
context	entier	Spécifie le contexte vidéo : - 0:Inconnu - 1: Pré-roll - 2: Mid-roll - 3: Post-roll - 4: Outstream - 5: BannerStream - 6: Dans le flux - 7:Interstitielle

Objet audio

Champ	Type	Description
mimes	tableau de chaînes	(Obligatoire) Spécifie les types MIME de contenu audio pris en charge ; par exemple, audio/vnd.wav, audio/mpeg, audio/mp4audio/ogg, ou audio/mp2.
minduration	entier	(Recommandé) Spécifie la durée minimale des publicités audio, en secondes.
maxduration	entier	(Recommandé) Spécifie la durée maximale des publicités audio, en secondes.
startdelay	entier	(Recommandé) Spécifie le délai de début de l’annonce audio : - > 0: pour les valeurs supérieures à zéro, délai avant le démarrage audio, en secondes. - 0: Pré-roll. - -1: mid-roll générique (délai inconnu). - -2: post-roll générique.
battr	tableau d’entiers	Spécifie les attributs créatifs audio à bloquer. Nous prenons en charge : - 11:Enquêtes - 16: Bouton d’arrêt De l’annonce fournit
minbitrate	entier	Débit binaire minimal, en kilo-octets par seconde.
maxbitrate	entier	Débit binaire maximal, en kilo-octets par seconde.
api	tableau d’entiers	Spécifie les frameworks d’API pris en charge pour cette impression. Si une API n’est pas répertoriée explicitement, elle est supposée ne pas être prise en charge. Les valeurs actuellement prises en charge sont les suivantes : - 1: VPAID 1.0 - 2: VPAID 2.0 - 3: MRAID-1 - 4: ORMMA - 5: MRAID-2 - 6: MRAID-3 - 7: OMID-1

Objet natif

Pour les impressions natives, nous prenons en charge le champ suivant, qui contient le balisage créatif :

Champ	Type	Description
request	string	Balisage créatif rendu à livrer ; Les créations natives peuvent être retournées dans ce champ sous la forme d’une chaîne encodée JSON. La première valeur de la chaîne doit être native. Pour obtenir des exemples de demandes d’enchères natives, consultez l’objet Request ci-dessous et Exemples de demandes d’enchères.

Objet de requête

Pour les impressions natives, l’objet request contient l’objet créatif dans les champs suivants :

Champ	Type	Description
ver	string	(Recommandé) Spécifie la version de la spécification ad native actuellement utilisée. Actuellement, les versions 1.1 et 1.2 sont prises en charge.
plcmtcnt	entier	Spécifie le nombre de placements identiques disponibles sur la demande d’offre. Généralement 1, mais peut être un entier différent si la demande d’enchère concerne un flux avec plusieurs emplacements.
plcmttype	entier	Conception/format/disposition de l’unité publicitaire proposée. Xandr envoie l’une ou l’autre valeur : - 1: dans le flux de contenu. - 4: widget de recommandation.
privacy	valeur booléenne	Indicateur indiquant si le vendeur prend en charge un avis de confidentialité spécifique à l’acheteur. - 0 ou absent : l’annonce native ne prend pas en charge les liens de confidentialité personnalisés. - 1: l’annonce native prend en charge l’avis de confidentialité spécifique à l’acheteur.
assets	tableau d’objets	Spécifie une liste des ressources qui sont censées être retournées dans la réponse d’enchère. Consultez l’objet Assets ci-dessous.

Objet Assets

Nous prenons en charge les champs suivants dans l’objet assets dans l’objet native :

Champ	Type	Description
id	entier	Spécifie un identificateur unique pour la ressource dans cette demande d’enchère. En règle générale, la première ressource du tableau est 1 et les ressources suivantes s’incrémentent à partir de là.
required	entier	Spécifie si la ressource est requise : - 0: la ressource est facultative. - 1: la ressource est requise.
title	objet	Spécifie des informations sur le titre de la ressource. Consultez l’objet Title ci-dessous.
img	objet	Spécifie des informations sur l’image de la ressource. Consultez l’objet Image ci-dessous.
data	objet	Spécifie des informations sur les données de la ressource. Consultez Assets Data Object ci-dessous.
video	objet	Spécifie des informations sur la vidéo pour la ressource. Consultez l’objet Video pour les ressources ci-dessous.

Objet Title

Nous prenons en charge les champs suivants dans l’objet title dans l’objet assets :

Champ	Type	Description
len	entier	Longueur maximale du texte dans le titre.

Objet image

Nous prenons en charge les champs suivants dans l’objet img de l’objet assets :

Champ	Type	Description
type	entier	Spécifie l’ID de type de l’élément image demandé par l’éditeur. Les valeurs prises en charge sont : - 1: image d’icône à utiliser sur des tailles d’écran plus petites (icon_img_url). - 3: grand aperçu de l’image de l’annonce pour une utilisation sur des tailles d’écran plus grandes (main_media).
w	entier	Spécifie la largeur exacte de l’image, en pixels.
wmin	entier	Spécifie la largeur minimale demandée de l’image, en pixels. Si elle est incluse, cette valeur doit être utilisée pour toute mise à l’échelle des images par le client. Si w ou wmin sont tous les deux inclus, utilisez w comme largeur exacte.
h	entier	Spécifie la hauteur de l’image, en pixels.
hmin	entier	Spécifie la hauteur minimale demandée de l’image, en pixels. Si elle est incluse, cette valeur doit être utilisée pour toute mise à l’échelle des images par le client. Si h et hmin sont inclus, utilisez h comme hauteur exacte.
mimes	tableau de chaînes	Spécifie les types MIME de contenu d’image pris en charge. Doit être vide, car tous les types d’images sont pris en charge.

Objet de données Assets

Nous prenons en charge les champs suivants dans l’objet data de l’objet assets :

Champ	Type	Description
type	entier	Spécifie l’ID de type de l’élément pris en charge par le serveur de publication. L’éditeur peut afficher ces informations dans un format approprié. Les valeurs prises en charge sont : - 1: - sponsored Message « Sponsored By », où la réponse contient le nom de marque du sponsor - 2: - desc Texte descriptif associé au produit ou service en cours de publicité - 3: rating - Évaluation du produit proposé à l’utilisateur. Par exemple, l’évaluation d’une application dans un App Store comprise entre 0 et 5. - 12: - ctatext Texte descriptif d’un bouton « appel à l’action » pour l’URL de destination
len	entier	Longueur maximale du texte dans la réponse de l’élément.

Objet de requête de suivi d’événements

Nous prenons en charge les champs suivants dans l’objet event trackers request (Native 1.2 uniquement) :

Champ	Type	Description
event	entier	Type d’événement disponible pour le suivi. Les valeurs prises en charge sont : - 1: impression - Impression - 2: - viewable-mrc50 Impression visible à l’aide de la définition MRC à 50 % dans la vue pendant 1 seconde. - 3: viewable-mrc100 - Impression visible à l’aide de la définition MRC à 100 % dans la vue pendant 1 seconde (c’est-à-dire la norme GroupM). - 4: viewable-video50 - Impression visible pour la vidéo à l’aide de la définition MRC à 50 % dans la vue pendant 2 secondes. - 555: custom value to signify OMID
methods	tableau d’entiers	Tableau des types de suivi disponibles pour l’événement donné. Les valeurs prises en charge sont : - 1: img - Suivi Img-pixel - L’URL fournie sera insérée en tant que pixel 1x1 au moment de l’événement. - 2: js - Suivi javascript : l’URL fournie est insérée en tant que js balise au moment de l’événement.

Objet vidéo pour les ressources

Nous prenons en charge les champs suivants dans l’objet video de l’objet assets :

Champ	Type	Description
mimes	tableau de chaînes	Types MIME de contenu pris en charge. Si les mimes ne sont pas spécifiés dans la demande d’enchère côté fourniture, nous aurons la valeur par défaut “video/mp4” pour la vidéo standard et “video/x-flv” pour les appareils mobiles.
minduration	entier	Durée minimale de la publicité vidéo en secondes.
maxduration	entier	Durée maximale des publicités vidéo en secondes.
protocols	tableau d’entiers	Tableau de protocoles vidéo que l’éditeur peut accepter dans la réponse d’enchère. Les valeurs actuellement prises en charge sont les suivantes : - 1: VAST 1.0 - 2: VAST 2.0 - 3: VAST 3.0 - 4: wrapper VAST 1.0 - 5: wrapper VAST 2.0 - 6: wrapper VAST 3.0 - 7: VAST 4.0 - 8: DAAST 1.0

Objet place de marché privée

Nous prenons en charge les champs suivants dans l’objet pmp de l’objet imp pour prendre en charge les places de marché privées (transactions) entre les acheteurs et les vendeurs qui peuvent s’appliquer à cette impression :

Champ	Type	Description
private_auction	entier	Indique l’éligibilité aux enchères pour les sièges nommés dans l’objet deals . - 0: toutes les offres sont acceptées. - 1: seules les offres pour les transactions spécifiées sont acceptées.
deals	tableau d’objets	Spécifie des informations sur les transactions pour cette offre. Consultez l’objet Deal ci-dessous.

Objet Deal

Nous prenons en charge les champs suivants dans l’objet deal de l’objet pmp :

Champ	Type	Description
id	string	(Obligatoire) Spécifie un identificateur unique pour la transaction.
bidfloor	float	Spécifie le prix d’enchère minimal pour la transaction, en CPM à l’aide de la devise par défaut (USD). En cas d’omission, la valeur par défaut est 0.00.
at	entier	Remplacement facultatif du type d’enchère global de la demande d’offre. En cas d’omission, la valeur par défaut est 2. - 1: Premier prix. - 2: Deuxième prix plus un centime (valeur par défaut). - 3: le prix plancher de l’offre est le prix convenu (prix fixe).
wseat	tableau de chaînes	Spécifie une liste d’ID de siège d’acheteur qui sont autorisés à enchérir sur cette transaction. Si aucun siège n’est spécifié, tous les acheteurs sont éligibles.
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme d’OpenRTB pour l’objet deal. Consultez l’objet d’extension de transaction ci-dessous.

Objet d’extension de transaction

Nous prenons en charge un seul objet dans l’objet ext pour prendre en charge les extensions spécifiques à la plateforme de l’objet deal :

Champ	Type	Description
appnexus	objet	Spécifie les extensions spécifiques à la plateforme de l’objet deal.

Objet AppNexus Deal

Nous prenons en charge les champs suivants dans l’objet appnexus d’extension de l’objet deal :

Champ	Type	Description
ad_quality_override	entier	Spécifie la façon dont la transaction gère les créations : - 1: les créatifs utilisent les paramètres de qualité des publicités existants (par défaut). - 2: les créatifs dans les status d’audit « en attente » serviront. Une fois ces créations auditées, les paramètres de qualité des publicités existants sont utilisés. - 3: aucune restriction de profil publicitaire n’est appliquée à cette transaction (confiance maximale).
allowed_media_types	tableau d’entiers	Spécifie les ID des types de médias autorisés sur cette transaction. Pour obtenir la liste des types de médias, consultez Expandables et Rich Media. S’il n’existe aucun type de média unique pour cette transaction par rapport à l’objet de demande d’enchère main, ce champ est un tableau vide. Cela ne signifie PAS que l’offre n’autorise aucun type de média, au lieu de cela, cela signifie simplement que les types de média sur l’objet d’enchère main (tout ce qui n’est pas spécifiquement répertorié dans l’objet « battr ») peuvent être utilisés lors de la soumission sur cette transaction. Si ce tableau est rempli, il contient une liste complète des types de médias autorisés sur cette transaction.
allowed_media_subtypes	tableau d’entiers	Spécifie les ID des sous-types de média autorisés sur cette transaction. Pour obtenir la liste des sous-types de média, consultez Expandables et Rich Media. S’il n’existe aucun sous-type de média unique pour cette transaction par rapport à l’objet de demande d’enchère main, ce champ est un tableau vide. Cela ne signifie PAS que la transaction n’autorise aucun sous-type de média, mais simplement que les sous-types de média sur l’objet d’enchère main (tout ce qui n’est pas spécifiquement répertorié dans l’objet « battr ») peuvent être utilisés lors de l’enchère sur cette transaction. Si ce tableau est rempli, il contient une liste complète des types de sous-médias autorisés sur cette transaction.
sizes	tableau d’objets	Spécifie les tailles de création autorisées pour cette transaction. Si ce tableau est rempli, il contient une liste complète des tailles autorisées sur cette transaction. Les tailles autorisées sur la transaction ne doivent pas être un sous-ensemble de ce qui est autorisé dans l’objet de demande d’offre main. Si le tableau est vide, cela signifie qu’il n’existe aucune taille unique pour cette transaction, et que les tailles autorisées à partir de l’objet d’enchère main doivent être utilisées à la place. Consultez l’objet Sizes ci-dessous.
sc	entier	Spécifie si le champ wseat de l’objet deal transmet un ID de siège acheteur. Ce champ est uniquement présent pour les transactions configurées avec l’ID de siège d’acheteur d’un fournisseur de services de distribution de données et transmettra une valeur de "1".
gtd	entier	Spécifie si la transaction est garantie par programmation. Ce champ n’est présent que pour les transactions configurées en tant que programmatiquement garantis et transmet la valeur "1".

Objet Sizes

Nous prenons en charge les champs suivants dans l’objet sizes de l’objet deal ext .

Champ	Type	Description
w	entier	Spécifie la largeur du créatif autorisé pour cette transaction, en pixels.
h	entier	Spécifie la hauteur de la création autorisée pour cette transaction, en pixels.

Objet d’extension Impression

Nous prenons en charge un seul objet dans l’objet ext pour prendre en charge les extensions spécifiques à la plateforme de l’objet imp :

Champ	Type	Description
appnexus	objet	Spécifie les extensions spécifiques à la plateforme de l’objet impression.

Objet AppNexus Impression

Nous prenons en charge les champs suivants dans l’objet appnexus d’extension de l’objet imp :

Champ	Type	Description
estimated_clear_price	double	Spécifie le prix clair estimé nécessaire pour gagner l’impression. Le prix est supposé être dans la devise de l’éditeur. Si ce n’est pas le cas, vous devez spécifier les unités monétaires.
predicted_view_rate	double	Spécifie la probabilité que l’impression soit visible par l’utilisateur sous la forme d’un pourcentage d’impressions d’affichage mesurées, en fonction des données historiques.
predicted_view_rate_over_total	double	Spécifie la probabilité que l’impression soit visible par l’utilisateur sur toutes les impressions d’affichage, en fonction des données historiques.
predicted_video_view_rate_over_total	double	Spécifie la probabilité que l’impression soit visible par l’utilisateur sur toutes les impressions vidéo, en fonction des données historiques.
predicted_video_view_rate	double	Spécifie la probabilité que l’impression soit visible par l’utilisateur sous la forme d’un pourcentage d’impressions vidéo mesurées, en fonction des données historiques.
member_ad_profile_id	entier	Spécifie l’ID de profil publicitaire du vendeur.
allowed_payment_types	tableau d’objets	Spécifie les types de paiements autorisés pour cette impression. Si ce champ n’est pas présent, le seul type de paiement autorisé est 'impression'. Note: Cet objet n’est pas activé pour tous les clients. Contactez votre représentant de compte pour cette fonctionnalité.
traffic_source_code	chaîne	Spécifie la source externe du trafic tiers pour cette impression.
predicted_video_completion_rate	double	Spécifie la probabilité que l’impression vidéo soit entièrement visionnée par un utilisateur, en fonction des données historiques.
gpid	string	Identificateur de niveau de placement global fourni par l’éditeur pour indiquer un placement publicitaire spécifique sur la page.

Objet Types de paiement autorisés

Nous prenons en charge les champs suivants dans l’objet allowed_payment_types :

Remarque

Cet objet n’est pas activé pour tous les clients. Contactez votre représentant de compte pour cette fonctionnalité.

Champ	Type	Description
payment_type	entier	Spécifie le type de paiement autorisé pour cette impression. Valeurs actuellement prises en charge : - 1:Impression - 2: Affichages - Affichage standard - 6: Vues - Affichage personnalisé - 100pv1s - 8: Vues - Vidéo standard - 9: Vues - Vidéo personnalisée - 100pv50pd
conversion_rate	double	Spécifie le taux utilisé par Xandr pour convertir une enchère sans impression en prix eCPM pour le classement des enchères. Un soumissionnaire peut l’utiliser pour le classement interne des soumissions, la budgétisation/rythme, ou éventuellement pour d’autres personnes.
imp_count_method	int	Spécifie la façon dont l’impression est comptée. Valeurs actuellement prises en charge : - 0: Non applicable - 1:Inconnu - 2: compter sur le rendu - 3: Compter sur la décision/servir

Pour plus d’informations case activée la page Vue d’ensemble.

Objet de site

Les sites (également appelés groupes de placement) sont un sous-ensemble de l’inventaire d’un éditeur. Nous prenons en charge les champs suivants dans l’objet site :

Champ	Type	Description
id	string	Recommandé. Spécifie l’ID de site Xandr. Omis si la visibilité du vendeur interdit le partage. Les soumissionnaires ne peuvent pas rechercher le site auquel correspond l’ID, mais ces ID peuvent être utilisés en tant que blocs d’inventaire anonymes et optimisables.
domain	string	Spécifie le domaine du site (par exemple, publishersite.com). Omis si la visibilité du vendeur interdit le partage.
cat	tableau de chaînes	Spécifie une liste de catégories de contenu. Inclut les catégories IAB (répertoriées dans la section 5.1 de la spécification). Omis si les paramètres de visibilité du vendeur interdisent le partage.
page	chaîne	Spécifie l’URL complète de la page où l’impression est affichée (par exemple, page.publishersite.com/path/to/page). Omis si les paramètres de visibilité du vendeur interdisent le partage. Contient le domaine au lieu de l’URL complète si seul le domaine est exposé dans le profil de visibilité.
publisher	objet	Spécifie des informations sur l’éditeur. Omis si les paramètres de visibilité du vendeur interdisent le partage. Consultez l’objet Publisher ci-dessous.
content	objet	Détails sur le contenu dans le site. Voir Content Object ci-dessous.
ext	objet	Utilisé pour conserver les champs d’extension d’application. Consultez l’objet Extension de site ci-dessous.

Objet d’extension de site

Nous prenons en charge les champs suivants dans l’objet ext de l’objet site.

Champ	Type	Description
inventorypartnerdomain	objet	La valeur passée dans ce champ indique au app-ads.txt application de case activée fichier app-ads.txt de l’application pour la directive inventorypartnerdomain=[valeur de ce champ].

Objet d’application

Nous prenons en charge les champs suivants dans l’objet app :

Champ	Type	Description
id	string	Spécifie l’ID d’application Xandr. Omis si la visibilité du vendeur interdit le partage. Les soumissionnaires ne peuvent pas rechercher le site auquel correspond l’ID, mais ces ID peuvent être utilisés en tant que blocs d’inventaire anonymes et optimisables.
bundle	string	Spécifie le nom du package ou de l’offre groupée d’applications (par exemple, com.foo.mygame). Il s’agit d’un ID unique sur plusieurs échanges. Pour iOS, il s’agit de l’ID d’application iTunes (ID numérique). Omis si la visibilité du vendeur interdit le partage.
cat	tableau de chaînes	Spécifie une liste de catégories de contenu. Inclut les catégories IAB (répertoriées dans la section 5.1 de la spécification). Omis si les paramètres de visibilité du vendeur interdisent le partage.
publisher	objet	Spécifie des informations sur l’éditeur. Omis si les paramètres de visibilité du vendeur interdisent le partage. Consultez l’objet Publisher ci-dessous.
name	string	Nom complet de l’application (par exemple, Angry Birds). (Cette valeur peut être aliasée à la demande de l’éditeur.)
content	objet	Détails sur le contenu dans le site. Voir Content Object ci-dessous.
storeurl	chaîne	URL de l’App Store pour une application installée.
ext	objet	Utilisé pour conserver les champs d’extension d’application. Voir Objet d’extension d’application ci-dessous.

Objet Publisher

Nous prenons en charge le champ suivant dans l’objet publisher :

Champ	Type	Description
id	string	Spécifie l’ID de l’éditeur Xandr. Omis si les paramètres de visibilité du vendeur interdisent le partage.

Objet content

Xandr prend en charge les champs suivants dans l’objet Content :

Champ	Type	Description
genre	string	Genre qui décrit le mieux le contenu (par exemple, rock, pop, etc.).
id	string	ID identifiant de manière unique le contenu.
language	string	Langage de contenu utilisant ISO-639-1-alpha-2.
ext	objet	Espace réservé pour les extensions spécifiques à l’échange pour OpenRTB.
episode	entier	Numéro d’épisode.
title	string	Titre du contenu. Exemples de vidéos : « Comité de recherche » (télévision), « Un nouvel espoir » (film) ou « Endgame » (fait pour le web). Exemple non vidéo : « Pourquoi un glacier antarctique fond si rapidement » (article du magazine Time).
series	chaîne	Exemples vidéo : « The Office » (télévision), « Star Wars » (film) ou « Arby 'N' The Chief » (créé pour le web). Exemple non vidéo : « Ecocentric » (blog Time Magazine).
season	chaîne	Saison de contenu (par exemple, « Saison 3 »).
artist	chaîne	Artiste crédité du contenu.
album	string	Album auquel appartient le contenu ; généralement pour l’audio.
isrc	chaîne	Code d’enregistrement standard international conforme à la norme ISO-3901.
producer	objet	Détails sur le contenu Producer. Reportez-vous à la section 3.2.12 dans la spécification IAB.
url	chaîne	URL du contenu, pour la contextualisation ou la révision côté achat.
cat	tableau de chaînes	Tableau de catégories de contenu IAB qui décrivent le producteur de contenu. Reportez-vous à la liste 5.1 dans la spécification IAB.
prodq	entier	Qualité de la production. Reportez-vous à La liste 5.11 dans la spécification IAB.
videoquality	entier	Déconseillé en faveur de prodq. Qualité vidéo. Reportez-vous à La liste 5.11 dans la spécification IAB.
context	entier	Type de contenu (jeu, vidéo, texte, etc.). Reportez-vous à List 5.16 dans la spécification IAB.
contentrating	string	Évaluation du contenu (par exemple, MPAA).
userrating	string	Évaluation par l’utilisateur du contenu (par exemple, nombre d’étoiles, mentions J’aime, etc.).
qagmediarating	entier	Évaluation des médias selon les recommandations iqg. Reportez-vous à List 5.17 dans la spécification IAB.
keywords	string	Liste de mots clés séparés par des virgules décrivant le contenu.
livestream	entier	0 = non en direct, 1 = le contenu est en direct (par exemple, flux, blog en direct).
sourcerelationship	entier	0 = indirect, 1 = direct.
len	entier	Longueur du contenu en secondes ; approprié pour la vidéo ou l’audio.
data	tableau d’objets	Données de contenu supplémentaires. Chaque objet Data représente une source de données différente. Reportez-vous à la section 3.2.16 de la spécification IAB.

Objet d’extension de contenu

Xandr prend en charge le champ suivant dans l’objet ext :

Champ	Type	Description
network	string	La société mère de niveau supérieur ou, le cas échéant, une sous-marque qui possède plusieurs chaînes de type TV, des marques de contenu d2c ou des propriétés numériques sur lesquelles le contenu est affiché.

Objet d’extension d’application

Nous prenons en charge les champs suivants dans l’objet ext de l’objet d’application.

Champ	Type	Description
inventorypartnerdomain	string	La valeur passée dans ce champ indique au app-ads.txt application de case activée fichier app-ads.txt de l’application pour la directive inventorypartnerdomain=[valeur de ce champ].

Objet Device

Nous prenons en charge les champs suivants dans l’objet device .

Champ	Type	Description
ua	string	(Recommandé) Spécifie la chaîne de l’agent utilisateur à partir du navigateur. L’agent utilisateur identifie souvent des informations telles que l’application, le système d’exploitation et le fournisseur de logiciels agissant au nom de l’utilisateur, par exemple . "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4"
geo	objet	Spécifie l’emplacement de l’appareil, tel que dérivé des services de localisation de l’appareil (tels que la triangulation de la tour cellulaire ou le GPS) ou de l’adresse IP. Inclut également le fuseau horaire et un code pour la zone de marché désignée. Note:geo remplace l’adresse IP. Pour plus d’informations, consultez Objet géo.
dnt	entier	Spécifie le paramètre Ne pas suivre : - 0: Do Not Track est défini sur false dans le navigateur (le suivi est autorisé). - 1: Do Not Track est défini sur true dans le navigateur (l’utilisateur a désactivé le suivi).
ip	chaîne	Spécifie l’adresse IPv4 la plus proche de l’appareil. Omis si les paramètres de visibilité du vendeur interdisent le partage.
ipv6	string	Adresse IP la plus proche de l’appareil en tant que IPv6.
devicetype	entier	Spécifie le type d’appareil, à l’aide des valeurs IAB : - 1: Mobile/Tablette - 2: Ordinateur personnel - 3: Tv connectée - 4:Téléphone - 5:Tablette - 6: Appareil connecté - 7: Set Top Box
make	string	Spécifie la fabrique de l’appareil.
model	chaîne	Spécifie le modèle de l’appareil.
os	string	Spécifie le système d’exploitation de l’appareil. Si elle est transmise, cette opération remplace le système d’exploitation dans le champ ua. Voici les valeurs possibles dans le champ du système d’exploitation : - « Inconnu » - « Android » - « Apple iOS » - « Apple Mac » - « Microsoft Windows » - « Blackberry OS » - « Microsoft Mobile » - « Linux » - « Symbian OS » - « Chrome OS » - « Système d’exploitation PlayStation 4 » - « Firefox OS » - « Roku OS »
language	string	Spécifie la langue du navigateur ; utilisez les codes ISO 639-1 ou ISO 3166 alpha-2.
lmt	entier	Signal « Limiter le suivi publicitaire » approuvé commercialement (par exemple, iOS, Android), où 0=suivi est illimité, 1=suivi doit être limité selon les directives commerciales.
carrier	chaîne	Spécifie l’opérateur pour l’appareil.
connectiontype	entier	Spécifie le type de connexion de données détecté pour l’appareil à l’aide des valeurs IAB. Nous prenons en charge les valeurs suivantes aujourd’hui : - 0:Inconnu - 3: Réseau cellulaire – Génération inconnue
ifa	string	Spécifie l’ID approuvé pour l’utilisation de l’annonceur en clair. Définissez sur iOS idfa, Android aaidou Windows adid si disponible. Est également défini pour les impressions CTV, à l’aide des types d’ID d’appareil fournis par l’appareil, fournis par l’éditeur ou d’autres types d’ID d’appareil, le cas échéant. Pour plus d’informations, consultez ext.ifa_type. Omis si les paramètres de visibilité du vendeur interdisent le partage.
dpidsha1	string	Spécifie l’identificateur unique sha1 chiffré, propre à la plateforme (par exemple, ANDROID_ID ou UDID pour iOS) pour l’appareil mobile. Omis si les paramètres de visibilité du vendeur interdisent le partage.
dpidmd5	string	Spécifie l’identificateur unique md5 chiffré, propre à la plateforme (par exemple, ANDROID_ID ou UDID pour iOS) pour l’appareil mobile. Omis si les paramètres de visibilité du vendeur interdisent le partage.
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme d’OpenRTB pour l’objet géo. Consultez l’objet d’extension géographique ci-dessous.

Objet géo

Nous prenons en charge les champs suivants dans l’objet geo :

Champ	Type	Description
lat	float	Spécifie la latitude de l’appareil, comme dérivé des services de localisation de l’appareil. Cela peut aller de -90 à 90. Sud est négatif.
lon	float	Spécifie la longitude de l’appareil, comme dérivé des services de localisation de l’appareil. Cela peut aller de -180 à 180. L’ouest est négatif.
country	string	Spécifie le nom du pays, conformément à la norme ISO-3166-1 Alpha-3.
region	string	Code de région utilisant ISO-3166-2 ; Code d’état à 2 lettres si usa.
city	string	Spécifie le nom de la ville. Omis si les paramètres de visibilité du vendeur interdisent le partage.
zip	string	Spécifie le code postal ou le code postal où se trouve l’appareil. Omis si les paramètres de visibilité du vendeur interdisent le partage.
metro	string	Contient un code pour la zone de marché désignée de l’utilisateur en fonction de son adresse IP (si l’adresse IP peut être déterminée).
utcoffset	int	Indique l’heure locale sous la forme d’un décalage par rapport à l’heure UTC.
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme d’OpenRTB pour l’objet géo. Consultez l’objet d’extension géographique ci-dessous.

Objet d’extension géographique

Nous prenons en charge un seul objet dans l’objet ext pour prendre en charge les extensions spécifiques à la plateforme de l’objet geo :

Champ	Type	Description
appnexus	objet	Spécifie les extensions spécifiques à la plateforme de l’objet géo. Pour obtenir la liste des extensions de cet objet, consultez Geo AppNexus, objet ci-dessous.

Objet Geo AppNexus

Nous prenons en charge le champ suivant dans l’objet appnexus d’extension de l’objet geo :

Champ	Type	Description
timezone	string	Contient le fuseau horaire de l’utilisateur en fonction de l’adresse IP (si l’adresse IP peut être déterminée).

Objet d’extension d’appareil

Nous prenons en charge un seul objet dans l’objet ext pour prendre en charge les extensions spécifiques à la plateforme de l’objet device :

Champ	Type	Description
ifa_type	string	Spécifie la source de l’IFA, si elle est générée par l’appareil (et donc utilisée dans les applications) ou s’il s’agit d’un IFA fourni par l’éditeur ou d’un IFA temporaire/session. Utilisé principalement pour les impressions CTV. Les types d’IFA sont Appareil, Serveur de publication (y compris les applications), Fournisseur de services partagés et Session. Voici les valeurs recommandées pour le ifa_type paramètre : - « dpid » : l'« ID fourni par l’appareil » générique, mais en fonction de l’historique d’utilisation, des valeurs communes spécifiques au type d’appareil peuvent être utilisées - « rida » - Id Roku - « aaid » - ID Android - « idfa » - Id Apple - « afai » - Amazon Fire ID - « tifa » - Identifiant Tizen pour la publicité (Samsung Ad ID) - « vida » - Id vizio advertising - « lgudid » - ID d’appareil unique LG - « msai » - ID Microsoft - « ppid » - ID fourni par l’éditeur - « sspid » - ID fourni par le fournisseur de services partagés - « sessionid » : id de session/ID synthétique (décrit ci-dessous)

User, objet

Nous prenons en charge les champs suivants dans l’objet user :

Champ	Type	Description
id	string	(Ou idbuyeruid est recommandé) Spécifie l’ID unique Xandr pour cet utilisateur. Omis si les paramètres de visibilité du vendeur interdisent le partage. ID 64 bits unique de l’utilisateur. Il en va de même pour toutes les demandes de cet utilisateur jusqu’à ce que les cookies soient effacés. Ce champ est 0 lorsque Xandr n’a pas de correspondance pour cet utilisateur ou que le navigateur de l’utilisateur n’accepte pas les cookies. Il est -1 destiné aux utilisateurs opt-out.
buyeruid	chaîne	(Ou idbuyeruid est recommandé) ID unique de l’acheteur pour cet utilisateur, s’il est connu. Omis si les paramètres de visibilité du vendeur interdisent le partage.
yob	entier	Spécifie l’année de naissance sous la forme d’un entier à 4 chiffres. Omis si inconnu ou si les paramètres de visibilité du vendeur interdisent le partage.
gender	string	Spécifie le sexe. Définissez sur null si inconnu. Omis si inconnu ou les paramètres de visibilité du vendeur interdisent le partage. - M:Mâle - F:Femelle - O:Autres
data	tableau d’objets	Spécifie des informations sur les données de l’utilisateur. Consultez l’objet Données utilisateur ci-dessous.
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme d’OpenRTB pour l’objet utilisateur.

Objet de données utilisateur

Nous prenons en charge les champs suivants dans l’objet data de l’objet user :

Champ	Type	Description
id	string	Spécifie l’ID du fournisseur de données.
segment	tableau d’objets	Déconseillé (avril 2019).

Objet d’extension utilisateur

Nous prenons en charge les champs suivants dans l’objet ext pour prendre en charge les extensions spécifiques à la plateforme de l’objet user :

Champ	Type	Description
appnexus	objet	Spécifie les extensions spécifiques à la plateforme de l’objet utilisateur. Pour obtenir la liste des extensions de cet objet, voir ci-dessous.
consent	string	Facultatif. Contient la structure des données développée par le groupe de travail sur le consentement du Règlement général sur la protection des données (RGPD) sous les auspices d’IAB Europe.
eids	objet	Spécifie les informations relatives aux identificateurs d’utilisateur étendus. Il peut s’agir de solutions d’identité tierces (Criteo, TDID, RampID, etc.) ou d’identificateurs fournis par le serveur de publication (PPID).

Objet

Remarque

eids n’est pas disponible si les signaux de confidentialité indiquent que les informations personnelles ne peuvent pas être traitées.

Nous prenons en charge les champs suivants dans l’objet eids :

Champ	Type	Description
source	string	Spécifie le domaine du organization qui est le générateur de l’ID tiers.
uids	Objet	Spécifie les informations d’identité spécifiques à la solution ou à l’éditeur d’identité tiers. Les champs pertinents sont les suivants : id chaîne ID d’utilisateur fourni par la solution d’identité ou l’éditeur tiers. Poste Objet Spécifie des informations supplémentaires spécifiques fournies par la solution ou l’éditeur d’identité tiers. Les champs Ext sont les suivants : rtiPartner = nom de la solution d’identité tierce, utilisé par TDID.

Objet Segment

Avertissement

Cet objet est déconseillé (2019).

Nous prenons en charge les champs suivants dans l’objet segment de l’objet utilisateur data :

Champ	Type	Description
id	string	Spécifie l’ID de segment Xandr.
value	string	Spécifie la valeur du segment de données.

Objet Regs

Nous prenons en charge les champs suivants dans l’objet regs :

Champ	Type	Description
coppa	entier	Indique si cette demande est soumise à la États-Unis Loi sur la protection de la vie privée en ligne des enfants (COPPA). - 0: Non soumis à LA COPPA. Traitez comme une vente aux enchères normale. - 1: Soumis à LA COPPA. Limitez ce qui est autorisé pour le ciblage et la journalisation en fonction des besoins.
ext	objet	Utilisé pour identifier les extensions spécifiques à la plateforme d’OpenRTB pour l’objet reg.
gpp		Indique la chaîne de consentement réelle du GPP IAB. Cela implique quels fournisseurs sont autorisés à traiter les données personnelles et dans quelles conditions. Exemple : { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } }
gpp_sid		Facultatif : indique quelles réglementations ou logiques GPP doivent être appliquées, ou si un utilisateur se trouve dans un pays (pays de l’EEE) avec un cadre qui fait partie du GPP. Exemple : { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } }

Objet d’extension Regs

Nous prenons en charge le champ suivant dans l’objet regs.ext :

Champ	Type	Description
gdpr	entier	Optional. Indique si la demande est soumise ou non aux réglementations du Règlement général sur la protection des données (RGPD). Valeurs possibles : - 0: Non, la demande n’est pas soumise aux réglementations RGPD. - 1: Oui, la demande est soumise aux réglementations RGPD. Aucune valeur n’indique Unknown.
us_privacy	string	La chaîne de confidentialité américaine prend actuellement en charge la conformité CCPA en transmettant les informations suivantes dans la chaîne : Version de spécification Nombre (1 char dans la chaîne) Version de cette spécification de chaîne utilisée pour encoder la chaîne Notification explicite/possibilité de refuser ENUM (N = Non, Y = Oui, - = Non applicable) A-t-il été explicitement fourni comme requis par l’article 1798.115(d) du CCPA et la possibilité de refuser la vente de ses données en vertu des articles 1798.120 et 1798.135 du CCPA Refuser la vente ENUM (N = Non, Y = Oui, - = Non applicable) L’utilisateur a-t-il refusé la vente de ses informations personnelles en vertu des articles 1798.120 et 1798.135 LSPA ENUM (N = Non, Y = Oui, - = Non applicable) Publisher est signataire de l’IAB Limites ces termes sont définis dans le Contrat. d Contrat de fournisseur de services (LSPA) et l’éditeur déclare que la transaction est couverte comme une « transaction de refus couverte » ou une « transaction de non-refus » comme ces termes sont définis dans le Contrat. ces termes sont définis dans le Contrat.
gpp		Indique la chaîne de consentement réelle du GPP IAB. Cela implique quels fournisseurs sont autorisés à traiter les données personnelles et dans quelles conditions. Exemple : { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } }
gpp_sid		Facultatif : indique quelles réglementations ou logiques GPP doivent être appliquées, ou si un utilisateur se trouve dans un pays (pays de l’EEE) avec un cadre qui fait partie du GPP. Exemple : { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } }
dsa		Optional. Indique si la demande est soumise ou non à la Loi sur les services numériques (DSA). Pour plus d’informations, reportez-vous ici. Exemple : { dsarequired: 1, pubrender: 0, transparency: [ { domain: 'request.tomato.com', dsaparams: [ 1 ] },{ domain: 'request2.tomato.com', dsaparams: [ 1, 2, 3 ] }],datatopub: 1 }

Objet Source

Nous prenons en charge les champs suivants dans l’objet source :

Champ	Type	Description
fd	entier	Entité responsable de la décision de vente d’impression finale, où : - 0: exchange (par défaut) - 1: source amont
tid	string	ID de transaction qui doit être commun à tous les participants à cette demande d’enchère. La valeur sera transmise par le vendeur. Si le vendeur ne fournit pas d’ID de transaction, nous en créons un et le partageons.

Exemples de demandes d’enchères

Demande d’offre de bannière

{
    "id": "8765482113786061111",
    "imp": [{
        "id": "7654319310942953333",
        "banner": {
            "w": 320,
            "h": 50,
            "id": "1",
            "battr": [1, 2, 15],
            "pos": 0,
            "format": [{
                "w": 320,
                "h": 50
            }]
        },
        "instl": 0,
        "tagid": "12347654",
        "secure": 1,
        "ext": {
            "appnexus": {
                "estimated_clear_price": 0.57,
                "predicted_view_rate": 0.073255,
                "member_ad_profile_id": 1111055,
                "predicted_video_completion_rate": 0.592172,
                "predicted_view_rate_over_total": 0.067229,
                "allowed_payment_types": [{
                    "payment_type": 1,
                    "imp_count_method": 2
                }]
            }
        }
    }],
    "site": {
        "id": "3232399",
        "domain": "example.com",
        "cat": ["IAB12-2", "IAB12", "IAB11-5"],
        "page": "https://example.com/somepage.md",
        "publisher": {
            "id": "1111999"
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (Linux; Android 6.0.1; HUAWEI Build/MMB28B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.137 Mobile Safari/537.36",
        "geo": {
            "lat": 36.6203,
            "lon": -4.4998,
            "country": "ESP",
            "region": "MA",
            "metro": "1",
            "city": "UnaCuidad",
            "zip": "11111",
            "utcoffset": 60,
            "ext": {
                "appnexus": {
                    "timezone": "Africa/Ceuta"
                }
            }
        },
        "dnt": 0,
        "ip": "11.222.111.0",
        "devicetype": 4,
        "make": "Unknown",
        "model": "Generic Android Mobile",
        "os": "Android",
        "language": "es",
        "connectiontype": 0
    },
    "user": {
        "id": "7939999668795769876",
        "buyeruid": "CABBBBrbuQ9AA5DMJJJJlOL9ZOo",
        "gender": "O",
        "data": [{
            "id": "0",
            "segment": [{
                "id": "1",
                "value": "0"
            }]
        }, {
            "id": "1234",
            "segment": [{
                "id": "4444555",
                "value": "0"
            }]
        }],
        "ext": {
            "appnexus": {
                "userdata_json": "{\"uid\":\"CABBBBrbuQ9AA5DMJJJJlOL9ZOo\"}"
            }
        }
    },
    "test": 0,
    "at": 1,
    "tmax": 150,
    "wseat": ["1234",..., "9988"],
    "cur": ["USD"],
    "bcat": ["IAB23-7", "IAB23-5", "IAB23-10", "IAB23-9", "IAB23-1", "IAB7-44", "IAB9-9", "IAB8-18", "IAB8-5"],
    "badv": ["url1.com", "url2.com"],
    "ext": {
        "appnexus": {
            "seller_member_id": 123,
            "publisher_integration": {
                "is_header": 0
            }
        },
        "schain": {
            "complete": 1,
            "nodes": [{
                "asi": "appnexus.com",
                "sid": "123",
                "rid": "2dd111ff-7777-4abc-8558-86a123ab46d6",
                "hp": 1
            }],
            "ver": "1.0"
        }
    },
    "source": {
        "fd": 1,
        "tid": "2dd111ff-7777-4abc-8558-86a123ab46d6"
    }
}

Demande d’enchère native 1.1

{
    "id": "123456789",
    "imp": [{
        "id": "987654321",
        "native": {
            "request": "{\"ver\":\"1.1\",\"plcmttype\": 4,\"plcmtcnt\": 1,\"assets\":[{\"id\": 1,\"required\": 1,\"title\":{\"len\": 140}},{\"id\": 4,\"required\": 1,\"img\":{\"type\": 3,\"wmin\": 600,\"hmin\": 315}},{\"id\": 2,\"required\": 0,\"img\":{\"type\": 1,\"wmin\": 320,\"hmin\": 180}},{\"id\": 6,\"required\": 1,\"data\":{\"type\": 2,\"len\": 205}},{\"id\": 5,\"required\": 1,\"data\":{\"type\": 1,\"len\": 140}}]}}",
            "ver": "1.1"
        },
        "instl": 0,
        "secure": 0,
        "ext": {
            "appnexus": {
                "estimated_clear_price": 11.644000,
                "member_ad_profile_id": 667317,
                "predicted_view_rate_over_total": 0.000000
            }
        }
    }],
    "app": {
        "id": "1234",
        "bundle": "com.news.example"
    },
    "device": {
        "ua": "iPad; OS like Mac OS X; iOS 9.2; STR 2.2.4",
        "geo": {
            "country": "USA",
            "city": "Wilmington",
            "zip": "01887"
        },
        "dnt": 0,
        "ip": "198.51.100.2",
        "devicetype": 1,
        "make": "Apple",
        "model": "iPad",
        "os": "Apple iOS",
        "connectiontype": 0
    },
    "user": {
        "id": "2233445566",
        "data": [{
            "id": "0",
            "segment": [{
                "id": "1",
                "value": "0"
            }]
        }],
        "ext": {
            "appnexus": {
                "userdata_json": "{}"
            }
        }
    },
    "test": 0,
    "at": 2,
    "tmax": 2000,
    "wseat": [
        "1234"
    ],
    "cur": [
        "USD"
    ],
    "ext": {
        "appnexus": {
            "seller_member_id": 1234
        },
        "schain": {
            "complete": 1,
            "nodes": [{
                "asi": "appnexus.com",
                "sid": "1234",
                "rid": "25e2b11c-004f-4903-a912-5aef7732096b",
                "hp": 1
            }],
            "ver": "1.0"
        }
    }
}

Demande d’offre MultiMedia

Pour vous assurer que votre soumissionnaire est configuré pour recevoir ces demandes, ouvrez un cas de support.

{
    "id": "914181541748747384",
    "imp": [{
        "id": "837746433617288491",
        "banner": {
            "w": 320,
            "h": 250,
            "id": "1",
            "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
            "pos": 0,
            "api": [3, 5],
            "format": [{
                "w": 320,
                "h": 250
            }, {
                "w": 1,
                "h": 1
            }, {
                "w": 1,
                "h": 1
            }]
        },
        "native": {
            "request": "{\"ver\":\"1.2\",\"plcmtcnt\":1,\"assets\":[{\"id\":7,\"required\":0,\"img\":{\"type\":3}},{\"id\":8,\"required\":0,\"img\":{\"type\":1}},{\"id\":1,\"required\":0,\"title\":{\"len\":100}},{\"id\":2,\"required\":0,\"data\":{\"type\":2,\"len\":300}},{\"id\":3,\"required\":0,\"data\":{\"type\":12,\"len\":20}},{\"id\":4,\"required\":0,\"data\":{\"type\":1}},{\"id\":5,\"required\":0,\"data\":{\"type\":3}}],\"plcmttype\":4,\"eventtrackers\":[{\"event\":1,\"methods\":[1]}]}",
            "ver": "1.2"
        },
        "instl": 0,
        "tagid": "12345678",
        "secure": 1,
        "pmp": {
            "private_auction": 0,
            "deals": [{
                "id": "345667",
                "bidfloor": 4,
                "bidfloorcur": "USD",
                "at": 2,
                "wseat": ["1234"],
                "ext": {
                    "appnexus": {
                        "sizes": [{
                            "w": 1,
                            "h": 1
                        }, {
                            "w": 320,
                            "h": 250
                        }]
                    }
                }
            }, {
                "id": "345678",
                "bidfloor": 3,
                "bidfloorcur": "USD",
                "at": 2,
                "wseat": ["1234"],
                "ext": {
                    "appnexus": {
                        "sizes": [{
                            "w": 1,
                            "h": 1
                        }, {
                            "w": 320,
                            "h": 250
                        }]
                    }
                }
            }]
        },
        "ext": {
            "appnexus": {
                "estimated_clear_price": 10.72,
                "predicted_view_rate": 0.784599,
                "member_ad_profile_id": 23456,
                "predicted_video_completion_rate": 0,
                "predicted_view_rate_over_total": 0.764223,
                "allowed_payment_types": [{
                    "payment_type": 1,
                    "imp_count_method": 2
                }]
            }
        }
    }],
    "app": {
        "id": "3840770",
        "name": "FunAPP",
        "bundle": "no.funapp.android",
        "publisher": {
            "id": "123567"
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (Linux; Android 9; SM-G965F Build/PPR1.180610.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/74.0.3729.157 Mobile Safari/537.36",
        "geo": {
            "country": "NOR",
            "region": "02",
            "metro": "2435",
            "city": "Hakadal",
            "zip": "1487",
            "utcoffset": 120,
            "ext": {
                "appnexus": {
                    "timezone": "Europe/Oslo"
                }
            }
        },
        "lmt": 0,
        "ip": "123.23.100.5",
        "devicetype": 4,
        "make": "Samsung",
        "model": "SM-G965F",
        "os": "Android",
        "connectiontype": 0,
        "ifa": "0b3979c6-9c84-4359-a5e6-ee6565048fde",
        "ext": {
            "ifa_type": "aaid"
        }
    },
    "user": {
        "id": "4038657820804547795",
        "buyeruid": "S5670DGCSRG"
    },
    "at": 2,
    "tmax": 100,
    "wseat": ["3456"],
    "cur": ["USD"],
    "bcat": ["IAB9-9", "IAB8-5", "IAB8-18"],
    "badv": ["some_advertiser_domain.com"],
    "regs": {
        "coppa": 0
    },
    "source": {
        "fd": 0,
        "tid": "5676d767-e8b8-43b1-b7bf-fd6056b65018"
    },
    "ext": {
        "appnexus": {
            "seller_member_id": 1234,
            "publisher_integration": {
                "is_header": 0
            }
        },
        "schain": {
                "complete": 1,
                "nodes": [{
                    "asi": "appnexus.com",
                    "sid": "1234",
                    "rid": "5676d767-e8b8-43b1-b7bf-fd6056b65018",
                    "hp": 1
                }],
                "ver": "1.0"
            }
    }
}

Demande d’enchère multitag

{
    "id": "5698201228871522665",
    "imp": [{
            "id": "13529449707735835",
            "banner": {
                "w": 300,
                "h": 250,
                "id": "1",
                "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
                "pos": 0,
                "format": [{
                    "w": 300,
                    "h": 250
                }]
            },
            "instl": 0,
            "tagid": "123456",
            "secure": 1,
            "ext": {
                "appnexus": {
                    "estimated_clear_price": 0.5,
                    "member_ad_profile_id": 1234,
                    "allowed_payment_types": [{
                        "payment_type": 1,
                        "imp_count_method": 2
                    }]
                }
            }
        },
        {
            "id": "2460698130037038280",
            "banner": {
                "w": 580,
                "h": 400,
                "id": "1",
                "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
                "pos": 0,
                "format": [{
                    "w": 580,
                    "h": 400
                }, {
                    "w": 580,
                    "h": 500
                }]
            },
            "instl": 0,
            "tagid": "123457",
            "secure": 1,
            "ext": {
                "appnexus": {
                    "estimated_clear_price": 12.4,
                    "member_ad_profile_id": 1235,
                    "allowed_payment_types": [{
                        "payment_type": 1,
                        "imp_count_method": 2
                    }]
                }
            }
        }, {
            "id": "5610871170052394076",
            "banner": {
                "w": 580,
                "h": 400,
                "id": "1",
                "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
                "pos": 0,
                "format": [{
                    "w": 580,
                    "h": 400
                }, {
                    "w": 580,
                    "h": 500
                }]
            },
            "instl": 0,
            "tagid": "123478",
            "secure": 1,
            "ext": {
                "appnexus": {
                    "estimated_clear_price": 11.14,
                    "member_ad_profile_id": 8765,
                    "allowed_payment_types": [{
                        "payment_type": 1,
                        "imp_count_method": 2
                    }]
                }
            }
        }, {
            "id": "9057531734780521319",
            "banner": {
                "w": 580,
                "h": 400,
                "id": "1",
                "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
                "pos": 0,
                "format": [{
                    "w": 580,
                    "h": 400
                }, {
                    "w": 580,
                    "h": 500
                }]
            },
            "instl": 0,
            "tagid": "677",
            "secure": 1,
            "ext": {
                "appnexus": {
                    "estimated_clear_price": 11.31,
                    "member_ad_profile_id": 65987,
                    "allowed_payment_types": [{
                        "payment_type": 1,
                        "imp_count_method": 2
                    }]
                }
            }
        }, {
            "id": "7953238633763561522",
            "banner": {
                "w": 160,
                "h": 600,
                "id": "1",
                "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
                "pos": 0,
                "format": [{
                    "w": 160,
                    "h": 600
                }]
            },
            "instl": 0,
            "tagid": "987345",
            "secure": 1,
            "ext": {
                "appnexus": {
                    "estimated_clear_price": 18.91,
                    "member_ad_profile_id": 12345,
                    "allowed_payment_types": [{
                        "payment_type": 1,
                        "imp_count_method": 2
                    }]
                }
            }
        }, {
            "id": "6528429208551730965",
            "banner": {
                "w": 980,
                "h": 300,
                "id": "1",
                "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
                "pos": 0,
                "format": [{
                    "w": 980,
                    "h": 300
                }, {
                    "w": 580,
                    "h": 400
                }, {
                    "w": 580,
                    "h": 500
                }]
            },
            "instl": 0,
            "tagid": "34546",
            "secure": 1,
            "ext": {
                "appnexus": {
                    "estimated_clear_price": 8.58,
                    "member_ad_profile_id": 3456,
                    "allowed_payment_types": [{
                        "payment_type": 1,
                        "imp_count_method": 2
                    }]
                }
            }
        }, {
            "id": "8731177004555232453",
            "banner": {
                "w": 160,
                "h": 600,
                "id": "1",
                "battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
                "pos": 0,
                "format": [{
                    "w": 160,
                    "h": 600
                }, {
                    "w": 180,
                    "h": 500
                }, {
                    "w": 180,
                    "h": 700
                }]
            },
            "instl": 0,
            "tagid": "345637",
            "secure": 1,
            "ext": {
                "appnexus": {
                    "estimated_clear_price": 8.78,
                    "member_ad_profile_id": 34567,
                    "allowed_payment_types": [{
                        "payment_type": 1,
                        "imp_count_method": 2
                    }]
                }
            }
        }
    ],
    "site": {
        "id": "346789",
        "domain": "xandr.com",
        "cat": ["IAB12", "IAB12-2", "IAB11-5"],
        "page": "xandr.com",
        "publisher": {
            "id": "876543"
        }
    },
    "device": {
        "ua": "Mozilla/5.0 (Linux; Android 9; SAMSUNG SM-G950U) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/10.1 Chrome/71.0.3578.99 Mobile Safari/537.36",
        "geo": {
            "country": "USA",
            "region": "FL",
            "metro": "539",
            "city": "Tampa",
            "zip": "33617",
            "utcoffset": -240,
            "ext": {
                "appnexus": {
                    "timezone": "America/Indiana/Vevay"
                }
            }
        },
        "dnt": 0,
        "ip": "173.168.163.240",
        "devicetype": 2,
        "make": "Samsung",
        "model": "SM-G950U",
        "os": "Android",
        "language": "en",
        "connectiontype": 0,
        "ext": {}
    },
    "user": {
        "id": "6535227187230073444",
        "buyeruid": "a_dsp_user_id",
        "at": 1,
        "tmax": 100,
        "wseat": ["1417"],
        "cur": ["USD"],
        "regs": {
            "coppa": 0
        },
        "source": {
            "fd": 0,
            "tid": "0edd5bae-91e7-4723-9f6b-21e942b623ce"
        },
        "ext": {
            "appnexus": {
                "seller_member_id": 958,
                "publisher_integration": {
                    "is_header": 0
                }
            },
            "schain": {
                "complete": 1,
                "nodes": [{
                    "asi": "appnexus.com",
                    "sid": "958",
                    "rid": "0edd5eab-91e7-4723-9f6b-21e912b623ce",
                    "hp": 1
                }],
                "ver": "1.0"
            }
        }
    }
}