Intégration OpenRTB

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

Pour en savoir plus sur les protos OpenRTB, consultez le fichier proto OpenRTB. Pour les extensions Authorized Buyers, consultez le fichier Open Buffers Protocol Buffers.

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

  • JSON
  • Protobuf: le fichier de définition .proto peut être référencé pour le décodage des messages.

Cette page sert de référence pour les deux.

Remarques concernant l'intégration

Structure de ce document

Les tableaux ci-dessous contiennent les définitions des objets, y compris leur nom (s'il est requis ou non dans la demande d'enchère ou la réponse à l'enchère), leur équivalent dans notre protobuf d'enchères en temps réel d'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é dans votre configuration de préciblage. Ce champ permet d'associer l'enchère à un billing_id envoyé dans la demande d'enchère. Si la requête contient plusieurs cid/billing_id ou si des sous-comptes sont 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, la valeur sera déduite de la réponse.
  • Par souci 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. Reportez-vous au fichier proto OpenRTB.
  • Dans les demandes d'enchères encodées au format JSON, tous les champs saisis dans "int64" ou "fixed64" ci-dessous sont envoyés sous forme de chaînes pour éviter toute perte de précision pour les valeurs intégrales de 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. Cela est requis 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 tous les inventaires, y compris les annonces natives.

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, en raison du préchargement, ont été récupérées par l'application, mais ne s'affichent jamais. Utilisez la macro %%WINNING_PRICE%% chiffrée 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. Attribut BidRequest.id.
  • ${AUCTION_BID_ID} : ID de l'enchère, attribut BidResponse.bidid.
  • ${AUCTION_IMP_ID} : ID de l'impression qui vient d'être remportée. Attribut BidRequest.imp[].id.
  • ${AUCTION_SEAT_ID} : ID du siège du système d'enchères pour lequel l'enchère a été effectuée (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} : compensation 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 dans la macro WINNING_PRICE du protocole Authorized Buyers. Pour savoir comment déchiffrer le prix, consultez le guide de confirmation des prix du déchiffrement.

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 comportent des champs correspondants.

Lorsque vous migrez du code 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 l'intégralité de la version VAST intégrée, et tous les comptes peuvent être activés pour cette fonctionnalité en contactant l'équipe d'assistance chargée des comptes.

Notez qu'avec OpenRTB 2.4 ou version ultérieure, si la valeur video.skip=1 est définie, les acheteurs peuvent enchérir avec des créations vidéo non désactivables ou désactivables. Nous vous recommandons d'activer l'option Ignorer la correction lors de la configuration du compte, car aucune distinction n'est effectuée entre ALLOW_SKIPPABLE et REQUIRE_SKIPPABLE dans OpenRTB.

Champs non acceptés

Le champ Nurl n'est pas pris en charge à l'heure actuelle, 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 la norme 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 MRAID-2. Par conséquent, 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 et définitions de demandes d'enchères

Demande d'enchère

L'objet de demande d'enchère de premier niveau contient une demande d'enchère ou un ID d'enchère uniques. Cet attribut d'ID est requis, de même qu'au moins un objet Imp (impression). D'autres attributs de cet objet de premier niveau définissent des règles et des restrictions qui s'appliquent à toutes les impressions proposées.

Il existe également plusieurs objets subordonnés qui fournissent des données détaillées aux acheteurs potentiels. Parmi ceux-ci figurent 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 requête 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.

Attribut Toujours transmis Type Acheteurs
autorisés
équivalents
Autorisé Détails de mise en œuvre
dans la version par Google
id Oui chaîne ID du demande d'enchère 2,3
2,4
2,5


ID unique de la demande d'enchère, fourni par la place de marché.

OpenRTB utilise une base64 adaptée au Web (sans remplissage).

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 demande d'enchère 2,3
2,4
2,5


Informations sur le site Web de l'éditeur.

Uniquement applicable et recommandé pour les sites Web.

Une seule fois avec app.

app Non Objet App BidRequest
BidRequest.Mobile
2,3
2,4
2,5


Informations sur l'application de l'éditeur

(applications sans navigateur). Uniquement applicable et recommandé pour les applications.

Une seule fois avec site.

device Non Objet Device BidRequest.Mobile, BidRequest.Appareil 2,3
2,4
2,5


Détails 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


Spécifie toutes les réglementations sectorielles, légales ou gouvernementales en vigueur pour cette demande.
user Non Objet User demande d'enchère 2,3
2,4
2,5


Détails sur l'utilisateur humain de l'appareil et l'audience publicitaire.
at Non Objet AuctionType Type de demande 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 à partir de valeurs supérieures à 500. Valeur par défaut = SECOND_PRICE.

tmax Non int32 80 à 1 000 ms 2,3
2,4
2,5


Durée maximale, en millisecondes, de l'envoi d'une enchère pour éviter l'expiration du délai. Cette valeur est couramment communiquée hors connexion.
wseat Non chaîne Non compatible 2,3
2,4
2,5


Liste de licences utilisateur (par exemple, annonceurs, agences) autorisées à enchérir sur cette impression. Les ID des sièges ainsi que la connaissance des clients de l'acheteur auxquels ils font référence doivent être coordonnés entre les enchérisseurs et la priorité des places de marché. Une absence de restriction de siège 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 de type pré-roll, mid-roll ou post-roll) pour permettre le blocage de routes. 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ères à l'aide des 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


Catégories d'annonceurs bloquées à l'aide des catégories de contenu de l'IAB. Reportez-vous à l'é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, "addomain.com")
bapp Non Tableau de chaînes Non compatible 2,4
2,5

Bloquer la liste des applications en fonction de leurs identifiants d'application indépendants de la plate-forme. Sur Android, il doit s'agir de noms de packages ou de packages (com.foo.mygame, par exemple). Sur iOS, il s'agit d'identifiants numériques.
test Non Bool BidRequest.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 2.5 Bloquer la liste des sièges d'acheteurs (annonceurs, agences, etc.) qui ne peuvent pas définir d'enchères pour cette impression. Les ID des sièges ainsi que la connaissance des clients de l'acheteur auxquels ils font référence doivent être coordonnés entre les enchérisseurs et la priorité des places de marché. Vous ne pouvez utiliser qu'un seul des éléments wseat et bseat dans la même requête. L'absence des deux options n'implique aucune restriction de siège.
wlang Non chaîne BidRequest
.AdSlot
.allowed
_languages
2.5 Liste des langues autorisées 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 des attributs de langue dans les objets Device et/ou Content s'ils sont disponibles.
source Non Objet Source Utilisé uniquement pour les extensions 2.5 Un objet Source qui fournit des données sur la source d'inventaire et 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 accédez au champ ext du 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 système d'enchères. 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. Si une requête comporte plusieurs accroches, toutes les demandes d'accroche pour cette requête contiendront le même google_query_id.
fcap_scope Oui FrequencyCappingScope énumération BidRequest.AdSlot.FrequencyCappingScope

Fonctionnalité expérimentale. Elle est 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 la limite de la fréquence d'exposition n'a pas pu être déterminée de manière fiable.

FREQUENCY_CAPPING_SCOPE_NONE = 1 ; la limitation de la fréquence d'exposition basée sur les spécifications de la réponse à l'enchère n'est pas disponible pour cette demande. Une enchère avec limite du nombre d'expositions pour une demande d'enchère sans disponibilité de limite du nombre d'expositions sera filtrée avant la mise aux enchères.

FREQUENCY_CAPPING_SCOPE_BROWSER = 2 ; la limitation du nombre d'expositions est disponible sur plusieurs sites dans le même navigateur.

FREQUENCY_CAPPING_SCOPE_DEVICE = 3. La limitation du nombre d'expositions 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 du nombre d'expositions est disponible sur un seul site.

privacy_treatments Non Objet PrivacyTreatments BidRequest.privacy_treatments Traitements pour la confidentialité. Certains champs de la demande d'enchère peuvent être anonymisés ou masqués afin de protéger la vie privée des utilisateurs. Ce message fournit des informations sur les traitements liés à la confidentialité qui s'appliquent à une opportunité d'annonce proposée dans cette demande.
Commentaires sur l'enchère

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 système d'enchères. 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.BidResponseFeedback.request_id. ID unique du BidRequest.id.
creative_status_code Non int32 BidRequest.BidResponseFeedback.creative_status_code (code d'état de la création) Code d'état de l'annonce. Pour obtenir la liste des ID, consultez les codes d'état de la création sur la page Protos & Reference Data.
price Non double BidRequest.BidResponseFeedback.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 a dépassé les enchères, il s'agit du CPM qui aurait 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 choisi de ne pas partager les prix gagnants avec d'autres enchérisseurs. Pour les enchères au premier prix, "minimum_bid_to_win" est renseigné à la place de ce champ.
minimum_bid_to_win Non double BidRequest.BidResponseFeedback.minimum_bid_to_win Valeur d'enchère minimale nécessaire pour avoir remporté l'enchère, dans la devise de votre compte. Si votre enchère a remporté la mise aux enchères, il s'agit de la deuxième enchère la plus élevée non filtrée (y compris le prix plancher). Si votre enchère ne remporte pas l'enchère, 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.BidResponseFeedback.samples_mediation_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 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 (classé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 correspond à un prix représentant un exemple d'enchère issue des réseaux de médiation éligibles qui était supérieur au gagnant de la mise aux enchères, 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 indiqué dans la devise de votre compte.
event_notification_token Non Objet EventNotificationToken BidRequest.BidResponseFeedback.event_notification_token: Jeton inclus dans l'enchère correspondante.
buyer_creative_id Non chaîne BidRequest.BidResponseFeedback.buyer_creative_id ID de la création inclus dans l'enchère correspondante.
Événement 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.BidResponseFeedback.event_notification_token: Contenu du jeton.
Objet PrivacyTreatments
Parent

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

Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
non_personalized_ads_reason Non NonPersonalizedAdsReason énumération BidRequest.privacy_treatments.non_personalized_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 devrait diffuser des annonces non personnalisées indépendamment des autres signaux.

RESTRICT_DATA_PROCESSING= 2 ; l'éditeur a demandé le 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 Vraie si l'éditeur autorise l'enchérisseur à utiliser les informations relatives aux visites des utilisateurs sur son site pour créer des catégories de centres d'intérêt pouvant être utilisées pour diffuser des annonces basées sur ces catégories. Pour utiliser ces données afin de créer des catégories de centres d'intérêt, un enchérisseur doit également remporter une impression donnée. Consultez À propos des commandes de collecte de données (version bêta).

Source

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

Attribut Toujours transmis Type Acheteurs
autorisés
équivalents
Autorisé Détails de mise en œuvre
dans la version par Google
fd Non booléen Non compatible 2.5 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 2.5 ID de transaction qui doit être commun à tous les participants à cette demande d'enchère (par exemple, plusieurs échanges). RECOMMANDÉ par la spécification OpenRTB.
pchain Non chaîne Non compatible 2.5 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 TAG d'ID de paiement. 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 accédez au champ ext dans le message source.

SourceExt

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 Objet SupplyChain OpenRTB. Pour en savoir plus, consultez cet article.
Chaîne d'approvisionnement

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 renvoyant le propriétaire du site, de l'application ou 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 de vendeur impliqués dans la transaction (le propriétaire du site, de l'application ou un autre support, par exemple). 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 du système auquel les enchérisseurs se connectent : SSP, Exchange, Wrapper de l'en-tête, etc. 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 l'adresse IP inverse afin d'établir clairement la propriété du système délégué. Il doit avoir la même valeur que celle utilisée pour identifier les vendeurs dans un fichier ads.txt, le cas échéant.
sid Non chaîne BidRequest.supply_chain.nodes.identifier_seller Identifiant associé au compte vendeur ou revendeur dans le système publicitaire. Il 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 plate-forme SSP ou 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. Ne doit pas dépasser 64 caractères.
rid Non chaîne Non compatible ID de requête OpenRTB de la demande, tel qu'il a été émis par ce vendeur.
name Non chaîne Non compatible Nom de l'entreprise (entité juridique) versée pour l'inventaire transactionné sous l'identifiant 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 de l'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. Lorsque la valeur est définie sur 1, le système publicitaire dans le champ asi paie le vendeur dans le champ sid, qui est responsable du paiement du nœud précédent de la chaîne. Lorsque la valeur est définie 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 nécessaire de l'inclure, car il est prévu que les futures versions de la spécification introduisent des nœuds de traitement des paiements. Les développeurs doivent s'assurer de prendre en charge ce champ et le propager plus tard lors de la création 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 en concurrence. Une seule demande d'enchère peut inclure plusieurs objets Imp. Il peut s'agir, par exemple, d'une place de marché qui accepte la vente de toutes les positions d'annonces sur une page donnée. Chaque objet Imp possède un ID obligatoire 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 offerte. L'éditeur peut choisir l'un de ces types de cas comme le cas typique ou le mélanger à sa discrétion. Toute enchère pour l'impression doit respecter l'un des types proposés.

Attribut Toujours transmis Type Acheteursautoriséséquivalents Autorisé 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 s'incrémente jusqu'à n pour les impressions).
banner Non Objet Banner BidRequest
.AdSlot
2,3
2,4
2,5


Objet Banner ; obligatoire si cette impression est offerte 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 offerte 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 offerte 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 de l'affichage de l'annonce (généralement vidéo ou mobile). Utilisé par certains ad servers pour personnaliser le code d'annonce par partenaire. Recommandé 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 SDK ou du lecteur responsable du rendu des annonces (généralement vidéo ou mobile). Utilisé par certains ad servers pour personnaliser le code d'annonce par partenaire. Recommandé pour les vidéos et/ou les applications.
instl Non Bool BidRequest
.AdSlot
.Mobile.
is_interstitial
_request
2,3
2,4
2,5


1 = l'annonce est interstitielle ou en plein écran, 0 = non interstitiel.
tagid Non chaîne BidRequest
.AdSlot
.ad_block_key
2,3
2,4
2,5


Identifiant d'emplacement d'annonce ou de tag d'emplacement publicitaire utilisé pour lancer la mise aux enchères. Cela peut être utile pour déboguer les éventuels problèmes ou pour optimiser l'achat.
bidfloor Non double min(BidRequest
.AdSlot.
correspondance
_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
obtenu
à 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é l'autorise.

Une devise unique, obtenue à partir de l'élément 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 pour les besoins de cet attribut, le Safari View Controller sur les appareils iOS 9.x est considéré comme un navigateur natif.

secure Non Bool BidRequest
.ad_slot
.excluded_attribute
48:RichMedia
CapabilityNonSSL
2,3
2,4
2,5


Option indiquant si l'impression nécessite des éléments de création et un balisage sécurisés pour les URL HTTPS, où 0 = non sécurisé, 1 = sécurisé. S'il est omis, l'état sécurisé est inconnu, mais la compatibilité avec le protocole HTTP non sécurisé peut être déduite.
iframebuster Non Tableau de chaînes Non compatible 2,3
2,4
2,5


Tableau de 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 associés à une place de marché privée pour cette impression.
native Non Natifs BidRequest
.AdSlot
.NativeAdTemplate
2,3
2,4
2,5


Objet Native ; obligatoire si cette impression est offerte en tant qu'opportunité d'annonce native.
exp Non int32 BidRequest
.AdSlot
.impression_expiration
_secondes
2,4
2,5

Indication du nombre de secondes qui peuvent s'écouler entre la mise aux enchères 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.
2.5 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 dans la métrique OpenRTB, mais elle est exprimée en pourcentage [0-100] dans le protocole AdX. Reportez-vous au tableau sur les objets AdSlot du Guide du système d'enchères en temps réel pour obtenir une description de ces métriques. Notez que session_depth est une valeur entière.
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 accédez avec le champ ext dans le message Imp.

ImpExt

Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
billing_id Oui Tableau int64 BidRequest.AdSlot.MatchingAdData.billing_id ID de facturation correspondant aux configurations de préciblage correspondantes.
publisher_settings_list_id Oui Tableau de fixed64 BidRequest.publisher_settings_list_id
BidRequest.AdSlot.publisher_settings_list_id
ID de la liste des paramètres éditeur applicable à cette page. Pour en savoir plus, consultez le guide Paramètres éditeur du système d'enchères en temps réel.
allowed_vendor_type Non Tableau de 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 soumettez une enchère avec l'une des créations de cette liste, celle-ci 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 fournies par l'éditeur dans le cadre des configurations de groupe de rendement correspondantes dans l'interface utilisateur d'Ad Manager. Ce format est arbitraire et doit être convenu entre 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, cette option n'est définie que pour les demandes Open Bidding.
is_rewarded_inventory Non Bool BidRequest.AdSlot.is_rewarded 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 un article de presse supplémentaire sans frais, de bénéficier d'une vie supplémentaire dans un jeu ou 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.
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 relatives aux 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 standards sont autorisées, mais pas les annonces AMP.

AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4. Les annonces AMP ou standards sont autorisées, et les annonces AMP s'affichent de manière anticipée.

AMP_AD_REQUIRED = 5 ; les annonces AMP sont obligatoires. 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é uniquement: 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) si elle remporte la mise aux enchères, par rapport à la probabilité que d'autres enchères génèrent un événement facturable s'il remporte la mise aux enchères. Cet ajustement peut être supérieur ou inférieur à 1. Cela n'affecte que le classement final lors de la mise aux enchères. En particulier, ce multiplicateur n'affecte pas le paiement. Par défaut = 1.0.
open_bidding Non Objet OpenBidding BidRequest.AdSlot.open_bidding Paramètres associés à Open Bidding.
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 compatibles avec l'attribution d'installation d'application 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.ExcludedCreative.buyer_creative_id ID de la création de l'acheteur associée à la création non autorisée.
BuyerGeneratedRequestData
data Non chaîne BidRequest.AdSlot.SecureSignal.data Signal de sécurité.
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 ayant généré ces données. Il correspondra à l'ID 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 notre Centre d'aide pour en savoir plus sur Open Bidding et ses effets sur le processus d'enchères.
Demande SKAdNetwork
version Non chaîne BidRequest.Mobile.skadn.version Obsolète. Elle sera supprimée en novembre 2022. Utilisez BidRequest.imp.ext.skadn.versions à la place.

Version de SKAdNetwork compatible. Dépend de la version du système d'exploitation et de la version du SDK.

versions Non Tableau de chaînes BidRequest.Mobile.skadn.versions Liste de toutes les versions de SKAdNetwork compatibles avec la demande, en fonction de la version du système d'exploitation 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.

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, qui permettent de prendre des décisions, telles que la visibilité moyenne moyenne, le taux de clics, etc. Chaque métrique est identifiée par son type, enregistre la valeur de la métrique et identifie éventuellement la source ou le fournisseur mesurant la valeur.

Attribut Toujours transmis Type Acheteurs
autorisés
équivalents
Autorisé Détails de mise en œuvre
dans la version par Google
type Non chaîne L'un des éléments suivants :
BidRequest
.AdSlot
.viewability

BidRequest
.AdSlot
.click_
through_rate

BidRequest
.AdSlot
.video_
completion_rate

BidRequest
.AdSlot
.session_depth
2.5 Type de métrique présentée à l'aide de noms de chaîne sélectionnés par l'échange, qui doivent être publiés au préalable pour les enchérisseurs. OBLIGATOIRE par la spécification OpenRTB. Les types de fichiers acceptés sont les suivants : click_through_rate, viewability, completion_rate et session_depth.
value Non double Valeur comprise entre 0 et 1. 2.5 Nombre représentant la valeur de la métrique. Les probabilités doivent être comprises entre 0 et 1. OBLIGATOIRE par la spécification OpenRTB. La métrique viewability est une fraction comprise entre 0,00 et 1,00 dans la métrique OpenRTB, mais elle est exprimée en pourcentage [0-100] dans le protocole AdX.
vendor Non chaîne EXCHANGE 2.5 Source de la valeur à l'aide de noms de chaîne d'échange sélectionnés qui doivent être publiés au préalable pour les enchérisseurs. Si la place de marché elle-même est la source et non une tierce, il est recommandé d'utiliser "EXCHANGE". RECOMMANDÉ par la spécification OpenRTB.

Cet objet représente le type d'impression le plus général. Même si le terme "bannière" peut avoir une signification très spécifique dans d'autres contextes, il peut s'agir de nombreux éléments, par exemple une simple image statique, un bloc d'annonces extensible ou même une vidéo InBanner (consultez l'objet Video pour découvrir les blocs d'annonces vidéo les 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'une sous-classe Banner en tant qu'élément subordonné de l'objet Imp indique que cette impression est proposée en tant qu'impression de type bannière. À la discrétion de l'éditeur, cette même impression peut également être proposée en tant que vidéo et/ou native en incluant également les objets Imp subordonnés Video et/ou Native. Cependant, chaque enchère pour l'impression doit être conforme à l'un des types proposés.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé 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, c'est une largeur préférée.
h Non int32 BidRequest.AdSlot.height[0] 2,3
2,4
2,5


Hauteur en pixels indépendants des appareils (DIPS). Si aucun objet Format n'est spécifié, il s'agit d'une exigence de hauteur exacte. Sinon, il s'agit d'une hauteur à privilégier.
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 attribut n'est spécifié, nous vous recommandons vivement 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 des 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_visibility
BidRequest.StickySettings.
2,3
2,4
2,5


Cette table OpenRTB comporte des valeurs dérivées des consignes du contrôle qualité de l'IAB. Les professionnels doivent se synchroniser avec les mises à jour des valeurs de contrôle qualité, telles qu'elles ont été publiées sur IAB.net. Les valeurs "4" à "7" s'appliquent aux applications conformément à l'avenant relatif à la version 1.5.

Banner.pos n'accepte qu'une seule valeur. Si la valeur est is_sticky, Banner.pos est renseigné avec le niveau d'adhésion. Si unknown_stickiness, slot_visibility est utilisé. La position fixe indique que la bannière s'affiche systématiquement, tandis que la visibilité dans la partie au-dessus ou en dessous de la ligne de flottaison peut changer lorsque l'utilisateur fait défiler la page.

Les valeurs possibles sont les suivantes :

ABOVE_THE_FOLD = 1;

BELOW_THE_FOLD = 3;

HEADER = 4;
Équivaut à sticky_settings.top_horizontal_stickiness dans le protocole RTB d'Authorized Buyers.

FOOTER = 5;
Équivaut à sticky_settings.bottom_horizontal_stickiness dans le protocole RTB d'Authorized Buyers.

SIDEBAR = 6;
Équivaut à sticky_settings.vertical_stickiness dans le protocole RTB d'Authorized Buyers.

btype Non Tableau de l'énumération BannerAdType Non compatible 2.5 Types de bannières bloqués

Exemples:
XHTML_TEXT_AD = 1; // "Habituellement mobile".
XHTML_BANNER_AD = 2; // "Généralement mobile".
JAVASCRIPT_AD = 3; // JavaScript doit être un code 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 seulement pour BidRequest.Video.companionad : BidRequest.Video.companionad.creative_format
BidRequest.AdSlot.excluded_attribute / VPAID
2,3
2,4
2,5


Liste d'autorisation des types MIME de contenu acceptés. Les types MIME les plus courants incluent, sans s'y limiter : "image/jpg", "image/gif" et "application/x-shockwave-flash".
topframe Non Bool BidRequest.AdSlot.iframe_state

NO_IFRAME: false
SAME_DOMAIN_IFRAME, CROSS_DOMAIN_IFRAME: true

2,3
2,4
2,5


Spécifiez si la bannière est diffusée dans le cadre supérieur (vrai) ou dans un cadre iFrame (faux).
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 avec 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 2.5 Pertinent uniquement pour les objets Banner utilisés avec un objet Video dans un tableau d'annonces associées. Indique le mode d'affichage de la bannière associée par rapport à la vidéo associée, où 0 = mode simultané, 1 = carte de fin. Nous n'acceptons actuellement que les fiches de fin sur les interstitiels vidéo pour les 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. Ils sont généralement utilisés dans un tableau pour une impression où plusieurs tailles sont autorisées.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé 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 des appareils (DIPS).
wratio Non int32 Non compatible 2.5 Largeur relative lors de l'expression de la taille sous forme de ratio.
hratio Non int32 Non compatible 2.5 Hauteur relative lorsque la taille est exprimée sous forme de ratio.
wmin Non int32 Non compatible 2.5 Largeur minimale en pixels indépendants de l'appareil (DIPS) auxquels l'annonce sera affichée lorsque la taille est exprimée en ratio.

Vidéo

Cet objet représente une impression vidéo InStream. La plupart des champs ne sont pas essentiels aux transactions minimales viables, mais ils sont inclus pour offrir un contrôle précis si nécessaire. Dans OpenRTB, la vidéo est généralement conforme à la norme VAST. Ainsi, la notion d'annonce associée est acceptée par l'ajout facultatif d'un tableau d'objets Banner qui définissent ces annonces associées.

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

Pour en savoir plus, consultez le guide des 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.AdSlotexcluded_attribute / VPAID
2,3
2,4
2,5


Liste d'autorisation des types MIME de contenu acceptés. Parmi les types MIME les plus courants figurent, entre autres, "image/jpg", "image/gif" et "application/x-shockwave-flash".

OBLIGATOIRE conformément à 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, supposez 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.protocols. 2,3
2,4
2,5


Tableau des protocoles de réponse aux enchères vidéo compatibles.

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 des appareils (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 des appareils (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émarrage en secondes des emplacements d'annonces vidéo pré-roll, mid-roll ou post-roll. Reportez-vous à l'énumération StartDelay pour connaître les valeurs génériques.

RECOMMANDÉ par la spécification OpenRTB.

skip Non Bool BidRequest.Video.video_ad_skippable. 2,4
2,5

Indique si le lecteur peut 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 "attr" et un élément "16" indiquant la 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. Ne s'applique que si l'annonce est désactivable.
skipafter Non int32 Non compatible 2,4
2,5

Nombre de secondes pendant lesquelles une vidéo doit être lue avant d'ignorer l'annonce. Ne s'applique 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 une 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 étendue, si l'extension est autorisée. Si ce champ est vide ou 0, 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 elle est supérieure à 0, la valeur représente le nombre de secondes d'écoute prolongée autorisée au-delà de la valeur "maxduration".
minbitrate Non int32 Non compatible 2,3
2,4
2,5


Débit minimal en Kbit/s.
maxbitrate Non int32 Non compatible 2,3
2,4
2,5


Débit maximal en Kbit/s.
boxingallowed Non Bool Non compatible 2,3
2,4
2,5


Indique si le format letterbox est autorisé dans une fenêtre 16:9 (0 = non, 1 = oui).
default = true
playbackmethod Non Tableau de la méthode de
lecture
BidRequest.Video.playback_méthode

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


Modes de lecture actuellement utilisés Si aucune n'est spécifiée, n'importe quelle méthode peut être utilisée. 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. Il est fortement recommandé d'utiliser uniquement le premier élément de ce tableau en vue de ce changement.

AUTO_PLAY_SOUND_ON = 1: démarre lors du chargement de page avec le son.
AUTO_PLAY_SOUND_OFF = 2: l'application se lance lors du chargement de la page, avec le son désactivé par défaut.
CLICK_TO_PLAY = 3: se lance en un clic avec le son activé.
MOUSE_OVER = 4: ouverture au passage du curseur de la souris avec le son activé.
ENTER_SOUND_ON = 5: ouvre la fenêtre d'affichage avec le son activé.
ENTER_SOUND_OFF = 6: ouvre la fenêtre d'affichage sans le son par défaut.

delivery Non Tableau
ContentDelivery
Method
Non compatible 2,3
2,4
2,5


Modes de diffusion compatibles (par exemple, streaming, progressive) Si aucune valeur n'est spécifiée, supposons que tous les éléments soient pris en charge.
STREAMING = 1;
PROGRESSIVE = 2;
pos Non AdPosition BidRequest.AdSlot.slot_visibility. 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 avec 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 compatibles Recommandé si les objets Banner associés sont inclus via le tableau companionad.
placement Non VideoPlacementType BidRequest.VideoPlacement

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{/14)

2.5

Type d'emplacement pour l'impression.

UNDEFINED_VIDEO_PLACEMENT: l'emplacement vidéo n'est pas défini. Valeur par défaut.
IN_STREAM_PLACEMENT : contenu 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, par opposition à un autre format statique ou rich media. Ce format repose sur l'existence de l'inventaire d'annonces display sur la page pour sa diffusion.
IN_ARTICLE_PLACEMENT: se charge et lit dynamiquement entre les paragraphes du contenu éditorial. Il existe déjà un message de marque autonome.
IN_FEED_PLACEMENT: In-Feed, disponible dans les flux de contenu, réseaux sociaux et produits.
FLOATING_PLACEMENT : interstitiel/curseur/Flash transparent. Recouvre tout ou partie de la zone de l'écran, mais reste toujours à l'écran lors de l'affichage (par exemple, il est impossible de faire défiler la page hors du champ de vision). Notez qu'un interstitiel en plein écran (par exemple, sur mobile) se distingue d'un bloc Flash transparent/curseur par le champ imp.instl.

playbackend Non PlaybackCessationMode Non compatible 2.5 Événement entraînant la fin de la lecture.

Son

Cet objet représente une impression de type audio. La plupart des champs ne sont pas essentiels aux transactions minimales viables, mais ils sont inclus pour offrir un contrôle précis si nécessaire. Dans OpenRTB, le contenu audio est généralement conforme à la norme DAAST. Ainsi, la notion d'annonce associée est acceptée par l'inclusion facultative d'un tableau d'objets Banner qui définissent ces annonces associées. La présence d'un objet Audio en tant que subordonné de l'objet Imp indique que cette impression est proposée en tant qu'impression de type audio. À la discrétion de l'éditeur, la 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, chaque enchère pour l'impression doit être conforme à l'un des types proposés.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
mimes Non Tableau de chaînes BidRequest.Video.allowed_video_formats, BidRequest.AdSlot.excluded_attribute / VPAID 2,4
2,5

Types MIME pour le contenu acceptés (par exemple, "audio/mp4")

OBLIGATOIRE conformément à 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.protocols. 2,4
2,5

Tableau des protocoles de réponse aux enchères vidéo compatibles. 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émarrage en secondes des emplacements d'annonces vidéo pré-roll, mid-roll ou post-roll. Reportez-vous à l'énumération StartDelay pour connaître 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 une 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 étendue, si l'extension est autorisée. Si ce champ est vide ou 0, 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 elle est supérieure à 0, la valeur représente le nombre de secondes de lecture étendue acceptée au-delà de la valeur maxduration.
minbitrate Non int32 Non compatible 2,4
2,5

Débit minimal en Kbit/s.
maxbitrate Non int32 Non compatible 2,4
2,5

Débit maximal en Kbit/s.
delivery Non Tableau d'objets ContentDeliveryMethod Non compatible 2,4
2,5

Modes de diffusion compatibles (par exemple, streaming, progressive) Si aucune valeur n'est spécifiée, supposons que tous les éléments soient pris en charge.

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 avec 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 compatibles.
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 livré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

Natifs

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

Notez que Native 1.1 est compatible avec OpenRTB 2.4 et OpenRTB 2.5.

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

Cet objet fournit le moyen de transporter les paramètres de demande sous la forme d'une chaîne opaque afin que les paramètres spécifiques puissent évoluer séparément selon les spécifications de l'annonce native. De même, le balisage des annonces est structuré selon ces spécifications. La présence d'une valeur Native en tant que sous-classe de l'objet Imp indique que cette impression est proposée en tant qu'impression de type natif. À la discrétion 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 des objets Imp subordonnés Banner et/ou Video. Cependant, chaque enchère pour l'impression doit être conforme à l'un des types proposés.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé 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 une charge utile conforme aux spécifications des annonces natives.

Vous devez utiliser exactement l'un des éléments {request, request_native}.

request_native Non Demande native Modèle BidRequest.AdSlot.NativeAd 2,3
2,4
2,5


Demandez une charge utile conforme aux spécifications des annonces natives. Vous ne devez utiliser qu'un seul champ {request, request_native}. Il s'agit d'un autre champ, de préférence 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 est conforme. 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 avec 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.

Fichier PMP

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

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé 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 d'éligibilité à la mise aux enchères pour les postes 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.CorrespondanceAdData.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 ayant été priorisé 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 Autorisé 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 par 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 de la billing_id incluse 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 cela est autorisé par le paramètre exchange.default = "USD".
wseat Non Tableau de chaînes Non compatible 2,3
2,4
2,5


Liste des licences utilisateur (annonceurs, agences, etc.) autorisées à enchérir sur cet accord. ID des sièges et connaissance de la

Les clients auxquels ils font référence doivent être coordonnés entre les enchérisseurs et la place de marché a priori. Une absence de restriction de siège 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 de demande d'enchère 2,3
2,4
2,5


Remplacement facultatif du type de mise aux enchères global de la demande d'enchère, où 1 = First Price, 2 = Second Price Plus, 3 = la valeur transmise dans "bidfloor" correspond au prix 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 accédez au champ ext dans le message de l'accord.

DealExt

Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
deal_type Non Énumération DealType BidRequest.AdSlot.MatchingAdData.DirectDeal.deal_type Type d'accord. Notez que les remplacements de règles Authorized Buyers s'appliquent à toutes les enchères reposant sur le programmatique garanti et les accords préférés, et non aux autres types d'accords.

UNKNOWN_DEAL_TYPE = 0 ; valeur par défaut.

PREFERRED_DEAL = 1 ; Les enchères sont à prix fixe et évaluées avant l'enchère ouverte. Les enchérisseurs ne sont pas tenus de définir des enchères avec des accords préférés lorsqu'ils figurent dans la demande d'enchère. Pour en savoir plus, consultez cet article.

PRIVATE_AUCTION = 2; Les enchères participent à une enchère privée avec une liste spécifique d'acheteurs avec des prix planchers spécifiques. Pour en savoir plus, consultez cet article.

PROGRAMMATIC_GUARANTEED = 3 ; les enchères sont associées à un prix fixe et sont évaluées avant l'enchère ouverte. Les enchérisseurs doivent définir des enchères 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" (vrai) pour s'assurer que le nombre d'impressions convenu pour un accord donné est diffusé. Pour en savoir plus, consultez cet article.

AUCTION_PACKAGE = 4; L'ID d'accord identifie un ensemble d'inventaires d'enchères ouvertes correspondant à un ensemble donné de critères de ciblage. 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 les enchères sur l'impression si ce champ est faux. Lorsque la valeur est "true", l'acheteur doit enchérir sur cet accord pour cette opportunité d'impression. Ce champ sera toujours rempli explicitement pour le format de fil JSON. Par défaut = true.
publisher_blocks_overridden Non Bool BidRequest.AdSlot.MatchingAdData.DirectDeal.publisher_blocks_overridden. Indique si l'éditeur a exempté 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 ; susceptible d'être modifié. Énumération déclarant l'hôte de la création, qui 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 le système d'enchères est tenu de 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 la page https://support.google.com/admanager/answer/9243220. Cette fonctionnalité n'est actuellement pas disponible pour les enchérisseurs RTB.

Site

Cet objet doit être inclus si le contenu compatible avec les annonces 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 Autorisé Détails de mise en œuvre
dans la version par Google
id Non chaîne Non compatible 2,3
2,4
2,5


ID de 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. Par exemple, "foo.com".
cat Non Tableau de chaînes Non compatible 2,3
2,4
2,5


Tableau des catégories de contenu IAB du 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 décrivant 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 en cours 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 dispose de 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 généré une 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 demande d'enchère 2,3
2,4
2,5


Détails sur l'objet Publisher du site.
content Non Objet Content demande d'enchère 2,3
2,4
2,5


Détails sur le Content dans le 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 l'implémentation d'un tableau de chaînes, mais ce problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit à nouveau d'une chaîne unique avec du contenu CSV. La compatibilité avec certains échanges OpenRTB 2.2 ayant adopté une autre représentation peut nécessiter un traitement personnalisé 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 lorsqu'il est consulté sur des 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. Il s'agit d'une page AMP.

page_visibility Non Énumération VisibilitéState BidRequest.page_visibility

État de visibilité de la page Web contenant l'espace publicitaire. Consultez la page www.w3.org/TR/page-visibility/.

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 ouverte dans un onglet en arrière-plan du navigateur ou dans une fenêtre réduite).

is_semi_transparent_request Non Bool BidRequest.is_semi_transparent_request Indique que la requête utilise un branding semi-transparent, ce qui signifie qu'une seule version tronquée de l'URL de la requête sera fournie. Cette décision est prise par l'éditeur. Pour en savoir plus, consultez la page support.google.com/admanager/answer/4584891.

Application

Cet objet doit être inclus 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 ce n'est pas obligatoire.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
id Non chaîne Non compatible 2,3
2,4
2,5


ID d'application sur la place de marché. RECOMMANDÉ par la spécification OpenRTB.
name Non chaîne BidRequest.Mobile.app_name (nom de l'application) 2,3
2,4
2,5


Nom de l'application (peut être associé à un 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. Par exemple, "mygame.foo.com".
cat Non Tableau de chaînes BidRequest.Mobile.app_category_ids 2,3
2,4
2,5


Remarque : Les valeurs de ce champ sont maintenant masquées. Tableau des catégories de contenu IAB de l'application. Voir 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. Voir 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 unique à l'application et indépendant de la place de marché. Sur Android, il doit s'agir d'un nom de groupe ou de package (par exemple, com.foo.mygame). Sur iOS, il s'agit d'un ID numérique.
privacypolicy Non Bool Non compatible 2,3
2,4
2,5
Indique si le site dispose de règles de confidentialité, où 0 = non, 1 = oui.
paid Non Bool Non compatible 2,3
2,4
2,5
0 = application offerte, 1 = application payante.
publisher Non Objet Publisher demande d'enchère 2,3
2,4
2,5


Détails sur l'objet Publisher de l'application.
content Non Objet Content demande d'enchère 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 pour cette application. Remarque: OpenRTB 2.2 permettait d'utiliser un ensemble de chaînes comme implémentation alternative, mais le problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit à nouveau d'une seule chaîne avec du contenu CSV. La compatibilité avec certains échanges OpenRTB 2.2 ayant adopté une autre représentation peut nécessiter un traitement personnalisé du fichier JSON.
storeurl Non chaîne BidRequest.url 2,3
2,4
2,5


URL de la plate-forme de téléchargement associée à 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 au champ ext dans le message de l'application.

AppExt

Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
installed_sdk Non SDK installé BidRequest.Mobile.Installed_sdk Informations sur un SDK installé dans l'application de l'éditeur et auxquelles l'enchérisseur a accès, souvent parce qu'il s'agit du SDK de l'enchérisseur.
SDK installé
id Oui chaîne BidRequest.Mobile.InstalledSdk.id Identifiant du SDK installé.
sdk_version Oui Version BidRequest.Mobile.InstalledSdk.sdk_version Version du SDK installé.
adapter_version Oui Version BidRequest.Mobile.InstalledSdk.adapter_version Version de l'adaptateur qui communique avec le SDK installé.
Version
major Non int32 Non compatible Par défaut = -1.
minor Non int32 Non compatible Par défaut = -1.
micro Non int32 Non compatible 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 dans une transaction OpenRTB.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
id Non chaîne BidRequest.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 du code du site Web. Par exemple, pub-123 est le code de l'éditeur du code du site Web ca-pub-123.
name Non chaîne Non compatible 2,3
2,4
2,5
Nom de l'éditeur (peut être associé à un 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. Voir l'énumération ContentCategory.
domain Non chaîne Non compatible 2,3
2,4
2,5
Domaine de premier niveau 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 accédez 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. Ce nom peut être différent du pays détecté pour 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 BidRequest.host_publisher_id ID de l'éditeur hôte. Si ce champ est renseigné, indique que l'éditeur hôte a participé au partage des revenus. Cet ID peut être utilisé pour autoriser ads.txt.

Contenu

Cet objet décrit le contenu dans lequel l'impression apparaîtra, qui peut être syndiqué ou non. 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 une connaissance de 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 Autorisé 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 de contenu (s'applique généralement 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 non vidéo : "Why an Antarctic Glacier Is Fondting So Quickly" (article de 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 magazine Time)

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é du contenu
genre Non chaîne Non compatible 2,3
2,4
2,5
Genre qui décrit 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 (BidRequest App.content uniquement) BidRequest.url 2,3
2,4
2,5


URL du contenu, à des fins de contextualisation ou d'examen côté acheteur.
cat Non Tableau de chaînes Non compatible 2,3
2,4
2,5
Tableau des catégories de contenu 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 autorisait l'utilisation d'un tableau de chaînes comme version alternative. Ce problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit à nouveau d'une chaîne unique avec du contenu CSV. La compatibilité avec certaines places de marché OpenRTB 2.2 qui ont adopté une autre représentation peut nécessiter un traitement personnalisé 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 les utilisateurs (par exemple, nombre d'étoiles, "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


OpenRTB <= 2.2 ; compatibilité avec le contexte 2.3+.
livestream Non Bool BidRequest.Video.is_livestream 2,3
2,4
2,5


0 = non diffusé, 1 = contenu diffusé 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 BidRequest.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 ; adaptée au contenu vidéo ou audio.
qagmediarating Non QAGMediaRating Non compatible 2,3
2,4
2,5


Classification du support conformément aux consignes de contrôle qualité.
embeddable Non Bool Non compatible 2,3
2,4
2,5


Indique 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


Langue du contenu en 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 donc lorsque le producteur et l'éditeur ne sont pas nécessairement la même entité.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé 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'émetteur 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 contenu 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 premier niveau du producteur de contenu (par exemple, "producer.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 Autorisé 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 (AdX tronque les 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 demande d'enchère 2,3
2,4
2,5


La position de l'appareil correspond à 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 de l'appareil (par exemple, code IMEI) haché sous SHA1
didmd5 Non chaîne Non compatible 2,3
2,4
2,5


ID de l'appareil (par exemple, code IMEI) haché sous MD5.
dpidsha1 Non chaîne Non compatible 2,3
2,4
2,5


ID d'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 (hexa version en minuscules)
Il s'agit de la version hachée d'ifa.
Dpidmd5 ou ifa sont disponibles
selon la version du SDK pour mobile.
2,3
2,4
2,5


ID de l'appareil de la plate-forme (par exemple, ID Android) haché via MD5.
ipv6 Non chaîne BidRequest.ip

- AdX tronque 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 de critère 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 de place de marché qui doivent être publiés a priori auprès des enchérisseurs.
language Non chaîne Non compatible 2,3
2,4
2,5


Langue du navigateur utilisant 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 général d'appareil.
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 2,3
2,4
2,5


ID sanctionné pour une utilisation par l'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


Signal "Limiter le suivi des annonces" commercialement approuvé (iOS, Android, par exemple), où 0 = le suivi est illimité, 1 = le suivi doit être limité conformément aux consignes commerciales.

RECOMMANDÉ par la spécification OpenRTB.

mccmnc Non chaîne Non compatible 2.5 Opérateur mobile utilisé comme code MCC-MNC concaténé (par exemple, "310-005" identifie CDMA Verizon Wireless 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 CM 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 accédez au champ ext du message de l'appareil.

DeviceExt

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 les appareils pour la TV connectée/le service de distribution par contournement (OTT, over-the-top) avec une durée maximale de six heures. L'utilisation de session_id n'est jamais autorisée pour personnaliser les 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 d'application, où 0 = non déterminé 1 = restreint 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'agent utilisateur.
UserAgent

Informations sur l'agent utilisateur. Il sera renseigné avec des informations sur le 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 Vraie si l'agent préfère le contenu "optimisé pour les mobiles". Reportez-vous au champ BidRequest.device pour obtenir des informations spécifiques à l'appareil, qui peuvent être cohérentes avec ce champ (par exemple, si le navigateur d'un téléphone mobile demande "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 Débit d'image des appareils (par exemple, "64" pour une architecture 64 bits).
model Non chaîne BidRequest.user_agent_data.model Modèle de l'appareil.
Objet BrandVersion

Un tuple de (marque, version) pour le navigateur ou 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, scindez les 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, qui peut également être interprétée comme la position actuelle de l'utilisateur. Lorsqu'il est subordonné à un objet User, il indique la position de la base d'accueil de l'utilisateur (par exemple, pas nécessairement sa position actuelle). Les attributs lat/lon ne doivent être transmis que s'ils respectent la précision indiquée dans l'attribut type. Par exemple, le centroïde d'une région géographique telle que le code postal ne doit pas être transmis.

Remarque concernant le protocole d'enchères en temps réel d'Authorized Buyers: les informations de géolocalisation précises sont limitées par les mêmes contraintes que celles qui s'appliquent à l'objet Hyperlocal d'Authorized Buyers. Toutes les requêtes ne disposent pas de cette information et lat/lon représentent un point (pas nécessairement le centre) d'une zone dont la taille est inversement proportionnelle à la densité de population. C'est suffisant pour le ciblage, mais pas pour le suivi individuel.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
lat Non double BidRequest.[encrypted_]hyperlocal_set.
center_point.latitude
2,3
2,4
2,5


Latitude de -90,0 à +90,0, où la valeur négative est sud.
lon Non double BidRequest.[encrypted_]hyperlocal_set.center_point.longitude 2,3
2,4
2,5


Longitude de -180,0 à +180,0, où la valeur négative est ouest.
country Non chaîne BidRequest.geo_criteria_id via geo-table.csv 2,3
2,4
2,5


Pays utilisant la norme alpha-3 ISO-3166-1.
region Non chaîne BidRequest.geo_criteria_id via geo-table.csv 2,3
2,4
2,5


Code régional à l'aide de la norme ISO-3166-2 ; code à deux lettres pour les États-Unis.
regionfips104 Non chaîne 2,3
2,4
2,5


Région d'un pays utilisant la norme 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, Cities-dma-regions.csv 2,3
2,4
2,5


Code d'agglomération Google ; similaire aux DMA 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 au format "city": "San Antonio", code des Nations Unies pour les échanges commerciaux et les transports. Reportez-vous à l'annexe A pour obtenir le lien d'accès aux 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é pour transmettre les coordonnées de 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 de la précision indiquée par l'appareil. Consultez la documentation spécifique au système d'exploitation (par exemple, Android, iOS) pour une interprétation exacte.
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 sur plusieurs récupérations. Idéalement, cette valeur doit correspondre au moment où le correctif a été pris.

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.timezone_offset 2,3
2,4
2,5


Heure locale en tant que nombre +/- de minutes à partir de UTC.

Utilisateur

Cet objet contient des informations connues ou dérivées concernant l'utilisateur humain de l'appareil (par exemple, l'audience publicitaire).L'ID utilisateur est un artefact de place de marché qui peut être soumis à une rotation ou à d'autres règles de confidentialité. Toutefois, cet ID utilisateur doit être suffisamment long pour pouvoir servir de base pour la limitation du nombre d'expositions et le reciblage.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé 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 la place de marché. Il est recommandé d'utiliser au moins id ou buyerid
buyeruid Non chaîne BidRequest.[constrained_usage_]hosted_match_data - AdX est binaire, OpenRTB est au format base64 adapté au Web (sans remplissage). 2,3
2,4
2,5


ID spécifique à l'acheteur pour l'utilisateur, tel qu'il est mappé par la place de marché de l'acheteur. Il est recommandé 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) (Aucune valeur indiquée 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'intention, séparés par une virgule. Remarque: OpenRTB 2.2 permettait l'implémentation d'un tableau de chaînes, mais ce problème a été corrigé dans les versions 2.3 et ultérieures, où il s'agit à nouveau d'une chaîne unique avec du contenu CSV. La compatibilité avec certains échanges OpenRTB 2.2 ayant adopté une autre représentation peut nécessiter un traitement personnalisé du fichier JSON.
customdata Non chaîne BidRequest.[constrained_usage_]hosted_match_data - AdX est binaire, OpenRTB est au format base64 adapté au Web (sans remplissage). 2,3
2,4
2,5


Fonctionnalité facultative permettant de transmettre des données d'enchères dans le cookie de la place de marché. La chaîne doit être rédigée en caractères base85 et être acceptée dans n'importe quel format. Un encodage JSON approprié doit être utilisé pour inclure des guillemets "échappés".
geo Non Objet Geo Non compatible 2,3
2,4
2,5


Emplacement de la base personnelle de l'utilisateur définie par un objet Geo. Il ne s'agit pas nécessairement de 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 l'échange.

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 au champ ext dans le message "Utilisateur".

UserExt

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 la personnalisation des annonces conformément aux règles de Google relatives au consentement de l'utilisateur dans l'UE. Ce champ n'est renseigné que lorsque "RegsExt.gdpr" est défini sur "true".
consent Non chaîne BidRequest.AdSlot.ParamètresConsentedProviders.tcf_consent_string Chaîne Consent Framework vCF (TCF) v2 encodée en base64 adaptée au Web et sécurisée, extraite de la plate-forme de gestion du consentement de l'éditeur (CMP). 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 la version 2 du TCF et que celle-ci indique que le RGPD s'applique à cette demande d'annonce et qu'il fournit une chaîne de consentement valide. Consultez cet article pour en savoir plus sur l'intégration de la version 2 du TCF de Google.

Consultez la liste globale des fournisseurs de l'IAB à l'adresse 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 des signaux sécurisés choisis par l'éditeur.
ConsentedProviderSettings

Informations sur les fournisseurs de technologie publicitaire pour lesquels l'éditeur a indiqué à Google que son utilisateur de l'EEE a consenti à la personnalisation de ses données à caractère personnel conformément aux règles de Google 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 int64 BidRequest.AdSlot.consented_providers Ensemble d'ID correspondant à des fournisseurs de technologie publicitaire pour lesquels l'éditeur a indiqué à Google que ses utilisateurs situés dans l'EEE ont consenti légalement à: 1) utiliser des cookies ou tout autre stockage local lorsque la législation l'impose ; et 2) collecter, partager et utiliser des données à caractère personnel pour personnaliser les annonces par un fournisseur de technologie publicitaire, conformément aux règles de Google relatives au consentement de l'utilisateur dans l'UE.

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 ATP 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 ATP autorisés via la chaîne de consentement du TCF v2 sont représentés dans le champ UserExt.consent.

Un mappage entre l'ID ATP et le nom ATP est publié dans le fichier provider.csv.

IDÉtendu

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 de sécurité.
ExtendedIdUid
Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
id Non chaîne BidRequest.AdSlot.SecureSignal.data Signal de sécurité.

Données

Les objets data et segment combinés permettent de spécifier des données contextuelles supplémentaires. Ces données peuvent provenir de plusieurs sources, qu'elles proviennent de la place de marché elle-même ou de fournisseurs tiers, comme spécifié dans le champ id. Une demande d'enchère peut combiner des objets de données provenant 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, ce champ permet également d'envoyer des paires clé-valeur de l'éditeur à l'acheteur.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
id Non chaîne Autorisé 2,3
2,4
2,5


ID spécifique au place de marché pour le fournisseur de données.
name Non chaîne Autorisé 2,3
2,4
2,5


Nom spécifique au place de marché pour le fournisseur de données.
segment Tableau d'objets Segment Autorisé 2,3
2,4
2,5


Tableau d'objets Segment contenant les valeurs de données réelles.

Segment

Les objets data et segment combinés permettent de spécifier des données contextuelles supplémentaires. Ces données peuvent provenir de plusieurs sources, qu'elles proviennent de la place de marché elle-même ou de fournisseurs tiers, comme spécifié 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 ses enchérisseurs.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
id Non chaîne Autorisé 2,3
2,4
2,5


ID du segment de données propre au fournisseur de données.
name Non chaîne Autorisé 2,3
2,4
2,5


Nom du segment de données propre au fournisseur de données.
value chaîne Autorisé 2,3
2,4
2,5


Représentation, sous forme de chaîne, de la valeur du segment de données.

Expressions régulières

Cet objet contient toutes les réglementations légales, gouvernementales ou sectorielles applicables à la requête. L'option coppa indique si la requête est conforme aux réglementations de la Federal Trade Commission des États-Unis (Federal Trade Commission) pour la loi COPPA (Children's Online Privacy Protection Act) des États-Unis. Reportez-vous à la section 7.1 pour plus d'informations.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé 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 loi COPPA établie par la FTC américaine, 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 accédez au champ ext dans le message Regs.

Expression régulière

Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
gdpr Non Bool BidRequest.AdSlot.regs_gdpr Ce champ sera défini sur "true" dans les deux cas suivants :
  1. Google reçoit une chaîne de consentement valide de la version 2 du Transparency and Consent Framework (TCF) de l'IAB. La plate-forme de gestion du consentement indique que le RGPD s'applique à cette demande d'annonce.
  2. Google ne reçoit pas de chaîne de consentement de la version 2 du TCF de l'IAB. Selon les informations à sa disposition, cette impression sera diffusée auprès d'un utilisateur de l'EEE.
Il ne constitue pas une assistance juridique sur le RGPD.
lgpd Non Bool BidRequest.AdSlot.regs_lgpd Ce champ sera défini sur "true" si, selon les informations disponibles sur Google, cette impression sera diffusée auprès d'un utilisateur situé au Brésil. 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 requêtes en vertu de la loi LGPD.

Pour en savoir plus sur la loi LGPD, consultez cet article.

Variables et définitions de réponse aux enchères

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

BidResponse

Cet objet est l'objet de réponse d'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ères à des fins de journalisation. De même, bidid est un ID de suivi de réponse facultatif pour les enchérisseurs. Si elle est spécifiée, elle peut être incluse dans l'appel de notification de victoire suivant si l'enchérisseur gagne. 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 expression "sans enchère", renvoyez une réponse vide avec HTTP 204. Sinon, si l'enchérisseur souhaite communiquer à la place de marché un motif de ne pas définir d'enchère, seul un objet BidResponse est renvoyé avec un code de motif dans l'attribut nbr.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
id Oui chaîne Non mappé sur 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 par la spécification OpenRTB.

seatbid Non Tableau d'objets Seatbid BidResponse.Ad 2,3
2,4
2,5


Tableau de Seatbid objets ; un minimum est requis si une enchère doit être définie.
bidid Non chaîne BidResponse.debug_string 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


Devise de l'enchère en utilisant les 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 par défaut des enchères sera utilisée, ce qui est déterminé selon la priorité suivante:

  1. Devise au niveau du système d'enchères, si elle est configurée dans les paramètres de compte RTB.
  2. Devise au niveau de l'acheteur. S'il est renseigné, l'acheteur est déterminé par l'ID de facturation spécifié dans le champ de l'extension BidResponse.seatbid.bid.ext.billing_id. 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 au moment de la création du compte. Vous pouvez vérifier cette information 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 rédigée en caractères base85 et être acceptée dans n'importe quel format. L'encodage JSON approprié doit être utilisé pour inclure des guillemets "échappés".
nbr Non NoBidReason Non compatible 2,3
2,4
2,5


Motif de non-enchère.
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 accédez au champ ext dans le message BidResponse.

BidResponseExt

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

Seatbid

Une réponse à l'enchère peut contenir plusieurs objets SeatBid, chacun représentant un compte d'enchérisseur différent et chacun contenant une ou plusieurs enchères individuelles. Si la requête contient plusieurs impressions, vous pouvez utiliser l'attribut "group" 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 remporter l'une des impressions que s'il peut toutes les remporter en tant que groupe.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
bid Non Tableau d'objets Bid BidResponse.Ad 2,3
2,4
2,5


Tableau d'au moins un objet Bid associé à une impression. Plusieurs enchères peuvent être associées à la même impression.
seat Non chaîne BidResponse.Ad.
AdSlot.buyer_reporting_id
2,3
2,4
2,5


ID du siège de l'acheteur (annonceur ou agence, par exemple) 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 gagnées individuellement ; 1 = les impressions doivent être gagnées ou perdues en tant que groupe. Par défaut = false

Enchère

Un objet SeatBid contient un ou plusieurs objets Bid. Chacun de ces objets se rapporte à une impression spécifique dans la requête d'enchère via l'attribut impid et constitue une offre d'achat de cette impression à un prix donné.

Attribut Toujours transmis Type Équivalent Authorized Buyers Autorisé Détails de mise en œuvre
dans la version par Google
id Oui chaîne Non mappé sur 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 par la spécification OpenRTB.

impid Oui chaîne BidResponse.Ad.AdSlot 2,3
2,4
2,5


ID de l'objet Imp dans la demande d'enchère associée. OBLIGATOIRE par la spécification OpenRTB.
price Oui double BidResponse.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 ne concerne qu'une impression d'unité. Bien que le type indique "float", il est fortement recommandé d'utiliser des nombres entiers lors du traitement des devises (par exemple, BigDecimal en Java). OBLIGATOIRE par 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


Si l'enchère l'emporte, gagnez l'URL de notification appelée par la place de marché. Moyen facultatif de diffuser le balisage de l'annonce.

DoubleClick n'accepte pas les avis d'impressions gagnantes. Utilisez %%WINNING_PRICE%% dans l'URL d'impression de l'extrait ou ${AUCTION_PRICE}.

adm Non chaîne BidResponse.Ad.html_snippet, BidResponse.Ad.video_url, BidResponse.Ad.video_vast_xml ou BidResponse.Ad.native_ad 2,3
2,4
2,5


Moyen facultatif de transmettre le balisage de l'annonce en cas d'enchère gagnante. Remplace l'avis d'enchère gagnante si le balisage est inclus dans les deux. Pour les enchères d'annonces natives, vous ne devez utiliser qu'un seul des champs {adm, adm_native}. Ce champ est compatible avec OpenRTB pour la sérialisation JSON.
adm_native Non Réponse native BidResponse.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 éléments {adm, adm_native}. Il s'agit du champ utilisé pour la sérialisation du protocole Protobuf.
adomain Non Tableau de chaînes BidResponse.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"). Il peut s'agir d'un tableau pour les créations à rotation alternée. Les places de marché 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 explorable. Pour les annonces natives, nous vous recommandons d'utiliser BidResponse.seatbid[].bid[].adm_native.link.url plutôt que adomain.
bundle Non chaîne BidResponse.Ad.advertised_app_id 2,3
2,4
2,5


ID de l'application sur une plate-forme de téléchargement d'applications telle que l'App Store d'Apple ou Google Play. Pour en savoir plus sur les chaînes attendues sur les plates-formes de téléchargement d'applications pour TV connectée, consultez les consignes d'identification des applications attribuées par le service de distribution par contournement (OTT, over-the-top) et les TV connectées. Pour les applications mobiles du Google Play Store, il doit s'agir de noms de packages ou de packages tels que com.foo.mygame. Pour les applications sur l'App Store d'Apple, il doit s'agir d'un ID numérique. Si ce champ est
iurl Non chaîne Non compatible 2,3
2,4
2,5


URL sans contournement du cache pointant vers une image représentative du contenu de la campagne pour le contrôle qualité/sécurité des annonces.
cid Non chaîne BidResponse.Ad.AdSlot.billing_id 2,3
2,4
2,5


ID de la campagne pour faciliter le contrôle de la qualité des annonces. Ensemble de créations pour lesquelles iurl doit être représentatif.

Correspond au n° compte facturation du préciblage. Si elle n'est pas définie 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 requêtes billing_id sont spécifiées dans la requête ou si l'enchérisseur possède des sous-comptes actifs.

crid Non chaîne BidResponse.Ad.buyer_creative_id 2,3
2,4
2,5


ID de la création pour faciliter le contrôle de la qualité des annonces.
cat Non Tableau de chaînes BidResponse.Ad.category 2,3
2,4
2,5


Catégories de contenu IAB de la création.
attr Non Tableau d'objets CreativeAttribute BidResponse.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 Framework d'API Bid.api accepte la déclaration des 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 QAGMediaRating Non compatible 2,3
2,4
2,5


Évaluation du support de la création conformément aux consignes de contrôle qualité.
dealid Non chaîne BidResponse.Ad.AdSlot.deal_id (ou BidResponse.Ad.AdSlot.exchange_deal_id si l'enchérisseur est une place de marché tierce) 2,3
2,4
2,5


Référence à deal.id dans la demande d'enchère si cette enchère concerne un accord direct sur une place de marché privée.
w Non int32 BidResponse.Ad.width : obligatoire uniquement si l'impression est à tailles multiples. 2,3
2,4
2,5


Largeur de la création en pixels indépendants des appareils (DIPS).
h Non int32 BidResponse.Ad.height : obligatoire uniquement si l'impression est multitaille. 2,3
2,4
2,5


Hauteur de la création en pixels indépendants des appareils (DIPS).
exp Non int32 Non compatible 2,4
2,5

Indication du nombre de secondes pendant lesquelles l'enchérisseur est prêt à attendre entre la mise aux enchères et l'impression réelle.
burl Non chaîne impression_tracking_url 2.5 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 spécifiques à 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 2.5 URL d'avis de perte appelée par la place de marché lorsqu'il est possible de perdre une enchère. Vous pouvez utiliser des macros de substitution. Les règles spécifiques aux places de marché peuvent empêcher la prise en charge des notifications de perte ou la divulgation de prix d'effacement gagnants entraînant la suppression de macros de ${AUCTION_PRICE} (par exemple, remplacement d'une chaîne de longueur nulle).
tactic Non chaîne Non compatible 2.5 ID de tactique permettant aux acheteurs d'ajouter un libellé aux enchères afin de créer des rapports sur la place de marché pour laquelle la tactique a été soumise. L'utilisation et la signification spécifiques de l'ID de tactique doivent être communiquées entre l'acheteur et les places de marché a priori.
language Non chaîne Non compatible 2.5 Langue de la création utilisant la norme ISO-639-1-alpha-2. Vous pouvez également utiliser le code non standard "xx" si la création n'a pas de contenu linguistique (par exemple, une bannière ne comportant qu'un logo de l'entreprise).
wratio Non int32 Non compatible 2.5 Largeur relative de la création lorsque la taille est exprimée sous forme de ratio. Obligatoire pour les annonces Flex.
hratio Non int32 Non compatible 2.5 Hauteur relative de la création lorsque la taille est exprimée 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 accédez au champ ext dans le message d'enchère.

BidExt

Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
impression_tracking_url Non Tableau de chaînes BidResponse.Ad.impression_tracking_url URL à appeler lorsque l'impression est générée Cette fonctionnalité 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 BidResponse.Ad.ad_choices_destination_ Lien vers une page de préférences pour les annonces ou de désactivation Le cas échéant, une icône AdChoices standard est ajoutée à la création native et associée à cette URL. Cette fonctionnalité 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 BidResponse.Ad.click_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, ils sont envoyés depuis l'appareil de l'utilisateur. Pour en savoir plus sur les créations gérées par l'éditeur, consultez l'article Créations gérées par l'éditeur.
bidder_name Non chaîne BidResponse.Ad.bidder_name (nom de l'enchérisseur) Pour les enchérisseurs Authorized Buyers (places de marché tierces effectuant des enchères en temps réel sur Ad Manager), nom de l'enchérisseur appelé par la place de marché pour fournir l'annonce. Il s'agit d'un texte UTF8 arbitraire, qui doit être suffisant pour identifier l'enchérisseur et doit être défini de manière cohérente pour le même enchérisseur.
exchange_deal_type Non Énumération ExchangeDealType BidResponse.Ad.AdSlot.exchange_deal_type OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;
default = OPEN_AUCTION
attribute Non Tableau de int32 BidResponse.Ad. Consultez le fichier buyer-declarable-creative-attributes.txt pour 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 annonces "fluides" (également appelées annonces responsives "responsives" ou "sans taille") qui sont redimensionnées 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 BidResponse.Ad.amp_ad_url URL permettant de récupérer une annonce AMP HTML. Vous ne devez définir qu'un seul des paramètres suivants: html_snippet, video_url, amp_ad_url, native_ad.
sdk_rendered_ad Non Objet SdkRenderedAd BidResponse.Ad.sdk_rendered_ad Annonce qui sera affichée par un SDK connu de l'acheteur. Cette méthode ne peut être utilisée que si le BidRequest comprenait un sous-message AppExt.InstalledSdk.
event_notification_token Non Objet EventNotificationToken BidResponse.Ad.event_notification_token Jeton défini par les enchérisseurs pour le dépannage. Il sera inclus dans les commentaires en temps réel de l'enchère à laquelle il est envoyé. Le contenu du jeton ne sera pas consigné.
restricted_category Non Tableau de int32 BidResponse.Ad.restricted_category Toutes les catégories limitées pour les annonces pouvant être diffusées à partir de cet extrait. Consultez le fichier ad-restricted-categories.txt pour obtenir la liste des identifiants.
billing_id Non int64 BidResponse.Ad.AdSlot.billing_id ID de facturation auquel attribuer cette impression. La valeur doit être dans le champ répété "BidRequest.Imp.ImpExt.billing_id" envoyé pour cette impression. Si BidRequest.Imp.ImpExt.billing_id est exactement 1 et que l'enchérisseur ne possède pas de sous-comptes actifs, ce champ n'est pas obligatoire et son contenu est ignoré.
third_party_buyer_token Non chaîne BidResponse.Ad.Adslot.third_party_buyer_token Jeton permettant d'identifier les informations tierces de l'acheteur 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 dans la réponse à l'enchère.
buyer_reporting_id Non chaîne BidResponse.Ad.Adslot.buyer_reporting_id ID déclaré par l'acheteur. Il sera utilisé pour ventiler les dépenses et les métriques sur le trafic incorrect dans les rapports sur la transparence du trafic dans l'éditeur de requêtes. Notez que les ID ayant 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 BidResponse.Ad.skadn Informations SKAdNetwork de l'annonceur pour permettre 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 sur l'annonceur signé pour qu'une installation soit attribuée à l'impression d'annonce. Pour en savoir plus, consultez cet article.
Annonce SdkRendered
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 pour afficher l'annonce. Ces données sont opaques pour l'éditeur et pour Google.
declared_ad Non DelcaredAd BidResponse.ad[].sdk_rendered_ad.declared_ad Éléments d'annonce déclarés permettant d'analyser, de classer et d'appliquer les règles relatives aux annonces ainsi que les blocages d'éditeurs pour les annonces diffusées à l'aide d'un SDK personnalisé. Définissez seulement un des éléments html_snippet, video_url, video_vast_xml ou native_response.
Événement de notification d'événement
payload Non chaîne BidResponse.ad[].event_notification_token Contenu du jeton, qui sera ignoré si la longueur est supérieure à 64 octets.
Réponse 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. Il doit correspondre à la version de BidRequest.imp.ext.skad.version.
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 de BidRequest.imp.ext.skad.skadnetids.
campaign Non chaîne BidResponse.ad[].skadn.campaign ID de campagne compatible avec les spécifications d'Apple
itunesitem Non chaîne BidResponse.ad[].skadn.itunesitem ID de l'application de l'annonceur sur la plate-forme de téléchargement d'applications d'Apple
fidelities Non Tableau d'objets Fidelity BidResponse.ad[].skadn.fidelities À partir de la version 2.2, l'API SKAdNetwork accepte plusieurs options de présentation des annonces spécifiées par le paramètre fidelity-type de la signature SKAdNetwork. Ce champ contient les paramètres utilisés pour générer la signature, qui seraient différents pour chaque type de fidélité accepté. Pour en savoir plus, consultez cet article.
nonce Non chaîne BidResponse.ad[].skadn.nonce UUID unique généré par l'annonceur et entièrement en minuscules, permettant de générer la signature. Remarque: ce champ sera abandonné et remplacé par le champ "BidResponse.bid.ext.skadn.fidelities.nonce" pour accepter 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 fourni par BidRequest.imp.ext.skad.sourceapp.
timestamp Non chaîne BidResponse.ad[].skadn.timestamp Durée Unix en millisecondes utilisée au moment de la génération de la signature. Remarque: Ce champ sera abandonné au profit du champ "BidResponse.bid.ext.skadn.fidelities.timestamp" pour accepter plusieurs types de fidélité.
signature Non chaîne BidResponse.ad[].skadn.signature Signature SKAdNetwork spécifiée par Apple. Remarque: Ce champ sera abandonné et remplacé par le champ "BidResponse.bid.ext.skadn.fidelities.signature" pour accepter plusieurs types de fidélité.
Objet DeclaredAd

Éléments d'annonce déclarés permettant d'analyser, de classer et d'appliquer les règles relatives aux annonces ainsi que les blocages d'éditeurs pour les annonces diffusées à l'aide d'un SDK personnalisé.

Définissez seulement un des éléments 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 BidResponse.ad[].sdk_rendered_ad.declared_ad.html_snippet Extrait HTML représentatif de l'annonce affichée par le SDK.
video_url Non chaîne BidResponse.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 BidResponse.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 BidResponse.ad[].sdk_rendered_ad.declared_ad.native_response Contenu d'une annonce native. Les annonces natives sont constituées de plusieurs composants principaux qui sont 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 BidResponse.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. 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 du produit sur la plate-forme de téléchargement affichée par StoreKit et générée par des 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é par l'annonceur et entièrement en minuscules, permettant de générer la signature.
timestamp Non chaîne BidResponse.ad[].skadn.timestamp Durée 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 spécifiée par Apple.

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 lors des enchères est un format d'annonce 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 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, devant être abandonné
adunit Non ID du 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 Native 1.0. Facultatif dans la version 1.1, qui sera abandonné.
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, etc. Notez que ce champ ne doit généralement PAS être utilisé conjointement avec plcmtcnt. Vous pouvez mettre aux enchères plusieurs emplacements identiques (dans ce cas plcmtcnt>1, seq=0) ou des enchères distinctes pour des éléments distincts du flux (auquel cas plcmtcnt=1, seq>=1).
assets Non Tableau d'objets Asset Non compatible Toute enchère doit être conforme au tableau d'éléments exprimé par la place de marché. OBLIGATOIRE conformément à la spécification OpenRTB Native: au moins un élément.
aurlsupport Non bool Non compatible Indique si la source / l'impression de l'offre accepte le renvoi d'un élément asseturl au lieu d'un objet asset. 0 ou l'absence de champ n'indique aucune compatibilité. Implémenté dans la version 1.2
durlsupport Non bool Non compatible Indique si la source / l'impression d'approvisionnement accepte le renvoi d'une URL DCO au lieu d'un objet d'asset. 0 ou l'absence de champ n'indique aucune compatibilité. Implémenté dans la version 1.2. Bêta.
eventtrackers Non EventTrackers Non compatible Indique le type de suivi des événements accepté. 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 les avis de confidentialité propres à l'acheteur. Définissez la valeur sur 0 (ou sans le champ) lorsque l'annonce native n'accepte pas 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é. C'est donc implicitement "1" pour les requêtes natives.
ext Non Objet NativeRequestExt Non 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.
modèle_annonce_native[0].id_style
ID global unique du style, du code HTML et du CSS avec lesquels l'annonce native est affichée.
style_height Non int32 BidRequest.AdSlot.
modèle_annonce_native[0]
.style_height
Si la propriété style_layout_type est définie sur Pixel, il s'agit de la hauteur de toute l'annonce native après affichage.
style_width Non int32 BidRequest.AdSlot.
modèle_annonce_native[0]
.style_width
Si style_layout_type est défini sur Pixel, il s'agit de la largeur de l'annonce native complète après affichage.
style_layout_type Non énumération LayoutType BidRequest.AdSlot.
modèle_annonce_native[0]
.style_layout_type
Énumération LayoutType :
PIXEL = 0; (Default)
FLUID = 1;

Asset

Objet de conteneur principal de chaque élément demandé ou accepté par Exchange au nom 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. Toutes les autres valeurs doivent être nulles/absentes. La valeur id doit être unique dans le 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 un ordre non spécifié, correspondant aux champs recommandés ou obligatoires du premier NativeAdTemplate. ID d'asset 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 l'élément est requis.
title Non Titre de la demande BidRequest.AdSlot.native_ad_template[0] de type HEADLINE Objet Title pour les assets de titre.

RECOMMANDÉ par la spécification OpenRTB Native. Title, Image, Data ou Video.

img Non Image de la demande BidRequest.AdSlot.native_ad_template[0] de types MAIN/IMAGE, ICON/APP_ICON, LOGO/LOGO Objet Image pour les composants Image.

RECOMMANDÉ par la spécification OpenRTB Native. 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 font pas partie du format natif. Les annonces natives peuvent contenir une vidéo en tant que création publicitaire. Les demandes d'enchères peuvent indiquer qu'une vidéo est obligatoire dans la réponse NativeResponse en définissant NativeRequest.assets[].required sur true et en spécifiant NativeRequest.assets[].video. RECOMMANDÉ par la spécification OpenRTB Native. L'un des éléments suivants : Title, Image, Data, Video.
data Non Données BidRequest.AdSlot.native_ad_template[0] de types CTATEXT/CALL_TO_ACTION, DESC/BODY,

SPONSORED/ADVERTISER, PRICE/PRICE, RATING/STAR_RATING

Objet Data pour les notes, les prix, etc.

RECOMMANDÉ par la spécification OpenRTB Native. Title, Image, Data ou Video.

Titre

L'objet Title doit être utilisé pour l'élément title 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 de 25, 90 ou 140. OBLIGATOIRE conformément à la spécification OpenRTB Native.

Image

L'objet Image doit être utilisé pour les éléments d'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 redimensionnement des images par le client. Les valeurs w ou wmin doivent être transmises. Si seul w est inclus, il doit être considéré comme une exigence exacte. RECOMMANDÉ par la spécification OpenRTB Native.
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 redimensionnement des images par le client. Les valeurs h ou hmin doivent être transmises. Si seul h est inclus, il doit être considéré comme une exigence exacte. RECOMMANDÉ par la spécification OpenRTB Native.
mimes Non chaîne Liste d'autorisation des types MIME de contenu acceptés. Les types MIME les plus courants incluent, sans s'y limiter, "image/jpg" et "image/gif". Chaque implémentation Exchange doit avoir sa propre liste de types compatibles dans la documentation sur l'intégration. Pour en savoir plus et obtenir des liens vers toutes les RFC de l'IETF, consultez la page MIME de Wikipédia. Si ce champ est vide, 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_videoformats Types MIME du contenu acceptés. Voici quelques exemples de types MIME courants : "video/x-mswmv" pour Windows Media, et "video/x-flv" pour Flash Video ou "video/mp4". Notez que les annonces natives ne sont souvent pas compatibles avec Flash.

OBLIGATOIRE selon la spécification OpenRTB Native: 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.protocols. Tableau des protocoles vidéo que l'éditeur peut accepter dans la réponse à l'enchère.

OBLIGATOIRE selon la spécification OpenRTB Native: 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 qui ne font pas partie de la suite principale de l'unité native, tels que les notes, le nombre d'avis, les étoiles, le nombre de téléchargements, etc. Il est également générique pour les éléments natifs qui ne sont pas 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 d'asset de données 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:

DESC/BODY: corps_max_safe_length

CTATEXT/CALL_TO_ACTION: call_to_action_max_safe_length

SPONSORED/ADVERTISER: 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 0,5

Suivi des événements

L'objet EventTrackers spécifie dans la réponse d'enchère le type d'événements que l'enchérisseur peut demander à suivre, ainsi que les types de suivi disponibles pour chaque type d'événement. Il est inclus dans la requête en tant que tableau.
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 Méthode EventTracking 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 d'éléments BidResponse.Ad.native_ad[0] Tous les éléments sont mappés aux champs d'une seule annonce native. Liste des assets de l'annonce native.
link Oui Lien BidResponse.Ad.native_ad[0] Destination Link.REQUIRED requis par la spécification OpenRTB Native.
imptrackers Non Tableau de chaînes BidResponse.Annonce.impression_tracking_url Tableau d'URL de suivi des impressions, qui doivent renvoyer une image 1 x 1 ou la réponse 204 (généralement transmises lorsque des 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 script tags à exécuter au moment de l'impression, où ils peuvent être acceptés.
eventtrackers Non Tableau d'objets EventTracker BidResponse.Ad.impression_tracking_url et BidResponse.Ad.impression_tracking_resource Tableau d'outils de suivi des événements de réponse à exécuter avec l'annonce, en réponse aux méthodes acceptées par 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 permettant de les suivre. Le système d'enchères ne doit répondre qu'avec les méthodes indiquées dans la demande. Notez que la plupart des outils de suivi JavaScript s'attendent à être chargés au moment de l'impression. Il n'est donc généralement pas recommandé que l'acheteur réponde avec des outils de suivi JavaScript pour d'autres événements. Toutefois, il appartient à l'acheteur de décider si cela convient.

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 text BidResponse.Ad.impression_tracking_url et BidResponse.Ad.ImpressionTrackingResourcescript_url URL de l'image ou du fichier js. Requis pour les formats image ou js, facultatif pour personnalisé.
customdata Non Objet contenant des paires clé/valeur. Non compatible À approuver individuellement avec la place de marché, un tableau d'objets key:value pour le suivi personnalisé (par exemple, le numéro de compte de la DSP avec une société de suivi, par exemple {"accountnumber":"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 au champ ext du message EventTracker.

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

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

Attribut Toujours transmis Type Équivalent Authorized Buyers Détails de mise en œuvre
url Non chaîne BidResponse.ad[].native_ad.click_link_url [URL_lien_native] URL de destination du lien cliquable.
clicktrackers Non Tableau de chaînes (NativeResponse.link) BidResponse.Ad.NativeAd.click_tracking_url[0] URL de suivi tierces à déclencher lorsque l'utilisateur clique sur l'URL. Les outils de suivi des clics Google redirigent le trafic HTTP 30x 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 dans la requête. Objet de conteneur principal de 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 null/absent. L'ID doit être unique dans le tableau d'assets 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 Non compatible L'ID d'élément unique, attribué par l'échange, doit correspondre à l'un des ID d'éléments de la demande

OBLIGATOIRE conformément à la spécification OpenRTB Native.

required Non Bool Non compatible Définissez la valeur sur 1 si l'asset est obligatoire. (l'enchérisseur requiert son affichage)
title Non Titre AdX: BidResponse.Ad.native_ad[0] / HEADLINE Au choix : Title, Image, Data ou Video

Objet title pour les assets de titre.

img Non Image BidResponse.Ad.native_ad[0] /IMAGE|LOGO|APP_ICON Au choix : Title, Image, Data ou Video

Objet Image pour les composants Image.

video Non Vidéo BidResponse.Ad.NativeAd.video_url ou BidResponse.Ad.NativeAd.video_vast_xml

Il peut s'agir d'une chaîne contenant du code XML VAST ou d'une URL pointant vers 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 font pas partie du format natif. Les annonces natives peuvent contenir une vidéo en tant que création publicitaire.

data Non Données BidResponse.Ad.native_ad[0] /
BODY|CALL_TO_ACTION|ADVERTISER|STAR_RATING_PRICE_STORE
Title, Image, Data ou Video.

Objet Data pour les notes, les prix, etc.

link Non Lien BidResponse.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 BidResponse.Ad.native_ad[0].titre Texte associé à l'élément textuel. OBLIGATOIRE par la spécification OpenRTB Native.

Image

Correspond à l'objet Image dans 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 BidResponse.Ad.native_ad[0] pour le type d'asset de la demande:

PRINCIPALE/IMAGE: image.url

ICON/APP_ICON: app_icon.url

LOGO/LOGO: logo.url

URL de l'asset image. OBLIGATOIRE conformément à la spécification OpenRTB Native.
w Non int32 BidResponse.Ad.native_ad[0] pour le type d'asset de la demande:

PRINCIPALE/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 BidResponse.Ad.native_ad[0] pour le type d'asset de la demande:

PRINCIPALE/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 contenant la 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 qui ne sont pas 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 BidResponse.Ad.native_ad[0] pour le type d'asset de demande OpenRTB/AdX:

CTATEXT/CALL_TO_ACTION: call_to_action

DESC/BODY: corps

SPONSORED/ADVERTISER: Annonceur

PRICE/PRICE: prix

RATING/STAR_RATING: star_rating (AdX requiert un double 0,5

Chaîne de données à afficher à mettre en forme. Peut contenir une valeur mise en forme telle que "5 étoiles", "$10" ou "3,4 étoiles sur 5". OBLIGATOIRE par la spécification OpenRTB Native.

Exemples