Dati strutturati - v3.1 - Elementi pubblicitari

Questa versione dell'SDF è stata ritirata. Gli utenti devono eseguire la migrazione a SDF v7 o v6 per continuare a utilizzare i file di dati strutturati. 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 modifichi elementi pubblicitari esistenti	numero intero	No	Valore dell'ID numerico dell'elemento pubblicitario. Se il campo viene lasciato vuoto, verrà creato un nuovo elemento pubblicitario e assegnato un ID univoco. Se vuoi, quando crei nuovi elementi pubblicitari, puoi utilizzare un identificatore personalizzato al fine di 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 verranno associati (ad esempio, dal gruppo di annunci all'elemento pubblicitario) in base agli identificatori personalizzati.
ID IO	Sì	numero intero	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 all'elemento pubblicitario.
Tipo	Sì	stringa	Sì	Il tipo di voce. Possono essere modificate solo durante la creazione, non in modifica. Display Video TrueView Audio
Sottotipo	Sì	stringa	Sì	Campo obbligatorio per gli elementi pubblicitari TrueView per distinguere i formati TrueView standard e per l'installazione di app mobile Simple Installazione di app mobili
Nome	Sì	stringa	Sì	Il nome della voce.
Timestamp	Obbligatorio quando si modificano voci esistenti	numero intero	No	Il timestamp della voce. Questo viene 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 della voce. Attiva In pausa Bozza Archiviato Eliminati
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 o sulle impressioni. Se l'IO per questa voce è abilitato per l'allocazione automatica del budget, puoi impostare l'opzione su "Automatica" per consentire a DBM di impostare automaticamente il budget per questa voce. Importo Impressioni Schermi illimitati Automatico Budget giornaliero TrueView
Importo del budget	Obbligatorio quando il "Tipo" è "Display", "Video" o "Audio"	float	Sì	Un importo del budget positivo per il tipo di budget. Potrebbe essere un valore impressione intero semplice o un valore in virgola mobile per un importo in valuta. Le valute verranno visualizzate nella valuta dell'inserzionista in unità standard (non in 1/1.000.000 di unità di valuta). Se per la voce è impostata l'allocazione del budget di tipo "Automatica", puoi specificare un importo minimo da spendere (ad esempio, "spesa almeno" questo importo).
Pacing	Sì	stringa	Sì	Il periodo di tempo utilizzato per spendere l'importo del pacing. Ogni giorno Ogni mese Periodo di pubblicazione
Tasso di pacing	Sì	stringa	Sì	Il tasso di pacing per questa voce. ASAP Uniforme Davanti
Importo del pacing	Sì	float	Sì	L'importo da spendere per il periodo di tempo impostato dal tipo di pacing.
Frequenza abilitata	Sì	stringa	Sì	Attiva/disattiva la quota limite basata sulle impressioni nell'elemento pubblicitario. TRUE FALSE
Esposizioni a frequenza	Obbligatorio quando "Frequenza abilitata" è "TRUE"	numero intero	Sì	Un numero intero positivo per il numero di impressioni in un determinato importo di frequenza, ovvero la x in "Mostra x impressioni nel periodo y".
Periodo di frequenza	Obbligatorio quando "Frequenza abilitata" è "TRUE"	stringa	Sì	Specifica l'unità del periodo di tempo per la quota limite. Per gli elementi pubblicitari TrueView, i periodi supportati sono Giorni, Settimane, Mesi. Minuti Ore Giorni Settimane Mesi Lifetime dell'utente
Importo frequenza	Obbligatorio quando "Frequenza abilitata" è "TRUE"	numero intero	Sì	Un numero intero positivo per la durata del tipo Periodo di frequenza, ovvero il valore y in "Mostra x impressioni nel periodo y". Questo importo non è supportato per gli elementi pubblicitari TrueView.
Frequenza di visualizzazione TrueView attivata	Obbligatorio quando il "Tipo" è "TrueView"	stringa	Sì	Attiva/disattiva la quota limite basata sulle visualizzazioni nell'elemento pubblicitario TrueView. TRUE FALSE
Esposizioni frequenza di visualizzazione TrueView	Obbligatorio quando "Frequenza di visualizzazione TrueView abilitata" è "TRUE"	numero intero	Sì	Un numero intero positivo per il numero di visualizzazioni TrueView, ovvero la x in "Mostra x visualizzazioni nel periodo"
Periodo di frequenza delle visualizzazioni TrueView	Obbligatorio quando "Frequenza di visualizzazione TrueView abilitata" è "TRUE"	stringa	Sì	Specifica l'unità del 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 - Markup sul costo dei media totale MCM - Markup sul costo dei media CPM - Costo per mille impressioni
Importo 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 il "Tipo" è "Display", "Video" o "Audio"	stringa	Sì	Scegli i tipi di conversioni da conteggiare. Conta tutto Conteggio post clic Conteggio %
% di conteggio delle conversioni	Obbligatorio quando il "Tipo" è "Display", "Video" o "Audio"	float	Sì	Specificare la percentuale per il tipo di conteggio delle conversioni 'Conteggio %'. Formatta la percentuale come numero in virgola mobile (3,123% = 3,123), con precisione limitata alle migliaia (3 cifre decimali).
ID pixel di conversione	No	stringa, elenco di elenchi	Sì	Specifica i pixel di conversione come elenco di elenchi. Ogni pixel viene 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 tariffe per questa voce. Formato elenco = (Categoria tariffa; Importo tariffa; Tipo di tariffa; Fatturato;). Categoria tariffa CPM Contenuti multimediali Importo commissione In virgola mobile % come in virgola mobile Tipo di tariffa (stringa, vedi la tabella nelle tariffe) Fatturato True False vuoto Esempio "(CPM; 2; Tariffa Bid Manager; False) ; (Media; 13; Predefinito; True);" I valori accettabili sono indicati nella seguente tabella: Nota: la tariffa CPM delle tariffe premium è riservata dal sistema ed è immutabile. La cardinalità della tariffa premium viene mantenuta in tutte le modifiche, inserendo tariffe CPM predefinite, se necessario. Categoria tariffa Tipo di commissione Opzione con fatturazione non automatica CPM/media Predefinito Non consentito (lascia vuoto) CPM/media Ad server di terze parti Non consentito (lascia vuoto) CPM/media DoubleVerify Consentito (Vero/Falso) CPM/media Adsafe Non consentito (lascia vuoto) CPM/media AdXpose Non consentito (lascia vuoto) CPM/media Vizu Non consentito (lascia vuoto) CPM/media Aggregate Knowledge Non consentito (lascia vuoto) CPM/media Teracent Non consentito (lascia vuoto) CPM/media Evidon Non consentito (lascia vuoto) CPM/media Tariffa trading desk agenzia Non consentito (lascia vuoto) CPM/media Adloox Consentito (Vero/Falso) CPM ShopLocal Obbligatorio (vero) CPM TrustMetrics Non consentito (lascia vuoto) CPM Video Integral Ad Science Consentito (Vero/Falso) CPM Video MOAT Non consentito (lascia vuoto) Contenuti multimediali Tariffa di Bid Manager Obbligatorio (vero) Contenuti multimediali Dati di costo dei media Non consentito (lascia vuoto) CPM Tariffe premium Non consentito (lascia vuoto)
Codice integrazione	No	stringa	Sì	Un codice facoltativo per il monitoraggio.
Dettagli	No	stringa	Sì	Dettagli della voce in formato stringa.
Tipo strategia di offerta	Obbligatorio quando il "Tipo" è "Display", "Video" o "Audio"	stringa	Sì	Seleziona una delle strategie di offerta applicabili: Minimizza: riduci al minimo il CPA/CPC entro i limiti di spesa dell'intero budget Massimizza: entro i limiti di spesa dell'intero budget, massimizza il valore delle impressioni o le impressioni di qualità Supera: raggiungi o supera un obiettivo di CPA/CPC X Ottimizza vCPM: ottimizza per offerta CPM visibile di X Fisso: specifica un'offerta fissa di X
Valore strategia di offerta	Obbligatorio, a meno che "Tipo di strategia di offerta" non sia "Riduci al minimo", "Massimizza" o "Tipo" non sia "TrueView"	float	Sì	Per i tipi di strategia Battito, Ottimizza VCPM, Fisso, scegli un valore per l'offerta con obiettivo. Tieni presente che non è richiesto alcun valore della strategia di offerta "Minimizza" o "Massimizza" per il tipo di strategia di offerta.
Unità strategia di offerta	Obbligatorio quando "Tipo di strategia di offerta" è "Battito" ,"Riduci al minimo" o "Massimizza"	stringa	Sì	Per i tipi di strategia Battito, Riduci al minimo o Massimizza, seleziona l'unità corrispondente: CPA CPC impr. valore/costo personalizzate CIVA IVO_TEN AV_VIEWED INCREMENTAL_CONVERSIONS
La strategia di offerta non supera	Obbligatorio quando il "Tipo" è "Display", "Video" o "Audio"	float	Sì	Imposta un valore CPM "non superare" Se è pari a 0, 'non superare' non è abilitato. Questa opzione è disponibile solo se la strategia di offerta è "Minimizza", "Massimizza" o "Beat".
Assegnazioni creatività	No	stringa, elenco	Sì	Elenco di 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 di aree geografiche da includere nel targeting. Formato elenco = (GeoLocation.id; GeoLocation.id;ecc.).
Targeting geografico - Escludi	No	stringa, elenco	Sì	Elenco di aree geografiche da escludere dal targeting. Formato elenco = (GeoLocation.id;GeoLocation.id; ecc.).
Targeting per lingua - Includi	No	stringa, elenco	Sì	Elenco di lingue da includere nel targeting. Formato elenco = (Language.id;Language.id;ecc.).
Targeting per lingua - Escludi	No	stringa, elenco	Sì	Elenco di lingue da escludere dal targeting. Formato elenco = (Language.id;Language.id;ecc.).
Targeting per dispositivo - Includi	No	stringa, elenco	Sì	Elenco di dispositivi da includere nel targeting. Formato elenco = (DeviceCriteria.id;DeviceCriteria.id;ecc.).
Targeting per dispositivo - Escludi	No	stringa, elenco	Sì	Elenco di dispositivi da escludere dal targeting. Formato elenco = (DeviceCriteria.id;DeviceCriteria.id;ecc.).
Targeting per browser - Includi	No	stringa, elenco	Sì	Elenco del browser da includere nel targeting. Formato elenco = (Browser.id;Browser.id;ecc.).
Targeting per browser - Escludi	No	stringa, elenco	Sì	Elenco di browser da escludere nel targeting. Formato elenco = (Browser.id;Browser.id;ecc.).
Etichette di sicurezza del brand	No	stringa, elenco	Sì	Elenco delle etichette per contenuti digitali da scegliere come target. Formato elenco = (G;PG ecc.). G PG T MA ?
Impostazione della sensibilità per la sicurezza del brand	No	stringa	Sì	Scegli l'impostazione Sensibilità per bloccare l'inventario in base all'oggetto dei contenuti circostanti. Non bloccare Utilizza DoubleClick Verification Utilizza personalizzato
Impostazioni personalizzate per la sicurezza del brand	Obbligatorio quando "Impostazione personalizzata per la sicurezza del brand" è "Utilizza Personalizzata"	stringa, elenco	Sì	Se l'impostazione Sensibilità alla sicurezza del brand è "Utilizza personalizzato", specifica l'elenco di categorie di classificazione dei contenuti standard. Ad esempio (Per adulti;Alcolici,Tabacco e così via). Adulto Contenuti dispregiativi Download e condivisione Armi Giochi e scommesse Violenza Contenuti allusivi Linguaggio volgare Alcolici Droghe Tabacco Politica Religione Tragedia Incidenti relativi ai trasporti Problemi sociali sensibili Scioccante
Servizi di verifica di terze parti	No	stringa	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 Servizi di verifica di terze parti non è impostato su "Nessuno", specifica un elenco di etichette supportate dal fornitore selezionato.
Targeting per canale - Includi	No	stringa, elenco	Sì	Elenco di canali da includere nel targeting. Formato elenco = (UniversalChannel.id;UniversalChannel.id; ecc.).
Targeting per canale - Escludi	No	stringa, elenco	Sì	Elenco di canali da includere nel targeting. Formato elenco = (UniversalChannel.id;UniversalChannel.id; ecc.).
Targeting per sito - Includi	No	stringa, elenco	Sì	Elenco di siti da includere nel targeting. L'elenco può includere un insieme di ID sito o stringhe di URL, se non presenti nella tabella Sito universale. Formato elenco = (UniversalSite.Id;'http://someurl.com';ecc.).
Targeting per sito - Escludi	No	stringa, elenco	Sì	Elenco di siti da escludere nel targeting. L'elenco può includere un insieme di ID sito o stringhe di URL, se non presenti nella tabella Sito universale. Formato elenco = (UniversalSite.Id;'http://someurl.com';ecc.).
Targeting per app - Includi	No	stringa, elenco	Sì	Elenco di app da includere nel targeting. L'elenco può includere un insieme di ID sito universale o stringhe di pacchetti di app, se non sono presenti nella tabella Sito universale. Formato elenco = (UniversalSite.Id; 'some.app.package';ecc.).
Targeting per app - Escludi	No	stringa, elenco	Sì	Elenco di app da escludere nel targeting. L'elenco può includere un insieme di ID sito universale o stringhe di pacchetti di app, se non sono presenti nella tabella Sito universale. Formato elenco = (UniversalSite.Id; 'some.app.package';ecc.).
Targeting per categoria - Includi	No	stringa, elenco	Sì	Elenco di categorie da includere nel targeting, da ID verticale AdX. Formato elenco = (Verticals.Id;Verticals.Id;ecc.).
Targeting per categoria - Escludi	No	stringa, elenco	Sì	Elenco di 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 nel targeting.
Targeting per pubblico - Segmenti di pubblico simili	Obbligatorio quando il "Tipo" è "Display", "Video" o "Audio"	stringa	Sì	Attiva i segmenti di pubblico simili per gli elenchi proprietari scelti come target positivo. TRUE FALSE
Targeting per pubblico - Includi	No	stringa, elenco di coppie	Sì	Elenco di elenchi dei segmenti di pubblico da includere nel targeting. Per gli elenchi dei segmenti di pubblico proprietari, ogni segmento di pubblico viene elencato come coppia di ID elenco utenti e impostazione di recency. Una coppia è (1;1d;), dove 1d rappresenta l'attualità campione che rappresenta l'attualità di 1 giorno. La data più recente non è disponibile per i segmenti di pubblico di terze parti, pertanto il formato dell'elenco è (3;);(4;);. Per i gruppi di segmenti di pubblico "AND" e "OR", segui questo esempio: per combinare le coppie con e senza recency: ' ((1;1d;);(2;365d;].[(3;);(4;5m;);(5;all;;");'.'. Ciò significa (elenco 1 con recency a 1 giorno, 1h d, 1 d d, 1 d d, 1 d, 1 d, 1 giorno, 2 h, 2 h, 2 con recency di 365 giorni ) AND (elenco 3 senza recency specificata OPPURE 4 con recency di 5 minuti OR elenco 5 con tutti gli utenti). I valori di attualità sono: tutti, 1 m, 5 m, 10 m, 15 m
Targeting per pubblico - Escludi	No	stringa, elenco di coppie	Sì	Elenco di elenchi dei segmenti di pubblico da escludere nel targeting. Ogni segmento di pubblico viene elencato come coppia di ID elenco utente e impostazione di recency, se l'elenco del segmento di pubblico è un elenco del segmento di pubblico proprietario. Una coppia è (1;1d;), dove 1d rappresenta l'attualità campione che rappresenta l'attualità di 1 giorno. Tuttavia, per i segmenti di pubblico di terze parti, la recency non è disponibile, quindi il formato dell'elenco è (3;);(4;);. d elenco d d, d 1, d 1, d 1, d 0, 10 m, 10 m, 5 m, 10 m, 15 m, 30 m, 1 h, 2 h, 3 h, 6 h, 12 h, 1 g, 2 d
Targeting di affinità e in-market - Includi	No	stringa, elenco	Sì	Elenco di elenchi dei segmenti di pubblico di affinità e/o in-market da includere. Formato elenco= ID elenco utente; ID elenco utente;
Targeting di affinità e in-market - Escludi	No	stringa, elenco	Sì	Elenco di elenchi dei segmenti di pubblico di affinità e/o in-market da escludere. Formato elenco= ID elenco utente; ID elenco utente;
Targeting per affinità personalizzata	No	stringa, elenco	Sì	Elenco di elenchi personalizzati da scegliere come target. Formato elenco= ID elenco utente; ID elenco utenti;
Targeting origine dell'inventario - Includi	Obbligatorio quando il "Tipo" è "Display", "Video" o "Audio"	stringa, elenco	Sì	Elenco dell'inventario da includere nel targeting. Formato elenco = (InventorySource.id; InventorySource.id;).
Targeting origine dell'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, dove ogni ID fascia oraria viene creato nel seguente formato: daypart_id = base_dayparting_id + days_since_monday * 10000 + start * 100 + end base_dayparting_id = 300000 days_since_monday: 0=Monday, 1=Tuesday-0min. ; "Locale"). Per le entità esistenti, il fuso orario non verrà modificato.
Targeting per ambiente	Obbligatorio quando il "Tipo" è "Display", "Video" o "Audio"	stringa, elenco	Sì	Elenco di ambienti da scegliere come target. Formato elenco = (web desktop, app mobile e così via). Per 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 Web desktop in-read In-feed web desktop Video web mobile Video per app mobile Interstitial video per app mobile Per l'audio: Audio per web desktop Audio per web mobile Audio per app mobile
Targeting per visibilità con Visualizzazione attiva	No	stringa	Sì	Scegli come target le percentuali di visibilità previste. Le percentuali sono rappresentate come valori in virgola mobile. Uno di {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Posizione dell'annuncio con targeting per visibilità - Includi	No	stringa	Sì	Targeting delle posizioni dell'annuncio. Seleziona uno o nessuno dei valori accettati: Tutte ATF BTF Sconosciuta
Targeting per visibilità: posizione dell'annuncio - Escludi	No	stringa	Sì	Escludi posizioni dell'annuncio nel targeting. Seleziona uno o nessuno dei valori accettati: ATF BTF Sconosciuta
Targeting per posizione dell'annuncio video	No	stringa, elenco	Sì	Elenco delle posizioni degli annunci video da scegliere come target. Seleziona uno o più dei valori accettati: sconosciuto Pre-roll Mid-roll Post-roll
Targeting per dimensione del video player	No	stringa, elenco	Sì	Elenco delle dimensioni del player di annunci video da scegliere come target. Seleziona uno o più dei valori accettati: sconosciuto small large HD
Targeting demografico - Genere	No	stringa, elenco	Sì	Elenco di generi da scegliere come target. Seleziona uno o più dei valori accettati: Donna Uomo Sconosciuta
Età del targeting demografico	No	stringa, elenco	Sì	Scegliere come target una fascia d'età dell'utente. Specifica un intervallo da/a selezionando una singola età di origine e una sola età di arrivo e se includere le età sconosciute vero/falso. Consulta l'elenco di età Da/A accettabili. Esempio 1: per scegliere come target 18-55 anni e includere età sconosciute, specifica il formato {From; To ; Include sconosciute True/False} = 18;55;true; Esempio 2: per scegliere come target solo utenti di età superiore a 35 anni ed escludere età sconosciute, specifica quanto segue = 35;+;false;. Valori accettabili per Da: 18 25 35 45 55 65 Valori accettabili per A: 25 35 45 55 65 +
Targeting per velocità di connessione	No	stringa	Sì	Scegli come target una velocità di connessione specifica. Seleziona uno dei valori accettati: Tutte 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 per dispositivi mobili TrueView	No	stringa	Sì	Scegli "Aumenta" o "Riduci" Aumenta Riduci
Percentuale di aggiustamento delle offerte per dispositivi mobili TrueView	No	numero intero	Sì	Aggiustamento delle offerte per aumentare le probabilità di pubblicare gli annunci sui dispositivi mobili. Gli aggiustamenti accettabili per l'opzione di aggiustamento delle offerte "Aumento" sono pari a [0;900%] e per l'opzione "Diminuisci" [0;90%] o 100%
Targeting per esclusione di categorie TrueView	No	stringa, elenco	Sì	Elenco delle categorie da escludere. Formato dell'elenco = giochi; tragedie e conflitti e così via Video incorporati Live streaming Giochi Tragedie e conflitti Temi sociali delicati 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