Richiesta di bid Open RTB 2.4
Questa pagina descrive i diversi componenti delle richieste RTB che riceverai per effettuare un'offerta.
Header della richiesta di offerta
Header HTTP della versione OpenRTB:
x-openrtb-version: 2.4Header HTTP Keep-Alive:
Connection: Keep-AliveJSON del contenuto:
Content-Type: application/jsonHeader di codifica dei dati:
Accept-Encoding
Oggetto della richiesta di offerta
Quando richiedi offerte per un contesto specifico, la piattaforma eseguirà una richiesta HTTP con un timeout di 300ms e invierà il seguente oggetto codificato come JSON nel corpo della richiesta. HTTP è consigliato a causa della latenza aggiuntiva quando si usa HTTPS.
a
Tipo di asta, first price = 1 (int)
id
ID univoco della richiesta di offerta (stringa)
imp
Oggetto che rappresenta l'impression offerta (oggetto).
site
Dettagli tramite un oggetto Site sul sito web del publisher (oggetto).
device
Dettagli tramite un oggetto Device sul dispositivo dell'utente a cui verrà consegnata l'impression (oggetto).
user
Dettagli tramite un oggetto User sull'utente umano del dispositivo; il pubblico pubblicitario (oggetto).
ext
Segnaposto per estensioni specifiche dell'exchange.
imp
id
ID univoco dell'impression all'interno di questa richiesta di offerta (stringa)
bidfloor
Offerta minima per questa impression (CPM) / click (CPC) e valuta dell'account, facoltativo (float).
bidfloorcur
Valuta per il valore minimo dell'offerta specificato usando codici alfa ISO-4217, facoltativo (stringa)
native
Un oggetto Native; richiesto se questa impression è offerta come opportunità pubblicitaria nativa (oggetto).
banner
Un oggetto banner; richiesto se questa impression è offerta come opportunità pubblicitaria banner (oggetto).
instl
Un oggetto interstitial; richiesto se questa impression è offerta come opportunità pubblicitaria interstitial o popunder (oggetto).(oggetto).
secure
Flag per indicare se l'impression richiede asset creativi e markup con URL HTTPS sicuri, dove 0 = non sicuro, 1 = sicuro. Se omesso, lo stato di sicurezza è sconosciuto, ma si può assumere il supporto HTTP non sicuro; facoltativo (intero)
el
Email codificata in Base64 (stringa)
imp.banner
w
Larghezza del banner in pixel (intero).
h
Altezza del banner in pixel (intero).
mimes
Tipi MIME supportati. Valori di esempio: image/jpg, image/png, video/mp4, image/webp.
imp.instl
instl
Flag che specifica se l'annuncio è popunder/interstitial (intero): 1=true, 0=false
imp.native (Native e Notifiche Push)
request
Payload della richiesta conforme alla Specifica dell'Annuncio Native - un stringa codificata JSON della richiesta Native Ads, inclusa la sua native oggetto di primo livello (oggetto JSON)
ver
Versione dell'API Dynamic Native Ads a cui request è conforme (stringa)
imp.native.request
ver
Versione del markup Native in uso (stringa)
context
Il contesto in cui appare l'annuncio. In questo caso è 1 (un contesto incentrato sul contenuto, come newsfeed, articolo, galleria immagini, galleria video o simili), facoltativo (intero)
plcmttype
Il design/formato/layout dell'unità pubblicitaria offerta. Attualmente supportiamo 4 (Widget di raccomandazione) e 500 (Notifica push) (intero)
plcmtcnt
Il numero di posizionamenti identici in questo layout (intero)
assets
Un array di Oggetti Asset. Qualsiasi risposta all'offerta deve essere conforme all'array di elementi espresso nella richiesta di offerta (array di oggetti JSON)
seq
0 per il primo annuncio, 1 per il secondo annuncio, e così via. Nota che in genere NON verrebbe usato in combinazione con plcmtcnt - o stai mettendo all'asta più posizionamenti identici (nel qual caso plcmtcnt>1, seq=0) oppure stai tenendo aste separate per elementi distinti nel feed (nel qual caso plcmtcnt=1, seq=>=1)
imp.native.request.assets
id
ID univoco dell'asset, assegnato dall'exchange. Tipicamente un contatore per l'array (intero)
richiesto
Imposta su 1 se l'asset è richiesto o 0 se l'asset è opzionale** (intero)
plcmtcnt
Il numero di posizionamenti identici in questo layout (intero)
img
Oggetto immagine per gli asset immagine* (oggetto JSON)
title
Oggetto titolo per gli asset titolo* (oggetto JSON)
data
Oggetto dati per nome del marchio, descrizione, valutazioni, prezzi ecc.* (oggetto JSON)
video
Oggetto video per gli asset video. Vedi la definizione dell'oggetto richiesta Video. Nota che i video in-stream (cioè preroll, ecc.) non fanno parte del Native. Gli annunci Native possono contenere un video come creatività dell'annuncio stessa (oggetto).
* Solo uno degli oggetti {img, title, data} dovrebbe essere presente in ogni oggetto asset
** Gli asset sono contrassegnati come richiesti in base alla configurazione della zona del publisher in cui il tuo annuncio potrebbe essere visualizzato
imp.native.request.assets.img
type
ID del tipo di elemento immagine supportato dal publisher. Supportiamo: 1 (Immagine icona) (intero), 3 (Anteprima immagine grande per l'annuncio) (intero)
w
Larghezza dell'immagine in pixel, facoltativo (intero)
h
Altezza dell'immagine in pixel, facoltativo (intero)
wmin
Larghezza minima richiesta dell'immagine in pixel (intero)
hmin
Altezza minima richiesta dell'immagine in pixel (intero)
imp.native.request.assets.title
len
Lunghezza massima del testo nell'elemento titolo. (intero)
imp.native.request.assets.video
mimes
Elenco dei tipi MIME supportati (array di stringhe).
minduration
Durata minima dell'annuncio video in secondi (intero).
maxduration
Durata massima dell'annuncio video in secondi (intero).
protocols
Elenco dei protocolli di risposta alle offerte video supportati (array di interi).
linearity
Indica se l'impression deve essere lineare, non lineare, ecc. (intero).
boxingallowed
Indica se è consentito il letter-boxing di contenuti 4:3 in una finestra 16:9 (intero).
imp.native.request.assets.data
type
ID del tipo di elemento supportato dal publisher (intero). Supportiamo: 1 (sponsored - Messaggio Sponsored By in cui la risposta dovrebbe contenere il nome del marchio dello sponsor), 2 (desc - Testo descrittivo associato al prodotto o servizio pubblicizzato)
len
Lunghezza massima del testo nella risposta dell'elemento (intero)
imp.video
mimes
Elenco dei tipi mime supportati (array di stringhe)
protocols
Elenco dei protocolli di risposta alle offerte video supportati (array di int)
skip
Indica se il player consentirà di saltare il video, dove 0 = no, 1 = sì
skipafter
Numero di secondi che un video deve essere riprodotto prima che il salto sia abilitato; applicabile solo se l'annuncio è saltabile
skipmin
I video con durata totale superiore a questo numero di secondi possono essere saltabili; applicabile solo se l'annuncio è saltabile
Se il publisher fornisce "skip" nella richiesta ma non "skipafter", il video sarà saltabile dopo 5 secondi. La risposta imposterà "skipoffset" a 5. Se il publisher fornisce "skip" ma non "skipmin", il video sarà saltabile indipendentemente dalla sua durata.
site
id*
ID univoco del sito (stringa)
domain*
Nome di dominio del sito (stringa)
cat
ID categoria IAB (array di stringhe)
page
URL completo della pagina in cui verrà mostrato l'annuncio (stringa)
keywords
Le parole chiave possono essere usate per garantire che le zone pubblicitarie ricevano il giusto tipo di pubblicità. Le parole chiave dovrebbero essere una stringa di parole separate da virgole
ext
Segnaposto per estensioni specifiche dell'exchange a OpenRTB.
*Questi attributi sono obbligatori per i formati Direct Link e Email Clicks.
site.ext
exchangecat
ID categoria personalizzato ExoClick (intero)
idzone
ID personalizzato della Ad Zone ExoClick (intero)
keyword
Parola chiave corrispondente, se presente (stringa)
L'attributo idzone viene usato per identificare la fonte in ExoClick da cui proviene il traffico.
device
ua
User agent del browser (stringa)
sua
Informazioni strutturate sullo user agent, che possono essere usate quando un client supporta User-Agent Client Hints (oggetto)
geo
Posizione del dispositivo assunta come posizione attuale dell'utente definita da un oggetto Geo.
ip
Indirizzo IP dell'utente (stringa)*
ipv6
Indirizzo IPv6 dell'utente (stringa)*
language
Lingua del browser usando ISO-639-1-alpha-2 (stringa)
os
Sistema operativo (stringa)
js
Supporto per JavaScript, dove 0 = no, 1 = sì (intero)
ext
Segnaposto per estensioni specifiche dell'exchange a OpenRTB
*Esattamente uno tra ip o ipv6 sarà presente nella richiesta di offerta.
device.geo
country
Paese ISO3
device.ext
remote_addr
Indirizzo IP principale dell'utente (stringa)
x_forwarded_for
Indirizzo IP X-FORWARDED-FOR dell'utente oppure vuoto se non impostato (stringa)
device.sua
Informazioni strutturate sullo User Agent. device.sua è considerata la rappresentazione più accurata degli attributi del dispositivo.
browsers
Invia marchi e versioni derivati dall'header Sec-CH-UA-Full-Version-List. (Array di BrandVersion oggetti)
platform
Invia un marchio derivato dall'header Sec-CH-UA-Platform e una versione derivata dall'header Sec-CH-UA-Platform-Version. (BrandVersion Oggetto)
mobile
Deriva questo valore dall'header Sec-CH-UA-Mobile. (intero)
architecture
Recupera questo valore dall'header Sec-CH-UA-Arch. (stringa)
bitness
Recupera questo valore dall'header Sec-CH-UA-Bitness. (stringa)
model
Recupera questo valore dall'header Sec-CH-UA-Model. (stringa)
source
La fonte dei dati usati per creare questo oggetto, Elenco: User-Agent Source nell'AdCOM 1.0 (intero; predefinito 0)
device.sua.browsers | device.sua.platform
brand
Il valore può provenire dagli header User-Agent Client Hints, rappresentando il marchio dello user agent (da Sec-CH-UA-Full-Version header) o il marchio della piattaforma (da Sec-CH-UA-Platform header). (stringa)
version
Una sequenza di componenti di versione, in ordine gerarchico decrescente [major, minor, micro, …] (array di stringhe)
user
id
ID utente univoco (stringa)
ext
sub
No
sub sarà un numero intero che rappresenta l'ID della zona da cui è stata originata la richiesta.
regs.ext
dsaapply
Flag per indicare se la DSA è applicata alla richiesta. 1 = Richiesto (int)
dsa
Estensione per informazioni di trasparenza DSA (oggetto)
regs.ext.dsa
richiesto
Flag per indicare se le informazioni DSA devono essere rese disponibili. 0 = Non richiesto, 1 = Supportato, le risposte all'offerta con o senza oggetto DSA saranno accettate, 2 = Richiesto, le risposte all'offerta senza oggetto DSA non saranno accettate, 3 = Richiesto, le risposte all'offerta senza oggetto DSA non saranno accettate, il publisher è una piattaforma online (int)
datatopub
Il publisher potrebbe aver bisogno dei dati di trasparenza per scopi di audit. 0 = non inviare dati di trasparenza, 1 = facoltativo inviare dati di trasparenza, 2 = inviare dati di trasparenza (int)
Se ricevi dsaapply: 1 e required: 2 o 3, è obbligatorio aggiungere nella risposta gli attributi dsa con valori, altrimenti la risposta verrà rifiutata.
Esempi
Puoi trovare un elenco completo di tutti i tipi di richieste che puoi ricevere nella nostra pagina di esempio della Richiesta Inserzionista.
Ultimo aggiornamento
È stato utile?