Intégration OpenRTB

Ce guide aborde l'intégration d' OpenRTB 2.5 (y compris les macros) et des annonces natives avec Authorized Buyers. Il décrit également chaque champ du protocole des extensions Authorized Buyers OpenRTB.

Pour en savoir plus sur les protos OpenRTB, consultez le fichier proto OpenRTB. Pour les extensions Authorized Buyers, consultez le fichier de tampon de protocole des extensions OpenRTB.

L'implémentation OpenRTB sur Authorized Buyers est disponible dans deux formats similaires.

• JSON
• Protobuf: vous pouvez référencer le fichier de définition .proto pour le décodage des messages.

Cette page fait référence à l'implémentation d'OpenRTB par Google. Elle est basée sur le protocole Protobuf. Nous recommandons aux utilisateurs d'OpenRTB JSON de consulter également les spécifications OpenRTB officielles pour en savoir plus sur la façon dont ces champs sont insérés dans le protocole JSON.

Remarques concernant l'intégration

Vous devez lire l'intégralité de cette section avant de commencer les tests d'intégration.

Structure de ce document

Les tableaux ci-dessous contiennent les définitions des objets, y compris leur nom, qu'il soit requis ou non dans la demande d'enchère ou la réponse à l'enchère, son équivalent dans notre protocole d'enchères en temps réel protobuf Authorized Buyers, ainsi que des informations sur l'implémentation.

Notez également les points suivants:

• Le champ cid représente l'ID de facturation spécifié lors de la configuration du préciblage. Ce champ permet d'associer l'enchère à un élément billing_id envoyé dans la demande d'enchère. Si la requête contient plusieurs cid/billing_id ou si vous avez des sous-comptes actifs, vous devez spécifier le cid souhaité dans votre réponse. S'il n'y en a qu'un dans la requête et que vous n'avez pas de sous-comptes actifs, cette valeur sera déduite de la réponse.
• Pour plus de simplicité, les noms des sections ci-dessous suivent OpenRTB.
• Tous les champs seront renseignés dans la requête, le cas échéant. Nous ne transmettons jamais de valeurs nulles ni de chaînes vides.
• Les types et les descriptions d'OpenRTB ne sont pas inclus dans les tableaux ci-dessous. Consultez le fichier proto OpenRTB.
• Dans les demandes d'enchères encodées au format JSON, tous les champs saisis sous int64 ou Fix64 ci-dessous seront envoyés sous forme de chaînes afin d'éviter toute perte de précision pour les valeurs entières 64 bits.
• Le protocole JSON OpenRTB représente tous les champs bool sous forme d'entiers dans la requête, où 0 représente false et 1 représente true. Cette opération est requise par la spécification OpenRTB.

Comptabilisation des impressions et utilisation de macros

Pour limiter les écarts, nous vous recommandons d'utiliser le champ BidResponse.seatbid[].bid[].ext.impression_tracking_url pour l'ensemble de l'inventaire, y compris pour le format natif.

Les acheteurs doivent supprimer les pixels de suivi des impressions de la création (balisage) et inclure le champ impression_tracking_url (tableau de chaînes) dans la réponse à l'enchère. Dans OpenRTB 2.5, vous pouvez également utiliser BidResponse.seatbid[].bid[].burl. Le impression_tracking_url se déclenche lorsque l'impression est considérée comme facturable. Cela offre plus de précision que les pixels de suivi, qui peuvent suivre les impressions qui ont été récupérées par l'application, mais qui ne sont jamais affichées, en raison de la prélecture. Utilisez la macro de chiffrement %%WINNING_PRICE%% pour ce champ, ou la macro ${AUCTION_PRICE}.

Voici la liste des macros compatibles avec impression_tracking_url et burl:

• ${AUCTION_ID} : ID de la demande d'enchère, issu de l'attribut BidRequest.id.
• ${AUCTION_BID_ID} : ID de l'enchère. Il correspond à l'attribut BidResponse.bidid.
• ${AUCTION_IMP_ID} : ID de l'impression qui vient d'être remportée ; provenant de l'attribut BidRequest.imp[].id.
• ${AUCTION_SEAT_ID} : ID du siège de l'enchérisseur pour lequel l'enchère a été effectuée. Il provient de l'attribut BidResponse.seatbid[].seat.
• ${AUCTION_AD_ID} : ID du balisage de l'annonce que l'enchérisseur souhaite diffuser ; à partir de l'attribut BidResponse.seatbid[].bid[].adid.
• ${AUCTION_PRICE} : suppression du prix dans la même devise et les mêmes unités que l'enchère. Notez que cette macro n'est actuellement pas compatible avec les annonces AMP.

L'implémentation OpenRTB de Google chiffre AUCTION_PRICE de manière identique à la macro WINNING_PRICE du protocole Authorized Buyers. Pour savoir comment déchiffrer le prix, consultez le guide Déchiffrer les confirmations de prix.

Migration vers Protobuf

L'encodage Protobuf est beaucoup plus efficace en termes de bande passante et de traitement. Il est donc recommandé. La migration vers Protobuf est simple, car les deux formats ont des champs correspondants.

Lorsque vous migrez de JSON vers Protobuf, assurez-vous que le champ cid est configuré en tant que chaîne dans la réponse à l'enchère. Nous utilisons ce champ pour associer l'enchère à votre billing_id dans votre préciblage. Si elle n'est pas lisible, nous n'accepterons pas l'enchère.

VAST et compatibilité vidéo

Par défaut, nous acceptons les URL SSL plutôt que le code XML complet pour les annonces VAST. Toutefois, les enchérisseurs sur une place de marché peuvent renvoyer la version VAST complète. Vous pouvez activer cette fonctionnalité dans tous les comptes en contactant l'équipe d'assistance dédiée.

Notez que dans video.skip=1 RTB 2.4 et versions ultérieures, les acheteurs peuvent enchérir avec des créations vidéo non désactivables ou désactivables. Nous vous recommandons d'activer la fonctionnalité Ignorer la correction lors de la configuration du compte, car aucune distinction n'est établie entre ALLOW_SKIPPABLE et REQUIRE_SKIPPABLE dans OpenRTB.

Champs non acceptés

Le champ Nurl n'est pas pris en charge pour le moment, mais impression_tracking_url l'est aussi, tout comme Bid.burl dans OpenRTB 2.5: consultez les commentaires ci-dessus.

Aucune enchère

Si le client ne souhaite pas enchérir, il doit répondre avec un code 204.

Enums

Toutes les énumérations sont disponibles dans la documentation officielle d' OpenRTB 2.5 et des annonces natives.

Notez que MRAID-1 est un sous-ensemble de MRAID-2. Dans OpenRTB 2.1 et versions antérieures, la valeur 3 était MRAID. Cependant, toutes les API compatibles avec la norme MRAID ne comprennent pas les fonctionnalités de la norme MRAID-2. La seule interprétation sûre de la valeur 3 est MRAID-1. Dans OpenRTB 2.2, cette valeur a été rendue explicite et MRAID-2 a été ajouté en tant que valeur 5.

Vérifier la version d'OpenRTB

OpenRTB/JSON

x-openrtb-version est présent et contient 2.2, 2.3, 2.4 ou 2.5. Content-Type est application/json. charset=utf-8.

OpenRTB/Protobuf

x-openrtb-version est présent et contient 2.3, 2.4 ou 2.5. Content-Type est application/octet-stream.

Variables de demande d'enchères et définitions

Assurez-vous d'avoir à disposition le guide de spécifications OpenRTB 2.5 lorsque vous consultez cette page. Cette spécification contient des informations et des nuances spécifiques à l'implémentation d'Authorized Buyers. Vous devez également suivre les consignes présentées dans OpenRTB en l'état.

Demande d'enchère

L'objet de demande d'enchère de premier niveau contient un appel d'enchère ou un ID d'enchère uniques à l'échelle mondiale. Cet attribut d'ID est obligatoire, tout comme au moins un objet Imp (impression). D'autres attributs de cet objet de niveau supérieur définissent des règles et des restrictions qui s'appliquent à toutes les impressions proposées.

Plusieurs objets subordonnés fournissent également des données détaillées aux acheteurs potentiels. Parmi eux, les objets Site et App, qui décrivent le type de support publié dans lequel les impressions apparaissent. Ces objets sont vivement recommandés, mais un seul s'applique à une demande d'enchère donnée, selon que le contenu multimédia est respectivement un contenu Web basé sur un navigateur ou une application autre qu'un navigateur.

Remarque: Le protocole JSON OpenRTB représente tous les champs bool sous forme d'entiers dans la requête, où 0 représente false et 1 représente true. Cette opération est requise par la spécification OpenRTB.

Attribut	Toujours transmis	Type	Acheteurs autorisés équivalents	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Oui	chaîne	ID du vCPM	2,3 2,4 2,5		ID unique de la demande d'enchère, fourni par la place de marché. OpenRTB utilise base64 sécurisée sur le Web (sans marge intérieure).
imp	Oui	Tableau d'objets Imp	BidRequest.AdSlot	2,3 2,4 2,5		Représente les impressions proposées. Veuillez indiquer au moins un objet Imp.
site	Non	Objet Site	BidRequest	2,3 2,4 2,5		Informations sur le site Web de l'éditeur. Uniquement applicable et recommandé pour les sites Web. Une seule occasion avec app.
app	Non	Objet App	BidRequest BidRequest.Mobile	2,3 2,4 2,5		Informations sur l'application de l'éditeur (applications autres que des navigateurs). Uniquement applicable et recommandé pour les applications. Une seule occasion avec site.
device	Non	Objet Device	BidRequest.Mobile, BidRequest.Device	2,3 2,4 2,5		Informations sur l'appareil de l'utilisateur sur lequel l'impression sera générée.
regs	Non	Objet Regs		2,3 2,4 2,5		Indique les réglementations, secteurs ou lois en vigueur pour cette demande.
user	Non	Objet User	BidRequest	2,3 2,4 2,5		Informations sur l'utilisateur de l'appareil et l'audience publicitaire.
at	Non	Objet AuctionType	Type d'enchère	2,3 2,4 2,5		où 1 = Premier prix, 2 = Deuxième prix plus. Les types d'enchères spécifiques aux places de marché peuvent être définis à l'aide de valeurs supérieures à 500. Valeur par défaut : SECOND_PRICE.
tmax	Non	int32	80 à 1 000 ms	2,3 2,4 2,5		Délai maximal, en millisecondes, pour soumettre une enchère afin d'éviter l'expiration du délai. Cette valeur est généralement communiquée hors connexion.
wseat	Non	chaîne	Non compatible	2,3 2,4 2,5		Liste d'autorisation de licences utilisateur (annonceurs, agences, etc.) autorisées à enchérir sur cette impression. Les ID des sièges et les connaissances des clients de l'acheteur auxquels ils font référence doivent être coordonnés entre les enchérisseurs et la place de marché a. L'omission n'implique aucune restriction de siège.
allimps	Non	Bool	Non compatible	2,3 2,4 2,5		Option permettant d'indiquer si Exchange peut vérifier que les impressions proposées représentent toutes les impressions disponibles en contexte (par exemple, toutes sur la page Web, tous les emplacements vidéo tels que les annonces pré/roll/post-roll) pour autoriser le blocage de route. 0 = non ou inconnu, 1 = oui, les impressions proposées représentent toutes les impressions disponibles.
cur	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des devises autorisées pour les enchères sur cette demande d'enchère à l'aide de codes alpha ISO-4217. Recommandé uniquement si la place de marché accepte plusieurs devises.
bcat	Non	Tableau de chaînes	BidRequest.AdSlot. excluded_sensitive _category, BidRequest.AdSlot. excluded_product _category	2,3 2,4 2,5		Les catégories d'annonceurs ont été bloquées à l'aide des catégories de contenu de l'IAB. Reportez-vous à la section énumération ContentCategory.
badv	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Bloquer la liste des annonceurs en fonction de leurs domaines (par exemple, "domainead.com")
bapp	Non	Tableau de chaînes	BidRequest.AdSlot.excluded_app_ids	2,4 2,5		Liste de blocage des applications en fonction de leurs identifiants d'application indépendants de la plate-forme. Sur Android, il doit s'agir de noms de bundle ou de package (par exemple, com.foo.monjeu). Sur iOS, il s'agit d'identifiants numériques.
test	Non	Bool	vCPM.is_test	2,3 2,4 2,5		Indicateur du mode test dans lequel les enchères ne sont pas facturables, 0 = mode actif, 1 = mode test. Par défaut : 1
bseat	Non	chaîne	Non compatible	4		Bloquer la liste des sièges d'acheteurs (annonceurs ou agences, par exemple) limités aux enchères pour cette impression. Les ID des sièges et les connaissances des clients de l'acheteur auxquels ils font référence doivent être coordonnés entre les enchérisseurs et la place de marché a priori. Un seul des éléments wseat et bseat doit être utilisé dans la même requête. Leur absence n'implique aucune restriction de siège.
wlang	Non	chaîne	BidRequest .AdSlot .allowed _languages	4		Liste de langues pour les créations utilisant la norme ISO-639-1-alpha-2. L'omission n'implique aucune restriction spécifique, mais les acheteurs sont invités à tenir compte de l'attribut de langue dans l'appareil et/ou les objets de contenu, s'ils sont disponibles.
source	Non	Objet Source	Utilisée uniquement pour les extensions	4		Un objet Source qui fournit des données sur la source d'inventaire et sur l'entité qui prend la décision finale
ext	Non	Objet BidRequestExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.bid_request] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder avec le champ ext dans le message BidRequest.

BidRequestExt

Pour en savoir plus, consultez la section Commentaires en temps réel.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
bid_feedback	Non	Tableau d'objets BidFeedback	BidRequest.bid_response_feedback	Commentaires sur les enchères envoyées dans les réponses précédentes. Ce paramètre n'est défini que si les commentaires en temps réel sont activés pour votre enchérisseur. Contactez votre responsable de compte si vous souhaitez activer les commentaires en temps réel.
google_query_id	Non	chaîne	BidRequest.google_query_id	Il s'agit d'un identifiant unique pour la requête globale. En cas d'appels multiples pour une requête, toutes les demandes d'accroche pour cette requête contiendront le même google_query_id.
fcap_scope	Oui	Énumération FrequencyCappingScope	BidRequest.AdSlot.FrequencyCappingScope	Fonctionnalité expérimentale susceptible d'être modifiée. Pour en savoir plus, consultez Définir des limites de la fréquence d'exposition hébergées par Google pour les enchères RTB . Décrit le champ d'application de la limite de la fréquence d'exposition disponible pour cette requête. Vous pouvez spécifier des limites de la fréquence d'exposition pour une enchère dans le champ "Bid.ext.fcap". FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0 ; valeur par défaut qui ne doit pas être utilisée, ou qui peut indiquer que le champ d'application de la limite de la fréquence d'exposition n'a pas pu être déterminé de manière fiable. FREQUENCY_CAPPING_SCOPE_NONE = 1. La limitation de la fréquence d'exposition basée sur les spécifications des réponses aux enchères n'est pas disponible pour cette demande. Une enchère avec limite de la fréquence d'exposition pour une demande d'enchère sans limitation de la fréquence d'exposition sera filtrée avant la mise aux enchères. FREQUENCY_CAPPING_SCOPE_BROWSER = 2 ; l'application de la limitation de la fréquence d'exposition est disponible sur plusieurs sites dans le même navigateur. FREQUENCY_CAPPING_SCOPE_DEVICE = 3 ; L'application de la limitation de la fréquence d'exposition est disponible sur plusieurs sites sur l'appareil, à l'exception des navigateurs. FREQUENCY_CAPPING_SCOPE_APP = 4 ; l'application de la limitation de la fréquence d'exposition est disponible dans une seule application. FREQUENCY_CAPPING_SCOPE_SITE = 5 ; l'application de la limitation de la fréquence d'exposition est disponible sur un seul site.
privacy_treatments	Non	Objet PrivacyTreatments	BidRequest.privacy_treatments	Traitements de la confidentialité. Certains champs de la demande d'enchère peuvent être masqués ou masqués afin de protéger la confidentialité des utilisateurs. Ce message fournit des informations sur les traitements liés à la confidentialité qui s'appliquent à une opportunité d'annonce proposée via cette demande.

Commentaires sur les enchères

Commentaires sur les enchères envoyées dans les réponses précédentes. Ce paramètre n'est défini que si les commentaires en temps réel sont activés pour votre enchérisseur. Contactez votre responsable de compte si vous souhaitez activer les commentaires en temps réel.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
request_id	Non	chaîne	BidRequest.vCPMFeedback.request_id.	ID unique du BidRequest.id.
creative_status_code	Non	int32	BidRequest.tokenFeedback.creative_status_code	Code d'état de l'annonce. Pour connaître la liste des ID, consultez les codes d'état des créations sur la page Protos & Data Data.
price	Non	double	vCPM.vCPMFeedback.cpm_micros	Si l'enchère a remporté la mise aux enchères, il s'agit du prix payé dans la devise de votre compte. Si l'enchère a participé à la mise aux enchères, mais qu'elle s'est avérée supérieure à l'enchère, il s'agit du CPM qui a dû être dépassé pour remporter l'enchère. Cette valeur n'est pas définie si l'enchère a été filtrée avant la mise aux enchères, si l'éditeur ou l'enchérisseur gagnant a désactivé les commentaires sur le prix, ou si votre compte a désactivé le partage des prix gagnants avec d'autres enchérisseurs. Pour les enchères au premier prix, le champ "minimum_bid_to_win" est renseigné à la place de ce champ.
minimum_bid_to_win	Non	double	BidRequest.tokenFeedback.minimum_bid_to_win	Montant minimal de l'enchère nécessaire pour remporter l'enchère, dans la devise de votre compte. Si votre enchère a remporté l'enchère, il s'agit de la deuxième enchère la plus élevée qui n'a pas été filtrée (prix plancher inclus). Si votre enchère n'a pas remporté la mise aux enchères, il s'agit de l'enchère du candidat gagnant. Ce champ n'est renseigné que si votre enchère a participé à une enchère au premier prix. Il n'est pas renseigné si votre enchère a été filtrée avant la mise aux enchères.
sampled_mediation_cpm_ahead_of_auction_winner	Non	double	BidRequest.vCPMFeedback.sample_médiation_cpm_ahead_of_auction_winner	Lorsqu'un éditeur utilise une mise aux enchères RTB et une médiation SDK basée sur une cascade d'annonces pour la même requête, le vainqueur de la mise aux enchères en temps réel doit également entrer en concurrence dans une cascade de médiation (triée par prix) pour remporter l'impression. Si l'enchère a participé à la mise aux enchères et qu'il n'y a pas de cascade d'annonces, la valeur de ce champ est 0. Si l'enchère a participé à la mise aux enchères et qu'il y a eu une cascade d'annonces, la valeur de ce champ est un prix représentant un exemple d'enchère provenant des réseaux de médiation éligibles qui était supérieur au gagnant, pondéré par le taux de remplissage attendu. Ce champ peut être utilisé conjointement avec minimum_bid_to_win pour entraîner des modèles d'enchères. Le CPM est exprimé dans la devise de votre compte.
event_notification_token	Non	Objet EventNotificationToken	BidRequest.tokenFeedback.event_notification_token	Jeton inclus dans l'enchère correspondante.
buyer_creative_id	Non	chaîne	BidRequest.tokenFeedback.buyer_creative_id	Identifiant de création inclus dans l'enchère correspondante.

Jeton de notification d'événement

Jeton inclus dans l'enchère correspondante.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
event_notification_token.payload	Non	chaîne	BidRequest.tokenFeedback.event_notification_token	Contenu du jeton.

Objet PrivacyTreatments

Parent

Traitements de la confidentialité. Certains champs de la demande d'enchère peuvent être masqués ou masqués afin de protéger la confidentialité des utilisateurs. Ce message fournit des informations sur les traitements liés à la confidentialité qui s'appliquent à une opportunité d'annonce proposée via cette demande.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
non_personalized_ads_reason	Non	Énumération NonPersonalizedAdsReason	BidRequest.privacy_treatments.non_customize_ads_reason	Indique les raisons pour lesquelles les annonces renvoyées en réponse à cette demande ne doivent pas être personnalisées. UNKNOWN = 0 ; raison inconnue. PUBLISHER_DECLARED_NPA = 1 ; l'éditeur a déclaré que cette demande devait diffuser des annonces non personnalisées indépendamment d'autres signaux. RESTRICT_DATA_PROCESSING= 2 ; l'éditeur a demandé un traitement restreint des données pour cette demande. USER_OPT_OUT = 3 : l'utilisateur a désactivé la personnalisation des annonces.
allow_user_data_collection	Non	Bool	BidRequest.privacy_treatments.allow_user_data_collection	"True" si l'éditeur autorise l'enchérisseur à utiliser les données de demande d'enchères pour créer des profils utilisateur à des fins telles que les annonces par centres d'intérêt et le remarketing. Pour utiliser ces données afin de créer des profils utilisateur, un enchérisseur doit également remporter une impression donnée. Consultez À propos des paramètres de collecte des données.

Source

Cet objet décrit la nature et le comportement de l'entité qui est la source de la demande d'enchère en amont de la place de marché. L'objectif principal de cet objet est de définir une décision post-enchère ou en amont lorsque la place de marché elle-même ne contrôle pas la décision finale. Les enchères d'en-tête constituent un exemple courant, mais elles peuvent également s'appliquer aux entités de serveur en amont telles qu'une autre place de marché RTB, une plate-forme de médiation ou un ad server qui combine des campagnes directes et une demande tierce lors de la prise de décisions.

Attribut	Toujours transmis	Type	Acheteurs autorisés équivalents	Compatible		Détails de mise en œuvre
				dans la version	par Google
fd	Non	booléen	Non compatible	4		Entité responsable de la décision finale concernant la vente d'impressions, où 0 = place de marché, 1 = source en amont. RECOMMANDÉ par la spécification OpenRTB.
tid	Non	chaîne	Non compatible	4		ID de transaction qui doit être commun à tous les participants à cette demande d'enchère (par exemple, plusieurs places de marché). RECOMMANDÉ par la spécification OpenRTB.
pchain	Non	chaîne	Non compatible	4		Chaîne de chaîne d'ID de paiement contenant la syntaxe intégrée décrite dans la version 1.0 du protocole de l'ID de paiement du TAG. RECOMMANDÉ par la spécification OpenRTB.
ext	Non	Objet SourceExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.source] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder au champ ext dans le message source.
schain	Non	Objet SupplyChain	BidRequest.supply_chain	2,3 2,4 2,5		Un objet SupplyChain OpenRTB Pour en savoir plus, consultez cet article.

Source ext.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
omidpn	Non	chaîne	BidRequest.AdSlot.omidpn	Identifiant de l'intégration du SDK OM. Pour en savoir plus, consultez l'avis OpenRTB concernant le SDK Open Measurement.
omidpv	Non	chaîne	BidRequest.AdSlot.omidpv	Version de l'intégration du SDK OM. Pour en savoir plus, consultez l'avis OpenRTB concernant le SDK Open Measurement.
schain	Non	Objet SupplyChain	BidRequest.supply_chain	Ce champ a été abandonné en faveur de BidRequest.source.schain et sera supprimé en décembre 2023. Ce champ contient l'objet SupplyChain OpenRTB. Pour en savoir plus, consultez cet article.

SupplyChain (Chaîne d'approvisionnement)

Un objet SupplyChain OpenRTB Pour en savoir plus, consultez cet article.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
complete	Non	int32	BidRequest.supply_chain.complete	Option indiquant si la chaîne contient tous les nœuds impliqués dans la transaction revenant au propriétaire du site, de l'application ou d'un autre support de l'inventaire, où 0 = non, 1 = oui.
nodes	Non	Tableau d'objets SupplyChainNode	BidRequest.supply_chain.nodes	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 publicitaire initial et l'ID du vendeur impliqué dans la transaction, par exemple 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.
ver	Non	chaîne	BidRequest.supply_chain.version	Version de la spécification de la chaîne d'approvisionnement en cours d'utilisation, au format "major.minor". Par exemple, pour la version 1.0 de la spécification, utilisez la chaîne "1.0".

SupplyChainNode

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
asi	Non	chaîne	BidRequest.supply_chain.nodes.advertising_system_identifier	Nom de domaine canonique de la plate-forme SSP, Exchange, Header Wrapper ou autre système auquel les enchérisseurs se connectent. Il peut s'agir du domaine opérationnel du système, s'il est différent du domaine parent de l'entreprise, pour faciliter la recherche WHOIS et inversée afin d'établir clairement la propriété du système délégué. Cette valeur doit être identique à celle utilisée pour identifier les vendeurs dans un fichier ads.txt, le cas échéant.
sid	Non	chaîne	BidRequest.supply_chain.nodes.seller_identifier	Identifiant associé au compte vendeur ou revendeur dans le système publicitaire. Cette valeur doit contenir la même valeur que celle utilisée dans les transactions (par exemple, les demandes d'enchères OpenRTB) dans le champ spécifié par la SSP/la place de marché. En général, dans OpenRTB, il s'agit de "publisher.id". Pour OpenDirect, il s'agit généralement de l'ID d'organisation de l'éditeur. Il ne doit pas dépasser 64 caractères.
rid	Non	chaîne	Non compatible	ID de requête OpenRTB de la requête, émis par ce vendeur.
name	Non	chaîne	Non compatible	Nom de l'entreprise (entité juridique) payée pour l'inventaire transactionné 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	Non	chaîne	Non compatible	Nom de domaine d'entreprise 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	Non	int32	BidRequest.supply_chain.nodes.handles_payment	Indique si ce nœud sera impliqué dans le flux de paiement de l'inventaire. Lorsqu'il est défini sur 1, le système publicitaire du champ "asi" paie le vendeur dans le champ "sid", qui est responsable du paiement du nœud précédent de la chaîne. Lorsqu'il est défini sur 0, ce nœud n'est pas impliqué dans le flux de paiement de l'inventaire. Pour la version 1.0 de SupplyChain, cette propriété doit toujours être 1. Il est explicitement requis d'inclure cette valeur, car les futures versions de la spécification introduisent des nœuds de traitement des paiements autres que les paiements. Les responsables de la mise en œuvre doivent s'assurer qu'ils acceptent ce champ et le propager lors de la construction des objets SupplyChain dans les demandes d'enchères envoyées à un système publicitaire en aval.

Lutin

Cet objet décrit un emplacement d'annonce ou une impression mise aux enchères. Une même demande d'enchère peut inclure plusieurs objets Imp. Il peut s'agir, par exemple, d'une place de marché permettant de vendre toutes les positions d'annonces sur une page donnée. Chaque objet Imp possède un identifiant requis qui permet aux enchères de les référencer individuellement.

La présence d'objets Banner, Video ou Native subordonnés à l'objet Imp indique le type d'impression proposée. L'éditeur peut choisir l'un de ces types, comme c'est le cas habituellement, ou les combiner à sa seule discrétion. Toute enchère pour une impression doit respecter l'un des types proposés.

Attribut	Toujours transmis	Type	Acheteursautoriséséquivalents	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Oui	chaîne	BidRequest .Adslot.id	2,3 2,4 2,5		Identifiant unique de cette impression dans le contexte de la demande d'enchère (généralement, la valeur commence par 1 et augmente jusqu'à n pour n impressions).
banner	Non	Objet Banner	BidRequest .AdSlot	2,3 2,4 2,5		Un objet Banner ; obligatoire si cette impression est proposée en tant qu'opportunité de bannière.
video	Non	Objet Video	BidRequest .AdSlot BidRequest .Vidéo	2,3 2,4 2,5		Obligatoire si cette impression est proposée en tant qu'opportunité d'annonce vidéo.
audio	Non	Objet Audio	BidRequest .AdSlot BidRequest .Vidéo	2,3 2,4 2,5		Obligatoire si cette impression est proposée en tant qu'opportunité d'annonce audio.
displaymanager	Non	chaîne	BidRequest .AdSlot .renderer	2,3 2,4 2,5		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 d'annonce en fonction du partenaire. Option recommandée pour les vidéos et/ou les applications. Exemples de chaînes: UNKNOWN_RENDERER GOOGLE PUBLISHER
displaymanagerver	Non	chaîne	Non compatible	2,3 2,4 2,5		Version du partenaire de médiation publicitaire, de la technologie du SDK ou du lecteur responsable du rendu de l'annonce (généralement pour les vidéos ou pour mobile). Utilisé par certains ad servers pour personnaliser le code d'annonce en fonction du partenaire. Option recommandée pour les vidéos et/ou les applications.
instl	Non	Bool	BidRequest .AdSlot .Mobile. is_interstitiel _request	2,3 2,4 2,5		1 = l'annonce est interstitielle ou en plein écran, 0 = n'est pas une annonce interstitielle.
tagid	Non	chaîne	BidRequest .AdSlot .ad_block_key	2,3 2,4 2,5		Identifiant d'un emplacement d'annonce ou d'un tag d'emplacement publicitaire ayant été utilisé pour lancer l'enchère. Cela peut être utile pour le débogage de tout problème ou pour l'optimisation par l'acheteur.
bidfloor	Non	double	min(BidRequest .AdSlot. correspondant _ad_data .minimum_cpm _micros) * 1 000 000	2,3 2,4 2,5		Enchère minimale pour cette impression, exprimée en CPM.
bidfloorcur	Non	chaîne	Compatible obtenue à partir de billing_id	2,3 2,4 2,5		Devise spécifiée à l'aide des codes alpha ISO-4217. Elle peut être différente de la devise d'enchère renvoyée par l'enchérisseur si la place de marché le permet. Une seule devise, obtenue à partir du billing_id inclus.
clickbrowser	Non	Bool	Non compatible	2,4 2,5		Indique le type de navigateur ouvert lorsque l'utilisateur clique sur la création dans une application, où 0 = intégré, 1 = natif. Notez que Safari Controller sur les appareils iOS 9.x est considéré comme un navigateur natif pour cet attribut.
secure	Non	Bool	BidRequest .ad_slot .excluded_attribute 48:RichMedia CapabilityNonSSL	2,3 2,4 2,5		Option permettant d'indiquer si l'impression nécessite des éléments et un balisage sécurisés pour les URL HTTPS, où 0 = non sécurisé et 1 = sécurisé. Si cette valeur est omise, l'état sécurisé est inconnu, mais la compatibilité HTTP non sécurisée peut être assurée.
iframebuster	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des noms spécifiques aux places de marché de contournements iFrame compatibles.
pmp	Non	Objet Pmp	BidRequest .AdSlot .MatchingAdData	2,3 2,4 2,5		Un objet Pmp contenant tous les accords de place de marché privée en vigueur pour cette impression.
native	Non	Natif	BidRequest .AdSlot .NativeAdTemplate	2,3 2,4 2,5		Un objet Native ; obligatoire si cette impression est proposée en tant qu'opportunité d'annonce native.
exp	Non	int32	BidRequest .AdSlot .impression_expiration _seconds	2,4 2,5		Indique le nombre de secondes qui peuvent s'écouler entre l'enchère et l'impression réelle.
metric	Non	Tableau d'objets Metric	BidRequest .AdSlot .viewability BidRequest .AdSlot .click_through _rate BidRequest .AdSlot .video_completion _rate BidRequest .AdSlot .session_depth.	4		Tableau d'objets Metric AdX fournit les métriques suivantes pour ce champ : click_through_rate, viewability, completion_rate et session_depth. La métrique viewability est une fraction comprise entre 0,00 et 1,00, mais exprimée en pourcentage [0-100] dans le protocole AdX. Reportez-vous au tableau des objets AdSlot du guide des enchères en temps réel pour obtenir la description de ces métriques. Notez que session_depth est un nombre entier.
ext	Non	Objet ImpExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.imp] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder au champ ext dans le message d'imp.
rwdd	Non	Bool	BidRequest.AdSlot.is_rewarded	2.6		Indique si l'utilisateur reçoit une récompense pour avoir vu l'annonce. Pour les annonces vidéo, les implémentations classiques permettent aux utilisateurs de lire sans frais un article d'actualité supplémentaire, de prolonger leur durée de vie dans un jeu ou de bénéficier d'une session musicale sponsorisée sans publicité. La récompense est généralement diffusée une fois l'annonce vidéo terminée.

Imp obtenir

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
billing_id	Oui	Tableau de Int64	BidRequest.AdSlot.MatchingAdData.billing_id	Les ID de facturation correspondant aux configurations de préciblage correspondantes.
publisher_settings_list_id	Oui	Tableau de Fix64	BidRequest.publisher_settings_list_id BidRequest.AdSlot.publisher_settings_list_id	ID de la liste des paramètres éditeur qui s'applique à cette page. Pour en savoir plus, consultez le guide Paramètres éditeur du RTB.
allowed_vendor_type	Non	Tableau int32	BidRequest.AdSlot.allowed_vendor_type	Types de fournisseurs autorisés. Reportez-vous au fichier vendors.txt pour obtenir la liste des ID.
excluded_creatives	Non	Tableau d'objets ExcludedCreative	BidRequest.AdSlot.excluded_creatives	Créations non autorisées pour l'impression. Si vous spécifiez une enchère avec l'une des créations de cette liste, elle sera filtrée avant la mise aux enchères. Contactez votre responsable de compte si vous souhaitez activer cette fonctionnalité.
publisher_parameter	Non	Tableau de chaînes	BidRequest.AdSlot.ExchangeBidding.publisher_parameter	Chaînes UTF8 éventuellement fournies par l'éditeur lors de la configuration des groupes de rendement correspondants dans l'interface utilisateur d'Ad Manager. Ce format est arbitraire et doit être convenu par l'éditeur et l'enchérisseur Authorized Buyers.
dfp_ad_unit_code	Non	chaîne	BidRequest.AdSlot.dfp_ad_unit_code	Code du bloc d'annonces Ad Manager. Actuellement, ce paramètre n'est défini que pour les demandes Open Bidding.
is_rewarded_inventory	Non	Bool	BidRequest.AdSlot.is_rewarded	Ce champ a été abandonné et a été supprimé en juillet 2023. Il sera remplacé par BidRequest.imp.rwdd. Ce champ indique si l'utilisateur reçoit ou non une récompense pour avoir vu l'annonce. Pour les annonces vidéo, les implémentations classiques permettent aux utilisateurs de lire sans frais un article d'actualité supplémentaire, de prolonger leur durée de vie dans un jeu ou de bénéficier d'une session musicale sponsorisée sans publicité. La récompense est généralement diffusée une fois l'annonce vidéo terminée.
is_app_open_ad	Non	Bool	BidRequest.Mobile.is_app_open_ad	Indique si une demande d'enchère pour une application mobile concerne une annonce à l'ouverture d'une application. Pour en savoir plus, consultez Conseils sur les annonces à l'ouverture d'une application.
ampad	Non	Énumération AmpAdRequirementType	BidRequest.AdSlot.amp_ad_request_type	Types d'exigences possibles pour les annonces AMP. UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1. (Par défaut) Les exigences concernant les annonces AMP ne sont pas connues. AMP_AD_NOT_ALLOWED = 2 ; les annonces AMP ne sont pas autorisées. AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 3. Les annonces AMP ou non-AMP sont autorisées, les annonces AMP ne sont pas diffusées de manière anticipée. AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4. Les annonces AMP ou non-AMP sont autorisées, les annonces AMP s'affichent de manière anticipée. AMP_AD_REQUIRED = 5 ; les annonces AMP sont requises. Les annonces non-AMP peuvent être refusées par l'éditeur.
buyer_generated_request_data	Non	Tableau d'objets BuyerGeneratedRequestData	BidRequest.AdSlot.secure_signals	Signaux sécurisés transmis par l'éditeur.
billable_event_rate_adjustment	Non	double	BidRequest.AdSlot.billable_event_rate_adjustment	Pour les annonces diffusées à l'aide d'un SDK personnalisé: multiplicateur appliqué à l'enchère. L'ajustement reflète la probabilité que votre enchère génère un événement facturable (par exemple, l'affichage de l'annonce avec succès) si elle a remporté l'enchère, par rapport à la probabilité que d'autres enchères génèrent un événement facturable s'ils l'ont remportée. Cet ajustement peut être supérieur ou inférieur à 1. Cela n'affecte que le classement final lors de l'enchère. Plus précisément, il n'a aucune incidence sur le paiement. Par défaut = 1,0.
open_bidding	Non	Objet OpenBidding	BidRequest.AdSlot.open_bidding	Paramètres associés à Open Bidding.
ad_unit_mapping	Non	Objet AdUnitMapping	BidRequest.AdSlot.ad_unit_mapping	Mises en correspondance de blocs d'annonces correspondant à l'espace publicitaire donné.
allowed_restricted_category	Non	int32	BidRequest.AdSlot.allowed_restricted_category	Catégories d'annonces limitées autorisées. Consultez le fichier ad-restricted-categories.txt pour obtenir la liste des identifiants.
skadn	Non	Objet SKAdNetworkRequest	BidRequest.Mobile.skadn	Informations SKAdNetwork de l'éditeur pour prendre en charge l'attribution d'installations d'applications pour iOS 14 et versions ultérieures. L'API SKAdNetwork d'Apple aide les annonceurs à mesurer l'installation d'applications basées sur les annonces en envoyant un postback au réseau publicitaire après une installation réussie. Les éditeurs doivent configurer les réseaux publicitaires compatibles dans la liste de propriétés de leur application (Info.plist) pour qu'une installation soit attribuée à l'impression d'annonce. Pour en savoir plus, consultez la documentation d'Apple.
Création exclue
buyer_creative_id	Non	chaîne	BidRequest.AdSlot.ExcludeCreative.buyer_creative_id	ID de la création de l'acheteur associée à la création non autorisée.
Requête de données de l'acheteur générée
data	Non	chaîne	BidRequest.AdSlot.SecureSignal.data	Signal sécurisé.
source_app	Non	Application source	BidRequest.AdSlot.SecureSignal.source	Source des données.
Application source
id	Non	chaîne	BidRequest.AdSlot.SecureSignal.source	Identifiant du SDK qui a généré ces données. Il correspond à l'identifiant dans BidRequest.AppExt.InstalledSdk.id.
OpenBidding
is_open_bidding	Non	Bool	BidRequest.AdSlot.OpenBidding.is_open_bidding	Ce champ est défini sur "true" si l'éditeur a configuré un groupe de rendement ou un groupe de médiation qui cible cet espace publicitaire et cet enchérisseur. Consultez le Centre d'aide pour en savoir plus sur Open Bidding et ses effets sur le processus d'enchères.
Mappage des blocs d'annonces
Keyval	Non	Objet Keyval	BidRequest.AdSlot.AdUnitMapping.keyval	Paire clé-valeur utilisée pour spécifier le bloc d'inventaire dans l'espace de noms de l'enchérisseur.
FormatType	Non	enum	BidRequest.AdSlot.AdUnitMapping.format_type	Formats de blocs d'annonces possibles pour la mise en correspondance. Correspond à l'adaptateur qui sera utilisé sur le SDK. Les valeurs possibles sont : FORMAT_UNKNOWN = 0; Bannières display pour le Web ou les applications mobiles. (par exemple, un espace leaderboard de 320 x 50). Cela inclut les vidéos OutStream. FORMAT_BANNER = 1; Annonce en plein écran qui s'affiche dans une application mobile. FORMAT_INTERSTITIAL = 2; Annonces display ou vidéo personnalisées pour le Web ou les applications mobiles qui correspondent à l'expérience utilisateur du site ou de l'application où elles sont diffusées. FORMAT_NATIVE = 3; Annonces vidéo qui s'affichent avant, pendant ou après les flux de contenu vidéo. FORMAT_VIDEO_VAST = 4; Annonces vidéo pour applications mobiles qui permettent aux utilisateurs de visionner volontairement une annonce en échange d'une récompense dans une application. FORMAT_REWARDED = 5; Annonces interstitielles qui permettent aux utilisateurs de regarder une annonce en échange d'une récompense dans une application. Aucune activation requise. https://support.google.com/admanager/answer/7386053 FORMAT_REWARDED_INTERSTITIAL = 6; Les annonces à l'ouverture d'une application s'affichent sur les écrans de chargement de l'application. Les annonces à l'ouverture d'une application peuvent être fermées à tout moment et sont conçues pour être diffusées lorsque l'utilisateur positionne l'application au premier plan. FORMAT_APP_OPEN = 7;
Demande SKAdNetwork
versions	Non	Tableau de chaînes	BidRequest.Mobile.skadn.versions	Liste de toutes les versions de SKAdNetwork compatibles avec la requête, en fonction de la version de l'OS et de la version du SDK.
sourceapp	Non	chaîne	BidRequest.Mobile.skadn.sourceapp	ID de l'application de l'éditeur sur l'App Store d'Apple.
skadnetids	Non	Tableau de chaînes	BidRequest.Mobile.skadn.skadnetids	Entrées SKAdNetworkIdentifier dans le fichier Info.plist de l'application de l'éditeur.
fidelities	Non	Tableau d'objets SKAdNetworkFidelityType	BidRequest.Mobile.skadn.supported_fidelity_types	Liste des types de fidélité compatibles, en fonction de la version de l'API SKAdNetwork compatible avec le système d'exploitation et le SDK, ainsi que les propriétés de l'espace publicitaire.
skoverlay	Non	Bool	BidRequest.Mobile.skadn.skOverlay	Indique si cette demande est compatible avec SKOverlay pour les annonces vidéo.

Objet Keyval

Parent

Vous pouvez spécifier plusieurs paires clé/valeur afin d'accepter les enchérisseurs dont l'espace de bloc d'inventaire est hiérarchique et possède plusieurs identifiants. Les paires clé-valeur du AdUnitMapping choisi doivent être renvoyées dans la réponse à l'enchère sous la forme de "ffffff.seatbid.bid.ext.sdk_rendered_ad.sdk_params". Elle est transmise au SDK de l'enchérisseur.

Attribut	Type	Toujours transmis	Équivalent Authorized Buyers	Détails de mise en œuvre
key	chaîne	Non	BidRequest.AdSlot.AdUnitMapping.keyval.key	La clé correspond au nom de l'identifiant d'unité d'inventaire de l'enchérisseur pour le SDK.
value	chaîne	Non	BidRequest.AdSlot.AdUnitMapping.keyval.value	Valeur de l'identifiant de bloc d'inventaire de l'enchérisseur pour le format donné.

Métrique

Cet objet est associé à une impression sous la forme d'un tableau de métriques. Ces métriques peuvent fournir des informations sur l'impression afin de faciliter la prise de décision, comme la visibilité récente récente, le taux de clics, etc. Chaque métrique est identifiée par son type, en indique la valeur, et éventuellement la source ou le fournisseur qui la mesure.

Attribut	Toujours transmis	Type	Acheteurs autorisés équivalents	Compatible		Détails de mise en œuvre
				dans la version	par Google
type	Non	chaîne	Au choix: BidRequest .AdSlot .viewability BidRequest .AdSlot .click_ through_rate BidRequest .AdSlot .video_ completion_rate BidRequest .AdSlot .session_depth.	4		Type de métrique présentée à l'aide de noms de chaîne sélectionnés par la place de marché, qui doivent être publiés au préalable sur les enchérisseurs. OBLIGATOIRE conformément à la spécification OpenRTB. Les types compatibles sont les suivants : click_through_rate, viewability, completion_rate et session_depth.
value	Non	double	Valeur comprise entre 0 et 1.	4		Nombre représentant la valeur de la métrique. Les probabilités doivent être comprises entre 0 et 1. OBLIGATOIRE conformément à la spécification OpenRTB. La métrique viewability est une fraction comprise entre 0,00 et 1,00, mais exprimée en pourcentage [0-100] dans le protocole AdX.
vendor	Non	chaîne	EXCHANGE	4		Source de la valeur à l'aide de noms de chaîne sélectionnés pour la place de marché, qui doivent être publiés a priori auprès des enchérisseurs. Si la place de marché en elle-même est la source plutôt qu'une source tierce, nous vous recommandons d'utiliser "EXCHANGE". RECOMMANDÉ par la spécification OpenRTB.

Bannière

Cet objet représente le type d'impression le plus général. Bien que le terme "bannière" puisse avoir une signification très spécifique dans d'autres contextes, il peut s'agir, entre autres, d'une image statique simple, d'un bloc d'annonces extensibles ou même d'une vidéo InBanner (consultez l'objet Video pour connaître les blocs d'annonces vidéo plus généralisés et complets). Un tableau d'objets Banner peut également apparaître dans la vidéo pour décrire des annonces associées facultatives définies dans la spécification VAST.

La présence d'un élément Banner en tant que subordonnée de l'objet Imp indique que cette impression est proposée en tant qu'impression de type bannière. Du point de vue de l'éditeur, cette même impression peut également être proposée en tant que vidéo et/ou native en incluant également, en tant que Imp, les objets Video et/ou Native. Cependant, une enchère pour une impression doit respecter l'un des types proposés.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
w	Non	int32	BidRequest.AdSlot.width[0]	2,3 2,4 2,5		Largeur en pixels indépendants de l'appareil (DIPS). Si aucun objet Format n'est spécifié, il s'agit d'une exigence de largeur exacte. Sinon, il s'agit d'une largeur préférée.
h	Non	int32	BidRequest.AdSlot.height[0]	2,3 2,4 2,5		Hauteur en pixels indépendants de l'appareil (DIPS). Si aucun objet Format n'est spécifié, il s'agit d'une exigence de hauteur exacte. Sinon, il est préférable d'utiliser la hauteur.
format	Non	Tableau d'objets Format	Non compatible	2,4 2,5		Tableau d'objets Format représentant les tailles de bannière autorisées. Si aucun n'est spécifié, il est vivement recommandé d'utiliser les attributs h et w.
id	Non	chaîne	BidRequest.AdSlot	2,3 2,4 2,5		Identifiant unique de cet objet Banner. Recommandé lorsque les objets Banner sont utilisés avec un objet Video pour représenter un tableau d'annonces associées. Les valeurs commencent généralement à 1 et augmentent avec chaque objet. Elles doivent être uniques au sein d'une impression.
pos	Non	Énumération AdPosition	BidRequest.AdSlot.slot_visibilité BidRequest.StickySettings	2,3 2,4 2,5		Les valeurs de cette table OpenRTB sont dérivées des consignes de contrôle qualité de l'IAB. Les professionnels doivent veiller à la synchronisation des mises à jour des valeurs de contrôle qualité telles qu'elles sont publiées sur IAB.net. Les valeurs "4" à "7" s'appliquent aux applications conformément à l'avenant relatif à la version 1.5 du contrôle qualité. Banner.pos n'accepte qu'une seule valeur. Si is_sticky, Banner.pos est renseigné avec des paramètres persistants. Si la valeur est unknown_stickiness, slot_visibility est utilisé. Le terme "persistant" indique que la bannière est toujours affichée à l'écran, tandis que la visibilité dans la partie au-dessus ou en dessous de la ligne de flottaison peut changer à mesure que l'utilisateur fait défiler la page. Les valeurs possibles sont les suivantes : ABOVE_THE_FOLD = 1; BELOW_THE_FOLD = 3; HEADER = 4; Équivalent de sticky_settings.top_horizontal_stickiness dans le protocole RTB d'Authorized Buyers. FOOTER = 5; Équivalent de sticky_settings.bottom_horizontal_stickiness dans le protocole RTB d'Authorized Buyers. SIDEBAR = 6; Équivalent de sticky_settings.vertical_stickiness dans le protocole RTB d'Authorized Buyers.
btype	Non	Tableau de l'énumération bannièreAdType	Non compatible	4		Types de bannières bloquées Exemples: XHTML_TEXT_AD = 1; // "Généralement mobile." XHTML_BANNER_AD = 2; // "Généralement mobile." JAVASCRIPT_AD = 3; // JavaScript doit être un identifiant xhtml valide. iFrame = 4; // iFrame.
battr	Non	Tableau d'énumération CreativeAttribute	BidRequest.AdSlot.excluded_attribute	2,3 2,4 2,5		Attributs de création bloqués. Exemples: AUDIO_AUTO_PLAY = 1; AUDIO_USER_INITIATED = 2
mimes	Non	Tableau de chaînes	Mappage uniquement pour BidRequest.Video.companionad : BidRequest.Video.companionad.creative_format BidRequest.AdSlot.excluded_attribute / VPAID	2,3 2,4 2,5		Liste des types MIME de contenu acceptés. Les types MIME courants incluent, sans s'y limiter, "image/jpg", "image/gif" et "application/x-shockwave-flash".
topframe	Non	Bool	BidRequest.AdSlot.iframe_state NO_iFrame: faux SAME_DOMAIN_iFrame, CROSS_DOMAIN_iFrame: true	2,3 2,4 2,5		Indiquez si la bannière est diffusée dans le cadre supérieur (true) ou dans un cadre iFrame (false).
expdir	Non	Tableau de ExpandableDirection énumération	BidRequest.AdSlot.excluded_attribute / ExpandING_*	2,3 2,4 2,5		Directions dans lesquelles la bannière peut se développer.
api	Non	Tableau d'objets APIFramework	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,3 2,4 2,5		Liste des frameworks d'API compatibles pour cette impression. Si une API n'est pas explicitement listée, elle est considérée comme non compatible.
vcm	Non	Bool	BidRequest.Video.end_cap_support	4		Uniquement pertinent pour les objets bannière utilisés avec un objet Vidéo dans un tableau d'annonces associées. Indique le mode de rendu de la bannière associée par rapport à la vidéo associée, où 0 = simultané, 1 = final. Pour le moment, seules les fiches de fin sont compatibles avec les interstitiels vidéo pour applications mobiles.
wmax	Non	int32	BidRequest.AdSlot.flexible_ad_slot_settings.max_width	2,3 2,4 2,5		Largeur maximale de l'impression en pixels.
hmax	Non	int32	BidRequest.AdSlot.flexible_ad_slot_settings.max_height	2,3 2,4 2,5		Hauteur maximale de l'impression en pixels.
wmin	Non	int32	BidRequest.AdSlot.flexible_ad_slot_settings.min_width	2,3 2,4 2,5		Largeur minimale de l'impression en pixels.
hmin	Non	int32	BidRequest.AdSlot.flexible_ad_slot_settings.min_height	2,3 2,4 2,5		Hauteur minimale de l'impression en pixels.

Format

Cet objet représente une taille autorisée (combinaison hauteur/largeur) pour une impression de bannière. Elles sont généralement utilisées dans un tableau pour une impression dans laquelle plusieurs tailles sont autorisées.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
w	Non	int32	BidRequest.AdSlot.width	2,4 2,5		Largeur en pixels indépendants de l'appareil (DIPS).
h	Non	int32	BidRequest.AdSlot.height	2,4 2,5		Hauteur en pixels indépendants de l'appareil (DIPS).
wratio	Non	int32	Non compatible	4		Largeur relative lors de l'expression de la taille sous forme de ratio.
hratio	Non	int32	Non compatible	4		Hauteur relative lors de l'expression de la taille sous forme de ratio.
wmin	Non	int32	Non compatible	4		Largeur minimale en pixels indépendants de l'appareil (DIPS) à laquelle l'annonce est diffusée lorsque la taille est exprimée sous forme de ratio.

Vidéo

Cet objet représente une impression vidéo InStream. La plupart des champs ne sont pas essentiels pour les transactions minimales viables, mais sont inclus pour offrir un contrôle précis en cas de besoin. Dans OpenRTB, les vidéos sont généralement conformes à la norme VAST. Ainsi, la notion d'annonce associée est acceptée par la possibilité d'inclure un tableau d'objets Banner qui définissent ces annonces.

La présence d'un élément Video en tant que subordonnée de l'objet Imp indique que cette impression est proposée en tant qu'impression de type vidéo. À la discrétion de l'éditeur, cette même impression peut également être proposée en tant que bannière et/ou native en incluant également des objets Imp Banner et/ou Native. Cependant, une enchère pour une impression doit respecter l'un des types proposés.

Pour en savoir plus, consultez le guide sur les annonces vidéo OpenRTB.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Version	Compatible avec Google	Détails de mise en œuvre
mimes	Oui	Tableau de chaînes	BidRequest.Video.allowed_video_formats, BidRequest.AdSlot.excluded_attribute / VPAID	2,3 2,4 2,5		Liste des types MIME de contenu acceptés. Les types MIME courants incluent, sans s'y limiter, "image/jpg", "image/gif" et "application/x-shockwave-flash". Requis par la spécification OpenRTB: au moins un élément.
linearity	Non	int32		2,3 2,4 2,5		Indique si l'impression doit être linéaire, non linéaire, etc. Si aucune valeur n'est spécifiée, supposons que toutes les impressions sont autorisées. LINEAR = 1: linéaire/InStream NON_LINEAR = 2: non linéaire/superposition
minduration	Non	int32	BidRequest.Video.min_ad_duration	2,3 2,4 2,5		Durée minimale de l'annonce vidéo en secondes. RECOMMANDÉ par la spécification OpenRTB.
maxduration	Non	int32	BidRequest.Video.max_ad_duration	2,3 2,4 2,5		Durée maximale de l'annonce vidéo en secondes. RECOMMANDÉ par la spécification OpenRTB.
protocols	Non	Tableau d'objets Protocol	BidRequest.Video.protocoles	2,3 2,4 2,5		Tableau des protocoles de réponse aux enchères vidéo acceptés. Vous devez spécifier au moins un protocole compatible. Exemples: VAST_1_0 = 1 ; VAST_2_0 = 2 ; VAST_3_0 = 3
w	Non	int32	BidRequest.AdSlot.width[0]	2,3 2,4 2,5		Largeur du lecteur vidéo en pixels indépendants de l'appareil (DIPS). RECOMMANDÉ par la spécification OpenRTB.
h	Non	int32	BidRequest.AdSlot.height[0]	2,3 2,4 2,5		Hauteur du lecteur vidéo en pixels indépendants de l'appareil (DIPS). RECOMMANDÉ par la spécification OpenRTB.
startdelay	Non	int32	BidRequest.Video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL Autres valeurs: videoad_start_delay / 1 000	2,3 2,4 2,5		Indique le délai de début de diffusion des annonces pré-roll, mid-roll ou post-roll, en secondes. Reportez-vous à l'énumération StartDelay pour les valeurs génériques. RECOMMANDÉ par la spécification OpenRTB.
skip	Non	Bool	BidRequest.Video.video_ad_désactivable	2,4 2,5		Indique si le lecteur permet d'ignorer la vidéo, où 0 = non, 1 = oui. Si un enchérisseur envoie un balisage/une création qui est lui-même désactivable, l'objet Bid doit inclure le tableau d'attributs, avec un élément de 16 indiquant une vidéo désactivable.
skipmin	Non	int32	Non compatible	2,4 2,5		Les vidéos d'une durée totale supérieure à ce nombre de secondes peuvent être désactivables. Elles ne s'appliquent que si l'annonce est désactivable.
skipafter	Non	int32	Non compatible	2,4 2,5		Durée en secondes pendant laquelle une vidéo doit être lue avant d'être ignorée. Cette option n'est applicable que si l'annonce est désactivable.
sequence	Non	int32	Non compatible	2,3 2,4 2,5		Si plusieurs impressions d'annonces sont proposées dans la même demande d'enchère, le numéro de séquence permet la diffusion coordonnées de plusieurs créations.[default = 1]
battr	Non	Tableau de l'attribut création	BidRequest.AdSlot.excluded_attribute	2,3 2,4 2,5		Attributs de création bloqués.
maxextended	Non	int32	Non compatible	2,3 2,4 2,5		Durée maximale de l'annonce vidéo si l'extension est autorisée. Si ce champ est vide ou nul, l'extension n'est pas autorisée. Si -1, l'extension est autorisée et aucune limite de temps n'est imposée. Si cette valeur est supérieure à 0, la valeur représente le nombre de secondes de lecture étendue acceptées au-delà de la valeur maxduration.
minbitrate	Non	int32	Non compatible	2,3 2,4 2,5		Débit minimal en Kbits/s.
maxbitrate	Non	int32	Non compatible	2,3 2,4 2,5		Débit maximal en Kbits/s.
boxingallowed	Non	Bool	Non compatible	2,3 2,4 2,5		Indique si le format letterbox 4:3 est autorisé dans une fenêtre 16:9, où 0 = no, 1 = yes. par défaut = true
playbackmethod	Non	Tableau de la méthode Playback	BidRequest.Video.playback_method AdX: VideoPlaybackMethod.AUTO_PLAY_SOUND_ON VideoPlaybackMethod.AUTO_PLAY_SOUND_OFF VideoPlaybackMethod.CLICK_TO_PLAY VideoPlaybackMethod.MOUSE_OVER VideoPlaybackMethod.ENTER_SOUND_ON VideoPlaybackMethod.ENTER_SOUND_OFF	2,3 2,4 2,5		Méthodes de lecture en cours d'utilisation. Si aucune méthode n'est spécifiée, vous pouvez utiliser n'importe quelle méthode. En général, une seule méthode est utilisée. Par conséquent, ce tableau peut être converti en entier dans une prochaine version de la spécification. Nous vous recommandons vivement de n'utiliser que le premier élément de ce tableau pour vous préparer à ce changement. AUTO_PLAY_SOUND_ON = 1: se lance lors du chargement de la page avec le son activé. AUTO_PLAY_SOUND_OFF = 2: se lance lors du chargement de la page sans son par défaut. CLICK_TO_PLAY = 3: se lance en cas de clic avec le son activé MOUSE_OVER = 4: se déclenche lorsque l'utilisateur passe la souris avec le son activé. ENTER_SOUND_ON = 5: lancement de la fonctionnalité dans la fenêtre d'affichage avec le son activé. ENTER_SOUND_OFF = 6: lancement de l'affichage de la fenêtre d'affichage sans son par défaut.
delivery	Non	Tableau ContentDelivery Method	Non compatible	2,3 2,4 2,5		Modes de diffusion compatibles (par exemple, streaming, progressif) Si aucune valeur n'est spécifiée, tous les éléments sont acceptés. STREAMING = 1; PROGRESSION = 2;
pos	Non	AdPosition	BidRequest.AdSlot.slot_visibilité	2,3 2,4 2,5		Position de l'annonce à l'écran.
companionad	Non	Tableau d'objets Banner	BidRequest.Video.companion_slot	2,3 2,4 2,5		Tableau d'objets Banner si des annonces associées sont disponibles.
api	Non	Tableau d'objets APIFramework	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,3 2,4 2,5		Liste des frameworks d'API compatibles pour cette impression. Si une API n'est pas explicitement listée, elle est considérée comme non compatible.
companiontype	Non	Tableau d'objets CompanionType	BidRequest.Video.companion_slot.creative_format	2,3 2,4 2,5		Types d'annonces associées VAST acceptées. Recommandé si les objets Banner associés sont inclus via le tableau companionad.
placement	Non	VideoPlacementType	vCPM.Vidéo.Emplacement INSTREAM -> IN_STREAM_PLACEMENT INTERSTITIAL -> FLOATING_PLACEMENT IN_FEED -> IN_FEED_PLACEMENT IN_ARTICLE -> IN_ARTICLE_PLACEMENT UNKNOWN_PLACEMENT -> UNDEFINED_VIDEO_PLACEMENT AUDIO -> UNDEFINED_VIDEO_PLACEMENT (non défini) -> IN_BANNER_PLACEMENT	4		Type d'emplacement de l'impression. UNDEFINED_VIDEO_PLACEMENT: l'emplacement vidéo n'est pas défini. Valeur par défaut. IN_STREAM_PLACEMENT: lu avant, pendant ou après le contenu vidéo en streaming demandé par le consommateur. (par exemple, pré-roll, mid-roll ou post-roll). IN_BANNER_PLACEMENT: existe dans une bannière Web qui exploite l'espace de la bannière pour offrir une expérience vidéo plutôt qu'un autre format statique ou rich media. Ce format repose sur l'existence, sur la page, d'un inventaire d'annonces display diffusé. IN_ARTICLE_PLACEMENT: charge et lit dynamiquement entre les paragraphes d'un contenu éditorial, existant sous la forme d'un message de marque autonome. IN_FEED_PLACEMENT : In-Feed : disponible dans les flux de contenu, de produits ou de réseaux sociaux. FLOATING_PLACEMENT: interstitiel/Curseur/Flottant. Couvre l'intégralité ou une partie de la zone de l'écran, mais elle reste toujours affichée à l'écran lorsqu'elle est affichée (par exemple, il est impossible de la faire défiler hors de la vue). Notez qu'un interstitiel en plein écran (sur mobile, par exemple) peut se distinguer d'un bloc Flash transparent/de curseur par le champ imp.instl.
playbackend	Non	PlaybackCessationMode	Non compatible	4		Événement qui entraîne la fin de la lecture.

Son

Cet objet représente une impression de type audio. La plupart des champs ne sont pas essentiels pour les transactions minimales viables, mais sont inclus pour offrir un contrôle précis en cas de besoin. Dans OpenRTB, le contenu audio est généralement conforme à la norme DAAST. Par conséquent, la notion d'annonce associée peut reposer sur l'ajout facultatif d'objets Banner qui définissent ces annonces associées. La présence d'un objet Audio en tant que sous-ensemble de l'objet Imp indique que cette impression est proposée en tant qu'impression de type audio. À la discrétion de l'éditeur, cette même impression peut également être proposée en tant que bannière, vidéo et/ou native en incluant également des objets subordonnés Imp de ces types. Cependant, une enchère pour une impression doit respecter l'un des types proposés.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
mimes	Non	Tableau de chaînes	BidRequest.Video.allowed_video_formats, BidRequestAdSlot.excluded_attribute / VPAID	2,4 2,5		Types MIME de contenu acceptés (par exemple, "audio/mp4") Requis par la spécification OpenRTB: au moins un élément.
minduration	Non	int32	BidRequest.Video.min_ad_duration	2,4 2,5		Durée minimale de l'annonce vidéo en secondes. RECOMMANDÉ par la spécification OpenRTB.
maxduration	Non	int32	BidRequest.Video.max_ad_duration	2,4 2,5		Durée maximale de l'annonce vidéo en secondes. RECOMMANDÉ par la spécification OpenRTB.
protocols	Non	Tableau d'objets Protocol	BidRequest.Video.protocoles	2,4 2,5		Tableau des protocoles de réponse aux enchères vidéo acceptés. Vous devez spécifier au moins un protocole compatible. Exemples: DAAST_1_0 = 9 ; DAAST_1_0_WRAPPER = 10
startdelay	Non	int32	BidRequest.Video.videoad_start_delay >0: start delay in seconds 0: PRE_ROLL -1: GENERIC_MID_ROLL -2: GENERIC_POST_ROLL Autres valeurs: videoad_start_delay / 1 000	2,4 2,5		Indique le délai de début de diffusion des annonces pré-roll, mid-roll ou post-roll, en secondes. Reportez-vous à l'énumération StartDelay pour les valeurs génériques. RECOMMANDÉ par la spécification OpenRTB.
sequence	Non	int32	Non compatible	2,4 2,5		Si plusieurs impressions d'annonces sont proposées dans la même demande d'enchère, le numéro de séquence permet la diffusion coordonnées de plusieurs créations.[default = 1]
battr	Non	Tableau d'objets CreativeAttribute	BidRequest.AdSlot.excluded_attribute	2,4 2,5		Attributs de création bloqués.
maxextended	Non	int32	Non compatible	2,4 2,5		Durée maximale de l'annonce vidéo si l'extension est autorisée. Si ce champ est vide ou nul, l'extension n'est pas autorisée. Si la valeur est -1, l'extension est autorisée et aucune limite de temps n'est imposée. Si cette valeur est supérieure à 0, la valeur représente le nombre de secondes de lecture étendue acceptées au-delà de la valeur maxduration.
minbitrate	Non	int32	Non compatible	2,4 2,5		Débit minimal en Kbits/s.
maxbitrate	Non	int32	Non compatible	2,4 2,5		Débit maximal en Kbits/s.
delivery	Non	Tableau d'objets ContentDeliveryMethod	Non compatible	2,4 2,5		Modes de diffusion compatibles (par exemple, streaming, progressif) Si aucune valeur n'est spécifiée, tous les éléments sont acceptés. STREAMING = 1; PROGRESSIVE = 2;
companionad	Non	Tableau d'objets Banner	BidRequest.Video.companion_slot	2,4 2,5		Tableau d'objets Banner si des annonces associées sont disponibles.
api	Non	Tableau d'objets APIFramework	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,4 2,5		Liste des frameworks d'API compatibles pour cette impression. Si une API n'est pas explicitement listée, elle est considérée comme non compatible.
companiontype	Non	Tableau d'objets CompanionType	BidRequest.Video.companion_slot.creative_format	2,4 2,5		Types d'annonces associées DAAST acceptés.
maxseq	Non	int32	Non compatible	2,4 2,5		Nombre maximal d'annonces pouvant être lues dans une série d'annonces.
feed	Non	Type de flux	Non compatible	2,4 2,5		Type de flux audio.
stitched	Non	Bool	Non compatible	2,4 2,5		Indique si l'annonce est assemblée avec du contenu audio ou diffusée de manière indépendante, où 0 = non, 1 = oui.
nvol	Non	VolumeNormalizationMode	Non compatible	2,4 2,5		Mode de normalisation des volumes

Natif

Cet objet représente une impression de type natif. Les blocs d'annonces natives sont conçus pour se fondre parfaitement dans le contenu environnant (par exemple, un post sponsorisé Twitter ou Facebook). Par conséquent, la réponse doit être bien structurée pour permettre à l'éditeur de contrôler précisément l'affichage.

Notez que la version 1.1 native est compatible avec OpenRTB 2.4 et OpenRTB 2.5.

Le sous-commis natif a développé une spécification associée à OpenRTB appelée Native Ad Specification. Il définit les paramètres de requête et la structure de balisage de réponse des blocs d'annonces natives.

Cet objet permet de transférer des paramètres de requête sous la forme d'une chaîne opaque afin que ces paramètres puissent évoluer séparément conformément aux spécifications des annonces natives. De même, le balisage de l'annonce diffusée sera structuré selon cette spécification. La présence d'un élément Native en tant que subordonnée de l'objet Imp indique que cette impression est proposée en tant qu'impression de type natif. Du point de vue de l'éditeur, cette même impression peut également être proposée sous forme de bannière et/ou de vidéo en incluant également, en tant que Imp, les objets Banner et/ou Video, respectivement. Cependant, une enchère pour une impression doit respecter l'un des types proposés.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
request	Non	chaîne	Modèle BidRequest.AdSlot.NativeAd	2,3 2,4 2,5		Demandez la charge utile conformément à la spécification d'annonce native. Vous devez utiliser exactement l'une des valeurs suivantes : {request, request_native}.
request_native	Non	Demande native	Modèle BidRequest.AdSlot.NativeAd	2,3 2,4 2,5		Demandez la charge utile conformément à la spécification d'annonce native. Vous ne devez utiliser qu'un seul de ces champs {request, request_native}. Il s'agit d'un autre champ préféré pour la sérialisation Protobuf.
ver	Non	chaîne	RECOMMANDÉ par la spécification OpenRTB.	2,3 2,4 2,5		Version de la spécification d'annonce native à laquelle la demande répond. RECOMMANDÉ par la spécification OpenRTB.
api		Tableau d'objets APIFramework	BidRequest.AdSlot.excluded_attribute / MRAID_1_0	2,3 2,4 2,5		Liste des frameworks d'API compatibles pour cette impression. Si une API n'est pas explicitement listée, elle est considérée comme non compatible.
battr		Tableau d'objets CreativeAttribute	BidRequest.AdSlot.excluded_attribute	2,3 2,4 2,5		Attributs de création bloqués.

MPA

Cet objet est le conteneur de la place de marché privée pour les accords directs entre les acheteurs et les vendeurs qui peuvent concerner cette impression. Les accords réels sont représentés par une collection d'objets Deal.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
private_auction	Non	Bool	BidRequest.AdSlot.only_deal_bids_accepted	2,3 2,4 2,5		Indicateur de l'éligibilité à la mise aux enchères pour les comptes nommés dans l'objet "Accords directs", où 0 = toutes les enchères sont acceptées, 1 = les enchères sont limitées aux accords spécifiés et aux conditions correspondantes
deals	Non	Tableau d'objets Deal	BidRequest.AdSlot.MatchingAdData.DirectDeal	2,3 2,4 2,5		Tableau d'objets Deal qui transmettent les accords spécifiques applicables à cette impression.

Accord

Cet objet constitue un accord spécifique qui a été conclu entre un acheteur et un vendeur. Sa présence dans la collection Pmp indique que cette impression est disponible selon les conditions de cet accord.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Oui	chaîne	BidRequest.AdSlot.MatchingAdData.DirectDeal.direct_deal_id	2,3 2,4 2,5		Identifiant unique de l'accord direct. OBLIGATOIRE conformément à la spécification OpenRTB.
bidfloor	Non	double	BidRequest.AdSlot.MatchingAdData.DirectDeal.fixed_cpm _micros *1 000 000	2,3 2,4 2,5		Enchère minimale pour cette impression, exprimée en CPM.
bidfloorcur	Non	chaîne	devise unique, obtenue à partir du billing_id inclus	2,3 2,4 2,5		Devise spécifiée à l'aide des codes alpha ISO-4217. Elle peut être différente de la devise d'enchère renvoyée par l'enchérisseur si la valeur "exchange.default" est définie sur "USD".
wseat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Liste d'autorisation de licences utilisateur (annonceurs, agences, etc.) autorisées à enchérir sur cet accord. ID des licences et connaissance de l'acheteur Les clients auxquels ils font référence doivent être coordonnés entre les enchérisseurs et la place de marché. L'omission n'implique aucune restriction de siège.
wadomain	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des domaines d'annonceurs (annonceur.com, par exemple) autorisés à enchérir sur cet accord. Une omission n'implique aucune restriction d'annonceur.
at	Non	Type d'enchères	Type d'enchère	2,3 2,4 2,5		Remplacement facultatif du type d'enchère global de la demande d'enchère, où 1 = Premier prix, 2 = Deuxième prix plus, 3 = La valeur transmise au prix plancher correspond au prix convenu de l'accord. La place de marché peut définir d'autres types d'enchères.
ext	Non	Objet DealExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.deal] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder au champ ext dans le message de l'accord.

Extérieures

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
deal_type	Non	Type d'accord (énumération)	BidRequest.AdSlot.MatchingAdData.DirectDeal.deal_type	Type d'accord. Notez que les remplacements de règle Authorized Buyers s'appliquent à toutes les enchères associées au programmatique garanti et à l'accord préféré, et non aux autres types d'accords. UNKNOWN_DEAL_TYPE = 0 ; par défaut. PREFERRED_DEAL = 1 ; Les enchères sont à prix fixe et sont évaluées avant les enchères ouvertes. Les enchérisseurs ne sont pas obligés de définir des enchères avec des accords préférés lorsqu'ils sont présents dans la demande d'enchère. Pour en savoir plus, consultez cet article. PRIVATE_AUCTION = 2 ; les enchères participent à des enchères privées pour une sélection d'acheteurs avec des prix planchers spécifiques. Pour en savoir plus, consultez cet article. PROGRAMMATIC_GUARANTEED = 3 ; Les prix sont fixes et sont évalués avant l'enchère ouverte. Les enchérisseurs doivent définir une enchère avec des accords de programmatique garanti dès lors qu'ils sont présents dans une demande d'enchère et que le champ "must_bid" est défini sur "true" afin que le nombre d'impressions convenu pour un accord donné soit diffusé. Pour en savoir plus, consultez cet article. AUCTION_PACKAGE = 4 ; l'ID de l'accord est un identifiant associé à un ensemble d'inventaires d'enchères ouvertes correspondant à un ensemble donné de critères de ciblage. Pour en savoir plus, consultez cet article. MARKETPLACE_PACKAGE = 5 ; ID de l'accord pour les packages d'inventaire sélectionnés par l'éditeur. Ces ID d'accord sont automatiquement envoyés à tous les acheteurs éligibles pour le package. Pour en savoir plus, consultez cet article.
must_bid	Non	Bool	BidRequest.AdSlot.MatchingAdData.DirectDeal.must_bid	Ce champ ne s'applique qu'aux accords de programmatique garanti. L'acheteur est autorisé à ignorer l'enchère pour l'impression si ce champ est faux. Lorsque la valeur est "true", l'acheteur doit définir une enchère sur cet accord pour cette opportunité d'impression. Ce champ sera toujours rempli explicitement pour le format de communication JSON. La valeur par défaut est "true".
publisher_blocks_overridden	Non	Bool	BidRequest.AdSlot.MatchingAdData.DirectDeal.publisher_blocks_overridden	Indique si l'éditeur a exclu cet accord des blocages configurés. Ce paramètre ne remplace pas les règles Authorized Buyers ni les décisions du centre de vérification des annonces. Pour en savoir plus, consultez cet article.
creative_source	Non	Énumération CreativeSourceType	BidRequest.AdSlot.MatchingAdData.DirectDeal.creative_source	Champ expérimental (sous réserve de modifications). Énumération déclarant l'hôte de la création. Elle ne sera renseignée que pour les accords de programmatique garanti. Actuellement, ce champ ne doit être défini que sur CREATIVE_SOURCE_ADVERTISER. CREATIVE_SOURCE_UNKNOWN = 0 CREATIVE_SOURCE_ADVERTISER = 1; (par défaut) la création est hébergée par l'annonceur, ce qui signifie que l'enchérisseur doit fournir une création dans la réponse à l'enchère. CREATIVE_SOURCE_PUBLISHER = 2 ; la création est hébergée par l'éditeur, ce qui signifie que l'enchérisseur n'a pas besoin d'inclure une création dans la réponse à l'enchère. Pour en savoir plus sur les créations hébergées par l'éditeur, consultez https://support.google.com/admanager/answer/9243220. Cette fonctionnalité n'est actuellement pas compatible avec les enchérisseurs RTB.

Site

Cet objet doit être inclus si le contenu accepté par l'annonce est un site Web et non une application autre qu'un navigateur. Une demande d'enchère ne doit pas contenir à la fois un objet Site et un objet App. Il est au minimum utile de fournir un ID de site ou une URL de page, mais ce n'est pas obligatoire.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	Non compatible	2,3 2,4 2,5		ID du site sur la place de marché. RECOMMANDÉ par la spécification OpenRTB.
name	Non	chaîne	Non compatible	2,3 2,4 2,5		Nom du site (peut être masqué à la demande de l'éditeur)
domain	Non	chaîne	Non compatible	2,3 2,4 2,5		Domaine du site, utilisé pour le blocage côté annonceur. Exemple : "foo.com".
cat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenu IAB de votre site. Reportez-vous à l'énumération ContentCategory.
sectioncat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenu IAB qui décrivent la section actuelle du site. Reportez-vous à l'énumération ContentCategory.
pagecat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenu IAB qui décrivent la page ou la vue actuelle du site. Reportez-vous à l'énumération ContentCategory.
page	Non	chaîne	BidRequest.url	2,3 2,4 2,5		URL de la page sur laquelle l'impression sera affichée
privacypolicy	Non	Bool	Non compatible	2,3 2,4 2,5		Indique si le site a des règles de confidentialité, où 0 = non, 1 = oui.
ref	Non	chaîne	Non compatible	2,3 2,4 2,5		URL de provenance ayant entraîné la navigation vers la page actuelle.
search	Non	chaîne	Non compatible	2,3 2,4 2,5		Chaîne de recherche ayant entraîné la navigation vers la page actuelle.
publisher	Non	Objet Publisher	BidRequest	2,3 2,4 2,5		Détails sur l'objet Publisher du site.
content	Non	Objet Content	BidRequest	2,3 2,4 2,5		Détails sur l'élément Content du site
keywords	Non	chaîne	Non compatible	2,3 2,4 2,5		Liste de mots clés associés à ce site, séparés par une virgule. Remarque: OpenRTB 2.2 permettait un tableau de chaînes comme implémentation alternative, mais ce problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit clairement d'une seule chaîne avec du contenu CSV à nouveau. La compatibilité avec certaines places de marché OpenRTB 2.2 qui ont adopté la représentation alternative peut nécessiter une gestion personnalisée du fichier JSON.
mobile	Non	Bool	BidRequest.Mobile.is_mobile_web_Optimized	2,3 2,4 2,5		Indique si le site a été programmé pour optimiser la mise en page sur les appareils mobiles, où 0 = non, 1 = oui.
ext	Non	Objet SiteExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.site] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous accédez au champ ext dans le message Site.

SiteExt

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
amp	Non	Énumération AmpPage	BidRequest.AdSlot .is_amp_page	Qu'il s'agisse ou non d'une page AMP. Omis si inconnu. DIALECT_HTML = 0. Il ne s'agit pas d'une page AMP. DIALECT_HTML_AMP = 1 ; ceci est une page AMP.
page_visibility	Non	Énumération VisibilityState	BidRequest.page_visibilité	État de visibilité de la page Web contenant l'espace publicitaire. Consultez la page www.w3.org/TR/page-visibilité/. VISIBILITY_STATE_UNKNOWN = 0 VISIBILITY_STATE_VISIBLE = 1 ; la page est au moins partiellement visible. Par exemple, dans l'onglet de premier plan d'une fenêtre non réduite. VISIBILITY_STATE_HIDDEN = 2 ; les utilisateurs ne peuvent pas voir la page. Par exemple, lorsque la page est dans un onglet de navigateur en arrière-plan ou dans une fenêtre réduite.
is_semi_transparent_request	Non	Bool	BidRequest.is_semi_transparent_demande	Indique que la requête utilise un branding semi-transparent, ce qui signifie qu'une version tronquée de l'URL de la requête sera fournie. Cette décision est prise par l'éditeur. Consultez la page support.google.com/admanager/answer/4584891.
inventorypartnerdomain	Non	chaîne	BidRequest.inventorypartnerdomain	Domaine du partenaire (du propriétaire de l'application) propriétaire d'une partie de l'inventaire publicitaire de l'application. Le fichier ads.txt ou app-ads.txt du partenaire sera hébergé ici. Plus de détails sur http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf

Application

Vous devez inclure cet objet si le contenu avec publicité est une application autre qu'un navigateur (généralement sur mobile) et non un site Web. Une demande d'enchère ne doit pas contenir à la fois un objet App et un objet Site. Il est au minimum utile de fournir un ID d'application ou un bundle, mais cela n'est pas obligatoire.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	Non compatible	2,3 2,4 2,5		ID application sur la place de marché. RECOMMANDÉ par la spécification OpenRTB.
name	Non	chaîne	vCPM.Mobile.app_name	2,3 2,4 2,5		Nom de l'application (peut être alias à la demande de l'éditeur)
domain	Non	chaîne	Non compatible	2,3 2,4 2,5		Domaine de l'application utilisé pour le blocage côté annonceur. Exemple : "mygame.foo.com".
cat	Non	Tableau de chaînes	BidRequest.Mobile.app_category_id	2,3 2,4 2,5		Remarque:Les valeurs de ce champ sont maintenant masquées. Tableau des catégories de contenus IAB de l'application. Reportez-vous à l'énumération ContentCategory.
sectioncat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenu IAB qui décrivent la section actuelle de l'application. Reportez-vous à l'énumération ContentCategory.
pagecat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenu IAB qui décrivent la page ou la vue actuelle de l'application. Reportez-vous à l'énumération ContentCategory.
ver	Non	chaîne	Non compatible	2,3 2,4 2,5		Version de l'application.
bundle	Non	chaîne	BidRequest.Mobile.app_id	2,3 2,4 2,5		Un identifiant d'application spécifique à la plate-forme destiné à être propre à l'application et indépendamment de l'échange. Sur Android, il doit s'agir d'un nom de bundle ou de package (par exemple, com.foo.mygame). Sur iOS, il s'agit d'un identifiant numérique.
privacypolicy	Non	Bool	Non compatible	2,3 2,4 2,5		Indique si le site a des règles de confidentialité, où 0 = non, 1 = oui.
paid	Non	Bool	Non compatible	2,3 2,4 2,5		0 = l'application est sans frais, 1 = l'application est une version payante.
publisher	Non	Objet Publisher	BidRequest	2,3 2,4 2,5		Détails sur l'objet Publisher de l'application.
content	Non	Objet Content	BidRequest	2,3 2,4 2,5		Détails sur le Content dans l'application
keywords	Non	chaîne	Non compatible	2,3 2,4 2,5		Liste de mots clés séparés par une virgule concernant cette application. Remarque: OpenRTB 2.2 permettait d'utiliser un tableau de chaînes comme implémentation alternative, mais ce problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit clairement d'une seule chaîne avec du contenu CSV à nouveau. La compatibilité avec certaines places de marché OpenRTB 2.2 qui ont adopté la représentation alternative peut nécessiter une gestion personnalisée du fichier JSON.
storeurl	Non	chaîne	BidRequest.url	2,3 2,4 2,5		URL de la plate-forme de téléchargement d'applications pour une application installée.
ext	Non	Objet AppExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.app] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous accédez via le champ ext dans le message de l'application.

Ext.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
installed_sdk	Non	SDK installé	BidRequest.Mobile.installed_sdk	Identification et informations sur un SDK installé dans l'application de l'éditeur auquel l'enchérisseur a accès, souvent parce qu'il s'agit du SDK de l'enchérisseur.
inventorypartnerdomain	Non	chaîne	BidRequest.inventorypartnerdomain	Domaine du partenaire (du propriétaire de l'application) propriétaire d'une partie de l'inventaire publicitaire de l'application. Le fichier ads.txt ou app-ads.txt du partenaire sera hébergé ici. Plus de détails sur http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf
SDK installé
id	Oui	chaîne	BidRequest.Mobile.InstallSdk.id	Identifiant du SDK installé.
sdk_version	Oui	Version	BidRequest.Mobile.InstallSdk.sdk_version	Version du SDK installé.
adapter_version	Oui	Version	BidRequest.Mobile.InstallSdk.adapter_version	Version de l'adaptateur qui communique avec le SDK installé.
Version
major	Non	int32	Non compatible	Valeur par défaut : -1.
minor	Non	int32	Non compatible	Valeur par défaut : -1.
micro	Non	int32	Non compatible	Valeur par défaut : -1.

Éditeur

Cet objet décrit l'éditeur du média dans lequel l'annonce sera affichée. L'éditeur est généralement le vendeur d'une transaction OpenRTB.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	vCPM.publisher_id	2,3 2,4 2,5		Référence éditeur spécifique à la place de marché, telle que définie par le suffixe du code de l'éditeur dans le code de la propriété Web. Par exemple, pub-123 est le code d'éditeur du code de la propriété Web ca-pub-123.
name	Non	chaîne	Non compatible	2,3 2,4 2,5		Nom de l'éditeur (peut être alias à la demande de l'éditeur)
cat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenu IAB de l'application. Reportez-vous à l'énumération ContentCategory.
domain	Non	chaîne	Non compatible	2,3 2,4 2,5		Domaine de niveau supérieur de l'éditeur (par exemple, "publisher.com")
ext	Non	Objet PublisherExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.publisher] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder au champ ext dans le message de l'éditeur.

PublisherExt

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
country	Non	chaîne	BidRequest .publisher_country	Pays de l'adresse de facturation de l'éditeur. Il peut être différent du pays détecté de l'utilisateur dans geo_criteria_id ou du pays d'hébergement du site Web. Consultez également la liste complète des codes pays.
host_publisher_id	Non	chaîne	vCPM.host_publisher_id	Identifiant de l'éditeur hôte. Si cet indicateur est renseigné, cela signifie que l'éditeur hôte a participé au partage des revenus. L'identifiant peut être utilisé pour autoriser ads.txt.

Contenus

Cet objet décrit le contenu dans lequel l'impression apparaît, qui peut être syndiqué ou non syndiqué. Cet objet peut être utile lorsque le contenu syndiqué contient des impressions et ne correspond pas nécessairement au contenu général de l'éditeur. L'échange peut avoir ou non des connaissances sur la page sur laquelle le contenu est diffusé, en raison de la méthode de syndication. Il peut s'agir, par exemple, d'une impression vidéo intégrée dans un iFrame sur une propriété Web ou un appareil inconnu.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	Non compatible	2,3 2,4 2,5		ID qui identifie le contenu de manière unique.
episode	Non	int32	Non compatible	2,3 2,4 2,5		Numéro de l'épisode du contenu (généralement applicable au contenu vidéo).
title	Non	chaîne	Non compatible	2,3 2,4 2,5		Titre du contenu Exemples de vidéos: "Search Committee" (télévision), "A New Hope" (film) ou "Endgame" (conçu pour le Web). Exemple d'une vidéo non vidéo: "Why an Antarctic Glacier Is Melting So Quick" (Pourquoi un glacier de l'Antarctique fond si vite) (article du Time Magazine).
series	Non	chaîne	Non compatible	2,3 2,4 2,5		Série de contenus. Exemples de vidéos: "The Office" (télévision), "Star Wars" (film) ou "Arby 'N' The Chief" (conçu pour le Web). Exemple non vidéo: "écocentrique" (blog du Time Magazine)
season	Non	chaîne	Non compatible	2,3 2,4 2,5		Saison du contenu (généralement pour le contenu vidéo, par exemple "Saison 3")
artist	Non	chaîne	Non compatible	2,3 2,4 2,5		Artiste crédité dans le contenu
genre	Non	chaîne	Non compatible	2,3 2,4 2,5		Genre décrivant le mieux le contenu (par exemple, rock, pop, etc.)
album	Non	chaîne	Non compatible	2,3 2,4 2,5		Album auquel appartient le contenu, généralement pour l'audio.
isrc	Non	chaîne	Non compatible	2,3 2,4 2,5		Code d'enregistrement standard international conforme à la norme ISO-3901.
url	Non	chaîne	(App.content uniquement) BidRequest.url	2,3 2,4 2,5		URL du contenu, pour la contextualisation ou l'examen côté achat.
cat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenu de l'IAB décrivant le contenu. Reportez-vous à l'énumération ContentCategory.
prodq	Non	Qualité de la production	Non compatible	2,4 2,5		Qualité de la production
keywords	Non		Non compatible	2,3 2,4 2,5		Liste de mots clés décrivant le contenu séparés par une virgule. Remarque: OpenRTB 2.2 permettait un tableau de chaînes en tant qu'implémentation alternative, mais ce problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit clairement d'une seule chaîne avec du contenu CSV à nouveau. La compatibilité avec certaines places de marché OpenRTB 2.2 qui ont adopté la représentation alternative peut nécessiter une gestion personnalisée du fichier JSON.
contentrating	Non	chaîne	BidRequest.detected_content_label 39: "DV_G", 40: "DV_PG", 41: "DV_T", 42: "DV_MA", 43: "DV_UNRATED"	2,3 2,4 2,5		Remarque:Les valeurs de ce champ sont maintenant masquées. Classification du contenu (MPAA, par exemple).
userrating	Non	chaîne	(App.content uniquement) BidRequest.Mobile.app_rating	2,3 2,4 2,5		Note attribuée au contenu par l'utilisateur (par exemple, nombre d'étoiles, mentions "J'aime", etc.)
context	Non	Contexte du contenu	Non compatible	2,3 2,4 2,5		Type de contenu (jeu, vidéo, texte, etc.)
context_22	Non	chaîne	Non compatible	2,3 2,4 2,5		Compatibilité avec OpenRTB <= 2.2 ou version ultérieure ; utiliser le contexte pour 2.3+.
livestream	Non	Bool	BidRequest.Video.is_livestream	2,3 2,4 2,5		0 = non en direct, 1 = contenu en direct (par exemple, diffusion en direct, blog en direct)
sourcerelationship	Non	Bool	Non compatible	2,3 2,4 2,5		0 = indirect, 1 = direct.
producer	Non	chaîne	vCPM.Vidéo	2,3 2,4 2,5		Informations sur le producteur de contenu
len	Non	int32	BidRequest.Video.ContentAttributs.duration_seconds	2,3 2,4 2,5		Durée du contenu en secondes ; appropriée pour les vidéos ou l'audio.
qagmediarating	Non	Qualité de contrôle qualité	Non compatible	2,3 2,4 2,5		Classification des médias conformément aux consignes de contrôle qualité.
embeddable	Non	Bool	Non compatible	2,3 2,4 2,5		Indicateur indiquant si le contenu est intégrable (par exemple, un lecteur vidéo intégrable), où 0 = non, 1 = oui.
language	Non	chaîne	BidRequest.detected_language	2,3 2,4 2,5		Langage de contenu utilisant la norme ISO-639-1-alpha-2.

Producteur

Cet objet définit le producteur du contenu dans lequel l'annonce sera diffusée. Cela est particulièrement utile lorsque le contenu est syndiqué et peut être distribué via différents éditeurs, et que le producteur et l'éditeur ne sont pas nécessairement la même entité.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	Non compatible	2,3 2,4 2,5		ID du producteur ou de l'auteur du contenu Utile si le contenu est syndiqué et peut être publié sur un site à l'aide de tags d'intégration.
name	Non	chaîne	Non compatible	2,3 2,4 2,5		Nom du producteur ou de l'émetteur de contenu (par exemple, "Warner Bros").
cat	Non	Tableau de chaînes	Non compatible	2,3 2,4 2,5		Tableau des catégories de contenus de l'IAB décrivant le producteur de contenu. Reportez-vous à l'énumération ContentCategory.
domain	Non	chaîne	BidRequest.Video.description_url	2,3 2,4 2,5		Domaine de niveau supérieur du producteur de contenu (par exemple, "producteur.com").

Type d'appareil

Cet objet fournit des informations sur l'appareil via lequel l'utilisateur interagit. Les informations sur l'appareil incluent le matériel, la plate-forme, la localisation et les données de l'opérateur. Il peut s'agir d'un téléphone mobile, d'un ordinateur de bureau, d'un boîtier décodeur ou d'un autre appareil numérique.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
dnt	Non	Bool	Non compatible. Consultez le guide des cookies google_error=1:	2,3 2,4 2,5		Option "Interdire le suivi" standard définie dans l'en-tête du navigateur, où 0 = le suivi est illimité, 1 = n'effectue pas le suivi. RECOMMANDÉ par la spécification OpenRTB.
ua	Non	chaîne	BidRequest.user_agent	2,3 2,4 2,5		Chaîne user-agent du navigateur. RECOMMANDÉ par la spécification OpenRTB.
ip	Non	chaîne	BidRequest.ip (tronc AdX est tronqué aux trois premiers octets ; OpenRTB correspond à "X.X.X.0")	2,3 2,4 2,5		Adresse IPv4 la plus proche de l'appareil. RECOMMANDÉ par la spécification OpenRTB
geo	Non	Objet Geo	BidRequest	2,3 2,4 2,5		Position de l'appareil considérée comme la position actuelle de l'utilisateur définie par un objet Geo. RECOMMANDÉ par la spécification OpenRTB.
didsha1	Non	chaîne	Non compatible	2,3 2,4 2,5		ID du matériel (code IMEI, par exemple) haché via SHA1.
didmd5	Non	chaîne	Non compatible	2,3 2,4 2,5		ID de l'appareil matériel (par exemple, code IMEI) haché par MD5.
dpidsha1	Non	chaîne	Non compatible	2,3 2,4 2,5		ID de l'appareil de la plate-forme (par exemple, ID Android) ; haché via SHA1
dpidmd5	Non	chaîne	BidRequest.Mobile.hashed_idfa - AdX est binaire, OpenRTB est base16 (minuscule au format hexadécimal). Il s'agit de la version hachée de ifa. Dpidmd5 ou ifa est disponible selon la version du SDK pour mobile.	2,3 2,4 2,5		ID d'appareil de la plate-forme (par exemple, ID Android) haché par MD5.
ipv6	Non	chaîne	BidRequest.ip - AdX est tronqué aux six premiers octets. OpenRTB correspond à "X:X:X:::::".	2,3 2,4 2,5		Adresse IPv6 la plus proche de l'appareil.
carrier	Non	chaîne	BidRequest.Device.carrier_id Les ID des critères seront les mêmes que ceux du protocole Authorized Buyers. Consultez la liste des opérateurs mobiles.	2,3 2,4 2,5		Opérateur ou FAI (par exemple, "VERIZON") utilisant des noms de chaîne sélectionnés pour la place de marché, qui doivent être publiés au préalable sur les enchérisseurs.
language	Non	chaîne	Non compatible	2,3 2,4 2,5		Langue du navigateur utilisant la norme ISO-639-1-alpha-2.
make	Non	chaîne	BidRequest.Device.brand	2,3 2,4 2,5		Marque de l'appareil (par exemple, "Apple").
model	Non	chaîne	BidRequest.Device.model	2,3 2,4 2,5		Modèle de l'appareil (par exemple, "iPhone")
os	Non	chaîne	BidRequest.Device.platform	2,3 2,4 2,5		Système d'exploitation de l'appareil (par exemple, "iOS")
osv	Non	chaîne	BidRequest.Device.os_version	2,3 2,4 2,5		Version du système d'exploitation de l'appareil
hwv	Non	chaîne	BidRequest.Device.hardware_version	2,3 2,4 2,5		Version du matériel de l'appareil (par exemple, "5S" pour iPhone 5S)
w	Non	int32	BidRequest.Device.screen_width	2,3 2,4 2,5		Largeur physique de l'écran en pixels.
h	Non	int32	BidRequest.Device.screen_height	2,3 2,4 2,5		Hauteur physique de l'écran en pixels.
ppi	Non	int32	Non compatible	2,3 2,4 2,5		Taille de l'écran en pixels par pouce linéaire.
pxratio	Non	double	BidRequest.Device.screen_pixel_ratio_millis / 1 000	2,3 2,4 2,5		Ratio entre les pixels physiques et les pixels indépendants des appareils.
js	Non	Bool	Non compatible	2,3 2,4 2,5		Compatibilité avec JavaScript, où 0 = non, 1 = oui
geofetch	Non	Bool	Non compatible	2,4 2,5		Indique si l'API de géolocalisation est disponible pour le code JavaScript exécuté dans la bannière, où 0 = non, 1 = oui.
connectiontype	Non	Type de connexion	Non compatible	2,3 2,4 2,5		Type de connexion réseau
devicetype	Non	DeviceType	BidRequest.Device.device_type	2,3 2,4 2,5		Type d'appareil général.
flashver	Non	chaîne	Non compatible	2,3 2,4 2,5		Version de Flash prise en charge par le navigateur.
ifa	Non	chaîne	BidRequest.Mobile.advertising_id - AdX est binaire, OpenRTB correspond à 36 caractères UUID (ID Android: tout en minuscules, IDFA: tout en majuscules). ifa est l'ID Android ou l'IDFA d'Apple, et dpidmd5 ou ifa est disponible selon la version du SDK pour mobile.	2,3 2,4 2,5		Pièce d'identité sanctionnée pour une utilisation par un annonceur en clair (par exemple, non hachée).
macsha1	Non	chaîne	Non compatible	2,3 2,4 2,5		Adresse MAC de l'appareil. hachée via SHA1.
macmd5	Non	chaîne	Non compatible	2,3 2,4 2,5		Adresse MAC de l'appareil, hachée via MD5
lmt	Non	Bool	BidRequest.Device.limit_ad_tracking	2,3 2,4 2,5		"Limiter le suivi des annonces" est un signal commercial approuvé en fonction des paramètres du système d'exploitation ou de l'appareil, où false indique que le suivi est illimité et true qu'il doit être limité conformément aux consignes commerciales. Ce signal reflète les décisions des utilisateurs sur certaines plates-formes, y compris iOS Tracking App Transparency. Consultez également les conseils sur le ML et le suivi d'applis, ainsi que l'identifiant publicitaire Android.
mccmnc	Non	chaîne	Non compatible	4		Opérateur mobile comme code MCC-MNC concaténé (par exemple, "310-005" identifie Verizon Wireless CDMA aux États-Unis). Consultez la page https://fr.wikipedia.org/wiki/Mobile_country_code pour obtenir d'autres exemples. Notez que le tiret entre les parties MCC et MNC est nécessaire pour supprimer l'ambiguïté d'analyse.
ext	Non	Objet DeviceExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.device] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder au champ ext dans le message de l'appareil.

Ext.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
session_id	Non	chaîne	BidRequest.session_id	Représente une session utilisateur de courte durée sur des appareils pour la TV connectée/service de distribution par contournement (OTT, over-the-top) avec une durée maximale de session de six heures. L'utilisation de session_id n'est jamais autorisée pour la personnalisation des annonces. session_id ne peut être utilisé que pour la limitation de la fréquence d'exposition, les exclusions réciproques ou à des fins similaires. Ce champ est renseigné avec un alphabet base64 adapté au Web.
atts	Non	int32	BidRequest.Device.app_tracking_authorization_status	(iOS uniquement) Entier transmis pour représenter l'état d'autorisation du suivi de l'application, où 0 = non déterminé 1 = limité 2 = refusé 3 = autorisé. Cette valeur est extraite d'ATTrackingManager et fournie telle quelle. Pour en savoir plus sur l'état d'autorisation du suivi d'application iOS, consultez cet article.
user_agent_data	Non	Objet UserAgent	BidRequest.user_agent_data	Informations sur l'user-agent.

UserAgent

Informations sur l'user-agent. Ce champ contient les informations relatives au user-agent extraites de l'en-tête user-agent ou des en-têtes Sec-CH-UA.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
browser	Non	Objet BrandVersion	BidRequest.user_agent_data.browser	Identifie le navigateur.
platform	Non	Objet BrandVersion	BidRequest.user_agent_data.platform	Identifie la plate-forme.
mobile	Non	Bool	BidRequest.user_agent_data.mobile	Critère : l'agent préfère le contenu optimisé pour les mobiles. Consultez le champ "BidRequest.device" pour obtenir des informations spécifiques sur ce périphérique, qui peuvent être cohérentes avec ce champ (par exemple, "Navigateur d'ordinateur" peut demander "Site pour ordinateur").
architecture	Non	chaîne	BidRequest.user_agent_data.architecture	Architecture de l'appareil, par exemple "x86" ou "arm".
bitness	Non	chaîne	BidRequest.user_agent_data.bitness	Nombre de bits de l'appareil, par exemple "64" pour l'architecture 64 bits.
model	Non	chaîne	BidRequest.user_agent_data.model	Modèle de l'appareil.

Objet BrandVersion

Un tuple (brand, version) du navigateur ou de la plate-forme

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
brand	Non	chaîne	BidRequest.user_agent_data.brand	Identifiant de marque, par exemple "Chrome" ou "Windows".
version	Non	chaîne	BidRequest.user_agent_data.version	Version, divisez en composants si nécessaire, par exemple, {"85", "1"} = v85.1.

Données géographiques

Cet objet encapsule différentes méthodes permettant de spécifier un emplacement géographique. Lorsqu'il est subordonné à un objet Device, il indique la position de l'appareil, ce qui peut également être interprété comme la position actuelle de l'utilisateur. Lorsqu'il est subordonné à un objet User, il indique la position de la base de l'utilisateur de l'utilisateur (par exemple, sa position actuelle). Les attributs lat/lon ne doivent être transmis que s'ils sont conformes à la précision indiquée dans l'attribut type. Par exemple, le centroïde d'une zone géographique telle que le code postal ne doit pas être transmis.

Dans la mise en œuvre OpenRTB de Google, des informations approximatives sur la géolocalisation sont approximatives en fonction de l'adresse IP de l'appareil d'où provient la demande d'annonce. Ces informations sont généralement incluses (mais pas toujours) dans la demande d'enchère, avec lat/lon représentant le point central d'un cercle, où accuracy correspond à son rayon. Pour en savoir plus sur la géolocalisation, consultez le guide de ciblage géographique.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
lat	Non	double	BidRequest.[encryption_]hyperlocal_set. center_point.latitude	2,3 2,4 2,5		Latitude de -90,0 à +90,0, où le négatif est au sud.
lon	Non	double	BidRequest.[encryption_]hyperlocal_set.center_point.longitude	2,3 2,4 2,5		Longitude de -180,0 à +180,0, où le négatif est ouest.
country	Non	chaîne	BidRequest.geo_criteria_id via geo-table.csv	2,3 2,4 2,5		Pays utilisant la norme ISO-3166-1 Alpha-3.
region	Non	chaîne	BidRequest.geo_criteria_id via geo-table.csv	2,3 2,4 2,5		Code de région ISO-3166-2. Code d'état à deux lettres si États-Unis.
regionfips104	Non	chaîne		2,3 2,4 2,5		Région d'un pays avec la notation FIPS 10-4. Bien qu'OpenRTB accepte cet attribut, il a été retiré par le NIST en 2008.
metro	Non	chaîne	BidRequest.geo_criteria_id via geo-table.csv, city-dma-regions.csv	2,3 2,4 2,5		Code d'agglomération Google ; similaire aux DMA de Nielsen, mais pas exactement. Consultez la page Ciblage géographique pour obtenir un lien vers les codes.
city	Non	chaîne	BidRequest.geo_criteria_id via geo-table.csv	2,3 2,4 2,5		Ville utilisant le code des Nations Unies pour le commerce et les transports au format "city": "San Antonio".Reportez-vous à l'annexe A pour obtenir un lien vers les codes.
zip	Non	chaîne	BidRequest.postal_code BidRequest.postal_code_prefix	2,3 2,4 2,5		Code postal.
type	Non	LocationType		2,3 2,4 2,5		Source des données de localisation ; recommandé lors de la transmission de la latitude/longitude.
accuracy	Non	int32	Non compatible	2,4 2,5		Précision de la position estimée en mètres ; recommandée lorsque les coordonnées de latitude/longitude sont spécifiées et dérivées des services de localisation d'un appareil (par exemple, type = 1). Notez qu'il s'agit du niveau de précision indiqué par l'appareil. Pour une interprétation exacte, consultez la documentation spécifique à l'OS (par exemple, Android, iOS). Google: rayon en mètres d'un cercle indiquant approximativement l'emplacement d'un appareil, où le point central est défini par la latitude et la longitude. Ce champ est renseigné en fonction de la géolocalisation approximative basée sur l'adresse IP.
lastfix	Non	int32	Non compatible	2,4 2,5		Nombre de secondes écoulées depuis l'établissement de ce correctif de géolocalisation. Notez que les appareils peuvent mettre en cache les données de localisation pour plusieurs récupérations. Idéalement, cette valeur doit correspondre au moment où la correction réelle a été effectuée.
ipservice	Non	Service de localisation	Non compatible	2,4 2,5		Service ou fournisseur utilisé pour déterminer la géolocalisation à partir de l'adresse IP, le cas échéant (par exemple, type = 2).
utcoffset	Non	int32	BidRequest.yourdomain_offset	2,3 2,4 2,5		Heure locale, sous forme de nombre +/- de minutes à partir de UTC.

Utilisateur

Cet objet contient des informations connues ou dérivées de l'utilisateur de l'appareil (par exemple, l'audience pour la publicité). L'ID utilisateur est un artefact de place de marché. Il peut être soumis à une rotation ou à d'autres règles de confidentialité. Cependant, cet ID utilisateur doit être stable suffisamment longtemps pour permettre une limitation raisonnable de la limitation de la fréquence d'exposition et du reciblage.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	BidRequest.[constrained_usage_]google_user_id	2,3 2,4 2,5		ID spécifique à l'utilisateur pour Exchange. Au moins l'un des éléments id ou buyerid est recommandé
buyeruid	Non	chaîne	BidRequest.[constrained_usage_]hosted_match_data - AdX est binaire, OpenRTB sur base64 sans Web	2,3 2,4 2,5		ID spécifique à l'acheteur pour l'utilisateur, tel qu'il est mappé par la place de marché pour l'acheteur. Nous vous recommandons d'utiliser au moins buyerid ou id.
gender	Non	chaîne	Non compatible	2,3 2,4 2,5		Sexe : "M" homme, "F" femme, "O" Autre. (Null indique une valeur inconnue)
keywords	Non	chaîne	Non compatible	2,3 2,4 2,5		Liste de mots clés, de centres d'intérêt ou d'intentions séparés par une virgule. Remarque: OpenRTB 2.2 permettait un tableau de chaînes comme implémentation alternative, mais ce problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit clairement d'une seule chaîne avec du contenu CSV à nouveau. La compatibilité avec certaines places de marché OpenRTB 2.2 qui ont adopté la représentation alternative peut nécessiter une gestion personnalisée du fichier JSON.
customdata	Non	chaîne	BidRequest.[constrained_usage_]hosted_match_data - AdX est binaire, OpenRTB sur base64 sans Web	2,3 2,4 2,5		Fonctionnalité facultative permettant de transmettre l'ensemble de données de l'enchérisseur dans le cookie de la place de marché. La chaîne doit comporter des caractères sécurisés en base85 et être respectant le format de votre choix. Un encodage JSON approprié doit être utilisé pour inclure des guillemets "échappement".
geo	Non	Objet Geo	Non compatible	2,3 2,4 2,5		Emplacement de la base de base de l'utilisateur définie par un objet Geo. Elle ne correspond pas nécessairement à sa position actuelle.
data	Non	Tableau d'objets Data	BidRequest.detected_vertical	2,3 2,4 2,5		Remarque:Les valeurs de ce champ sont maintenant masquées. Données contextuelles supplémentaires. Chaque objet Data représente une source de données différente. segment.id fait référence au secteur de la page détecté par la place de marché. segment.value correspond à la pondération de ce secteur détecté. Un poids plus élevé suggère que la page est plus pertinente pour le secteur détecté.
ext	Non	Objet UserExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.user] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous accédez via le champ ext dans le message de l'utilisateur.

Extrémité utilisateur

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
consented_providers_settings	Non	Objet ConsentedProvidersSettings	BidRequest.AdSlot.consented_providers_settings	Informations sur les fournisseurs de technologie publicitaire pour lesquels l'éditeur a indiqué à Google que son utilisateur de l'EEE a autorisé l'utilisation de ses données à caractère personnel pour personnaliser les annonces, conformément aux règles relatives au consentement de l'utilisateur dans l'UE de Google. Ce champ n'est renseigné que si RegsExt.gdpr est défini sur "true".
consent	Non	chaîne	BidRequest.AdSlot.ConsentedProvidersSettings.tcf_consent_string	Chaîne de consentement au format TCF (Transparency and Consent Framework) codée en base64 d'IAB récupérée sur la plate-forme de gestion du consentement (PGC) de l'éditeur. La structure de la chaîne est définie par la version 2 du TCF de l'IAB. Ce champ sera renseigné si l'éditeur a intégré une PGC pour le TCF v2, et que cette PGC indique que le RGPD s'applique à cette demande d'annonce et fournit une chaîne de consentement valide. Pour en savoir plus sur l'intégration du TCF de Google v2, consultez cet article. Consultez la liste globale des fournisseurs de l'IAB sur vendor-list.consensu.org/v2/vendor-list.json pour en savoir plus sur les fournisseurs répertoriés dans la chaîne de consentement.
eids	Non	Tableau d'objets ExtendedId	BidRequest.AdSlot.secure_signals	Extension standard utilisée pour transmettre les signaux sécurisés choisis par l'éditeur.

Paramètres du fournisseur de consentement

Informations sur les fournisseurs de technologie publicitaire pour lesquels l'éditeur a indiqué à Google que son utilisateur de l'EEE a autorisé l'utilisation de ses données à caractère personnel pour personnaliser les annonces, conformément aux règles relatives au consentement de l'utilisateur dans l'UE. Ce champ n'est renseigné que lorsque "RegsExt.gdpr" est défini sur "true".

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
consented_providers	Non	Tableau de Int64	BidRequest.AdSlot.consented_providers	Ensemble d'ID correspondant aux fournisseurs de technologie publicitaire pour lesquels l'éditeur a indiqué à Google que ses utilisateurs de l'EEE ont donné leur consentement légalement valable pour: 1) l'utilisation de cookies ou d'autres systèmes de stockage locaux lorsque la législation l'impose ; et 2) la collecte, le partage et l'utilisation de données à caractère personnel pour la personnalisation des annonces par un fournisseur de technologie publicitaire conformément aux Règles relatives au consentement de l'utilisateur dans l'UE de Google. Si un éditeur utilise le Transparency and Consent Framework (TCF) v2 de l'IAB pour gérer le consentement des utilisateurs, il s'agit de l'ensemble des fournisseurs de technologie publicitaire autorisés via la chaîne de consentement supplémentaire (consultez cet article pour en savoir plus sur le mode Consentement supplémentaire de Google). Les fournisseurs de technologie publicitaire autorisés via la chaîne de consentement du TCF v2 sont représentés dans le champ UserExt.consent. Un mappage de l'ID ATP et du nom ATP est publié sur provider.csv.

ExtendedId

Signaux sécurisés transmis par l'éditeur.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
source	Non	chaîne	BidRequest.AdSlot.SecureSignal.source	Source (fournisseur) du signal.
uids	Non	Tableau avec un objet ExtendedIdUid	Aucune	Signal sécurisé.

ExtendedIdUid

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
id	Non	chaîne	BidRequest.AdSlot.SecureSignal.data	Signal sécurisé.

Données

Les objets data et segment ensemble permettent de spécifier des données contextuelles supplémentaires. Ces données peuvent provenir de plusieurs sources, de la place de marché elle-même ou de fournisseurs tiers, comme indiqué dans le champ id. Une demande d'enchère peut combiner des objets de données de plusieurs fournisseurs. Les fournisseurs de données spécifiques utilisés doivent être publiés par la place de marché a priori auprès de ses enchérisseurs.

Cela permet d'envoyer les secteurs détectés à l'acheteur. Pour Open Bidding, elle est également utilisée pour envoyer des paires clé/valeur de l'éditeur à l'acheteur.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	Compatible	2,3 2,4 2,5		ID spécifique à la place de marché pour le fournisseur de données.
name	Non	chaîne	Compatible	2,3 2,4 2,5		Nom spécifique au fournisseur de données pour Exchange.
segment		Tableau d'objets Segment	Compatible	2,3 2,4 2,5		Tableau d'objets Segment contenant les valeurs réelles des données.

Segment

Les objets data et segment ensemble permettent de spécifier des données contextuelles supplémentaires. Ces données peuvent provenir de plusieurs sources, de la place de marché elle-même ou de fournisseurs tiers, comme indiqué dans le champ id. Une demande d'enchère peut combiner des objets Data provenant de plusieurs fournisseurs. Les fournisseurs de données spécifiques utilisés doivent être publiés par la place de marché a priori pour leurs enchérisseurs.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Non	chaîne	Compatible	2,3 2,4 2,5		ID du segment de données spécifique au fournisseur de données.
name	Non	chaîne	Compatible	2,3 2,4 2,5		Nom du segment de données propre au fournisseur de données.
value		chaîne	Compatible	2,3 2,4 2,5		Représentation, sous forme de chaîne, de la valeur du segment de données.

Rég.

Cet objet contient toutes les réglementations, réglementations ou secteurs qui s'appliquent à la requête. L'option coppa indique si la requête est ou non soumise à la réglementation de la Federal Trade Commission (Federal Trade Commission) des États-Unis pour la loi COPPA (Children's Online Privacy Protection Act) des États-Unis. Pour en savoir plus, consultez la section 7.1.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
coppa	Non	chaîne	BidRequest.user_data_treatment / TAG_FOR_CHILD_DIRECTED_TREATMENT	2,3 2,4 2,5		Option indiquant si cette demande est soumise à la réglementation COPPA établie par la FTC (États-Unis), où 0 = non, 1 = oui
ext	Non	Objet RegsExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.regs] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder au champ ext dans le message Regs.

RegsExt

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
gdpr	Non	Bool	BidRequest.AdSlot.regs_gdpr	Ce champ est défini sur "true" dans les deux cas suivants : Google reçoit une chaîne de consentement v2 (Transparency and Consent Framework) de l'IAB. La plate-forme de gestion du consentement indique que le RGPD s'applique à cette demande d'annonce. Google ne reçoit pas de chaîne de consentement de la version 2 du TCF de l'IAB. Selon les informations disponibles, cette impression sera diffusée auprès d'un utilisateur de l'EEE. Il ne s'agit pas d'informations juridiques sur le RGPD.
lgpd	Non	Bool	BidRequest.AdSlot.regs_lgpd	Ce champ est défini sur "true" si, d'après les informations disponibles chez Google, cette impression est diffusée auprès d'un utilisateur brésilien. Consultez la page https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv pour obtenir la liste des fournisseurs de technologie publicitaire autorisés à diffuser des annonces en réponse aux demandes conformes à la loi LGPD. Pour en savoir plus sur la loi LGPD, consultez cet article.

Variables et définitions des réponses aux enchères

Cette section décrit les variables et les définitions des réponses aux enchères.

vCPM

Cet objet est l'objet de réponse à l'enchère de premier niveau (par exemple, l'objet JSON externe sans nom). L'attribut id reflète l'ID de la demande d'enchère à des fins de journalisation. De même, bidid est un ID de suivi des réponses facultatif pour les enchérisseurs. Si cette option est spécifiée, elle peut être incluse dans l'appel d'avis suivant si l'enchérisseur remporte l'appel. Vous devez spécifier au moins un objet seatbid, qui contient au moins une enchère pour une impression. Les autres attributs sont facultatifs. Pour exprimer une enchère sans enchère, renvoyez une réponse vide avec HTTP 204. Sinon, si l'enchérisseur souhaite indiquer à la place de marché un motif de non-enchère, seul un objet BidResponse est renvoyé avec un code de motif dans l'attribut nbr.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Oui	chaîne	Aucune correspondance avec un champ, mais validé par rapport à BidRequest.id.	2,3 2,4 2,5		ID de la demande d'enchère à laquelle il s'agit d'une réponse. OBLIGATOIRE conformément à la spécification OpenRTB.
seatbid	Non	Tableau d'objets Seatbid	BidResponse.Ad	2,3 2,4 2,5		Tableau d'objets Seatbid ; un minimum est requis si une enchère doit être définie.
bidid	Non	chaîne	Réponse à la demande	2,3 2,4 2,5		ID de réponse généré par l'enchérisseur pour faciliter la journalisation et le suivi.
cur	Non	chaîne	BidResponse.Ad.AdSlot.currency	2,3 2,4 2,5		La devise de l'enchère correspond aux codes alpha ISO-4217. Si ce champ est renseigné, la devise spécifiée sera utilisée pour interpréter l'enchère. Sinon, la devise d'enchères par défaut sera utilisée, ce qui est déterminé par la priorité suivante: Devise au niveau de l'enchérisseur, si elle est configurée dans les paramètres de compte RTB. Devise au niveau de l'acheteur. L'acheteur est déterminé par l'ID de facturation spécifié dans le champ de l'extension BidResponse.seatbid.bid.ext.billing_id s'il est renseigné. Sinon, il est basé sur le seul ID de facturation envoyé dans la demande d'enchère. La devise d'un compte acheteur est définie lors de la création du compte et peut être vérifiée en contactant un responsable de compte technique.
customdata	Non	chaîne	Non compatible	2,3 2,4 2,5		Fonctionnalité facultative permettant à un enchérisseur de définir des données dans le cookie de la place de marché. La chaîne doit être composée de caractères de sécurité basés sur les cookies (base85) et respecter le format de votre choix. L'encodage JSON approprié doit être utilisé pour inclure des guillemets "échappement".
nbr	Non	NoBidReason	Non compatible	2,3 2,4 2,5		Motif de l'absence d'enchères.
ext	Non	Objet BidResponseExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.bid_response] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder avec le champ ext dans le message JWT.

Réponse

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
processing_time_ms	Non	int32	vCPM.processing_time_ms	Définissez ce paramètre sur le temps de traitement en millisecondes entre le moment où vous avez reçu la requête et le moment où vous avez renvoyé la réponse.

Enchère basée sur la licence

Une réponse à l'enchère peut contenir plusieurs objets SeatBid, chacun étant associé à un compte d'enchérisseur différent, et chacun contenant une ou plusieurs enchères individuelles. Si plusieurs impressions sont présentées dans la requête, l'attribut de groupe peut être utilisé pour indiquer si un siège est prêt à accepter toutes les impressions qu'il peut remporter (par défaut) ou s'il ne souhaite gagner que s'il peut toutes les remporter en tant que groupe.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
bid	Non	Tableau d'objets Bid	vCPM	2,3 2,4 2,5		Tableau d'au moins un objet Bid lié à une impression. Plusieurs enchères peuvent être liées à la même impression.
seat	Non	chaîne	vCPM.Ad. AdSlot.buyer_reporting_id	2,3 2,4 2,5		ID du siège de l'acheteur (par exemple, annonceur, agence) au nom duquel cette enchère est effectuée.
group	Non	Bool	Non compatible	2,3 2,4 2,5		0 = les impressions peuvent être remportées individuellement. 1 = les impressions doivent être remportées ou perdues en tant que groupe. Valeur par défaut = false

Enchère

Un objet SeatBid contient un ou plusieurs objets Bid, chacun étant associé à une impression spécifique dans la demande d'enchère via l'attribut impid. Il constitue une offre d'achat de cette impression pour un prix donné.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Compatible		Détails de mise en œuvre
				dans la version	par Google
id	Oui	chaîne	Aucune correspondance avec un champ, mais validé par rapport à BidRequest.id.	2,3 2,4 2,5		ID de la demande d'enchère à laquelle il s'agit d'une réponse. OBLIGATOIRE conformément à la spécification OpenRTB.
impid	Oui	chaîne	vCPM.Ad.AdSlot	2,3 2,4 2,5		ID de l'objet Imp dans la demande d'enchère associée. OBLIGATOIRE conformément à la spécification OpenRTB.
price	Oui	double	vCPM.Ad.AdSlot.max_cpm_micros * 1 000 000	2,3 2,4 2,5		Prix de l'enchère exprimé en CPM, bien que la transaction réelle ne concerne qu'une impression d'unité. Notez que même si le type indique "float", les nombres mathématiques sont vivement recommandés pour le traitement des devises (par exemple, BigDecimal en Java). OBLIGATOIRE dans la spécification OpenRTB.
adid	Non	chaîne	Non compatible	2,3 2,4 2,5		ID d'une annonce préchargée à diffuser si l'enchère l'emporte.
nurl	Non	chaîne	Non compatible	2,3 2,4 2,5		Gagnez une URL d'avis appelée par la place de marché si l'enchère l'emporte ; moyen facultatif de diffuser le balisage de l'annonce. DoubleClick n'accepte pas les avis de victoire. Utilisez %%WINNING_PRICE%% dans l'URL d'impression de l'extrait ou ${AUCTION_PRICE}.
adm	Non	chaîne	ffffff.Ad.html_snippet, ffffff.Ad.video_url, ffffff.Ad.video_vast_xml ou ffffff.Ad.native_ad	2,3 2,4 2,5		Moyen facultatif de transmettre le balisage de l'annonce au cas où l'enchère l'emporte ; remplace l'avis de victoire si le balisage est inclus dans les deux. Pour les enchères d'annonces natives, vous devez utiliser exactement l'une des valeurs {adm, adm_native}. Il s'agit du champ compatible avec OpenRTB pour la sérialisation JSON.
adm_native	Non	Réponse native	vCPM.Ad.native_ad	2,3 2,4 2,5		Réponse d'annonce native. Pour les enchères d'annonces natives, vous devez utiliser exactement l'un des champs {adm, adm_native}. Il s'agit du champ utilisé pour la sérialisation des tampons de protocole.
adomain	Non	Tableau de chaînes	vCPM.Ad.click_through_url	2,3 2,4 2,5		Domaine de l'annonceur pour la vérification des listes de blocage (par exemple, "domainead.com"). Dans le cas de créations en rotation, il peut s'agir d'un tableau. Les échanges peuvent exiger qu'un seul domaine soit autorisé. La spécification OpenRTB n'autorise que les noms de domaine dans adomain. Authorized Buyers est également compatible avec les URL complètes. Notez qu'il doit s'agir d'un domaine ou d'une URL à explorer. Pour les annonces natives, nous vous recommandons d'utiliser BidResponse.seatbid[].bid[].adm_native.link.url plutôt que adomain.
bundle	Non	chaîne	vCPM.Ad.advertised_app_id	2,3 2,4 2,5		L'ID de l'application sur une plate-forme de téléchargement d'applications, comme l'App Store d'Apple ou Google Play Pour en savoir plus sur les chaînes attendues pour les plates-formes de téléchargement d'applications pour TV connectées, consultez les consignes d'identification des applications attribuées par une plate-forme de distribution par contournement (OTT, over-the-top) et la TV connectée. Pour les applications mobiles sur le Google Play Store, il doit s'agir de noms de packages ou de packages, par exemple com.foo.mygame. Pour les applications sur l'App Store d'Apple, il doit s'agir d'un ID numérique. Google: en plus de ce champ, définissez le champ "bid.ext.app_promotion_type" afin de bénéficier des fonctionnalités propres aux types de promotion d'application.
iurl	Non	chaîne	Non compatible	2,3 2,4 2,5		URL sans cache busting vers une image représentative du contenu de la campagne utilisée pour le contrôle de la qualité/sécurité.
cid	Non	chaîne	vCPM.Ad.AdSlot.billing_id	2,3 2,4 2,5		ID de la campagne permettant de contrôler la qualité des annonces. Ensemble de créations pour lesquelles iurl doit être représentatif. Correspond au n° compte facturation dans le préciblage. S'il n'est pas défini sur l'un des billing_id de l'acheteur, la réponse à l'enchère est considérée comme non valide. Lorsque vous envoyez des créations, un cid est requis dans la réponse si plusieurs billing_id sont spécifiés dans la requête ou si l'enchérisseur possède des sous-comptes actifs.
crid	Non	chaîne	vCPM.Ad.buyer_creative_id	2,3 2,4 2,5		ID de la création permettant de contrôler la qualité des annonces.
cat	Non	Tableau de chaînes	Catégorie d'annonces	2,3 2,4 2,5		Catégories de contenu IAB de la création.
attr	Non	Tableau d'objets CreativeAttribute	vCPM.Ad.attribute	2,3 2,4 2,5		Ensemble d'attributs décrivant la création. Peut être déclaré dans OpenRTB avec bid.attr (OpenRTB) ou bid.ext.attribute (AdX).
api	Non	APIFramework	Bid.api permet de déclarer les attributs 1, 2, 3 et 5 qui correspondent aux versions VPAID et MRAID.	2,3 2,4 2,5		API requise par le balisage, le cas échéant.
protocol	Non	Protocole	Non compatible	2,3 2,4 2,5		Protocole de réponse vidéo du balisage, le cas échéant.
qagmediarating	Non	Qualité de contrôle qualité	Non compatible	2,3 2,4 2,5		Classification des médias des créations conformément aux consignes de contrôle qualité.
dealid	Non	chaîne	ffffff.Ad.AdSlot.deal_id (ou ffffff.Ad.AdSlot.exchange_deal_id si enchérisseur est une place de marché tierce)	2,3 2,4 2,5		Référence au deal.id de la demande d'enchère si celle-ci concerne un accord direct sur une place de marché privée.
w	Non	int32	ffffff.Ad.width : obligatoire uniquement si l'impression est multitaille.	2,3 2,4 2,5		Largeur de la création en pixels indépendants de l'appareil (DIPS).
h	Non	int32	ffffff.Ad.height : obligatoire uniquement si l'impression est multitaille.	2,3 2,4 2,5		Hauteur de la création en pixels indépendants de l'appareil (DIPS).
exp	Non	int32	Non compatible	2,4 2,5		Il s'agit du nombre de secondes pendant lesquelles l'enchérisseur est prêt à attendre entre l'enchère et l'impression réelle.
burl	Non	chaîne	impression_tracking_url	4		URL d'avis de facturation appelée par la place de marché lorsqu'une enchère gagnante devient facturable en fonction des règles commerciales propres à la place de marché (par exemple, généralement diffusées, vues, etc.). Vous pouvez utiliser des macros de substitution. Notez que BidExt.impression_tracking_url accepte une liste répétée d'URL d'avis de facturation. Si votre cas d'utilisation nécessite plusieurs URL de facturation, utilisez cette extension au lieu de burl.
lurl	Non	chaîne	Non compatible	4		URL d'avis de perte appelée par la place de marché lorsqu'il est certain qu'une enchère a été perdue. Vous pouvez utiliser des macros de substitution. Le règlement propre à la place de marché peut exclure la prise en charge des avis de perte ou de la divulgation du prix des opérations d'effacement gagnantes, entraînant la suppression de macros ${AUCTION_PRICE} (par exemple, à la place d'une chaîne de longueur nulle).
tactic	Non	chaîne	Non compatible	4		ID tactile L'utilisation et la signification spécifiques de l'ID de tactique doivent être communiquées entre l'acheteur et les places de marché.
language	Non	chaîne	Non compatible	4		Langue de la création au format ISO-639-1-alpha-2. Le code non standard "xx" peut également être utilisé si la création n'a pas de contenu linguistique (une bannière ne comportant qu'un logo d'entreprise, par exemple).
wratio	Non	int32	Non compatible	4		Largeur relative de la création lors de l'expression de la taille sous forme de ratio. Obligatoire pour les annonces Flex.
hratio	Non	int32	Non compatible	4		Hauteur relative de la création lors de l'expression de la taille sous forme de ratio. Obligatoire pour les annonces Flex.
ext	Non	Objet BidExt	Non compatible	2,3 2,4 2,5		Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.bid] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous pouvez accéder au champ ext dans le message de l'enchère.

Extrémité

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
impression_tracking_url	Non	Tableau de chaînes	vCPM.Ad.impression_tracking_url	URL à appeler lors de l'affichage de l'impression. Cette compatibilité est disponible pour tous les types et formats d'inventaires. Dans OpenRTB 2.5, Bid.burl est le champ standard analogue.
ad_choices_destination_url	Non	chaîne	vCPM.Annonce.URL_destination_annonce_	Ajoutez un lien vers des préférences pour les annonces ou la page de désactivation. Le cas échéant, une icône standard "Choisir sa pub" est ajoutée à la création native et associée à cette URL. Cette option est compatible avec les annonces natives, mais ne fait pas partie du message natif dans la réponse à l'enchère.
click_tracking_url	Non	chaîne	vCPM.Ad.url_tracking_	URL à appeler lorsque l'utilisateur clique sur l'annonce. Actuellement disponible uniquement pour les annonces natives et les accords de programmatique garanti avec des créations gérées par l'éditeur. Dans le cas des éditeurs, ces outils de suivi des clics sont envoyés au serveur d'enchères. Dans tous les autres cas, elles seront envoyées depuis l'appareil de l'utilisateur. Pour en savoir plus sur les créations gérées par l'éditeur, consultez Créations gérées par l'éditeur.
bidder_name	Non	chaîne	vCPM.Ad.bidder_name	Pour les enchérisseurs Authorized Buyers (places de marché tierces qui effectuent des enchères en temps réel sur Ad Manager), nom de l'enchérisseur appelé par la place de marché à fournir l'annonce. Il s'agit d'un texte UTF8 arbitraire, mais il suffit d'identifier l'enchérisseur et de définir la même valeur pour le même enchérisseur.
exchange_deal_type	Non	Énumération ExchangeDealType	ffffff.Ad.AdSlot.exchange_deal_type	OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3; par défaut = OPEN_AUCTION
attribute	Non	Tableau int32	Attribut ffffff.Ad.	Reportez-vous au fichier buyer-declarable-creative-attributes.txt afin d'obtenir la liste des ID. Notez que tous les attributs déclarables ne sont pas transmis au BidRequest dans les différents champs battr. De nombreux enchérisseurs déclarent l'attribut pour les interstitiels "fluides" (également appelés "annonces responsives" ou "sans taille") qui sont redimensionnés de manière dynamique pour occuper toute la largeur et la hauteur de l'écran. Pour en savoir plus, consultez la description du guide des annonces interstitielles.
amp_ad_url	Non	chaîne	vCPM.Ad.amp_ad_url	URL permettant de récupérer une annonce AMP HTML. Un seul des éléments suivants doit être défini: html_snippet, video_url, amp_ad_url, native_ad.
sdk_rendered_ad	Non	Objet SdkRenderedAd	ffffff.Ad.sdk_rendered_ad	Annonce affichée par un SDK connu de l'acheteur. Cette option ne peut être utilisée que lorsque le BidRequest incluait un sous-message AppExt.InstallSdk.
event_notification_token	Non	Objet EventNotificationToken	ffffff.Ad.event_notification_token	Un jeton défini par les enchérisseurs pour le dépannage, qui sera inclus dans les commentaires en temps réel pour l'enchère dans laquelle il est envoyé. Le contenu du jeton ne sera pas consigné.
restricted_category	Non	Tableau int32	vCPM.Annonce.catégorie limitée	Toutes les catégories limitées pour les annonces susceptibles d'être diffusées à partir de cet extrait. Consultez le fichier ad-restricted-categories.txt pour obtenir la liste des identifiants.
billing_id	Non	int64	vCPM.Ad.AdSlot.billing_id	Numéro de compte de facturation auquel attribuer cette impression. La valeur doit figurer dans le champ répété "BidRequest.Imp.ImpExtImpbilling_id" envoyé pour cette impression. Si la valeur de BidRequest.Imp.ImpExt.billing_id est exactement 1 et que l'enchérisseur ne dispose pas de licences enfants actives, ce champ n'est pas obligatoire et son contenu est ignoré.
third_party_buyer_token	Non	chaîne	ffffff.Ad.Adslot.third_party_token_token	Jeton permettant d'identifier les informations sur les acheteurs tiers si la place de marché en tant qu'enchérisseur Open Bidding est un intermédiaire. Il est obtenu auprès de l'acheteur tiers et doit être transmis à Google tel quel dans la réponse à l'enchère.
buyer_reporting_id	Non	chaîne	ffffff.Ad.Adslot.buyer_reporting_id	ID déclaré par l'acheteur, qui permettra de ventiler les dépenses et les métriques de trafic incorrect dans les rapports sur la transparence de l'IVT de l'éditeur de requêtes. Notez que les ID enregistrant moins de 1 000 impressions ne seront pas utilisés pour ventiler les métriques. Les ID de plus de 64 octets seront ignorés.
skadn	Non	Objet SKAdNetworkResponse	vCPM.Ad.skadn	Informations SKAdNetwork de l'annonceur pour prendre en charge l'attribution d'installations d'applications pour iOS 14 et versions ultérieures. L'API SKAdNetwork d'Apple aide les annonceurs à mesurer l'installation d'applications basées sur les annonces en envoyant un postback au réseau publicitaire après une installation réussie. Les réseaux publicitaires doivent envoyer leur ID de réseau et les informations signées de l'annonceur pour qu'une installation soit attribuée à l'impression d'annonce. Pour en savoir plus, consultez cet article.
app_promotion_type	Non	enum	vCPM.Ad.app_promotion_type	Type de la promotion correspondant à l'application annoncée dans le champ seatbid.bid.bundle. Si l'application dont vous faites la promotion n'est pas spécifiée, ce champ sera ignoré. La définition du champ bundle sans ce champ est traitée comme si ce champ était défini sur OTHER.
Annonce SDKSdRRed
id	Non	chaîne	BidResponse.ad[].sdk_rendered_ad.id	Identifiant du SDK qui affichera l'annonce. Doit correspondre à un BidRequest.app.ext.installed_sdk.id envoyé dans la demande d'enchère correspondante.
rendering_data	Non	chaîne	BidResponse.ad[].sdk_rendered_ad.rendering_data	Données à transmettre au SDK afin d'afficher l'annonce. Ces données sont opaques pour l'éditeur et pour Google.
declared_ad	Non	Annonce Delcared	BidResponse.ad[].sdk_rendered_ad.declared_ad	Les composants d'annonce ont été déclarés pour permettre l'analyse, la classification et l'application des règles relatives aux annonces et des blocages d'éditeurs pour les annonces diffusées à l'aide d'un SDK personnalisé. Définissez une seule des valeurs suivantes : html_snippet, video_url, video_vast_xml ou native_response.
Jeton de notification d'événement
payload	Non	chaîne	BidResponse.ad[].event_notification_token	Contenu du jeton, qui sera ignoré si la longueur dépasse 128 octets.
Réponse du SKAdNetwork
version	Non	chaîne	BidResponse.ad[].skadn.version	Version de SKAdNetwork compatible avec l'annonceur. Permet également de spécifier la manière dont la signature a été générée par l'annonceur. Cela doit correspondre à l'une des versions de BidRequest.imp.ext.skad.versions.
network	Non	chaîne	BidResponse.ad[].skadn.network	Identifiant de réseau publicitaire utilisé dans la signature. Il doit correspondre à l'un des éléments dans BidRequest.imp.ext.skad.skadnetids.
campaign	Non	chaîne	BidResponse.ad[].skadn.campaign	ID de campagne compatible avec les spécifications d'Apple. Utilisé dans SKAdNetwork 3.0 et ci-dessous. Remplacé par le champ BidResponse.imp.ext.skad.sourceidentifier dans SKAdNetwork 4.0 et versions ultérieures.
sourceidentifier	Non	chaîne	BidResponse.ad[].skadn.source_identifier	Entier à quatre chiffres défini par les réseaux publicitaires pour représenter la campagne publicitaire. Utilisée dans SKAdNetwork 4.0+ et remplace le champ BidResponse.imp.ext.skad.campaign.
itunesitem	Non	chaîne	BidResponse.ad[].skadn.itunesitem	ID de l'application de l'annonceur sur l'App Store d'Apple.
productpageid	Non	chaîne	BidResponse.ad[].skadn.product_page_id	ID de la page de produit personnalisée à afficher (pour iOS 15 ou version ultérieure). Si aucune valeur n'est spécifiée, la page du produit par défaut s'affiche. Consultez cet article pour en savoir plus sur les pages de produits personnalisées.
fidelities	Non	Tableau d'objets Fidelity	BidResponse.ad[].skadn.fidelities	À partir de la version 2.2, l'API SKAdNetwork est compatible avec plusieurs options de présentation d'annonces spécifiées par le paramètre fidelity-type de la signature SKAdNetwork. Elle contient les paramètres utilisés pour générer la signature, qui serait différent pour chaque type de fidélité compatible. Pour en savoir plus, consultez cet article.
nonce	Non	chaîne	BidResponse.ad[].skadn.nonce	UUID unique généré en minuscules par l'annonceur et qui sert à générer la signature. Remarque: Ce champ sera abandonné au profit du champ ffffff.bid.ext.skadn.fidelities.nonce compatible avec plusieurs types de fidélité.
sourceapp	Non	chaîne	BidResponse.ad[].skadn.sourceapp	ID de l'application de l'éditeur sur l'App Store d'Apple. Il doit correspondre à l'ID de BidRequest.imp.ext.skad.sourceapp.
timestamp	Non	chaîne	BidResponse.ad[].skadn.timestamp	Heure Unix en millisecondes utilisée au moment de la génération de la signature. Remarque: Ce champ sera abandonné au profit du champ ffffff.bid.ext.skadn.fidelities.timestamp afin de prendre en charge plusieurs types de fidélité.
signature	Non	chaîne	BidResponse.ad[].skadn.signature	Signature SKAdNetwork, comme spécifié par Apple. Remarque: Ce champ sera abandonné au profit du champ ffffff.bid.ext.skadn.fidelities.signature afin d'accepter plusieurs types de fidélité.
skoverlay	Non	Objet SKOverlay	BidResponse.ad[].skadn.skoverlay	Ces options indiquent comment présenter SKOverlay et recommande l'application annoncée. Compatible avec iOS 14 et versions ultérieures.

Objet déclaredAd

Les composants d'annonce ont été déclarés pour permettre l'analyse, la classification et l'application des règles relatives aux annonces et des blocages d'éditeurs pour les annonces diffusées à l'aide d'un SDK personnalisé.

Définissez une seule des valeurs suivantes : html_snippet, video_url, video_vast_xml ou native_response.

Parent

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
html_snippet	Non	chaîne	ffffff.ad[].sdk_rendered_ad.declared_ad.html_snippet	Extrait HTML représentant l'annonce affichée par le SDK.
video_url	Non	chaîne	vCPM.ad[].sdk_rendered_ad.declared_ad.video_url	URL de l'élément VAST utilisé dans l'annonce affichée par le SDK.
video_vast_xml	Non	chaîne	vCPM.ad[].sdk_rendered_ad.declared_ad.video_vast_xml	Document VAST utilisé pour afficher l'annonce personnalisée affichée par le SDK. Ce document doit être conforme à la norme VAST 2.0 ou 3.0.
native_response	Non	NativeResponse	ffffff.ad[].sdk_rendered_ad.declared_ad.native_response	Contenu d'une annonce native. Les annonces natives sont composées de plusieurs composants principaux, affichés par le SDK de l'acheteur. Doit correspondre à la définition NativeResponse standard OpenRTB Native 1.2. NativeResponse.assets.img.type est obligatoire.
click_through_url	Non	chaîne	vCPM.ad[].sdk_rendered_ad.declared_ad.click_through_url	Pages de destination finales de l'annonce affichée par le SDK.

Fidélité

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
fidelity	Non	énumération SKAdNetworkFidelityType	BidResponse.ad[].skadn.fidelity_type	Type de fidélité de l'attribution à suivre. Valeur par défaut : STOREKIT_RENDERED_ADS. VIEW_THROUGH_ADS = 0 ; attribution pour les installations d'application dans les 24 heures suivant le visionnage d'une annonce pendant au moins trois secondes. Compatible avec SKAdnetwork version 2.2 ou ultérieure. Pour en savoir plus, consultez cet article. STOREKIT_RENDERED_ADS = 1 ; attribution pour les installations d'application lancées à partir de la page de produit sur l'App Store affichée par StoreKit, générée par les clics sur les annonces. Compatible avec toutes les versions de SKAdNetwork. Pour en savoir plus, consultez cet article.
nonce	Non	chaîne	BidResponse.ad[].skadn.nonce	UUID unique généré en minuscules par l'annonceur et qui sert à générer la signature.
timestamp	Non	chaîne	BidResponse.ad[].skadn.timestamp	Heure Unix en millisecondes utilisée au moment de la génération de la signature.
signature	Non	chaîne	BidResponse.ad[].skadn.signature	Signature SKAdNetwork, comme spécifié par Apple.

Superposition SK

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
delay	Non	int32	BidResponse.ad[].skadn.skoverlay.delay_seconds	Délai (en secondes) après le début de la diffusion d'une annonce en superposition. Si ce champ est défini sur 0, la superposition est affichée immédiatement après le début de l'annonce. Si ce champ n'est pas défini, la superposition ne sera pas affichée pour l'annonce.
endcarddelay	Non	int32	BidResponse.ad[].skadn.skoverlay.endcard_delay_seconds	Délai d'affichage, en secondes, de la fiche de fin avant la présentation de la superposition. (Ce champ ne s'applique qu'aux créations vidéo avec récompense ou interstitielles.) Si ce champ est défini sur 0, la superposition est affichée immédiatement après l'affichage de la carte de fin. Si ce champ n'est pas défini, la superposition ne s'affichera pas pour la carte de fin. Si delay et endcarddelay sont tous deux définis, la superposition sera automatiquement ignorée à la fin de l'annonce, puis affichée à nouveau une fois la fiche de fin affichée.
dismissible	Non	Bool	BidResponse.ad[].skadn.skoverlay.dismissible	Indique si l'utilisateur peut ignorer cette superposition. La valeur par défaut est "true".

Variables, définitions et extensions d'enchères natives

Demande native

L'objet Native définit l'opportunité publicitaire native disponible pour l'enchère via cette demande d'enchère. Elle doit être incluse directement dans l'objet "impression" si l'impression proposée pour l'enchère est un format d'annonce native.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
ver	Oui	chaîne	"1.2" pour OpenRTB 2.5.	Numéro de la version de balisage native utilisée.
layout	Non	ID de mise en page	Non compatible	ID de mise en page du bloc d'annonces natives. RECOMMANDÉ par OpenRTB Native 1.0 ; facultatif dans la version 1.1, bientôt obsolète.
adunit	Non	ID de bloc d'annonces	Non compatible	ID du bloc d'annonces natives. Cela correspond à l'un des blocs d'annonces natives Core 6 de l'IAB. RECOMMANDÉ par OpenRTB 1.0 natif ; facultatif dans la version 1.1, bientôt obsolète.
context	Non	ContextType	Non compatible	Contexte dans lequel l'annonce est diffusée.
contextsubtype	Non	Sous-type de contexte	Non compatible	Contexte plus détaillé dans lequel l'annonce apparaît.
plcmttype	Non	Type d'emplacement	NativeAdTemplate.native_placement_type	Conception/Format/Mise en page du bloc d'annonces proposé.
plcmtcnt	Non	int32	Non compatible	Nombre d'emplacements identiques dans cette mise en page.
seq	Non	int32	Non compatible	0 pour la première annonce, 1 pour la deuxième, et ainsi de suite. Notez que cette option ne doit généralement pas être utilisée conjointement avec plcmtcnt. Soit vous définissez des enchères pour plusieurs emplacements identiques (dans ce cas, plcmtcnt>1, seq=0), soit vous organisez des enchères distinctes pour des éléments distincts du flux (dans ce cas, plcmtcnt=1, seq>=1).
assets	Non	Tableau d'objets Asset	Compatible avec l'objet NativeAdTemplate. Le champ des éléments OpenRTB correspond au champ native_ad_template du protocole AdX. Cette mise en correspondance n'est pas individuelle. Le protocole Google AdX transmet le même message via l'objet NativeAdTemplate, et les champs required_fields et recommended_fields indiquent à l'enchérisseur quels assets sont requis ou recommandés. NativeAdTemplate inclut également d'autres champs tels que image_width. Les informations du champ assets dans OpenRTB sont exprimées via plusieurs champs dans AdX.	Toute enchère doit respecter le tableau des éléments exprimé par la place de marché. Requis par la spécification native OpenRTB: au moins un élément.
aurlsupport	Non	bool	Compatible	Indique si la source / l'impression de l'approvisionnement permet de renvoyer un élément asseturl au lieu d'un objet d'élément. 0 ou l'absence de champ indique une telle compatibilité. Implémenté dans la version 1.2
durlsupport	Non	bool	Compatible	Indique si la source / l'impression de l'approvisionnement permet de renvoyer une URL DCO au lieu d'un objet d'élément. 0 ou l'absence de champ indique une telle compatibilité. Implémenté dans la version 1.2. Fonctionnalité bêta.
eventtrackers	Non	EventTrackers	La version 1.2 d'OpenRTB est compatible avec le suivi IMPRESSION et IMG. Si OMSDK est activé pour le format natif, JavaScript est accepté.	Indique le type de suivi des événements compatible. Implémenté dans la version 1.2
privacy	Non	bool	Non compatible	Définissez la valeur sur 1 lorsque l'annonce native est compatible avec l'avis de confidentialité propre à l'acheteur. Définissez la valeur sur 0 (ou champ manquant) lorsque l'annonce native n'est pas compatible avec les liens de confidentialité personnalisés, ou si la compatibilité est inconnue. RECOMMANDÉ et implémenté dans la version 1.2. Toutes les requêtes natives que nous envoyons acceptent une URL de confidentialité. Par conséquent, elle est implicitement toujours "1" pour les requêtes natives.
ext	Non	Objet NativeRequestExt	Compatible	Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.native_ext] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous accédez au champ ext dans le message NativeRequest.

NativeRequestExt

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
style_id	Non	int32	BidRequest.AdSlot. native_ad_template[0].style_id	ID global global pour le style spécifique, le code HTML et le CSS avec lequel l'annonce native est affichée.
style_height	Non	int32	BidRequest.AdSlot. native_ad_template[0] .style_height	Si style_layout_type est défini sur Pixel, il s'agit de la hauteur de l'ensemble de l'annonce native après l'affichage.
style_width	Non	int32	BidRequest.AdSlot. native_ad_template[0] .style_width	Si style_layout_type est défini sur Pixel, il s'agit de la largeur de l'ensemble de l'annonce native après l'affichage.
style_layout_type	Non	énumération LayoutType	BidRequest.AdSlot. native_ad_template[0] .style_layout_type	Type d'énumération: PIXEL = 0 ; (par défaut) FLUID = 1

Asset

L'objet conteneur principal de chaque élément demandé ou pris en charge par Exchange pour le compte du client de rendu. Tout objet requis doit être signalé en tant que tel. Un seul des objets {title,img,video,data} doit être présent dans chaque objet. Tous les autres doivent être nuls/absents. Le id doit être unique au sein du tableau Asset afin que la réponse puisse être alignée.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
id	Oui	int32	1 N pour N éléments dans l'ordre non spécifié, correspondant aux champs recommandés ou obligatoires dans le premier NativeAdTemplate.	ID d'élément unique, attribué par place de marché. Généralement, un compteur pour le tableau. OBLIGATOIRE conformément à la spécification OpenRTB Native.
required	Non	Bool	BidRequest.AdSlot.native_ad_template[0]. required_fields	Défini sur "true" si un asset est requis.
title	Non	Titre de la requête	BidRequest.AdSlot.native_ad_template[0] de type "HEADLINE"	Objet Title pour les assets de titre. RECOMMANDÉ par la spécification native OpenRTB. Title, Image, Data ou Video.
img	Non	Demander une image	BidRequest.AdSlot.native_ad_template[0] de type MAIN/IMAGE, ICON/APP_ICON, LOGO/LOGO	Objet Image pour les composants Image. RECOMMANDÉ par la spécification native OpenRTB. Title, Image, Data ou Video.
video	Non	Vidéo	BidRequest.AdSlot.NativeAdTemplate.required_fields	Objet Video pour les assets vidéo. Notez que les annonces vidéo InStream ne sont pas natives. Les annonces natives peuvent contenir une vidéo en tant que création elle-même. Les demandes d'enchères peuvent indiquer qu'une vidéo est requise dans la réponse native en définissant NativeRequest.assets[].required sur true et en spécifiant un élément NativeRequest.assets[].video. RECOMMANDÉ par la spécification native OpenRTB. Valeurs possibles : Title, Image, Data ou Video.
data	Non	Données	BidRequest.AdSlot.native_ad_template[0] de types CTATEXT/CALL_TO_ACTION, HREF/BODY, Sponsorisé/Annonceur, PRICE/PRIX, RATING/STAR_RATING	Objet Data pour les notes, les prix, etc. RECOMMANDÉ par la spécification native OpenRTB. Title, Image, Data ou Video.

Titre

L'objet Title doit être utilisé pour l'élément de titre de l'annonce native.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
len	Non	int32	BidRequest.AdSlot.native_ad_template[0].headline_max_safe_length	Longueur maximale du texte dans l'élément de titre. RECOMMANDÉ que la valeur soit: 25, 90, 140. OBLIGATOIRE conformément à la spécification OpenRTB Native.

Image

L'objet Image doit être utilisé pour les éléments image de l'annonce native.

Non compatible

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
type	Non	Type d'asset image	Type de champ BidRequest.AdSlot.native_ad_template[0]	ID de type de l'élément image accepté par l'éditeur. L'éditeur peut afficher ces informations dans un format approprié.
w	Non	int32	Non compatible	Largeur de l'image en pixels.
h	Non	int32	Non compatible	Hauteur de l'image en pixels.
wmin	Non	int32	BidRequest.AdSlot.native_ad_template[0] de type: MAIN/IMAGE:image_width LOGO/LOGO: logo_width ICON/APP_ICON: app_icon_width	Largeur minimale demandée de l'image en pixels. Cette option doit être utilisée pour tout rescaling des images par le client. Les valeurs w ou wmin doivent être transmises. Si seule w est inclus, il s'agit d'une exigence exacte. RECOMMANDÉ par la spécification native OpenRTB.
hmin	Non	int32	BidRequest.AdSlot.native_ad_template[0] de type: MAIN/IMAGE:image_height LOGO/LOGO: logo_height ICON/APP_ICON: app_icon_height	Hauteur minimale demandée de l'image en pixels. Cette option doit être utilisée pour tout rescaling des images par le client. Les valeurs h ou hmin doivent être transmises. Si seule h est inclus, il s'agit d'une exigence exacte. RECOMMANDÉ par la spécification native OpenRTB.
mimes	Non	chaîne		Liste des types MIME de contenu acceptés. Les types MIME courants incluent, sans s'y limiter, "image/jpg" et "image/gif". Chaque implémentation Exchange doit avoir sa propre liste des types compatibles dans la documentation d'intégration. Pour en savoir plus et obtenir des liens vers les RFC IETF, consultez la page MIME de Wikipédia. Si ce champ n'est pas renseigné, supposons que tous les types sont autorisés.

Vidéo

L'objet Video doit être utilisé pour les éléments vidéo de l'annonce native.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
mimes	Oui	Tableau de chaînes	BidRequest.Video.allowed_video_formats	Types MIME de contenu acceptés. Les types MIME courants incluent, entre autres, "video/x-mswmv" pour Windows Media et "video/x-flv" pour Flash Video, ou "video/mp4". Notez que le format natif natif n'est pas compatible avec Flash. OBLIGATOIRE conformément à la spécification native OpenRTB: au moins un élément.
minduration	Oui	int32	BidRequest.Video.min_ad_duration	Durée minimale de l'annonce vidéo en secondes. OBLIGATOIRE conformément à la spécification OpenRTB Native.
maxduration	Oui	int32	BidRequest.Video.max_ad_duration	Durée maximale de l'annonce vidéo en secondes. OBLIGATOIRE conformément à la spécification OpenRTB Native.
protocols	Oui	Tableau de Protocol énumération	BidRequest.Video.protocoles	Tableau des protocoles vidéo que l'éditeur peut accepter dans la réponse à l'enchère. OBLIGATOIRE conformément à la spécification native OpenRTB: au moins un élément. Exemples: VAST_1_0 = 1 ; VAST_2_0 = 2 ; VAST_3_0 = 3

Données

L'objet Data doit être utilisé pour tous les éléments non principaux de l'unité native tels que les notes, le nombre d'avis, les étoiles, le nombre de téléchargements, les descriptions, etc. Il est également générique pour l'avenir des éléments natifs non envisagés au moment de la rédaction de ce document.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
type	Oui	Type de ressource Data	Type de champ BidRequest.AdSlot.native_ad_template[0]	ID de type de l'élément accepté par l'éditeur. L'éditeur peut afficher ces informations dans un format approprié. OBLIGATOIRE par la spécification OpenRTB native.
len	Non	int32	BidRequest.AdSlot.native_ad_template[0] de type: CAS/CORPS: body_max_safe_length CTATEXT/CALL_TO_ACTION: call_to_action_max_safe_length Sponsorisé/Annonceur: Advertiser_max_safe_length PRICE/PRICE: price_max_safe_length	Longueur maximale du texte dans la réponse de l'élément. Remarque: non utilisé pour RATING/STAR_RATING, AdX a besoin d'un double de 0 à 5

Suivi des événements

L'objet EventTrackers spécifie le type d'événements que l'enchérisseur peut demander à suivre dans la réponse à l'enchère et les types de suivi disponibles pour chaque type d'événement. Il est inclus en tant que tableau dans la demande.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
event	Oui	EventType	Non compatible	Type d'événement disponible pour le suivi. OBLIGATOIRE conformément à la spécification OpenRTB Native.
methods	Oui	EventTrackingMethod	Non compatible	Tableau des types de suivi disponibles pour l'événement donné. OBLIGATOIRE conformément à la spécification OpenRTB Native.

Réponse native

L'objet de réponse natif est l'objet JSON de premier niveau qui identifie une réponse native.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
ver	Non	chaîne	"1.0" pour OpenRTB 2.3 ; "1.1" pour OpenRTB 2.4	Version de la balise native utilisée.
assets	Non	Tableau des composants	ffffff.Ad.native_ad[0]. Tous les éléments sont mappés avec les champs d'un même NativeAd.	Liste des composants de l'annonce native.
link	Oui	Lien	ffffff.Ad_native_ad[0]	"Destination Link.REQUIRED" requis par la spécification "OpenRTB Native".
imptrackers	Non	Tableau de chaînes	ffffff.Ad.impression_tracking_url	Tableau d'URL de suivi des impressions, censé renvoyer une image 1x1 ou une réponse 204 (généralement transmis lorsque les outils de suivi tiers sont utilisés). Utilisez la macro %%WINNING_PRICE%% ou ${AUCTION_PRICE}.
jstracker	Non	chaîne	Non compatible	Outil de suivi des impressions JavaScript (facultatif). Contient des tags script à exécuter au moment de l'impression, là où ils sont compatibles.
eventtrackers	Non	Tableau d'objets EventTracker	ffffff.Ad.impression_tracking_url et ffffff.Ad.impression_tracking_resource	Tableau des outils de suivi des événements de réponse à exécuter avec l'annonce, en réponse aux méthodes compatibles déclarées dans la requête native. Remplace les imptrackers et jstrackers. Implémenté dans la version 1.2.

Suivi des événements

La réponse de l'outil de suivi des événements consiste en un tableau d'objets et spécifie les types d'événements que l'enchérisseur souhaite suivre et les URL/informations à suivre. L'enchérisseur ne doit répondre qu'avec les méthodes indiquées comme disponibles dans la demande. Notez que la plupart des outils de suivi JavaScript s'attendent à être chargés au moment de l'impression. Par conséquent, il n'est généralement pas recommandé que l'acheteur réponde avec des outils de suivi JavaScript pour d'autres événements, mais la pertinence de l'opération revient à chaque acheteur.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
event	Oui	integer	Non compatible	Type d'événement à suivre.
method	Oui	integer	Non compatible	Type de suivi demandé.
url	Non	texte	ffffff.Ad.impression_tracking_url et vCPM.Ad.ImpressionTrackingResource.script_url	URL de l'image ou du fichier js. Obligatoire pour les images ou les fichiers js, facultatif pour les formats personnalisés.
customdata	Non	Objet contenant des paires clé/valeur.	Non compatible	Pour être convenu individuellement avec la place de marché, un tableau d'objets clé-valeur pour le suivi personnalisé ; par exemple, le numéro de compte de la DSP avec une entreprise de suivi ; par exemple, {accountaccount":"123"}.
ext	Non	Objet EventTrackerExt	Non compatible	Pour OpenRTB/Protobuf, vous pouvez accéder à cet objet avec la clé d'extension [com.google.doubleclick.eventtrackers] (le chemin d'accès exact varie en fonction du langage utilisé pour générer la bibliothèque proto). Pour OpenRTB/JSON, vous accédez via le champ ext dans le message EventTracker.

EventTrackerExt

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
context	Non	Tableau de contexte d'énumération	ffffff.Ad.ImpressionTrackingResource.contexte	Contexte supplémentaire fourni pour l'affichage. UNKNOWN = 0; OMID = 1; Actuellement non compatible.
verification_parameters	Non	chaîne	ffffff.Ad.ImpressionTrackingResource.paramètres_validation	Paramètres associés à la ressource qui seront transmis à la ressource lors de son chargement. Le format de ces paramètres dépend du fournisseur du script.
vendor_key	Non	chaîne	ffffff.Ad.ImpressionTrackingResource.vendor_key	Permet d'identifier de manière unique le fournisseur du script de validation.

Lien

Utilisé pour les composants d'incitation à l'action ou autres liens issus de l'annonce native. Cet objet doit être associé à son objet pair dans l'objet parent Asset. Lorsque cet objet pair est activé (clic), l'action doit rediriger l'utilisateur vers l'emplacement du lien.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
url	Non	chaîne	vCPM.ad[].annonce_native.Clic_lien_url	URL de destination du lien cliquable.
clicktrackers	Non	Tableau de chaînes	(NativeResponse.link) ffffff.Ad.NativeAd.click_tracking_url[0]	URL de suivi tierces à déclencher en cas de clic sur l'URL. Les outils de suivi des clics Google redirigent 30 fois le protocole HTTP vers l'outil de suivi de l'enchérisseur. Plusieurs outils de suivi des clics sont autorisés.
fallback	Non	chaîne	Non compatible	URL de remplacement pour le lien profond. À utiliser si l'URL fournie dans url n'est pas compatible avec l'appareil.

Asset

Correspond à l'objet Asset de la requête. Objet conteneur principal pour chaque élément demandé ou accepté par Exchange pour le client de rendu. Tout objet requis doit être signalé en tant que tel. Un seul des objets {title,img,video,data} doit être présent dans chaque objet. Tous les autres doivent être nuls/absents. L'ID doit être unique dans le tableau des éléments pour que la réponse puisse être alignée.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
id	Oui	int32	Non compatible	L'ID d'élément unique, attribué par l'échange, doit correspondre à l'un des ID d'éléments de la requête OBLIGATOIRE conformément à la spécification OpenRTB Native.
required	Non	Bool	Non compatible	Définissez la valeur sur 1 si un asset est requis. (l'enchérisseur a besoin de l'afficher)
title	Non	Titre	AdX: ffffff.Ad.native_ad[0] / TITRE	Title, Image, Data ou Video Objet Title pour les assets de titre.
img	Non	Image	PTR.Ad.native_ad[0] / IMAGE|LOGO|APP_ICON	Title, Image, Data ou Video Objet Image pour les composants Image.
video	Non	Vidéo	ffffff.Ad.NativeAd.video_url ou ffffff.Ad.NativeAd.video_vast_xml	Il peut s'agir d'une chaîne contenant du code XML VAST ou d'une URL d'un document VAST via l'attribut NativeResponse.assets[].video.vasttag. Objet Video pour les assets vidéo. Notez que les annonces vidéo InStream ne sont pas natives. Les annonces natives peuvent contenir une vidéo en tant que création elle-même.
data	Non	Données	ffffff.Ad.native_ad[0] / CORPS|CALL_TO_ACTION|ANNONCEUR|STAR_RATING_PRICE_STORE	Title, Image, Data ou Video. Objet Data pour les notes, les prix, etc.
link	Non	Lien	ffffff.Ad_native_ad[0]	Objet lien pour les incitations à l'action. Ce lien est associé à l'autre champ renseigné dans l'objet.

Titre

Correspond à l'objet Title de la requête, avec la valeur renseignée.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
text	Oui	chaîne	ffffff.Ad.native_ad[0].titre	Texte associé à l'élément textuel. Requis par la spécification native OpenRTB

Image

Correspond à l'objet Image de la requête. Objet Image à utiliser pour tous les éléments image de l'annonce native, tels que les icônes, l'image principale, etc.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
url	Oui	chaîne	ffffff.Ad.native_ad[0] pour le type de composant "Demande" : PRINCIPAL/IMAGE: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: logo.url	URL du composant Image. OBLIGATOIRE conformément à la spécification OpenRTB Native.
w	Non	int32	ffffff.Ad.native_ad[0] pour le type de composant "Demande" : PRINCIPAL/IMAGE: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: logo.url	Largeur de l'image en pixels. RECOMMANDÉ par la spécification OpenRTB Native.
h	Non	int32	ffffff.Ad.native_ad[0] pour le type de composant "Demande" : PRINCIPAL/IMAGE: image.url ICON/APP_ICON: app_icon.url LOGO/LOGO: logo.url	Hauteur de l'image en pixels.

Vidéo

Correspond à l'objet Video dans la requête, mais contient une valeur d'un tag VAST conforme.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
vasttag	Oui	chaîne	Non compatible	XML VAST. OBLIGATOIRE conformément à la spécification OpenRTB Native.

Données

Correspond à l'objet Data de la requête, avec la valeur renseignée. L'objet Data doit être utilisé pour tous les éléments divers de l'unité native tels que les notes, le nombre d'avis, les étoiles, les téléchargements, le nombre de prix, etc. Il est également générique pour les futurs éléments natifs non envisagés au moment de la rédaction de ce document.

Attribut	Toujours transmis	Type	Équivalent Authorized Buyers	Détails de mise en œuvre
label	Non	chaîne	Non compatible	Nom de chaîne formaté facultatif du type de données à afficher.
value	Oui	chaîne	ffffff.Ad.native_ad[0] pour le type d'asset de demande OpenRTB/AdX: CTATEXT/CALL_TO_ACTION: call_to_action descendant/corps: corps Sponsorisé/Annonceur: annonceur PRIX/PRIX: prix RATING/STAR_RATING: star_rating (AdX requiert un double 0,5)	Chaîne de données mise en forme à afficher. Peut contenir une valeur mise en forme comme "5 étoiles", "$10" ou "3,4 étoiles sur 5". OBLIGATOIRE par la spécification OpenRTB native.

Exemples

• Exemples de demandes d'enchères
• Exemples de réponses aux enchères