Tieni a portata di mano la specifica OpenRTB 2.6 mentre consulti questa pagina.
Display & Video 360 non supporta tutti i campi della specifica OpenRTB e possono essere applicate sfumature. Alcune sezioni di questo documento contengono informazioni e consigli specifici per l'implementazione di Display & Video 360. Devi anche seguire le linee guida presentate nella specifica OpenRTB, se non diversamente indicato.
Alcuni campi non sono supportati, ma vengono comunque analizzati. Questi campi devono essere formattati correttamente, ma non influiranno sul risultato dell'offerta.
Specifica della richiesta di offerta
Una richiesta di offerta è una richiesta HTTP Post con un corpo di un oggetto
richiesta di offerta. Il formato del corpo è definito nell'intestazione
Content-Type
.
La risposta corrispondente è un codice HTTP 204 senza corpo per un'offerta nulla oppure un codice HTTP 200 con un corpo di una risposta all'offerta.
Se una richiesta di offerta è malformata, potrebbe essere restituito un HTTP 200 con il corpo di una risposta
all'offerta con il campo nbr
compilato.
Il formato della risposta è controllato dall'intestazione Accept
.
Formato JSON
Il formato predefinito viene utilizzato quando non viene fornito alcun tipo MIME accettato.
Le richieste e le risposte JSON seguono la specifica OpenRTB 2.6 dell'IAB. La seguente documentazione descrive le estensioni e il supporto dei campi.
L'intestazione Content-Type
: application/json
indica una richiesta di offerta JSON,
Accept
: application/json
indica che le risposte all'offerta devono essere in formato JSON.
Formato Protobuf
NOTA: il supporto di Protobuf è in versione beta. Se ti interessa, contatta DV360.
Le richieste e le risposte JSON seguono le specifiche Protobuf OpenRTB 2.6 di IAB.
Le estensioni sono supportate in modo limitato. Contatta DV360 se ti interessano.
Invia l'intestazione Content-Type
: application/x-protobuf
per indicare una richiesta di offerta Protobuf e imposta Accept
: application/x-protobuf
per ricevere risposte all'offerta Protobuf.
Oggetto richiesta di offerta
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Obbligatorio. ID univoco della richiesta di offerta. Questi dati possono essere utilizzati per identificare le singole richieste per un periodo di tempo molto limitato dopo la pubblicazione. |
imp |
Array Imp | È richiesto almeno un oggetto imp .
Per i pod audio, sono supportati più oggetti |
site |
Sito | Obbligatorio per le richieste relative al sito web.site e app si escludono a vicenda. |
app |
App | Obbligatorio per le richieste di app.app e site si escludono a vicenda. |
device |
Dispositivo | Obbligatorio. |
user |
Utente | Obbligatorio. |
test |
Numero intero | Non supportato. |
at |
Numero intero |
1 : asta al primo prezzo in cui all'inserzionista viene addebitato l'importo dell'offerta.2 (impostazione predefinita): asta al secondo prezzo in cui all'inserzionista
viene addebitato un importo leggermente superiore a quello del secondo miglior offerente.3 : il prezzo iniziale è nella richiesta e non ha nulla a che fare
con le offerte concorrenti.
|
tmax |
Numero intero | Facoltativo, il valore predefinito è personalizzato per integrazione. |
wseat |
Array di stringhe | Elenco delle postazioni acquirente consentite. Consigliato, a meno che non sia consentito a tutti gli inserzionisti di fare offerte. Se non è impostato, non sono previste restrizioni. |
bseat |
Array di stringhe | Elenco dei posti degli acquirenti le cui offerte devono essere bloccate. Gli acquirenti elencati non potranno fare offerte per deal e aste aperte. |
allimps |
Numero intero | Non supportato. |
cur |
Array di stringhe | Facoltativo, ma vivamente consigliato. Il valore predefinito è per integrazione. La valuta nella richiesta di offerta deve corrispondere a una delle valute registrate durante l'integrazione. È consigliabile supportare una sola valuta per ogni exchange. |
wlang |
Array di stringhe | Non supportato. |
bcat |
Array di stringhe | Categorie di inserzionisti bloccate utilizzando le categorie di contenuti IAB. Non configurato indica che non sono presenti categorie bloccate. |
badv |
Array di stringhe | Specifica l'inserzionista bloccato in base al dominio fornito
dall'inserzionista. Unset is no blocked advertisers. |
bapp |
Array di stringhe | Non supportato. |
source |
Origine | Semi-required for schain . |
regs |
Regs | (Facoltativo) |
ext |
Estensioni delle richieste di offerta | (Facoltativo) |
Oggetto delle estensioni della richiesta di offerta
Campo | Tipo | Dettagli |
---|---|---|
schain |
Supply chain |
le nuove integrazioni devono
utilizzare il campo BidRequest.source.schain in
Origine.
|
purch |
Numero intero |
Il parametro Traffico acquistato è il traffico reindirizzato da
proprietà diverse da quelle possedute, acquisite o altrimenti incentivate
attività. Ciò è conforme alla nuova specifica IVT 2.0 dell'MRC.
Questo campo verrà chiamato Sorgente di traffico del publisher nei report
visibili agli acquirenti e avrà uno dei seguenti valori : |
gdemsignals |
Stringa | Un blob di indicatori dell'API SCAR dall'SDK GMA. Consigliato se il traffico dell'SDK GMA, altrimenti vietato. |
disable_gma_format |
int |
Facoltativo se viene fornito gdemsignals , altrimenti vietato.0 (predefinito): quando gdemsignals viene compilato, l'annuncio
di risposta all'offerta è un blob JSON.1 : verrà fornito anche un tag annuncio anziché il blob
JSON. |
Oggetto di origine
Campo | Tipo | Dettagli |
---|---|---|
fd |
Numero intero | Entità responsabile della decisione finale di vendita dell'impressione0 (impostazione predefinita): la decisione spetta all'exchange.1 : la decisione spetta a una fonte upstream.
|
tid |
Stringa | Non supportato. |
pchain |
Stringa | Non supportato. |
schain |
Supply chain |
Obbligatorio in quasi tutti i casi.
Questo campo è preferibile rispetto alla fornitura di |
ext |
Estensioni della fonte | (Facoltativo) |
Oggetto delle estensioni di origine
Questa estensione è altamente consigliata in quanto influisce sul modo in cui le misurazioni della visibilità vengono riportate in DV3 al cliente. Se il nome del partner OMID NON è presente nell'elenco delle certificazioni IAB, l'MRC ci richiede di segnalare le metriche di visibilità separatamente da quelle certificate dall'MRC. Scopri di più.
Campo | Tipo | Dettagli |
---|---|---|
omidpn |
Stringa | Identificatore dell'integrazione dell'SDK OM. Questo è uguale al parametro "name" dell'oggetto Partner OMID. |
omidpv |
Stringa | Versione dell'integrazione dell'SDK OM. Questo è uguale al parametro "versionString" dell'oggetto partner OMID. |
schain |
Supply chain |
le nuove integrazioni devono utilizzare il campo
schain in
Origine.
|
Oggetto Regs
Campo | Tipo | Dettagli |
---|---|---|
coppa |
Numero intero | 0 (valore predefinito): il COPPA non è applicabile a questa richiesta.1 : Questa richiesta è soggetta al COPPA. |
ext |
Estensioni Regs | (Facoltativo) |
Oggetto Estensioni normative
Campo | Tipo | Dettagli |
---|---|---|
gdpr |
Numero intero | Indica se la richiesta di offerta proviene dalla regione del SEE.0 (predefinito): regione non SEE.1 : regione SEE,per maggiori dettagli, consulta la soluzione per i fornitori con consenso per il GDPR. |
us_privacy |
Stringa | Segui la specifica
tecnica fornita da IAB Tech Lab per implementare la
stringa us_privacy .
Quando riceviamo la stringa |
Imp object
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Un identificatore univoco per questa impressione nel contesto della richiesta di offerta (in genere, il valore inizia da 1 e aumenta fino a n per n impressioni). |
metric |
Oggetto | Non supportato. |
banner |
Banner | Obbligatorio per le opportunità di annunci banner. |
video |
Video | Obbligatorio per le opportunità di annunci video. |
audio |
Audio | Obbligatorio per le opportunità di annunci audio. |
native |
Nativo | Obbligatorio per le opportunità di annunci nativi. |
pmp |
Pmp | Deal del marketplace privato in vigore per questa impressione. |
displaymanager |
Stringa | Nome del partner di mediazione degli annunci, della tecnologia SDK o del player responsabile del rendering dell'annuncio (in genere video o mobile). Utilizzato da alcuni ad server per personalizzare il codice dell'annuncio in base al partner. Consigliato per video e/o app. |
displaymanagerver |
Stringa | Versione del partner di mediazione degli annunci, della tecnologia SDK o del player responsabile del rendering dell'annuncio (in genere video o mobile). Utilizzato da alcuni ad server per personalizzare il codice dell'annuncio in base al partner. Consigliato per video e/o app. |
instl |
Numero intero |
0 (valore predefinito): non interstitial.1 : l'annuncio è interstitial o a schermo intero.
|
tagid |
Stringa | Identificatore del posizionamento dell'annuncio o del tag annuncio specifico utilizzato per avviare l'asta. Ciò può essere utile per il debug di eventuali problemi o per l'ottimizzazione da parte dell'acquirente. |
bidfloor |
Float | Offerta minima per questa impressione espressa in CPM. |
bidfloorcur |
Stringa |
Valuta specificata utilizzando i codici alfa ISO 4217. |
clickbrowser |
Numero intero |
Indica il tipo di browser aperto quando si fa clic sulla creatività in un'app. Tieni presente che Safari View Controller nei dispositivi iOS 9.x è considerato un browser nativo ai fini di questo campo. |
secure |
Numero intero |
Se questa impressione richiede un URL HTTPS sicuro o un URL HTTP non sicuro.0 (predefinito):non sicuro1 : sicuro
|
iframebuster |
Array di stringhe | |
exp |
Numero intero | La scadenza dell'offerta viene impostata da DV360 indipendentemente dal valore inviato da un partner in questo campo. Gli eventi di impressione ricevuti dopo il periodo di inattività dell'impressione (in genere 1 ora) vengono eliminati perché inattivi e non sono considerati fatturabili da DV360. |
rwdd |
Numero intero |
Indica se l'utente riceve un premio per la visualizzazione dell'annuncio.0 (impostazione predefinita): non premiato1 : premiato
In genere, le implementazioni degli annunci video consentono agli utenti di leggere senza costi un articolo di notizie aggiuntivo, ricevere una vita extra in un gioco o usufruire di una sessione musicale sponsorizzata senza annunci. Il premio viene in genere distribuito al termine dell'annuncio video. |
Oggetto estensione impressione
Campo | Tipo | Dettagli |
---|---|---|
bcrid |
Stringa | Elenco degli ID creatività da bloccare. |
Oggetto banner
Campo | Tipo | Dettagli |
---|---|---|
format |
Array formato | Un elenco dei formati supportati. |
w |
Numero intero |
format .
|
h |
Numero intero |
format .
|
wmax |
Numero intero | Non supportato. |
hmax |
Numero intero | Non supportato. |
wmin |
Numero intero | Non supportato. |
hmin |
Numero intero | Non supportato. |
btype |
Array di numeri interi |
Un elenco di tipi di annunci banner inclusi nella lista bloccata:
|
battr |
Array di numeri interi | Supporta i seguenti valori:
|
pos |
Numero intero |
La posizione dell'annuncio:
|
mimes |
Array di stringhe |
Non supportato.
DV360 utilizzerà text/html per tutte le creatività banner. |
topframe |
Numero intero |
0 (valore predefinito): il banner viene pubblicato in un iframe.1 : Non supportato: il banner viene visualizzato nel frame superiore.
|
expdir |
Array di numeri interi |
1 : Sinistra2 : Destra3 : Su4 : Giù5 : Schermo intero espandibile
|
api |
Array di numeri interi |
Framework di API supportate
|
id |
Stringa |
Un identificatore per l'oggetto banner e deve essere univoco nell'impressione.
Consigliato quando gli oggetti |
vcm |
Numero intero |
Pertinente solo per un 0 : Il banner è visibile contemporaneamente alla creatività video.1 : Il banner è una cartolina finale dopo il video.
|
Formattare l'oggetto
Campo | Tipo | Dettagli |
---|---|---|
w |
Numero intero | Larghezza in pixel indipendenti dal dispositivo (DIP). |
h |
Numero intero | Altezza in pixel indipendenti dal dispositivo (DIP). |
wratio |
Numero intero | Non supportato. |
hratio |
Numero intero | Non supportato. |
wmin |
Numero intero | Non supportato. |
Oggetto video
Ti consigliamo vivamente di specificare il posizionamento video nella richiesta di offerta. Un campo di posizionamento mancante viene classificato come posizionamento sconosciuto. Per maggiori dettagli, consulta l'articolo sul targeting per posizione.
Campo | Tipo | Dettagli |
---|---|---|
mimes |
Array di stringhe |
È obbligatorio almeno un tipo MIME.
|
minduration |
Numero intero | La durata minima del video in secondi. Il valore predefinito è nessun minimo. |
maxduration |
Numero intero | La durata massima di un video in secondi. Il valore predefinito è nessun limite massimo. |
protocols |
Array di numeri interi |
È richiesto almeno un protocollo supportato.
|
w |
Numero intero | Larghezza del video player in pixel indipendenti dal dispositivo (DIP). |
h |
Numero intero | L'altezza del video player in pixel indipendenti dal dispositivo (DIP). |
startdelay |
Numero intero | Ritardo iniziale in secondi per i posizionamenti degli annunci pre-roll, mid-roll o post-roll. |
placement |
Numero intero | È consigliabile specificare il posizionamento (e/o) del video nella richiesta di offerta.
Se mancano entrambi i campi, il posizionamento verrà classificato come sconosciuto.
|
plcmt |
Numero intero | È consigliabile specificare il posizionamento (e/o) del video nella richiesta di offerta.
Se mancano entrambi i campi, il posizionamento verrà classificato come sconosciuto.
Nota:per essere considerati in-stream (posizionamento o tipo di posizionamento 1), i posizionamenti/le impressioni video devono essere impostati su "audio attivo" ed essere segnalati correttamente nel metodo di riproduzione (sono idonei i valori 1, 3, 4 e 5).
Nota:se fornisci sia plcmt: Accompanying Content (2) è considerato placement: In Article (3) plcmt: No Content/Standalone (4) è considerato placement: In feed (4) placement: In Banner non ha mappatura in plcmt
|
linearity |
Numero intero | Non supportato. |
skip |
Numero intero |
Se il video player consente di ignorare l'annuncio.
|
skipmin |
Numero intero | Non supportato. |
skipafter |
Numero intero | Non supportato. |
sequence |
Numero intero | Se nella stessa richiesta di offerta vengono offerte più impressioni annuncio, il numero di sequenza consentirà la pubblicazione coordinata di più creatività. |
battr |
Array di numeri interi | Attributi delle creatività bloccati. |
maxextended |
Numero intero |
Durata massima dell'annuncio video esteso, se l'estensione è consentita.
|
minbitrate |
Numero intero | Velocità in bit minima in Kbps. |
maxbitrate |
Numero intero | Velocità in bit massima in Kbps. |
boxingallowed |
Numero intero |
Indica se è consentito il letterbox dei contenuti 4:3 in una finestra 16:9
|
playbackmethod |
Array di numeri interi |
Metodi di riproduzione che potrebbero essere in uso. Se non ne viene specificato nessuno, può essere utilizzato qualsiasi metodo.
|
playbackend |
Numero intero |
L'evento che causa la fine della riproduzione.
|
delivery |
Array di numeri interi | Metodi di pubblicazione supportati. Se non ne viene specificato nessuno, si presume che siano tutti supportati.
|
pos |
Numero intero |
Posizione dell'annuncio sullo schermo.
|
companionad |
Array Banner | Annunci companion, se disponibili. |
api |
Array di numeri interi |
|
companiontype |
Array di numeri interi | Non supportato. |
maxseq |
Numero intero | Il numero massimo di annunci da restituire in un pod video dinamico. |
poddur |
Array di numeri interi | La durata massima di un pod video dinamico in secondi. |
Estensione supportata per l'oggetto video
Campo | Tipo | Dettagli |
---|---|---|
rewarded |
Numero intero | Questo campo indica se le richieste sono premiate o meno. Deve essere inviato come numero intero.
|
Oggetto audio
Campo | Tipo | Dettagli |
---|---|---|
mimes |
Array di stringhe |
È obbligatorio almeno un tipo MIME.
|
minduration |
Numero intero | Durata minima dell'annuncio in secondi. |
maxduration |
Numero intero | Durata massima dell'annuncio in secondi. |
protocols |
Array di numeri interi |
|
startdelay |
Numero intero | Il ritardo iniziale in secondi per i posizionamenti degli annunci pre-roll, mid-roll o post-roll.
|
sequence |
Numero intero | Non supportato. |
battr |
Array di numeri interi | Non supportato. |
maxextended |
Numero intero | Non supportato. |
minbitrate |
Numero intero | La velocità in bit minima in Kbps. |
maxbitrate |
Numero intero | La velocità in bit massima in Kbps. |
delivery |
Array di numeri interi | Non supportato. |
companionad |
Array Banner object | Eventuali slot per creatività companion banner. |
api |
Array di numeri interi |
Elenco dei framework API supportati per questa impressione.
|
companiontype |
Array di numeri interi | Non supportato. |
maxseq |
Array di numeri interi | Non supportato. |
feed |
Numero intero |
Tipo di feed audio.
|
stitched |
Numero intero | Non supportato. |
nvol |
Numero intero | Non supportato. |
Oggetto nativo
Per ulteriori dettagli, consulta le specifiche degli annunci nativi DV360.
Campo | Tipo | Dettagli |
---|---|---|
request |
Stringa | L'oggetto JSON nativo codificato nella stringa. |
ver |
Stringa |
1.0 : Non supportato1.1 : Non supportato1.2
|
api |
Array di numeri interi |
Elenco dei framework API supportati per questa impressione.
|
battr |
Array di numeri interi | Non supportato. |
Oggetto PMP
Campo | Tipo | Dettagli |
---|---|---|
private_auction |
Numero intero |
0 (predefinito): tutte le offerte consentite1 : solo offerte
|
deals |
Array Deal object | Le offerte da includere. |
Oggetto Deal
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | L'oggetto PMP non può contenere più di un oggetto deal per ID. |
bidfloor |
Doppio |
Offerta minima per questa impressione in CPM.
Obbligatorio se |
bidfloorcur |
Stringa |
Valuta specificata utilizzando i codici alfa ISO 4217.
Se non specificato, il valore predefinito è la valuta della richiesta di offerta. |
at |
Numero intero |
Se non specificato, il valore predefinito corrisponde a bid_request.at .
|
wseat |
Array di stringhe |
Gli ID partner dei partner idonei per il deal.
Nessun posto implica nessuna limitazione per i posti. |
wadomain |
Array di stringhe |
I domini degli inserzionisti autorizzati a fare offerte per questo deal.
Nessun posto implica nessuna limitazione del dominio. |
guar |
Numero intero |
Questo campo serve a indicare se il deal è garantito. Deve essere inviato come numero intero.
Una piattaforma di scambio pubblicitario deve essere inclusa nella lista consentita per consentire a DV360 di accettare i deal garantiti; contattaci per richiedere questa operazione. Se la tua borsa attualmente utilizza un meccanismo diverso per segnalare le transazioni garantite con DV360, contattaci per discutere il passaggio a questa estensione preferita.
|
ext |
Estensioni offerta | (Facoltativo) |
Estensione supportata per l'oggetto deal
Campo | Tipo | Dettagli |
---|---|---|
guaranteed |
Numero intero |
Questo campo serve a indicare se il deal è garantito. Deve essere inviato come numero intero.
Una piattaforma di scambio pubblicitario deve essere inclusa nella lista consentita per consentire a DV360 di accettare i deal garantiti; contattaci per richiedere questa operazione. Se la tua borsa attualmente utilizza un meccanismo diverso per segnalare le transazioni garantite con DV360, contattaci per discutere il passaggio a questa estensione preferita.
Ti consigliamo di utilizzare |
Oggetto Sito
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | L'ID del sito sulla piattaforma di scambio. |
name |
Stringa | Non supportato. |
domain |
Stringa |
Il dominio del sito.
Ti consigliamo di inviare un URL completo in site.page anziché compilare solo site.domain. |
cat |
Array di stringhe | Non supportato. |
sectioncat |
Array di stringhe | Non supportato. |
pagecat |
Array di stringhe | Non supportato. |
page |
Stringa |
L'URL completo in cui deve essere mostrata l'impressione.
Ti consigliamo di inviare l'URL completo a scopo di targeting. |
ref |
Stringa | L'URL referrer che ha causato la navigazione alla pagina corrente. |
search |
Stringa | Non supportato. |
mobile |
Numero intero | Non supportato. |
privacypolicy |
Numero intero | Non supportato. |
publisher |
Oggetto Publisher | Dettagli sull'editore del sito. |
content |
Oggetto dei contenuti | Dettagli sui contenuti all'interno di un sito. |
keywords |
Stringa (formato CSV) | Non supportato. |
ext |
Estensioni sito | Estensioni per l'oggetto sito. |
Oggetto estensione sito
Campo | Tipo | Dettagli |
---|---|---|
inventorypartnerdomain |
Stringa | Utilizzato per la condivisione dell'inventario CTV, consulta la spiegazione relativa agli annunci per app CTV di IAB. |
Oggetto app
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | ID applicazione sulla piattaforma di scambio. |
name |
Stringa |
Nomi delle applicazioni, che possono essere alias su richiesta dei publisher.
I nomi delle app per le richieste senza SDK (principalmente TV connesse a internet) possono essere forniti dal publisher direttamente nella richiesta. |
bundle |
Stringa |
Obbligatorio.
Per iOS, deve essere l'ID numerico dell'App Store. Non accettiamo l'ID bundle in stile DNS inverso. Per l'app TV connessa a internet, consigliamo di trasmettere l'identificatore dell'app definito dallo store. Rispetta le linee guida per l'identificazione delle app assegnate ai negozi OTT/CTV pubblicate di recente da IAB. |
domain |
Stringa | Il dominio, ad esempio mygame.foo.com |
storeurl |
Stringa | Obbligatorio per la verifica di app-ads.txt e la convalida dello store per TV connessa a internet. |
cat |
Array di stringhe | Non supportato. |
sectioncat |
Array di stringhe | Non supportato. |
pagecat |
Array di stringhe | Non supportato. |
ver |
Stringa | Non supportato. |
privacypolicy |
Numero intero | Non supportato. |
paid |
Numero intero | Non supportato. |
publisher |
Oggetto Publisher | Informazioni sul publisher dell'app. |
content |
Oggetto dei contenuti | Informazioni sui contenuti dell'app. |
keywords |
Stringa (formato CSV) | Non supportato. |
ext |
Estensioni per app | Estensioni per l'oggetto app. |
Oggetto Estensione per app
Campo | Tipo | Dettagli |
---|---|---|
inventorypartnerdomain |
Stringa | Utilizzato per la condivisione dell'inventario CTV, consulta la spiegazione relativa agli annunci per app CTV di IAB. |
Oggetto dei contenuti
Ti consigliamo di trasmettere questi attributi, se disponibili.
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Un ID che identifica in modo univoco i contenuti. |
episode |
Numero intero | Numero della puntata del contenuto (normalmente per i contenuti video). |
title |
Stringa | Consigliato per le richieste di TV connesse a internet (CTV), video e audio. |
series |
Stringa | Consigliato per le richieste di TV connesse a internet (CTV), video e audio. |
season |
Stringa | Un'etichetta per la stagione dei contenuti. |
artist |
Stringa | L'artista a cui sono attribuiti i contenuti. |
genre |
Stringa | Il genere che descrive meglio i contenuti. DV360 consiglia di fornire questo segnale per le richieste di TV connesse a internet (CTV), video e audio.
DV360 supporta alcune tassonomie di valori di genere video per questo campo: |
album |
Stringa | L'album a cui appartengono i contenuti, in genere per l'audio. |
isrc |
Stringa | International Standard Recording Code conforme alla norma ISO-3901. |
producer |
Oggetto Producer | Dettagli sul produttore dei contenuti. |
url |
Stringa | L'URL dei contenuti. |
cat |
Array di stringhe | Categorie di contenuti IAB che descrivono i contenuti. |
prodq |
Numero intero |
Qualità di produzione:
|
videoquality |
Numero intero | Non supportato. |
context |
Numero intero |
Tipo di contenuti:
|
contentrating |
Stringa | Consigliato per audio e video/CTV, in quanto inizieremo a prendere decisioni in base a questo attributo. |
userrating |
Stringa | Numero di stelle, Mi piace e così via. |
qagmediarating |
Numero intero |
Classificazione dei contenuti multimediali per [linee guida QAG](http://www.iab.net/ne_guidelines).
|
keywords |
Stringa (formato CSV) | Non supportato. |
livestream |
Numero intero |
Se i contenuti sono live streaming.
|
sourcerelationship |
Numero intero |
|
len |
Numero intero |
La durata dei contenuti in secondi.
Consigliato per le richieste di TV connesse a internet (CTV), video e audio. |
language |
Stringa (ISO-639-1-alpha-2) | La lingua dei contenuti. |
embeddable |
Numero intero |
Indicatore che indica se i contenuti sono incorporabili (ad es. un video player incorporabile)
|
data |
Array di oggetti di dati | Dati aggiuntivi. |
Oggetto producer
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Non supportato. |
name |
Stringa | Non supportato. |
cat |
Array di stringhe | Non supportato. |
domain |
Stringa | Dominio di primo livello del producer. |
Oggetto dati
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Un ID del fornitore di dati. |
name |
Stringa | Nome dell'exchange per il fornitore di dati. |
segment |
Array di oggetti Segmento | I valori effettivi dei dati. |
ext |
Estensioni dei dati | Estensioni per l'oggetto Data. |
Estensioni supportate per l'oggetto dati
Campo | Tipo | Dettagli |
---|---|---|
segtax |
Numero intero | ID tassonomia. Per ulteriori dettagli, consulta Tassonomie dei segmenti. |
segclass |
Stringa | La versione del classificatore che ha prodotto gli ID segmento all'interno della tassonomia. |
Oggetto Segment
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Un ID del segmento di dati specifico per il fornitore di dati. |
name |
Stringa | Nome del segmento di dati. |
value |
Stringa | Valore del segmento di dati. |
Oggetto publisher
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Obbligatorio. |
name |
Stringa | Non supportato. |
cat |
Array di stringhe | Non supportato. |
domain |
Stringa | Non supportato. |
Oggetto dispositivo
Campo | Tipo | Dettagli |
---|---|---|
ua |
Stringa | Obbligatorio. |
sua |
Oggetto UserAgent | Informazioni strutturate sullo user agent. |
geo |
Oggetto geografico | La posizione del dispositivo. |
dnt |
Numero intero |
Il flag Non tracciare impostato nell'intestazione del browser.
|
lmt |
Numero intero |
Il segnale Limita il monitoraggio degli annunci approvato commercialmente.
|
ip |
Stringa |
Obbligatorio se IPv4.
Se l'indirizzo IP è troncato, deve essere dichiarato in |
ipv6 |
Stringa |
Obbligatorio se IPv6.
Se l'indirizzo IP è troncato, deve essere dichiarato in |
devicetype |
Numero intero | Consigliato vivamente per tutti i tipi di inventario. Utilizzato per migliorare il riconoscimento del tipo di dispositivo. |
make |
Stringa | |
model |
Stringa | |
os |
Stringa |
Il sistema operativo del dispositivo.
Questo campo non distingue tra maiuscole e minuscole. |
osv |
Stringa | Non supportato. |
hwv |
Stringa | La versione hardware del dispositivo. |
h |
Numero intero | Altezza fisica dello schermo in pixel. |
w |
Numero intero | Larghezza fisica dello schermo in pixel. |
ppi |
Numero intero | Non supportato. |
pxratio |
Doppio | Il rapporto tra i pixel fisici e i pixel indipendenti dal dispositivo. |
js |
Numero intero | Non supportato. |
geofetch |
Numero intero | Non supportato. |
flashver |
Stringa | Non supportato. |
language |
Stringa (ISO-639-1-alpha-2) | La lingua del dispositivo. |
carrier |
Stringa | Non supportato. |
mccmnc |
Stringa | Non supportato. |
connectiontype |
Numero intero | Tipo di connessione di rete |
ifa |
Stringa | ID approvato per l'utilizzo da parte dell'inserzionista in formato non criptato. |
didsha1 |
Stringa | Non supportato. |
didmd5 |
Stringa | Non supportato. |
dpidsha1 |
Stringa | Non supportato. |
dpidmd5 |
Stringa | Non supportato. |
macsha1 |
Stringa | Non supportato. |
macmd5 |
Stringa | Non supportato. |
ext |
Estensioni per dispositivi | Estensioni per l'oggetto dispositivo. |
Estensione supportata per l'oggetto dispositivo
Se ip
viene modificato o troncato, ti consigliamo vivamente di inviare le seguenti
estensioni per evitare che il traffico venga dichiarato non valido.
Campo | Tipo | Dettagli |
---|---|---|
truncated_ip |
Numero intero |
Indica se l'indirizzo IP nel campo device.ip della
richiesta di offerta è troncato.
Il valore predefinito non è troncato ed è obbligatorio se l'indirizzo IP è troncato. Se non viene dichiarata, la richiesta di offerta potrebbe essere classificata come traffico non valido. |
ifa_type |
Stringa |
Indica l'origine del campo device.ifa, se è stato fornito dal
dispositivo stesso o generato dal publisher o dalla SSP nella supply chain.
|
attestation_token |
Stringa (codifica Base64) | Un token di attestazione basato sul dispositivo per gli scambi che supportano questo livello di convalida del dispositivo. |
atts |
Numero intero |
(Solo iOS) Un numero intero passato per rappresentare lo stato di autorizzazione al monitoraggio dell'app.
|
cdep |
Stringa |
Etichetta di ritiro dei cookie di terze parti di Chrome.
Consulta Test facilitati da Chrome e la specifica della community IAB. |
Oggetto UserAgent
Campo | Tipo | Dettagli |
---|---|---|
browsers |
Array di oggetti BrandVersion | Ogni oggetto BrandVersion identifica un browser o un componente software simile. |
platform |
Oggetto BrandVersion | Identifica la piattaforma. |
mobile |
Numero intero |
0 (impostazione predefinita): l'agente preferisce i contenuti "desktop" o "completi".
1 : l'agente preferisce i contenuti per dispositivi mobili.
|
architecture |
Stringa | Architettura del dispositivo, ad esempio "x86" o "arm". |
bitness |
Stringa | Il numero di bit del dispositivo, ad esempio "64" per l'architettura a 64 bit. |
model |
Stringa | Modello del dispositivo. |
source |
Numero intero | L'origine dei dati utilizzati per creare questo oggetto. Vedi Elenco: origine User-Agent. Consigliato quando si passa l' oggetto UserAgent. |
Oggetto BrandVersion
Campo | Tipo | Dettagli |
---|---|---|
brand |
Stringa | Identificatore del brand, ad esempio "Chrome" o "Windows". Obbligatorio. |
version |
Array di stringhe | Una sequenza di componenti della versione, in ordine gerarchico decrescente (principale, secondaria, micro e così via). |
Oggetto geografico
Campo | Tipo | Dettagli |
---|---|---|
lat |
Doppio | Non supportato. |
lon |
Doppio | Non supportato. |
type |
Numero intero | Non supportato. |
accuracy |
Numero intero | Non supportato. |
lastfix |
Numero intero | Non supportato. |
ipservice |
Numero intero | Non supportato. |
country |
Stringa | Non supportato. |
region |
Stringa | Non supportato. |
regionfips104 |
Stringa | Non supportato. |
metro |
Stringa | Non supportato. |
city |
Stringa | Non supportato. |
zip |
Stringa | Non supportato. |
utcoffset |
Numero intero | Non supportato. |
Oggetto utente
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | Supportato se Google ospita la tabella delle corrispondenze degli ID. |
buyeruid |
Stringa | Supportato se la SSP ospita la tabella delle corrispondenze degli ID. |
yob |
Numero intero | Consigliato per il targeting demografico. |
gender |
Stringa | Consigliato per il targeting demografico. |
keywords |
Stringa (CSV) | Non supportato. |
customdata |
Stringa | Non supportato. |
geo |
Oggetto geografico | Non supportato. |
data |
Array di oggetti di dati | Dati aggiuntivi. |
eids |
Array di oggetti ID esteso | Istanze di ID estesi fornite dalla piattaforma di scambio. |
ext |
Estensioni utente | Estensioni per l'oggetto utente. |
Estensioni supportate per l'oggetto utente
Campo | Tipo | Dettagli |
---|---|---|
consent |
Stringa (Base64 sicura per il web) |
Stringa di consenso IAB.
Contiene metadati sulle informazioni che l'utente ha acconsentito alla raccolta e sui fornitori autorizzati a utilizzare queste informazioni. Il valore è una stringa binaria con codifica Base64 sicura per il web che utilizza un formato binario personalizzato. |
us_privacy |
Stringa | Se l'utente ha visto la conformità al CCPA o a leggi simili. |
consented_providers_settings .consented_providers |
Oggetto esterno (consented_providers_settings) che racchiude un array di numeri interi interno (consented_providers). | Quando il consenso GDPR viene raccolto tramite il TCF, questo campo elenca i fornitori di tecnologia pubblicitaria per i quali l'utente ha fornito il consenso e che non partecipano al TCF. Consulta la specifica tecnica del Consenso aggiuntivo di Google. |
eids |
Array di oggetti ID esteso | Istanze di ID estesi fornite dalla piattaforma di scambio. |
Oggetto ID esteso
Campo | Tipo | Dettagli |
---|---|---|
source |
Stringa | Il fornitore dell'identificatore |
uids |
Array di oggetti UID ID esteso | Gli identificatori effettivi |
Oggetto UID ID esteso
Campo | Tipo | Dettagli |
---|---|---|
id |
Stringa | L'identificatore stesso. |
atype |
Numero intero | Il tipo di user agent associato a questo ID. |
Oggetto della catena di fornitura
Campo | Tipo | Dettagli |
---|---|---|
complete |
Numero intero | 0 (impostazione predefinita): la catena di fornitura è incompleta.1 : La catena di fornitura è completa fino al publisher.
|
ver |
Stringa | Obbligatorio. Il valore è formattato come "major.minor", ad esempio la versione 1.0 è la stringa "1.0". |
nodes |
Array Supply chain node | Obbligatorio. In una catena di fornitura completa, il primo nodo rappresenta il sistema pubblicitario e l'ID venditore iniziali coinvolti nella transazione, ovvero il proprietario del sito, dell'app o di un altro mezzo. In una supply chain incompleta, rappresenta il primo nodo noto. L'ultimo nodo rappresenta l'entità che invia questa richiesta di offerta. |
Oggetto nodo della catena di fornitura
Campo | Tipo | Dettagli |
---|---|---|
asi |
Stringa | Il nome del dominio canonico di SSP, piattaforma di scambio, wrapper di intestazione e così via, del sistema a cui si collegano gli strumenti di offerta. Questo valore può corrispondere al dominio operativo
del sistema, se è diverso dal dominio aziendale principale,
per agevolare ricerche WHOIS e ricerche inverse a partire dall'IP in modo da stabilirne chiaramente
l'appartenenza del sistema delegato.
Deve essere lo stesso valore utilizzato per identificare i venditori in un file ads.txt, se esistente. |
sid |
Stringa | L'identificatore associato all'account venditore o rivenditore nel sistema pubblicitario. Deve contenere lo stesso valore utilizzato nelle
transazioni (ad es. richieste di offerta OpenRTB) nel campo specificato
dalla SSP/piattaforma di scambio.
In genere, in OpenRTB si tratta di publisher.id. Per OpenDirect, in genere è l'ID organizzazione del publisher. Deve avere una lunghezza massima di 64 caratteri. |
rid |
Stringa | L'ID richiesta OpenRTB della richiesta emessa da questo venditore. |
name |
Stringa | Il nome della società (la persona giuridica) che viene pagata per l'inventario
di cui è stata eseguita la transazione con l'ID venditore specificato. Questo valore è facoltativo e NON deve essere incluso se esiste nel file sellers.json del sistema pubblicitario. |
domain |
Stringa | Il nome di dominio aziendale dell'entità rappresentata da questo nodo.
Questo valore è facoltativo e NON deve essere incluso se esiste nel file sellers.json del sistema pubblicitario. |
hp |
Numero intero | Indica se questo nodo sarà coinvolto nel flusso di pagamento
per l'inventario.
Per la versione 1.0 di SupplyChain, questa proprietà deve essere sempre 1. È esplicitamente obbligatorio includerlo, in quanto si prevede che le versioni future della specifica introdurranno nodi di gestione non dei pagamenti. Gli implementatori devono assicurarsi di supportare questo campo e di propagarlo quando costruiscono oggetti SupplyChain nelle richieste di offerta inviate a un sistema pubblicitario downstream. |
Specifica della risposta all'offerta
Oggetto BidResponse
Attributo | Supportato | Dettagli di implementazione | Sempre superato |
---|---|---|---|
id | Se si verifica un errore di analisi, questo valore potrebbe essere "0" anziché l'ID richiesta di offerta. | Sì | |
seatbid | |||
bidid | |||
cur | Se si verifica un errore di analisi, questo valore non viene trasmesso. Per il traffico di richieste di offerta valide, cur viene sempre fornito. | Sì | |
customdata | |||
nbr |
Questo valore è incluso solo se è stato rilevato un problema con la richiesta di offerta. I valori possibili includono:2 : Richiesta non valida12 : Violazione dell'autorizzazione ads.txt16 : SupplyChain incompleta17 : Nodo SupplyChain bloccatoNota:quando viene rilevata una violazione specifica di (app-)ads.txt o SupplyChain, uno dei codici 12, 16 o 17 viene inserito in una frazione (1%) delle risposte. Il codice 2 verrà compilato per tutte le altre richieste non valide. Le richieste che includono NBR saranno simili a questa: { "id": "0", "nbr": 2, "ext": { "err": "Bid request body was empty.", "errHelp": "https://.../ortb-spec" } } |
||
ext | Se si verifica un problema con l'estensione della richiesta di offerta, questa potrebbe contenere informazioni per aiutare a diagnosticare l'errore, se supportato. |
Estensioni supportate per l'oggetto BidResponse
Attributo | Dettagli di implementazione |
---|---|
err | Una descrizione leggibile dell'errore nella richiesta di offerta. I casi di risposta includono:
|
errHelp | Un link a questa pagina. |
Oggetto Seatbid
Attributo | Supportato | Dettagli di implementazione | Sempre superato |
---|---|---|---|
offerta | sì | ||
utenza | sì | ||
gruppo |
Oggetto offerta
Attributo | Supportato | Dettagli di implementazione | Sempre superato |
---|---|---|---|
id | sì | ||
impid | sì | ||
prezzo | sì | ||
nurl | |||
burl | |||
lurl | |||
adm | |||
adid | |||
adomain | |||
gruppo | |||
iurl | |||
cid | sì | ||
crid | sì | ||
tattica | |||
gatto | |||
attr | |||
api | |||
protocollo | |||
qagmediarating | |||
language | |||
dealid | |||
w | |||
h | |||
wratio | |||
hratio | |||
exp |
Estensioni supportate per l'oggetto Offerta
Attributo | Dettagli di implementazione |
---|---|
apis |
DV360 invierà seatbid.bid.apis se sono supportati sia OMID che MRAID. DV360 imposterà sia OMID_1 sia MRAID come array di numeri interi. |
Opzioni di pubblicazione degli annunci
Nella sezione 4.3 delle specifiche OpenRTB, sono disponibili due diverse opzioni di pubblicazione:
- Markup pubblicato nella notifica di vincita
- Markup pubblicato nell'offerta
DV360 supporta entrambe le opzioni.
- Per l'annuncio banner, DV360 restituisce sempre il markup nel campo
adm
. Il markup pubblicato nella notifica di vincita è facoltativo. - Per gli annunci video/audio che utilizzano il protocollo VAST, DV360 supporta la restituzione di XML VAST nel campo
adm
o nella risposta della notifica di vincita in base ai requisiti dei partner di scambio.
Consulta la specifica OpenRTB per conoscere i pro e i contro di queste due opzioni.
Best practice
Ti consigliamo vivamente di utilizzare l'ID partner di Display & Video 360 come ID sede. L'utilizzo dell'ID posto specifico per la piattaforma di scambio non è consigliato.
Assicurati che i tuoi publisher abbiano file ads.txt o applicazioni con file app-ads.txt associati e che ti elenchino nel file come venditore o rivenditore autorizzato. Ulteriori informazioni.
Assicurati inoltre che le informazioni trasmesse nelle richieste di offerta siano coerenti. Ad esempio, l'app.bundle
deve essere coerente con le informazioni sul dispositivo mobile e con app.storeurl
.
TV connessa a internet
Rispetta le linee guida IAB per l'identificatore della pubblicità (IFA) sulle piattaforme OTT quando trasmetti device.ifa
e device.lmt
. Per rispettare le linee guida, devi anche implementare
device.ext.ifa_type
. Tutte le nostre funzionalità di quota limite e targeting per pubblico per la TV connessa a internet
richiederanno la presenza
di un IFA.
Inoltre, rispetta le linee guida per l'ID assegnato allo store OTT/CTV dell'IAB pubblicate di recente, che definiscono come deve essere trasmesso app.bundle
per le app per TV connesse a internet, utilizzando in gran parte l'ID definito dallo store.
Misurazione con Visualizzazione attiva
Visualizzazione attiva è una tecnologia di Google utilizzata per misurare se un'impressione era visibile e per quanto tempo. Visualizzazione attiva utilizza OMID sia per gli annunci display che per quelli video. Per attivare la misurazione utilizzando OMID, gli exchange devono aggiungere i seguenti campi nelle richieste OpenRTB in modo che DV360 conosca il supporto di OMID da parte del client.
- Obbligatorio: aggiungi un framework API (
Video.api=7
perOMSDK
) alle richieste di offerta. Questo è obbligatorio per consentire la misurazione con Visualizzazione attiva utilizzando OMID. - Consigliato: l'aggiunta di
omidpn
eomidpv
aSource.Ext
è vivamente consigliata perché influirà sul modo in cui le misurazioni della visibilità vengono riportate in DV360 al cliente. Se il nome del partner OMID non è presente nell'elenco delle certificazioni IAB, MRC ci richiede di segnalare le metriche di visibilità separatamente dalle metriche certificate MRC. Scopri di più.
Domande frequenti
- DV360 supporta le estensioni personalizzate delle piattaforme di scambio?
- Sì, oltre alle estensioni elencate in questa specifica, Display & Video 360 può supportare anche estensioni personalizzate caso per caso. Ti consigliamo di specificare e testare l'estensione personalizzata durante il periodo di integrazione.
- DV360 supporta i video con premio?
- Sì, inviaci l'estensione video con premio.
- Gran parte del mio inventario viene visualizzato come dati demografici sconosciuti. Come posso migliorare la copertura demografica?
- Compila
user.yob
euser.gender
nelle richieste di offerta a DV360 per aumentare la copertura. - DV360 ha endpoint per ogni regione?
- No, utilizziamo un singolo endpoint a livello globale e indirizziamo automaticamente le richieste al data center più vicino, quindi non possiamo fornire un endpoint specifico per regione.
- Quali sono i requisiti per le richieste server-server (s2s)?
- Contattaci per richiedere l'aggiunta alla nostra lista consentita. Lo user agent del client deve essere inoltrato e assicurarsi che i cookie siano disattivati/ignorati nella risposta a un recupero VAST s2s.
- DV360 supporta OMID?
- Possiamo misurare la visibilità utilizzando OMID a condizione che venga dichiarato come abilitato per OMID al momento della richiesta di offerta. I dettagli sono riassunti nelle pagine 24-25.
- Quale versione di Native supportate? Hai requisiti per gli annunci nativi?
- Supportiamo solo Native Ver1.2. Specifiche native.
- DV360 supporta le richieste di offerta inviate come GZIP?
- DV360 può ricevere richieste di offerta compresse con gzip e risponderà con risposte compresse con gzip se l'intestazione Accept-Encoding indica che è supportata.
- DV360 supporta DBURL?
- Al momento no.
- DV360 supporta la notifica di vittoria/sconfitta?
- Al momento no. Se ritieni che sarebbe utile per noi supportarlo, contattaci per fornirci maggiori dettagli.
- DV360 richiede App.name per il targeting?
- No, DV360 utilizza App.name come riferimento, ma non è obbligatorio per il targeting.
App.bundle
viene utilizzato per il targeting. - DV360 può supportare più dimensioni degli annunci inviate in un'unica richiesta di offerta?
- Sì, prenderemo in considerazione tutte le dimensioni delle creatività idonee in banner.format.
- DV360 supporta più formati nella stessa richiesta di offerta?
- Il supporto per le richieste di offerta multiformato è limitato, ma stiamo lavorando per migliorarlo. Supportiamo i formati display e video per gli interstitial, ma al momento non supportiamo display e nativi. Se invii richieste di offerta multiformato, contattaci per richiedere un test.
- DV360 supporta tipi di impressioni misti nella stessa richiesta?
- Al momento supportiamo solo gli interstitial video/banner. Stiamo lavorando su nativi/banner e video/banner. Se esistono altre combinazioni, contatta il nostro team.
- Più seat possono inviare più offerte per una o più di queste opportunità di impressione nella stessa richiesta?
- Sì.
- DV360 ha una soluzione o un'esigenza particolare in merito al capping o alla visualizzazione dello stesso inserzionista per più opportunità di impressione dello stesso tipo nella stessa richiesta?
- DV360 applica la regola secondo cui un inserzionista può fare offerte per un massimo di un'opportunità di impressione per ogni richiesta. Prevediamo che le SSP raggruppino gli oggetti impression in modo significativo, ad esempio tutti nella stessa pagina, tutti nella stessa app e così via.
- Display & Video 360 supporta più impressioni nella stessa richiesta di offerta?
- DV360 attualmente supporta più oggetti audio di impressione. Tuttavia, dovremo testare/attivare ogni
exchange che vuole utilizzare questa funzionalità. Per saperne di più, consulta le specifiche delle richieste di offerta. Stiamo lavorando per estendere questa funzionalità ad altri formati:
{ id: "2bbdc94f-7289-4fe2-9a5f-e2a530e06b38", seatbid { bid { id: "0", impid: "234232", price: 41.373926619828261, adid: "123", adm: "...", adomain: "xxx.com", cid: "0", crid: "123", dealid: "sample-deal-id-1", language: "xx", }, bid { id: "1", impid: "234255", price: 2.34192037470726, adid: "234", adm: "...", adomain: "xyz.com", cid: "0", crid: "234", dealid: "sample-deal-id-2", language: "xx", }, seat: "123456" }, cur: "EUR" }
Contattaci
In caso di domande o problemi, contatta il nostro team di assistenza per gli scambi.