Risposta all'offerta Open RTB 2.4
La risposta a una richiesta di offerta dovrebbe avere la seguente struttura:
Oggetto di risposta dell'offerta
id
Sì
ID della richiesta di offerta a cui questa è una risposta (stringa)
seatbid
Sì
Raccolta di offerte effettuate dall'offerente per conto di uno specifico seat (array)
Nota: L'id deve corrispondere a quello fornito nella richiesta
seatbid
bid
Sì
Array dell'oggetto bid relativo all'impression target
seatbid.bid
id
Sì
ID dell'oggetto bid, utilizzato per il tracciamento (stringa)
impid
Sì
ID dell'oggetto impression nella relativa richiesta di offerta.
price
Sì
Prezzo dell'offerta in CPM o CPC (float)
adm
Sì
Markup pubblicitario XML/JSON (stringa)
nurl
Sì
URL di notifica della vincita, si consiglia di usare HTTP anziché HTTPS per nurl (stringa)
burl
No
URL di notifica della fatturazione, si consiglia di usare HTTP anziché HTTPS per burl (stringa)
crid
Consigliato
ID della creatività per agevolare il controllo della qualità dell'annuncio (stringa)
iurl
Consigliato
URL della creatività
ext
No
Estensione specifica di ExoClick (oggetto)
Note:
Supportiamo il video sia nei posizionamenti banner sia in quelli interstitial.
L'impid deve corrispondere a quello fornito nella richiesta.
L'adm deve essere fornito in JSON o XML in base al formato pubblicitario target: JSON per Native, In-Stream e Push Notification; XML per tutti gli altri formati.
La nURL deve essere notificata per garantire il campaign capping ed evitare di ricevere sempre la stessa risposta.
La bURL viene richiamata quando sono state erogate impression o clic, a seconda di CPM o CPC dal campo btype (predefinito CPM).
seatbid.bid.ext
btype
Consigliato
Modello di prezzo. Valori: 1 = CPM, 2 = CPC. Predefinito = 1 (int). Quando la risposta è per una richiesta di zona Email Clicks, 1 = Smart CPC.
Nota: solo Push Notification, annunci Native, Direct Link ed Email Clicks possono fare offerte con il modello di prezzo CPC.
seatbid.bid.ext.dsa
behalf
Sì
Trasparenza dell'inserzionista: stringa di testo Unicode libera con il nome per conto di chi viene mostrato l'annuncio. Massimo 100 caratteri. (stringa)
paid
Sì
Trasparenza dell'inserzionista: stringa di testo Unicode libera di chi ha pagato per l'annuncio. Deve essere sempre inclusa anche se è la stessa indicata nell'attributo behalf. Massimo 100 caratteri (stringa)
adrender
Sì
Flag per indicare che il buyer/inserzionista renderizzerà le proprie informazioni di trasparenza DSA all'interno della creatività. 0 = il buyer/inserzionista non renderizzerà, 1 = il buyer/inserzionista renderizzerà (int)
seatbid.bid.dsa.transparency
domain
Sì
Dominio dell'entità che ha applicato i parametri utente (stringa)
params
Sì
Array del targeting dei parametri utente applicati dal buy-side (usando l'elenco fornito dalla DSA Transparency Taskforce). Includere il supporto per più vendor che possono aggiungere i propri parametri di targeting utente. (array di int)
Nessuna risposta all'offerta
Per rispondere a una richiesta di offerta senza effettuare una vera offerta, deve essere inviato il codice di risposta HTTP 204 "No Content".
URL di notifica della vincita e della fatturazione
Se sia nURL o bURL sono nella risposta bid e sono URL validi, la piattaforma ExoClick invierà una richiesta GET a essi. Questi URL possono contenere alcuni token da sostituire con ExoClick prima di eseguire la GET:
Esempio:
Se stai usando sia nURL e bURL, ExoClick effettuerà una chiamata a entrambi.
Struttura dell'ADM
A seconda del formato dell'annuncio, il adm parametro può contenere un frammento di XML o JSON. Puoi trovare esempi dettagliati delle strutture adm nella nostra pagina degli esempi
Quando crei l'ADM, tieni presente quanto segue:
markup iFrame (Banner, Fullpage Interstitial) devono essere abilitati nel tuo account ExoClick per poterli utilizzare.
In-Stream, Native e annunci Push Notification devono contenere una stringa codificata in JSON nell'adm.
Il parametro adm di In-Stream può seguire una delle due strutture: Remote VAST o Local VAST. In Remote VAST, devi semplicemente dichiarare l'URL in cui si trova il VAST Wrapper, mentre in Local VAST devi dichiarare qualsiasi "trackingEvents" che desideri tracciare oltre a "videoURL" e "clickURL".
Attualmente supportiamo impression, progress e complete eventi. Gli eventi impression e progress sono obbligatori, mentre complete può essere aggiunto solo se utilizzi Local VAST.
L'ADM deve seguire la stessa struttura mostrata nel nostro esempio sopra.
Come parametro opzionale, puoi includere crop_anchor_point nella stringa JSON dell'adm delle Native Ads per determinare dove si trova il punto di ancoraggio della tua immagine native. I valori disponibili sono:
MIDDLE_CENTER = 0,
TOP_LEFT = 1,
TOP_CENTER = 2,
TOP_RIGHT = 3,
MIDDLE_LEFT = 4,
MIDDLE_RIGHT = 5,
BOTTOM_LEFT = 6,
BOTTOM_CENTER = 7,
BOTTOM_RIGHT= 8
Ecco una visualizzazione dei punti di ancoraggio disponibili:
Inoltre, per quanto riguarda Native Ads, assicurati di aggiungere i tuoi eventtrackers secondo la più recente specifica native
Nota che, sebbene consentiamo anche gli imptrackers nelle Native Ads, raccomandiamo vivamente di usare eventtrackers invece.
Push Notification gli annunci consentono solo un asset immagine per notifica. La larghezza e l'altezza dipendono da ciò che arriva dalla richiesta, che può essere 192x192 o 720x480. Nota che l'adm deve anche essere una stringa codificata in JSON, poiché la richiesta proverrà da un oggetto Native.
Infine, Push Notification gli annunci consentono solo un URL "imptracker"
Esempi
Puoi trovare esempi dettagliati delle risposte bid e delle strutture ADM nella nostra pagina di esempio delle risposte dell'inserzionista
Ultimo aggiornamento
È stato utile?