Richiesta di offerta Open RTB 2.5

Questa pagina spiega come effettuare richieste di offerta.

Intestazioni suggerite per la richiesta di bid

• Intestazione HTTP della versione OpenRTB: x-openrtb-version: 2.5
• Intestazione HTTP Keep-Alive: Connection: Keep-Alive
• Contenuto JSON: Content-Type: application/json

I seguenti oggetti devono essere inviati codificati come JSON nel corpo della richiesta:

Oggetto della richiesta di offerta

Attributo	Obbligatorio?	Descrizione
a	Sì	Tipo di asta, first price = 1 (int)
id	Sì	ID univoco della richiesta di offerta (stringa)
imp	Sì	Array di oggetti Imp che rappresentano le impression offerte (oggetto).
site	Sì	Dettagli sul sito web dell'editore (oggetto).
app	Sì	Dettagli sull'app dell'editore (oggetto).
device	Sì	Dettagli sul dispositivo dell'utente a cui verrà erogata l'impressione (oggetto).
user	No	Dettagli sull'utente umano del dispositivo; il pubblico pubblicitario (oggetto).
ext	No	Segnaposto per estensioni di OpenRTB.

Solo uno degli oggetti {site, app} deve essere presente in ogni richiesta.

imp

Attributo	Obbligatorio?	Descrizione
id	Sì	ID univoco dell'impression all'interno di questa richiesta di offerta (stringa)
bidfloor	No	Offerta minima per questa impressione (CPM) / clic (CPC) e valuta dell'account (float).
banner	Solo per imp a pagina intera	Un oggetto banner (oggetto).
secure	No; consigliato 1	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)

imp.banner

Attributo	Obbligatorio?	Descrizione
w	Sì	Larghezza del banner (intero)
h	Sì	Altezza del banner (intero)
mimes	Sì	Tipi MIME - image/jpg, image/png, video/mp4 o image/webp

imp.video

Attributo	Obbligatorio?	Descrizione
mimes	Sì	Tipi MIME del contenuto supportati (ad es., "video/mp4") (array di stringhe)
minduration	No	Durata minima dell'annuncio video in secondi (intero)
maxduration	No	Durata massima dell'annuncio video in secondi (intero)
protocols	No	Array di protocolli video supportati (intero)
linearity	No	Indica se l'impressione deve essere lineare, non lineare, ecc. Se non ne viene specificato alcuno, si presume che siano consentiti tutti (intero)
boxingallowed	No	Indica se è consentito il letterboxing di contenuti 4:3 in una finestra 16:9, dove 0 = no, 1 = sì (intero)
pos	No	Posizione dell'annuncio sullo schermo (intero)
h	No	Larghezza del player video in pixel indipendenti dal dispositivo (DIPS) (intero)
w	No	Altezza del player video in pixel indipendenti dal dispositivo (DIPS) (intero)
ext	No	Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto)

imp.video.ext

Attributo	Obbligatorio?	Descrizione
zone_type	No	Tipo di zona all'interno dei formati pubblicitari di ExoClick (ad es.: video_slider)
cta	No	Specifica se la zona pubblicitaria mostra un componente CTA (intero)

site

Attributo	Obbligatorio?	Descrizione
id	Consigliato	ID univoco del sito (stringa)
name	No	Nome del sito (stringa)
domain	Consigliato	Nome di dominio del sito (stringa)
cat	No	ID categoria IAB (array di stringhe)
page	Consigliato	URL completo della pagina in cui verrà mostrato l'annuncio (stringa)
keywords	No	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

site.ext

Attributo	Obbligatorio?	Descrizione
exchangecat	No	ID categoria personalizzato ExoClick (intero)
idzone	No	ID personalizzato della zona ExoClick (intero)

app

Attributo	Obbligatorio?	Descrizione
id	Consigliato	ID univoco dell'app (stringa)
name	No	Nome dell'app (stringa)
domain	Consigliato	Nome di dominio dell'app (stringa)
cat	No	ID categoria IAB (array di stringhe)
keywords	No	Le parole chiave possono essere utilizzate per assicurarsi che le zone pubblicitarie ricevano il tipo giusto di pubblicità. Le parole chiave dovrebbero essere una stringa di parole separate da virgole (stringa)
publisher	No	Dettagli sull'editore (oggetto)

device

Attributo	Obbligatorio?	Descrizione
ua	Sì	User agent del browser (stringa)
sua	No	Informazioni strutturate sullo user agent, che possono essere usate quando un client supporta User-Agent Client Hints (oggetto)
geo	No	Posizione del dispositivo assunta come posizione attuale dell'utente definita da un oggetto Geo.
ip	Sì	Indirizzo IPv4 dell'utente (stringa)*
ipv6	Sì	Indirizzo IPv6 dell'utente (stringa)*
language	Consigliato	Lingua del browser (stringa)
os	No	Sistema operativo (stringa)
js	No	Supporto per JavaScript, dove 0 = no, 1 = sì (intero)
ext	No	Segnaposto per estensioni specifiche dell'exchange a OpenRTB

Devi includere solo ip o ipv6 nella tua richiesta, non entrambi. Se usi ipv6, rimuovi l'attributo ip, e viceversa. Includerli entrambi può causare errori.

device.geo

Attributo	Obbligatorio?	Descrizione
country	No	Paese ISO3

device.ext

Attributo	Obbligatorio?	Descrizione
remote_addr	No	Indirizzo IP principale dell'utente (stringa)
x_forwarded_for	No	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.

Attributo	Obbligatorio?	Descrizione
browsers	Consigliato	Gli implementatori dovrebbero inviare brand e versioni derivati dall'header Sec-CH-UA-Full-Version-List. (Array di BrandVersion oggetti)
platform	Consigliato	Gli implementatori dovrebbero inviare un brand derivato dall'header Sec-CH-UA-Platform e una versione derivata dall'header Sec-CH-UA-Platform-Version. (BrandVersion Oggetto)
mobile	Consigliato	Gli implementatori dovrebbero derivare questo valore dall'header Sec-CH-UA-Mobile. (intero)
architecture	Consigliato	Gli implementatori dovrebbero recuperare questo valore dall'header Sec-CH-UA-Arch. (stringa)
bitness	Consigliato	Gli implementatori dovrebbero recuperare questo valore dall'header Sec-CH-UA-Bitness. (stringa)
model	Consigliato	Gli implementatori dovrebbero recuperare questo valore dall'header Sec-CH-UA-Model. (stringa)
source	Consigliato	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

Attributo	Obbligatorio?	Descrizione
brand	Obbligatorio	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	Consigliato	Una sequenza di componenti di versione, in ordine gerarchico decrescente [major, minor, micro, …] (array di stringhe)

user

Attributo	Obbligatorio?	Descrizione
id	No	ID utente univoco (stringa)
ext	No	Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto)

user.ext

Attributo	Obbligatorio?	Descrizione
consent	No	Questa è la stringa di consenso richiesta dagli standard IAB. Per ora solo consenso negativo (stringa)

regs

Attributo	Obbligatorio?	Descrizione
ext	No	Segnaposto per estensioni specifiche dell'exchange di OpenRTB (oggetto)

regs.ext

Attributo	Obbligatorio?	Descrizione
gdpr	No	Questo è 0 se il chiamante ritiene che l'utente non sia soggetto al GDPR, e 1 se l'utente è soggetto al GDPR. In caso contrario, questo parametro non sarà definito.

ext

Attributo	Obbligatorio?	Descrizione
sub	No	Il Sub ID. Deve essere un numero tra una e dieci cifre: non usare zeri all'inizio dei Sub ID.