Richiesta di offerta Open RTB 2.4
Questa pagina spiega come effettuare richieste di 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/json
I seguenti oggetti devono essere inviati codificati come JSON nel corpo della richiesta:
Richiesta di offerta
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 tramite un oggetto Site sul sito web del publisher (oggetto).
app
Sì
Dettagli tramite un oggetto App sull'app dell'editore* (oggetto).
device
Sì
Dettagli tramite un oggetto Device sul dispositivo dell'utente a cui verrà consegnata l'impression (oggetto).
user
No
Dettagli tramite un oggetto User 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
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)
bidfloorcur
No
Valuta per il valore minimo dell'offerta specificato usando codici alfabetici ISO-4217 (stringa)
native
Solo per imp native e push
Un'opportunità per un oggetto Native (oggetto).
banner
Solo per imp banner e interstitial a pagina intera
Un'opportunità per un oggetto Banner (oggetto).
instl
Solo per imp pop, direct link, email e click interstitial a pagina intera
Un'opportunità per un oggetto Fullscreen (oggetto).
video
Solo per video
Un'opportunità per un oggetto Video (oggetto)
secure
Consigliato
Flag per indicare se l'impression richiede asset creativi e markup con URL HTTPS sicuro, dove 0 = non sicuro, 1 = sicuro (opzione consigliata). Se omesso, lo stato di sicurezza è sconosciuto, ma si può presumere il supporto per HTTP non sicuro (intero)
el
No
Email codificata in Base64 (stringa)
ext
No
Segnaposto per estensioni specifiche dell'exchange
imp.banner
w
Sì
Larghezza del banner (intero)
h
Sì
Altezza del banner (intero)
mimes
No
Elenco dei tipi MIME supportati (array di stringhe). Supportiamo: image/jpeg, image/jpg, image/png, image/png, image/gif, image/webp, video/mp4
ext
No
Segnaposto per estensioni specifiche dell'exchange (oggetto)
imp.banner.ext
image_output
No
Indica il formato di output per i banner immagine* (stringa)
video_output
No
Indica il formato di output per i banner video* (stringa)
*Definisce il formato del campo adm per il formato banner. Le opzioni sono xml o html. Il valore predefinito è xml se il campo non viene fornito.
imp.instl
instl
Sì
0 = clic su link diretto/email, 1 = popunder/interstitial a pagina intera
imp.native (per annunci Native e Push Notification)
request
Sì
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
No
Versione dell'API Dynamic Native Ads a cui request è conforme (stringa)
imp.native.request
ver
Sì
Versione del markup Native in uso (stringa)
context
No
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
Sì
Il design/formato/layout dell'unità pubblicitaria offerta. Attualmente supportiamo 4 (Widget di raccomandazione) e 500 (Notifica push) (intero)
plcmtcnt
No
Il numero di posizionamenti identici in questo Layout. Max: 10 (intero) (intero)
assets
Sì
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
No
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
Sì
ID univoco dell'asset, assegnato dall'exchange. Tipicamente un contatore per l'array (intero) 1: ID asset immagine, 2: ID asset titolo, 3: ID asset descrizione
richiesto
No
Imposta su 1 se l'asset è richiesto o 0 se l'asset è opzionale (intero)
plcmtcnt
No
Il numero di posizionamenti identici in questo layout (intero)
img
Sì
Oggetto Image per gli asset immagine** (oggetto JSON)
title
No
Oggetto Title per gli asset titolo** (oggetto JSON)
data
No
Oggetto dati per nome del marchio, descrizione, valutazioni, prezzi ecc.* (oggetto JSON)
*La quantità di offerte ricevute per la tua richiesta Native si baserà sul valore impostato in "plcmtcnt". Ad esempio, una richiesta di offerta con "plcmtcnt":3 riceverà 3 diversi oggetti offerta. Puoi trovare un esempio di questo nella pagina di esempio della risposta.
** In ogni oggetto asset deve essere presente solo uno degli oggetti {img, title, data}
imp.native.request.assets.img
type
No
ID del tipo di elemento immagine supportato dal publisher. Supportiamo: 1 (Immagine icona) (intero), 3 (Anteprima immagine grande per l'annuncio) (intero)
w
No
Larghezza dell'immagine in pixel, facoltativo (intero)
h
No
Altezza dell'immagine in pixel, facoltativo (intero)
wmin
Sì
Larghezza minima richiesta dell'immagine in pixel (intero)
hmin
Sì
Altezza minima richiesta dell'immagine in pixel (intero)
*Dimensioni dell'icona della Push Notification: 192px x 192px
imp.native.request.assets.title
len
Sì
Lunghezza massima del testo nell'elemento titolo. (intero)
imp.native.request.assets.data
type
Sì
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
No
Lunghezza massima del testo nella risposta dell'elemento (intero)
imp.video
mimes
No
Elenco dei tipi mime supportati (array di stringhe)
protocols
No
Elenco dei protocolli di risposta alle offerte video supportati (array di int)
skip
No
Indica se il player consentirà di saltare il video, dove 0 = no, 1 = sì
skipafter
No
Numero di secondi che un video deve essere riprodotto prima che il salto sia abilitato; applicabile solo se l'annuncio è saltabile
skipmin
No
I video con durata totale superiore a questo numero di secondi possono essere saltabili; applicabile solo se l'annuncio è saltabile
Se fornisci solo "skip" nella richiesta ma non "skipafter", il video sarà saltabile dopo 5 secondi. La risposta imposterà "skipoffset" a 5. Se fornisci "skip" ma non "skipmin", il video sarà saltabile indipendentemente dalla sua durata.
imp.ext
video_cta
No
Indica se devono essere forniti i CTA, dove 0 = no, 1 = sì (predefinito 1)
Per vedere un esempio di CTA, consulta la nostra pagina di esempio della risposta.
site
id
Obbligatorio
ID univoco del sito (stringa)
domain
Obbligatorio
Nome di dominio del sito (stringa)
nome
Obbligatorio
Nome 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 devono essere una stringa di parole separate da virgole.
ext
No
Segnaposto per estensioni specifiche dell'exchange a OpenRTB.
site.ext
exchangecat
No
ID categoria personalizzato ExoClick (intero)
idzone
No
ID personalizzato della Ad Zone ExoClick (intero)
app
id
Obbligatorio
ID univoco dell'app (stringa)
cat
No
ID categoria IAB (array di stringhe)
keywords
No
Le parole chiave possono essere usate per garantire che le zone pubblicitarie ricevano il giusto tipo di pubblicità. Le parole chiave devono essere una stringa di parole separate da virgole (stringa)
editore
No
Dettagli sull'editore (oggetto)
app.publisher
domain
Consigliato
Dominio di livello più alto dell'editore (ad es., "publisher.com") (stringa)
device
ua
Sì
User agent del browser (stringa)
geo
No
Posizione del dispositivo assunta come posizione attuale dell'utente definita da un oggetto Geo.
ip
Sì
Indirizzo IP dell'utente (stringa)*
ipv6
Consigliato
Indirizzo IPv6 dell'utente (stringa)*
language
Consigliato
Lingua del browser usando ISO-639-1-alpha-2 (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 richiesta, non entrambi. Se usi ipv6, rimuovi l'attributo ip, e viceversa. Includerli entrambi può causare errori.
device.geo
country
No
Paese ISO3
device.ext
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)
user
id
Sì
ID utente univoco (stringa)
Se non puoi generare una stringa ID utente, puoi lasciarla vuota (""). La richiesta riceverà una risposta purché l'oggetto "user" sia incluso nella richiesta.
ext
sub
No
Il Sub ID. Deve essere un numero compreso tra una e dieci cifre: non usare zeri all'inizio dei Sub ID.
esporta
No
Il tipo di risposta può essere "json" o "xml" (stringa). Il valore predefinito è "json".
Esempi
Puoi trovare un elenco dettagliato di esempi di richiesta nella nostra pagina di esempio
Ultimo aggiornamento
È stato utile?