Dati strutturati - v3.1 - Elementi pubblicitari

Questa versione di SDF è stata ritirata. Gli utenti devono eseguire la migrazione alla versione v9 dei file di dati strutturati per continuare a utilizzarli. Utilizza questa documentazione solo quando fai riferimento a file generati in precedenza.

Per una spiegazione del formato, consulta la panoramica.

Campo	Obbligatorio	Tipo	Scrivibile	Descrizione
ID elemento pubblicitario	Obbligatorio solo quando vengono modificati gli elementi pubblicitari esistenti	integer	No	Valore dell'ID numerico dell'elemento pubblicitario. Se il campo viene lasciato vuoto, verrà creato un nuovo elemento pubblicitario e verrà assegnato un ID univoco. Se vuoi, quando crei nuovi elementi pubblicitari, puoi utilizzare un identificatore personalizzato per assegnare gruppi di annunci TrueView al nuovo elemento pubblicitario. Il formato di un identificatore personalizzato è "ext[identificatore personalizzato]", ad esempio ext123. Quando il file viene caricato ed elaborato, tutti gli identificatori personalizzati vengono sostituiti con gli ID assegnati da DBM e gli oggetti vengono associati (ad esempio, gruppo di annunci a elemento pubblicitario) in base agli identificatori personalizzati.
ID Io	Sì	integer	No	Valore dell'ID numerico dell'ordine di inserzione. Puoi specificare un identificatore personalizzato (ad esempio, "ext[identificatore IO personalizzato]") per un ordine di inserzione che stai creando contemporaneamente a questo elemento pubblicitario.
Tipo	Sì	stringa	Sì	Il tipo di voce. Scrivibile solo durante la creazione, non la modifica. Display Video TrueView Audio
Sottotipo	Sì	stringa	Sì	Campo obbligatorio per gli elementi pubblicitari TrueView per distinguere tra i formati TrueView standard e per l'installazione di app mobile Semplice Installazione di app mobili
Nome	Sì	stringa	Sì	Il nome della voce.
Timestamp	Obbligatorio quando si modificano le voci esistenti	integer	No	Il timestamp della voce, utilizzato dal sistema per verificare che la voce non sia stata modificata nel periodo tra il download e il caricamento.
Stato	Sì	stringa	Sì	L'impostazione dello stato per la voce. Attivo In pausa Bozza Archiviata Eliminato
Data di inizio	Sì	stringa	Sì	Un timestamp per la data di inizio del volo della voce nel formato MM/GG/AAAA HH:mm.
Data di fine	Sì	stringa	Sì	Un timestamp per la data di fine del periodo di pubblicazione della voce nel formato MM/GG/AAAA HH:mm.
Tipo di budget	Sì	stringa	Sì	Specifica se il budget è basato su un importo monetario o sulle impressioni. Se l'ordine di inserzione per questa voce è abilitato per l'allocazione automatica del budget, puoi impostare questa opzione su "Automatico" per consentire a DBM di impostare automaticamente il budget per questa voce. Importo Impressioni Illimitato Automatico Budget giornaliero TrueView
Importo del budget	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	float	Sì	Un importo del budget positivo per il tipo di budget. Potrebbe trattarsi di un semplice valore intero di impressione o di un numero in virgola mobile per un importo in valuta. Le valute verranno mostrate nella valuta dell'inserzionista in unità standard (non in 1/1.000.000 di unità di valuta). Se per la voce è impostata l'allocazione automatica del budget, puoi specificare un importo minimo da spendere (ad esempio, "spendi almeno" questo importo).
Pacing	Sì	stringa	Sì	Il periodo di tempo utilizzato per spendere l'importo del pacing. Ogni giorno Mensile Volo
Tasso di pacing	Sì	stringa	Sì	Il tasso di pacing per questa voce. ASAP Uniforme In anticipo
Importo di pacing	Sì	float	Sì	L'importo da spendere per il periodo di tempo impostato dal tipo di pubblicazione.
Frequenza attivata	Sì	stringa	Sì	Attiva/disattiva la quota limite basata sulle impressioni nell'elemento pubblicitario. VERO FALSO
Esposizioni alla frequenza	Obbligatorio quando "Frequenza attivata" è "TRUE"	integer	Sì	Un numero intero positivo che indica il numero di impressioni in un determinato importo della frequenza, ovvero la x in "Mostra x impressioni in un periodo di tempo y".
Periodo di frequenza	Obbligatorio quando "Frequenza attivata" è "TRUE"	stringa	Sì	Specifica l'unità di periodo di tempo per la quota limite. Per gli elementi pubblicitari TrueView, i periodi supportati sono Giorni, Settimane e Mesi. Minuti Ore Giorni Settimane Mesi Intera durata
Importo frequenza	Obbligatorio quando "Frequenza attivata" è "TRUE"	integer	Sì	Un importo intero positivo per la durata del tipo di periodo di frequenza, ovvero y in "Mostra x impressioni nel periodo y". Questo importo non è supportato per gli elementi pubblicitari TrueView.
Frequenza di visualizzazione TrueView attivata	Obbligatorio quando "Tipo" è "TrueView"	stringa	Sì	Attiva/disattiva la quota limite basata sulle visualizzazioni nell'elemento pubblicitario TrueView VERO FALSO
Esposizioni alla frequenza di visualizzazione TrueView	Obbligatorio quando "Frequenza visualizzazioni TrueView attivata" è "TRUE"	integer	Sì	Un numero intero positivo che indica il numero di visualizzazioni TrueView, ovvero la x in "Mostra x visualizzazioni nel periodo"
Periodo di frequenza di visualizzazione TrueView	Obbligatorio quando "Frequenza visualizzazioni TrueView attivata" è "TRUE"	stringa	Sì	Specifica l'unità di periodo di tempo per la quota limite basata sulle visualizzazioni TrueView Giorni Settimane Mesi
Modello di entrate del partner	Sì	stringa	Sì	Un modello di ricavi del partner è il meccanismo di controllo per le modalità di calcolo delle entrate in Bid Manager. Utilizza questo modello per monitorare la maggiorazione relativa alle commissioni di servizio. TMCM - Total Media Cost Markup MCM - Media Cost Markup CPM - Costo per mille impressioni
Importo delle entrate partner	Sì	float	Sì	Un valore in virgola mobile positivo corrispondente al modello di entrate del partner.
Tipo di conteggio delle conversioni	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	stringa	Sì	Scegli i tipi di conversioni da conteggiare. Conteggio di tutti Conteggio post-clic Percentuale di conteggio
Percentuale di conteggio delle conversioni	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	float	Sì	Specifica la percentuale per il tipo di conteggio delle conversioni "Conteggio %". Formatta la percentuale come numero in virgola mobile (3,123% = 3,123), con una precisione limitata ai millesimi (3 cifre decimali).
ID pixel di conversione	No	stringa, elenco di elenchi	Sì	Specifica i pixel di conversione come elenco di elenchi. Ogni pixel è specificato come ID pixel, finestra post-visualizzazione (in minuti) e finestra post-clic (in minuti). Formato elenco = (Pixel.common_data.id; view_window_minutes; click_window_minutes;).
Tariffe	No	stringa, elenco di elenchi	Sì	Tutte le commissioni per questa voce. Formato elenco = (categoria commissione; importo commissione; tipo di commissione; fatturato;). Categoria di commissione CPM Media Importo della commissione Float Percentuale come numero in virgola mobile Tipo di tariffa (stringa, vedi tabella nelle tariffe) Con fatturazione non automatica Vero Falso vuoto Esempio: '(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True);' I valori accettabili sono riportati nella tabella seguente: Nota: la tariffa CPM per le tariffe premium è riservata dal sistema ed è immutabile. La cardinalità della tariffa premium viene mantenuta nelle mutazioni inserendo le tariffe CPM predefinite, se necessario. Categoria di commissione Tipo di commissione Opzione fatturata CPM/Media Predefinito Non consentito (lasciare vuoto) CPM/Media Ad server di terze parti Non consentito (lasciare vuoto) CPM/Media DoubleVerify Consentito (vero/falso) CPM/Media Adsafe Non consentito (lasciare vuoto) CPM/Media AdXpose Non consentito (lasciare vuoto) CPM/Media Vizu Non consentito (lasciare vuoto) CPM/Media Aggregate Knowledge Non consentito (lasciare vuoto) CPM/Media Teracent Non consentito (lasciare vuoto) CPM/Media Evidon Non consentito (lasciare vuoto) CPM/Media Tariffa trading desk agenzia Non consentito (lasciare vuoto) CPM/Media Adloox Consentito (vero/falso) CPM ShopLocal Obbligatorio (True) CPM TrustMetrics Non consentito (lasciare vuoto) CPM Video Integral Ad Science Consentito (vero/falso) CPM Video MOAT Non consentito (lasciare vuoto) Media Tariffa Bid Manager Obbligatorio (True) Media Dati sul costo dei media Non consentito (lasciare vuoto) CPM Tariffe premium Non consentito (lasciare vuoto)
Codice integrazione	No	string	Sì	Un codice facoltativo per il monitoraggio.
Dettagli	No	string	Sì	Dettagli della voce in formato stringa.
Tipo strategia di offerta	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	stringa	Sì	Seleziona una delle strategie di offerta applicabili: Minimizza: mentre spendi interamente il budget, minimizza il CPA/CPC Massimizza: massimizza il valore delle impressioni o le impressioni di qualità, ma spendi interamente il budget. Supera: raggiungi o supera un obiettivo di X CPA/CPC Ottimizza vCPM: ottimizza per offerta CPM visibile di X Fissa: specifica un'offerta fissa di X
Valore strategia di offerta	Obbligatorio a meno che "Tipo di strategia di offerta" non sia "Minimizza", "Massimizza" o "Tipo" non sia "TrueView"	float	Sì	Per i tipi di strategia Supera, Ottimizza VCPM e Fissa, scegli un valore per l'offerta obiettivo. Tieni presente che non è necessario alcun valore della strategia di offerta per i tipi di strategia di offerta "Minimizza" o "Massimizza".
Unità strategia di offerta	Obbligatorio quando "Tipo di strategia di offerta" è "Supera" ,"Minimizza" o "Massimizza"	stringa	Sì	Per i tipi di strategia Supera, Riduci al minimo o Massimizza, seleziona l'unità corrispondente: CPA CPC impr. valore/costo personalizzate CIVA IVO_TEN AV_VIEWED INCREMENTAL_CONVERSIONS
Strategia di offerta Non superare	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	float	Sì	Imposta un valore CPM "non superare". Se è 0, l'opzione "Non superare" non è abilitata. Questa opzione è disponibile solo se la strategia di offerta è "Minimizza", "Massimizza" o "Supera".
Assegnazioni creatività	No	stringa, elenco	Sì	Elenco degli ID creatività da assegnare alla voce. Formato elenco = (Creative.common_data.id;Creative.common_data_id;ecc.).
Targeting geografico - Includi	No	stringa, elenco	Sì	Elenco delle aree geografiche da includere nel targeting. Formato elenco = (GeoLocation.id; GeoLocation.id; ecc.).
Targeting geografico - Escludi	No	stringa, elenco	Sì	Elenco delle aree geografiche da escludere dal targeting. Formato elenco = (GeoLocation.id;GeoLocation.id; ecc.).
Targeting per lingua - Includi	No	stringa, elenco	Sì	Elenco delle lingue da includere nel targeting. Formato elenco = (Language.id;Language.id;ecc.).
Targeting per lingua - Escludi	No	stringa, elenco	Sì	Elenco delle lingue da escludere dal targeting. Formato elenco = (Language.id;Language.id;ecc.).
Targeting per dispositivo - Includi	No	stringa, elenco	Sì	Elenco dei dispositivi da includere nel targeting. Formato elenco = (DeviceCriteria.id;DeviceCriteria.id;ecc.).
Targeting per dispositivo - Escludi	No	stringa, elenco	Sì	Elenco dei dispositivi da escludere dal targeting. Formato elenco = (DeviceCriteria.id;DeviceCriteria.id;ecc.).
Targeting per browser - Includi	No	stringa, elenco	Sì	Elenco dei browser da includere nel targeting. Formato elenco = (Browser.id;Browser.id;ecc.).
Targeting per browser - Escludi	No	stringa, elenco	Sì	Elenco dei browser da escludere dal targeting. Formato elenco = (Browser.id;Browser.id;ecc.).
Etichette di sicurezza del brand	No	stringa, elenco	Sì	Elenco delle etichette dei contenuti digitali da scegliere come target. Formato elenco = (G;PG; ecc.). G PG T MA ?
Impostazione della sensibilità della sicurezza del brand	No	string	Sì	Scegli l'impostazione di sensibilità per bloccare l'inventario in base all'argomento dei contenuti circostanti. Non bloccare Utilizzare la verifica DoubleClick Usa personalizzato
Impostazioni personalizzate di sicurezza del brand	Obbligatorio quando "Impostazione personalizzata per la sicurezza del brand" è "Utilizza personalizzata"	stringa, elenco	Sì	Se l'impostazione di sensibilità della sicurezza del brand è "Utilizza personalizzata", specifica l'elenco dei classificatori di contenuti standard. Ad esempio, (Adulti;Alcol;Tabacco;ecc.). Adulto Contenuti dispregiativi Download e condivisione Armi Giochi e scommesse Violenza Contenuti allusivi Linguaggio volgare Alcolici Droghe Tabacco Politica Religione Eventi tragici Incidenti relativi ai trasporti Problemi sociali sensibili Scioccante
Servizi di verifica di terze parti	No	string	Sì	Fornitore di servizi di verifica di terze parti. Nessuno Integral Ad Science DoubleVerify Adloox
Etichette di verifica di terze parti	No	stringa, elenco	Sì	Se i servizi di verifica di terze parti non sono impostati su "Nessuno", specifica un elenco di etichette supportate dal fornitore selezionato.
Targeting per canale - Includi	No	stringa, elenco	Sì	Elenco dei canali da includere nel targeting. Formato elenco = (UniversalChannel.id;UniversalChannel.id; ecc.).
Targeting dei canali - Escludi	No	stringa, elenco	Sì	Elenco dei canali da includere nel targeting. Formato elenco = (UniversalChannel.id;UniversalChannel.id; ecc.).
Targeting per sito - Includi	No	stringa, elenco	Sì	Elenco dei siti da includere nel targeting. L'elenco può includere un insieme di ID sito o stringhe di URL, se non trovati nella tabella Sito universale. Formato elenco = (UniversalSite.Id;'http://someurl.com';etc.).
Targeting per sito - Escludi	No	stringa, elenco	Sì	Elenco dei siti da escludere dal targeting. L'elenco può includere un insieme di ID sito o stringhe di URL, se non trovati nella tabella Sito universale. Formato elenco = (UniversalSite.Id;'http://someurl.com';etc.).
Targeting per app - Includi	No	stringa, elenco	Sì	Elenco delle app da includere nel targeting. L'elenco può includere un insieme di ID sito universale o stringhe di pacchetti app, se non trovati nella tabella Sito universale. Formato elenco = (UniversalSite.Id; 'some.app.package';etc.).
Targeting per app - Escludi	No	stringa, elenco	Sì	Elenco di app da escludere dal targeting. L'elenco può includere un insieme di ID sito universale o stringhe di pacchetti app, se non trovati nella tabella Sito universale. Formato elenco = (UniversalSite.Id; 'some.app.package';etc.).
Targeting per categoria - Includi	No	stringa, elenco	Sì	Elenco delle categorie da includere nel targeting, dagli ID verticali AdX. Formato elenco = (Verticals.Id;Verticals.Id;ecc.).
Targeting per categoria - Escludi	No	stringa, elenco	Sì	Elenco delle categorie da escludere nel targeting, dagli ID verticali AdX. Formato elenco = (Verticals.Id;Verticals.Id;ecc.).
Targeting per parole chiave - Includi	No	stringa, elenco	Sì	Elenco di stringhe di parole chiave da includere nel targeting.
Targeting per parole chiave - Escludi	No	stringa, elenco	Sì	Elenco di stringhe di parole chiave da escludere dal targeting.
Targeting per pubblico - Segmenti di pubblico simili	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	stringa	Sì	Attiva i segmenti di pubblico simili per gli elenchi proprietari con targeting positivo. VERO FALSO
Targeting per pubblico - Includi	No	stringa, elenco di elenchi di coppie	Sì	Elenco dei segmenti di pubblico da includere nel targeting. Per gli elenchi dei segmenti di pubblico proprietari, ogni segmento di pubblico è elencato come coppia di ID UserList e impostazione di recency. Una coppia è (1;1d;), dove 1d è una recente rappresentazione di un giorno. La recente attività non è disponibile per i segmenti di pubblico di terze parti, quindi il formato dell'elenco è (3;);(4;);. Per combinare gruppi di segmenti di pubblico con le condizioni "AND" e "OR", segui questo esempio: per combinare coppie con e senza recentezza: ' ((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. Ciò significa (elenco 1 con aggiornamento di 1 giorno O elenco 2 con aggiornamento di 365 giorni) E (elenco 3 senza un aggiornamento specificato O elenco 4 con aggiornamento di 5 minuti O elenco 5 con tutti gli utenti). I valori di aggiornamento validi sono: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Targeting per pubblico - Escludi	No	stringa, elenco di elenchi di coppie	Sì	Elenco dei segmenti di pubblico da escludere dal targeting. Ogni segmento di pubblico è elencato come una coppia di ID elenco utenti e impostazione di recency, se l'elenco del segmento di pubblico è un elenco del segmento di pubblico proprietario. Una coppia è (1;1d;), dove 1d è una recente rappresentazione di un giorno. Tuttavia, per i segmenti di pubblico di terze parti, la recency non è disponibile, quindi il formato dell'elenco è (3;);(4;);. Formato elenco= (UserList.id; recency optional;); (UserList.id; recency optional;); Esempio: "(1;1d;);(2;);". Valori di recency validi: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Targeting per affinità e in-market - Includi	No	stringa, elenco	Sì	Elenco dei segmenti di pubblico in-market e/o di affinità da includere. Formato elenco= UserList ID; UserList ID;
Targeting di affinità e in-market - Escludi	No	stringa, elenco	Sì	Elenco dei segmenti di pubblico in-market e/o di affinità da escludere. Formato elenco= UserList ID; UserList ID;
Targeting di affinità personalizzata	No	stringa, elenco	Sì	Elenco degli elenchi personalizzati da usare come target. Formato elenco= UserList ID; UserList ID;
Targeting origine inventario - Includi	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	stringa, elenco	Sì	Elenco dell'inventario da includere nel targeting. Formato elenco = (InventorySource.id; InventorySource.id;).
Targeting origine inventario - Escludi	No	stringa, elenco	Sì	Elenco dell'inventario da escludere dal targeting. Formato elenco = (InventorySource.id; InventorySource.id;).
Targeting per fascia oraria	No	stringa, elenco	Sì	Elenco di ID, in cui ogni ID parte del giorno è strutturato nel seguente formato: daypart_id = base_dayparting_id + days_since_monday * 10000 + start * 100 + end base_dayparting_id = 300000 days_since_monday: 0=lunedì, 1=martedì, ..., 6=domenica start: 0..95 (00:00-23:45), un numero intero da 0 a 95 che rappresenta intervalli di 15 minuti end: 1..96 (00:15-24:00), un numero intero da 0 a 95 che rappresenta intervalli di 15 minuti start < end Per le nuove entità, gli orari verranno impostati nel fuso orario degli utenti (ad es. "Locale"). Per le entità esistenti, il fuso orario non verrà modificato.
Targeting per ambiente	Obbligatorio quando "Tipo" è "Display", "Video" o "Audio"	stringa, elenco	Sì	Elenco degli ambienti di destinazione. Formato elenco = (web desktop; app mobile; ecc.). Per l'ambiente display: Web desktop Web mobile App mobile Interstitial per app mobile Web Desktop su dispositivi mobili Per i video: Video web per computer Gioco web per computer Desktop web in-read Desktop web in-feed Video per web mobile Video app mobile Interstitial video per app mobile Per l'audio: Audio web per computer Audio web mobile Audio per app mobile
Targeting per visibilità con Visualizzazione attiva	No	string	Sì	Scegli come target le percentuali di visibilità previste. Le percentuali sono rappresentate come numeri in virgola mobile. Uno dei seguenti valori: {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Targeting per visibilità Posizione dell'annuncio - Includi	No	string	Sì	Targeting delle posizioni degli annunci. Seleziona uno o nessuno dei valori accettabili: Tutti ATF BTF Sconosciuto
Targeting per visibilità Posizione dell'annuncio - Escludi	No	string	Sì	Escludi le posizioni degli annunci dal targeting. Seleziona uno o nessuno dei valori accettabili: ATF BTF Sconosciuto
Targeting per posizione annuncio video	No	stringa, elenco	Sì	Elenco delle posizioni degli annunci video da scegliere come target. Seleziona uno o più dei valori accettabili: sconosciuto Pre-roll Mid-roll Post-roll
Targeting in base alle dimensioni del video player	No	stringa, elenco	Sì	Elenco delle dimensioni del video player da usare come target. Seleziona uno o più dei valori accettabili: sconosciuto piccola grande HD
Targeting demografico: genere	No	stringa, elenco	Sì	Elenco dei generi da scegliere come target. Seleziona uno o più dei valori accettabili: Donna UomoMaschio Sconosciuto
Targeting demografico per età	No	stringa, elenco	Sì	Targeting su una fascia d'età degli utenti. Specifica un intervallo da/a selezionando una singola età iniziale e una singola età finale e se includere o meno le età sconosciute. Consulta l'elenco delle età Da/A accettabili. Esempio 1: per scegliere come target la fascia d'età 18-55 anni e includere le età sconosciute, specifica il formato {Da; A; Includi sconosciuto Vero/Falso} = 18;55;true; Esempio 2: per scegliere come target solo gli utenti di età superiore a 35 anni ed escludere le età sconosciute, specifica quanto segue = 35;+;false;. Valori accettabili per Da: 18 25 35 45 55 65 Valori accettati per A: 25 35 45 55 65 +
Targeting per velocità di connessione	No	string	Sì	Targeting per una velocità di connessione specifica. Seleziona uno dei valori accettabili: Tutti 2G 3G DSL 4G
Targeting per operatore - Includi	No	stringa, elenco	Sì	Elenco di ISP o operatori da scegliere come target. Formato elenco = {ISP.id; ISP.id;}
Targeting per operatore - Escludi	No	stringa, elenco	Sì	Elenco di ISP o operatori da escludere. Formato elenco = {ISP.id; ISP.id;}
Opzione di aggiustamento delle offerte mobile TrueView	No	string	Sì	"Aumenta" o "Diminuisci" Aumenta Riduci
Percentuale aggiustamento delle offerte mobile TrueView	No	integer	Sì	Aggiustamento delle offerte per aumentare le probabilità di mostrare gli annunci sui dispositivi mobili. Gli aggiustamenti accettabili sono per l'opzione di aggiustamento delle offerte "Aumenta": [0;900%]; e per "Diminuisci": [0;90%] o 100%
Targeting per le esclusioni di categorie TrueView	No	stringa, elenco	Sì	Elenco delle categorie da escludere. Formato elenco = Giochi; Tragedie e conflitti; ecc. Video incorporati Live streaming Videogiochi Tragedie e conflitti Problemi sociali sensibili Famiglie Tutti i segmenti di pubblico Adolescenti più giovani Adolescenti Adulti Non ancora classificato Contenuti sessualmente allusivi Contenuti scandalosi e scioccanti Linguaggio volgare e offensivo
Targeting origine inventario TrueView	No	stringa, elenco	Sì	Elenchi di origini dell'inventario TrueView da includere Ricerca di YouTube Video di YouTube Partner video