View a markdown version of this page

Champ de référence ORTB - AWS Elemental MediaTailor
Catégories de champsobjet de l'applicationobjet de l'appareilobjet imp (impression)Top-level champsobjet utilisateurobjet regsÉtapes suivantes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Champ de référence ORTB

Cette page est une référence complète pour chaque champ de la demande d'offre OpenRTB. Les champs sont classés en fonction de la MediaTailor manière dont ils sont gérés et selon qu'APS les exige ou les recommande pour un remplissage optimal des annonces.

Pour la spécification complète d'OpenRTB 2.6, consultez la spécification IAB OpenRTB 2.6.

Catégories de champs

Catégorie Signification Votre action
obligatoire Doit figurer dans votre modèle. MediaTailor renvoie une erreur en cas d'absence. Vous devez les fournir.
Codé en dur par EMT MediaTailor les définit toujours à l'aide de valeurs issues de la configuration de votre console ou du contexte de disponibilité actuel. Les valeurs de votre modèle sont remplacées. Ne les définissez pas dans votre modèle.
APS recommandé Ce n'est pas strictement obligatoire MediaTailor, mais APS les recommande pour un meilleur remplissage et un meilleur ciblage des publicités. L'absence de champs recommandés peut entraîner une baisse des taux de remplissage ou des réponses sans enchère. Fortement recommandé.
Facultatif Inclus dans la demande d'offre uniquement si vous les fournissez. Aucune valeur par défaut. Indiquez si cela est pertinent pour votre cas d'utilisation.

objet de l'application

Champ Catégorie Remarques
app obligatoire L'appobjet doit exister dans votre modèle.
app.bundle obligatoire L'identifiant du bundle de votre application (par exemple,G15147002586). Il ne doit pas être vide.
app.storeurl obligatoire URL de l'App Store (par exemple,https://apps.apple.com/us/app/yourapp/id123).
app.publisher.id Codé en dur par EMT Définissez toujours votre configuration PublisherId depuis la console.
app.content Obligatoire (objet) MediaTailor envoie un Content objet vide si vous l'omettez. Fournissez des métadonnées de contenu pour un meilleur ciblage.
app.name APS recommandé Nom de l'application à des fins d'identification.
app.id APS recommandé L'identifiant de votre application dans APS.
app.domain APS recommandé Domaine de l'application.
app.content.genre APS recommandé Genre de contenu (par exemple,"Sport","News").
app.content.contentrating APS recommandé Évaluation du contenu (par exemple"TV-G","TV-14").
app.content.language APS recommandé Langue du contenu (ISO-639-1).
app.content.id APS recommandé Identifiant du contenu.
app.content.title APS recommandé Titre du contenu.
app.content.episode APS recommandé Numéro de l'épisode.
app.content.len APS recommandé Longueur du contenu en secondes.
app.cat Facultatif Catégories de contenu (taxonomie IAB).
app.sectioncat Facultatif Catégories de sections.
app.pagecat Facultatif Catégories de pages.
app.ver Facultatif Version de l'application.
app.privacypolicy Facultatif 1 = dispose d'une politique de confidentialité.
app.paid Facultatif 1 = application payante.
app.keywords Facultatif Comma-separated mots clés.
app.kwarray Facultatif Mots-clés sous forme de tableau.
app.inventorypartnerdomain Facultatif Domaine du partenaire d'inventaire.
app.ext Facultatif Objet d'extension (pass-through).

objet de l'appareil

Champ Catégorie Remarques
device obligatoire L'deviceobjet doit exister dans votre modèle.
device.ua obligatoire Chaîne de l'agent utilisateur. Il ne doit pas être vide. Utilisez {{session.user_agent}}.
device.ip obligatoire Adresse IPv4. Il ne doit pas être vide. Utilisez {{session.client_ip}}.
device.lmt Facultatif (par défaut : 0) Indicateur Limiter le suivi des publicités. 0= suivi autorisé, 1 = suivi limité. Si cela n'est pas indiqué dans votre modèle, la valeur par défaut est. 0
device.devicetype Codé en dur par EMT (par défaut : 3) MediaTailor ensembles 3 (TV connectée) s'ils ne sont pas fournis. Votre valeur est utilisée si elle est présente.
device.make APS recommandé Fabricant de l'appareil (par exemple,"Samsung","Apple").
device.model APS recommandé Modèle de l'appareil (par exemple,"Tizen TV","iPhone").
device.os APS recommandé Système d'exploitation (par exemple"Tizen","iOS").
device.osv APS recommandé Version du système d'exploitation.
device.h APS recommandé Hauteur de l'écran en pixels.
device.w APS recommandé Largeur de l'écran en pixels.
device.language APS recommandé Langue de l'appareil (ISO-639-1).
device.ifa APS recommandé Identifiant publicitaire de l'appareil. Tous les appareils n'en possèdent pas un (par exemple, les navigateurs Web).
device.dnt APS recommandé Drapeau Do Not Track.
device.geo Facultatif Objet géographique aveccountry,lat,lon.
device.sua Facultatif Agent utilisateur structuré (UA-CH).
device.ipv6 Facultatif Adresse IPv6.
device.hwv Facultatif Version matérielle.
device.connectiontype Facultatif Type de connexion (cellulaireWiFi, etc.).
device.carrier Facultatif Nom du transporteur
device.mccmnc Facultatif country/network Code de téléphone portable.
device.ext Facultatif Objet d'extension (pass-through).

objet imp (impression)

Votre modèle doit contenir exactement un imp objet dans un tableau.

Champ Catégorie Remarques
imp[0].video obligatoire L'videoobjet doit exister.
imp[0].video.mimes obligatoire Types MIME pris en charge (par exemple,["video/mp4"]).
imp[0].video.protocols Facultatif Protocoles VAST pris en charge. En cas d'omission, MediaTailor utilise une solution de secours codée en dur. [1, 2, 3, 4, 5, 6, 7, 8] Consultez la référence de l'énumération du protocole ci-dessous.
imp[0].video.minduration Codé en dur par EMT Réglez sur votre MinimumUnfilledDuration depuis la console.
imp[0].video.maxduration Codé en dur par EMT Réglez sur la durée réelle non remplie (secondes).
imp[0].video.maxseq Codé en dur par EMT Calculé :floor(unfilled_duration / 6). APS recommande l'une maxseq ou poddur l'autre de renvoyer plusieurs annonces.
imp[0].video.poddur Codé en dur par EMT Réglez sur la durée non remplie (secondes).
imp[0].video.startdelay Facultatif Retard de démarrage. 0= pré-rouleau, -1 = mi-rouleau générique, -2 = post-rouleau, = décalage à mi-rouleau en secondes. > 0 À utiliser -1 pour les pauses en direct à mi-course. Solution de secours codée en dur :. 6
imp[0].video.w APS recommandé Largeur de la vidéo en pixels.
imp[0].video.h APS recommandé Hauteur de la vidéo en pixels.
imp[0].video.plcmt APS recommandé Type de placement (1 = en cours d'eau).
imp[0].video.podid APS recommandé Identifiant du pod.
imp[0].video.slotinpod APS recommandé Position de la fente dans la capsule.
imp[0].video.ext.slotId Facultatif (par défaut :"default_slot_id") Votre identifiant de slot APS depuis la console APS. La valeur par défaut fonctionne, mais la fourniture de votre identifiant de machine à sous réel permet à APS d'appliquer un ciblage et une tarification plancher spécifiques à chaque machine à sous.
imp[0].bidfloor Facultatif (par défaut : 1.0) Prix d'enchère minimum en CPM.
imp[0].secure Facultatif (par défaut : 1) 1 = nécessite des URL créatives HTTPS.
imp[0].id Facultatif Identifiant de l'impression. Auto-generated s'il n'est pas fourni.
imp[0].tagid Facultatif Tag/placement IDENTIFIANT.
imp[0].bidfloorcur Facultatif Devise plancher de l'enchère (USD par défaut).
imp[0].ssai Facultatif Indicateur SSAI.
imp[0].exp Facultatif Délai de péremption de l'empreinte.
imp[0].rqddurs Facultatif Tableau des durées demandées.
imp[0].mincpmpersec Facultatif CPM minimum par seconde.
imp[0].pmp Facultatif Objet de marché privé.
imp[0].ext Facultatif Objet d'extension (pass-through).

Référence d'énumération du protocole

Value Protocole
1 VASTE 1.0
2 VASTE 2.0
3 VASTE 3.0
4 Enveloppe VAST 1.0
5 Enveloppe VAST 2.0
6 Enveloppe VAST 3.0
7 VASTE 4.0
8 Enveloppe VAST 4.0
9 ans et plus DAAST

Top-level champs

Champ Catégorie Remarques
id Codé en dur par EMT Auto-generated: {sessionId}_{availId} format (par exemple,abc123-def456_78901). Utile pour corréler les demandes d'enchères avec les journaux de session.
cur Facultatif (par défaut :["USD"]) Devises autorisées.
ext.integrationType Codé en dur par EMT Réglez toujours sur"EMT".
bcat Facultatif Catégories d'annonces bloquées (taxonomie IAB). La valeur de votre modèle est envoyée telle quelle à APS.
badv Facultatif Domaines d'annonceurs bloqués.
bapp Facultatif ID de bundle d'applications bloqués.
test Facultatif Indicateur du mode test.
at Facultatif Type d'enchère.
tmax Facultatif Durée maximale (ms) d'attente de la réponse à l'offre.
wseat Facultatif Sièges réservés aux acheteurs.
bseat Facultatif Sièges d'acheteurs bloqués.
wlang Facultatif Langages créatifs autorisés.
source Facultatif Objet source pour la chaîne d'approvisionnement.
ext Facultatif Vos champs d'extension personnalisés sont fusionnés avec ceux des EMT. integrationType

objet utilisateur

Champ Catégorie Remarques
user APS recommandé (UE) Obligatoire pour le trafic de l'UE avec le consentement du RGPD.
user.consent APS recommandé (UE) Chaîne de consentement RGPD (TCF).
user.id Facultatif ID de l'utilisateur.
user.buyeruid Facultatif Buyer-specific ID utilisateur.
user.eids Facultatif Identifiants étendus (LiveRamp, UID2, etc.).
user.data Facultatif Segments de données utilisateur.
user.ext Facultatif Objet d'extension.

objet regs

Champ Catégorie Remarques
regs APS recommandé À inclure pour des raisons de conformité réglementaire.
regs.coppa APS recommandé (États-Unis) Drapeau COPPA (1 = destiné aux enfants).
regs.us_privacy APS recommandé (États-Unis) US Privacy/chaîne CCPA.
regs.gdpr APS recommandé (UE) Le RGPD s'applique (1 = oui).
regs.gpp APS recommandé Chaîne de la Global Privacy Platform. Préféré us_privacy au public américain, il se traduit par de meilleurs taux de remplissage. Consultez Bonnes pratiques.
regs.gpp_sid APS recommandé Identifiants de section GPP (par exemple, [7] pour les ressortissants américains). Obligatoire gpp en cas de présence.
regs.ext Facultatif Objet d'extension.

Étapes suivantes