View a markdown version of this page

Riferimento al campo ORTB - AWS Elemental MediaTailor
Categorie di campioggetto appoggetto dispositivooggetto imp (impression)Top-level campioggetto utenteoggetto regsFasi successive

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento al campo ORTB

Questa pagina è un riferimento completo per ogni campo della richiesta di offerta OpenRTB. I campi sono classificati in base a come li MediaTailor gestisce e se APS li richiede o consiglia per una compilazione ottimale degli annunci.

Per le specifiche complete di OpenRTB 2.6, vedere le specifiche IAB OpenRTB 2.6.

Categorie di campi

Categoria Significato La tua azione
obbligatorio Deve essere presente nel modello. MediaTailor genera un errore se manca. È necessario fornire questi.
Codificato da EMT MediaTailor li imposta sempre utilizzando i valori della configurazione della console o del contesto di disponibilità corrente. I valori del modello vengono sostituiti. Non impostarli nel modello.
APS consigliato Non sono strettamente richiesti da MediaTailor, ma APS li consiglia per una migliore compilazione e targeting degli annunci. La mancanza dei campi consigliati può comportare una riduzione delle percentuali di riempimento o una mancata offerta. Fortemente consigliato.
Opzionale Sono inclusi nella richiesta di offerta solo se li fornisci. Nessun valore predefinito. Fornisci se pertinente al tuo caso d'uso.

oggetto app

Campo Categoria Note
app obbligatorio L'appoggetto deve esistere nel modello.
app.bundle È obbligatorio L'ID del pacchetto della tua app (ad esempio,G15147002586). Non deve essere vuoto.
app.storeurl obbligatorio URL dell'App Store (ad esempiohttps://apps.apple.com/us/app/yourapp/id123).
app.publisher.id Codificato da EMT Sempre impostato sulla configurazione PublisherId della console.
app.content Obbligatorio (oggetto) MediaTailor invia un Content oggetto vuoto se lo si omette. Fornisci metadati dei contenuti per un targeting migliore.
app.name APS consigliato Nome dell'app per l'identificazione.
app.id APS consigliato L'identificatore della tua app in APS.
app.domain APS consigliato Dominio dell'app.
app.content.genre APS consigliato Genere di contenuto (ad esempio,"Sport","News").
app.content.contentrating APS consigliato Classificazione dei contenuti (ad esempio"TV-G","TV-14").
app.content.language APS consigliato Lingua dei contenuti (ISO-639-1).
app.content.id APS consigliato Identificatore del contenuto.
app.content.title APS consigliato Titolo del contenuto.
app.content.episode APS consigliato Numero dell'episodio.
app.content.len APS consigliato Durata del contenuto in secondi.
app.cat Facoltativo Categorie di contenuti (tassonomia IAB).
app.sectioncat Facoltativo Categorie di sezione.
app.pagecat Facoltativo Categorie di pagine.
app.ver Facoltativo Versione dell'app.
app.privacypolicy Facoltativo 1 = ha una politica sulla privacy.
app.paid Facoltativo 1 = app a pagamento.
app.keywords Facoltativo Comma-separated parole chiave.
app.kwarray Facoltativo Parole chiave come array.
app.inventorypartnerdomain Facoltativo Dominio partner di Inventory.
app.ext Facoltativo Oggetto di estensione (pass-through).

oggetto dispositivo

Campo Categoria Note
device obbligatorio L'deviceoggetto deve esistere nel modello.
device.ua È obbligatorio Stringa dell'agente utente. Non deve essere vuoto. Utilizza {{session.user_agent}}.
device.ip obbligatorio Indirizzo IPv4. Non deve essere vuoto. Utilizza {{session.client_ip}}.
device.lmt Facoltativo (impostazione predefinita: 0) Contrassegno Limita il monitoraggio degli annunci. 0= tracciamento consentito, 1 = tracciamento limitato. Se non è fornito nel modello, il valore predefinito è. 0
device.devicetype Codificato da EMT (impostazione predefinita: 3) MediaTailor set 3 (Connected TV) se non forniti. Il tuo valore viene utilizzato se presente.
device.make APS consigliato Produttore del dispositivo (ad esempio"Samsung","Apple").
device.model APS consigliato Modello del dispositivo (ad esempio"Tizen TV","iPhone").
device.os APS consigliato Sistema operativo (ad esempio"Tizen","iOS").
device.osv APS consigliato Versione del sistema operativo.
device.h APS consigliato Altezza dello schermo in pixel.
device.w APS consigliato Larghezza dello schermo in pixel.
device.language APS consigliato Lingua del dispositivo (ISO-639-1).
device.ifa APS consigliato ID pubblicitario del dispositivo. Non tutti i dispositivi ne hanno uno (ad esempio, i browser Web).
device.dnt APS consigliato Bandiera Do Not Track.
device.geo Facoltativo Oggetto geografico concountry,lat,lon.
device.sua Facoltativo Agente utente strutturato (UA-CH).
device.ipv6 Facoltativo Indirizzo IPv6.
device.hwv Facoltativo Versione hardware.
device.connectiontype Facoltativo Tipo di connessione (WiFicellulare e così via).
device.carrier Facoltativo Nome del corriere.
device.mccmnc Facoltativo country/network Codice mobile.
device.ext Facoltativo Oggetto di estensione (pass-through).

oggetto imp (impression)

Il modello deve contenere esattamente un imp oggetto in un array.

Campo Categoria Note
imp[0].video È obbligatorio L'videooggetto deve esistere.
imp[0].video.mimes È obbligatorio Tipi MIME supportati (ad esempio,["video/mp4"]).
imp[0].video.protocols Opzionale Protocolli VAST supportati. Se omesso, MediaTailor utilizza il fallback codificato. [1, 2, 3, 4, 5, 6, 7, 8] Vedi il riferimento all'enumerazione del protocollo di seguito.
imp[0].video.minduration Codificato da EMT Imposta il tuo MinimumUnfilledDuration dalla console.
imp[0].video.maxduration Codificato da EMT Impostato sulla durata effettiva del vuoto (secondi).
imp[0].video.maxseq Codificato da EMT Calcolato:. floor(unfilled_duration / 6) APS consiglia di poddur restituire maxseq o restituire più annunci.
imp[0].video.poddur Codificato da EMT Impostato sulla durata non compilata (secondi).
imp[0].video.startdelay Facoltativo Ritardo di avvio. 0= pre-roll, -1 = mid-roll generico, -2 = post-roll, = offset mid-roll in secondi. > 0 Da utilizzare per le pause -1 dal vivo a metà del rollio. Fallback codificato:. 6
imp[0].video.w APS consigliato Larghezza del video in pixel.
imp[0].video.h APS consigliato Altezza del video in pixel.
imp[0].video.plcmt APS consigliato Tipo di posizionamento (1 = in-stream).
imp[0].video.podid APS consigliato Identificatore del pod.
imp[0].video.slotinpod APS consigliato Posizione dello slot nel pod.
imp[0].video.ext.slotId Facoltativo (impostazione predefinita:"default_slot_id") L'ID dello slot APS dalla console APS. L'impostazione predefinita funziona, ma la fornitura dell'ID slot effettivo consente ad APS di applicare il targeting specifico dello slot e la tariffa minima.
imp[0].bidfloor Facoltativo (impostazione predefinita: 1.0) Prezzo minimo di offerta in CPM.
imp[0].secure Facoltativo (impostazione predefinita: 1) 1 = richiede gli URL creativi HTTPS.
imp[0].id Facoltativo ID dell'impressione. Auto-generated se non fornito.
imp[0].tagid Facoltativo Tag/placement ID.
imp[0].bidfloorcur Facoltativo Valuta minima dell'offerta (impostazione predefinita in USD).
imp[0].ssai Facoltativo Indicatore SSAI.
imp[0].exp Facoltativo Ora di scadenza dell'impressione.
imp[0].rqddurs Facoltativo Matrice delle durate richieste.
imp[0].mincpmpersec Facoltativo CPM minimo al secondo.
imp[0].pmp Facoltativo Oggetto di mercato privato.
imp[0].ext Facoltativo Oggetto di estensione (pass-through).

Riferimento enumerato al protocollo

Valore Protocollo
1 VAST1.0
2 VAST2.0
3 VAST3.0
4 Involucro VAST 1.0
5 Involucro VAST 2.0
6 Involucro VAST 3.0
7 VAST4.0
8 Involucro VAST 4.0
9+ DAAST

Top-level campi

Campo Categoria Note
id codificato da EMT Auto-generated: {sessionId}_{availId} formato (ad esempio,). abc123-def456_78901 Utile per correlare le richieste di offerta con i registri delle sessioni.
cur Facoltativo (impostazione predefinita:["USD"]) Valute consentite.
ext.integrationType Codificato da EMT Sempre impostato su. "EMT"
bcat Facoltativo Categorie di annunci bloccati (tassonomia IAB). Il valore del modello viene inviato così com'è ad APS.
badv Facoltativo Domini degli inserzionisti bloccati.
bapp Facoltativo ID dei pacchetti di app bloccati.
test Facoltativo Bandiera della modalità test.
at Facoltativo Tipo di asta.
tmax Facoltativo Tempo massimo (ms) di attesa per la risposta all'offerta.
wseat Facoltativo Posti per gli acquirenti consentiti.
bseat Facoltativo Posti per gli acquirenti bloccati.
wlang Facoltativo Linguaggi creativi consentiti.
source Facoltativo Oggetto sorgente per la catena di fornitura.
ext Facoltativo I campi di estensione personalizzati vengono uniti a quelli EMT. integrationType

oggetto utente

Campo Categoria Note
user Consigliato APS (UE) Necessario per il traffico nell'UE con il consenso del GDPR.
user.consent Raccomandato da APS (UE) Stringa di consenso GDPR (TCF).
user.id Facoltativo ID utente.
user.buyeruid Facoltativo Buyer-specific ID utente.
user.eids Facoltativo Identificatori estesi (LiveRamp, UID2 e così via).
user.data Facoltativo Segmenti di dati utente.
user.ext Facoltativo Oggetto di estensione.

oggetto regs

Campo Categoria Note
regs APS consigliato Includere per la conformità normativa.
regs.coppa Consigliato APS (Stati Uniti) Bandiera COPPA (1 = destinata ai bambini).
regs.us_privacy Raccomandato da APS (USA) Stringa US Privacy/CCPA.
regs.gdpr Raccomandato da APS (UE) Si applica il GDPR (1 = sì).
regs.gpp APS consigliato Stringa Global Privacy Platform. Preferito rispetto us_privacy al pubblico statunitense, si traduce in tassi di riempimento migliori. Consulta Best practice.
regs.gpp_sid Consigliato APS ID di sezione GPP (ad esempio, [7] per i cittadini statunitensi). Obbligatorio quando gpp è presente.
regs.ext Facoltativo Oggetto di estensione.

Fasi successive