Questa pagina è stata tradotta dall'API Cloud Translation.

Dati strutturati - v4 - Ordine di inserzione

Consulta la panoramica per una spiegazione del formato.

Campo

Obbligatorio

Tipo

Scrivibile

Descrizione

ID Io

Obbligatorio solo quando modifichi ordini di inserzione esistenti

integer

Valore dell'ID numerico dell'ordine di inserzione. Se viene lasciato vuoto, verrà creato un nuovo ID ordine di inserzione e verrà assegnato un ID univoco. Facoltativamente, quando crei un nuovo ordine di inserzione, puoi utilizzare un identificatore personalizzato al fine di assegnare elementi pubblicitari al nuovo ordine di inserzione. 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 ID assegnati da DBM e gli oggetti vengono associati (ad esempio, da Elemento pubblicitario a Ordine di inserzione) in base a questi identificatori.

ID campagna

integer

Valore dell'ID numerico della campagna. Puoi specificare un identificatore personalizzato (ad esempio, "ext[identificatore della campagna personalizzata]") per una campagna che stai creando contemporaneamente a questo ordine di inserzione.

Nome

Sì

stringa

Sì

Il nome della voce.

Timestamp

Obbligatorio quando modifichi voci esistenti

integer

Il timestamp della voce, utilizzato dal sistema per verificare che la voce non sia cambiata tra il download e il caricamento.

Stato

Sì

stringa

Sì

L'impostazione dello stato della voce.

Attivo
In pausa
Bozza
Archiviato
Eliminati

Tipo di Io

Sì

stringa

Sì

Il tipo di ordine di inserzione. Impostabile solo al momento della creazione.

standard

Tariffe

stringa, elenco di elenchi

Sì

Tutte le tariffe per questa voce. Formato elenco = (Categoria tariffa; Importo tariffa; Tipo di commissione; Fatturato;).

Categoria tariffa
- CPM
- Media
Importo della commissione
- Float
- Pct come numero in virgola mobile
Tipo di tariffa
- (stringa, vedi tabella nelle tariffe)
Fatturato
- Vero
- Falso
- vuoto

Esempio: "(CPM; 2; Tariffa Bid Manager; False) ; (Media; 13; Predefinita; True);'
I valori accettati sono indicati nella seguente tabella:

Nota: la tariffa CPM per le tariffe premium è riservata al sistema ed è immutabile. La cardinalità della tariffa premium viene mantenuta in tutte le mutazioni inserendo le tariffe CPM predefinite, se necessario.

Categoria tariffa	Tipo di commissione	Opzione non 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 di Bid Manager	Obbligatorio (True)
Media	Dati sui costi multimediali	Non consentito (lasciare vuoto)
CPM	Tariffe premium	Non consentito (lasciare vuoto)

Codice integrazione

string

Sì

Un codice facoltativo ai fini del monitoraggio.

Dettagli

string

Sì

Dettagli della voce in formato stringa.

Pacing

Sì

stringa

Sì

Il periodo di tempo da spendere per l'importo del pacing.

Ogni giorno
Mensile
Volo

Frequenza di pacing

Sì

stringa

Sì

Il tasso di pacing per questa voce.

ASAP
Uniforme
In anticipo

Importo pacing

Sì

numero in virgola mobile

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'ordine di inserzione.

VERO
FALSO

Esposizioni alla frequenza

Obbligatorio se "Frequenza attivata" è "TRUE"

integer

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 se "Frequenza attivata" è "TRUE"

stringa

Sì

Specifica l'unità del periodo di tempo per la quota limite.

Minuti
Ore
Giorni
Settimane
Mesi
Intera durata

Importo frequenza

Obbligatorio se "Frequenza attivata" è "TRUE"

integer

Sì

Un numero intero positivo per il periodo di tempo del tipo Periodo di frequenza, ovvero la y in "Mostra x impressioni nel periodo y".

Tipo di obiettivo di rendimento

Sì

stringa

Sì

L'unità obiettivo per l'ordine di inserzione

CPM
CPA
CPC
CPV
CPIAVC
CTR
% visibilità
Nessuno
Altro

Valore obiettivo di rendimento

Sì

stringa

Sì

Il valore dell'obiettivo in valuta (CPM, CPA, CPC, CPV, CPIAVC), percentuale (% visibilità, CTR) o come stringa (Altro).

Misura DAR

Sì

stringa

Sì

Attiva/disattiva la misurazione del pubblico utilizzando Nielsen Digital Ad Ratings

VERO
FALSO

Misura canale DAR

Obbligatorio quando "Misura DAR" è "TRUE"

integer

Sì

Il canale da misurare con Nielsen Digital Ad Ratings. Formato = UniversalChannel.id

Tipo di budget

Sì

stringa

Sì

Specifica il tipo di budget in termini di importo delle "entrate" da spendere (importo) o numero di impressioni (impressioni) da acquistare.

Importo
Impressioni

Segmenti di budget

Sì

stringa, elenco di elenchi

Sì

Specifica i segmenti di budget specifici. Formato elenco = (budget, data di inizio, data di fine). Il budget è in formato valuta mobile. Le date sono nel formato MM/GG/AAAA. Esempio: "(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);"

Allocazione automatica del budget

Sì

stringa

Sì

Attiva/disattiva l'allocazione automatica del budget

VERO
FALSO

Targeting geografico - Includi

stringa, elenco

Sì

Elenco di aree geografiche da includere nel targeting. Formato elenco = (GeoLocation.id; GeoLocation.id; e così via).

Targeting geografico - Escludi

stringa, elenco

Sì

Elenco di aree geografiche da escludere dal targeting. Formato elenco = (GeoLocation.id;GeoLocation.id e così via).

Targeting per lingua - Includi

stringa, elenco

Sì

Elenco di lingue da includere nel targeting. Formato elenco = (Language.id;Language.id; e così via).

Targeting per lingua - Escludi

stringa, elenco

Sì

Elenco di lingue da escludere dal targeting. Formato elenco = (Language.id;Language.id; e così via).

Targeting per dispositivo - Includi

stringa, elenco

Sì

Elenco di dispositivi da includere nel targeting. Formato elenco = (DeviceCriteria.id;DeviceCriteria.id;ecc.).

Targeting per dispositivo - Escludi

stringa, elenco

Sì

Elenco di dispositivi da escludere dal targeting. Formato elenco = (DeviceCriteria.id;DeviceCriteria.id;ecc.).

Targeting per browser - Includi

stringa, elenco

Sì

Elenco di browser da includere nel targeting. Formato elenco = (Browser.id;Browser.id;e così via).

Targeting per browser - Escludi

stringa, elenco

Sì

Elenco di browser da escludere dal targeting. Formato elenco = (Browser.id;Browser.id;e così via).

Etichette di sicurezza del brand

stringa, elenco

Sì

Elenco delle etichette per contenuti digitali da scegliere come target. Formato elenco = (G;PG, ecc.).

Impostazione Sensibilità alla sicurezza del brand

string

Sì

Scegli l'impostazione Sensibilità per bloccare l'inventario in base all'oggetto dei contenuti circostanti.

Non bloccare
Utilizzo di DoubleClick Verification
Utilizza personalizzata

Impostazioni personalizzate per la sicurezza del brand

Obbligatoria quando "Impostazione personalizzata per la sicurezza del brand" è "Utilizza Personalizzato"

stringa, elenco

Sì

Se l'impostazione Sensibilità alla sicurezza del brand è "Utilizza personalizzato", specifica l'elenco di categorie standard di classificazione dei contenuti. Ad esempio, (Adulti;Alcolici;Tabacco;ecc.).

Adulto
Contenuti dispregiativi
Download e Condivisione attiva
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

string

Sì

Fornitore di servizi di verifica di terze parti.

Nessuno
Integral Ad Science
DoubleVerify
Adloox

Etichette di verifica di terze parti

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

stringa, elenco

Sì

Elenco dei canali da includere nel targeting. Formato elenco = (UniversalChannel.id;UniversalChannel.id; ecc.).

Targeting per canale - Escludi

stringa, elenco

Sì

Elenco dei canali da includere nel targeting. Formato elenco = (UniversalChannel.id;UniversalChannel.id; ecc.).

Targeting per sito - Includi

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

stringa, elenco

Sì

Elenco di siti da escludere dal 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

stringa, elenco

Sì

Elenco di app da includere nel targeting. L'elenco può includere un insieme di ID UniversalSite o stringhe di pacchetti di app, se non presenti nella tabella del sito universale. Formato elenco = (UniversalSite.Id; 'some.app.package';ecc.).

Targeting per app - Escludi

stringa, elenco

Sì

Elenco di app da escludere dal targeting. L'elenco può includere un insieme di ID UniversalSite o stringhe di pacchetti di app, se non presenti nella tabella del sito universale. Formato elenco = (UniversalSite.Id; 'some.app.package';ecc.).

Targeting raccolta app - Includi

stringa, elenco

Sì

Elenco di raccolte di app da includere nel targeting. Formato elenco= ID raccolta app; ID raccolta app;

Targeting raccolta app - Escludi

stringa, elenco

Sì

Elenco di raccolte di app da escludere dal targeting. Formato elenco= ID raccolta app; ID raccolta app;

Targeting per categoria - Includi

stringa, elenco

Sì

Elenco di categorie da includere nel targeting, dagli ID verticali di AdX. Formato elenco = (Verticals.Id;Verticals.Id;e così via).

Targeting per categoria - Escludi

stringa, elenco

Sì

Elenco di categorie da escludere dal targeting, dagli ID verticali di AdX. Formato elenco = (Verticals.Id;Verticals.Id;e così via).

Targeting per parole chiave - Includi

stringa, elenco

Sì

Elenco di stringhe di parole chiave da includere nel targeting.

Targeting per parole chiave - Escludi

stringa, elenco

Sì

Elenco di stringhe di parole chiave da escludere dal targeting.

Targeting per elenco parole chiave - Escludi

stringa, elenco

Sì

Elenco di elenchi di parole chiave escluse da escludere dal targeting. Formato elenco= ID elenco di parole chiave escluse; ID elenco di parole chiave escluse;

Targeting per pubblico - Segmenti di pubblico simili

Obbligatorio quando "Tipo" è "Display" o "Video" o "Audio"

stringa

Sì

Attivare i segmenti di pubblico simili per gli elenchi proprietari scelti positivamente come target.

VERO
FALSO

Targeting per pubblico - Includi

stringa, elenco di coppie

Sì

Elenco di elenchi di 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 è un'attualità di esempio che rappresenta un'attualità di 1 giorno. La data più recente non è disponibile per i segmenti di pubblico di terze parti, quindi il formato dell'elenco è (3;);(4;);. A "AND" e "OR" gruppi di segmenti di pubblico, segui questo esempio: per combinare coppie con e senza recency: ((1;1d;);(2;365d;;;(3;);(4;5m;);(5;tutti;;;) ; e (elenco 1 con ora di 1 giorno di recency di 1 giorno OR. OR elenco 2 con.

Targeting per pubblico - Escludi

stringa, elenco di coppie

Sì

Elenco di elenchi dei segmenti di pubblico da escludere dal targeting. Ciascun segmento di pubblico viene elencato come 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 è un'attualità di esempio che rappresenta un'attualità di 1 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;);

">All, 1m, 5m, 10m, 15m, 5m, 10m, 15m, 30m

Affinità e Targeting in-market - Includi

stringa, elenco

Sì

Elenco di elenchi di segmenti di pubblico di affinità e/o in-market da includere. Formato elenco= UserList ID; ID elenco utenti;

Affinità e Targeting in-market - Escludi

stringa, elenco

Sì

Elenco di elenchi di segmenti di pubblico in-market e/o di affinità da escludere. Formato elenco= UserList ID; ID elenco utenti;

Targeting per affinità personalizzata

stringa, elenco

Sì

Elenco di elenchi personalizzati da scegliere come target. Formato elenco= UserList ID; ID elenco utenti;

Targeting origine inventario - Includi

stringa, elenco

Sì

Elenco dell'inventario da includere nel targeting. Formato elenco = (InventorySource.id; InventorySource.id;).

Targeting origine inventario - Escludi

stringa, elenco

Sì

Elenco dell'inventario da escludere dal targeting. Formato elenco = (InventorySource.id; InventorySource.id;).

Targeting per origine dell'inventario - Scegli come target nuove piattaforme di scambio pubblicitario

string

Sì

Impostazione del targeting di nuove piattaforme di scambio pubblicitario.

Vero
Falso

Targeting per fascia oraria

stringa, elenco

Sì

un numero intero compreso tra 0 e 95, che rappresenta gli slot di 15 minuti
inizia < fine
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.

Fuso orario targeting per fascia oraria

Obbligatorio quando è selezionato "Targeting per fascia oraria" è inclusa.

stringa

Sì

Fuso orario da utilizzare per il targeting per fascia oraria.

Locale
Inserzionista

Targeting dell'ambiente

Obbligatorio quando "Tipo" è "Display" o "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 desktop
Gioco web per computer
Web desktop letto
In-feed web desktop
Video web mobile
Video per app mobile
Interstitial video per app mobile

Per audio:

Audio web desktop
Audio web mobile
Audio per app mobile

Visualizzazione attiva con targeting per visibilità

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}

Visibilità con targeting - Posizione dell'annuncio - Includi

string

Sì

Posizioni degli annunci target. Seleziona uno o nessuno dei valori accettabili:

Tutte
ATF
BTF
Sconosciuto

Posizione dell'annuncio con targeting per visibilità - Escludi

string

Sì

Escludere le posizioni degli annunci nel targeting. Seleziona uno o nessuno dei valori accettabili:

ATF
BTF
Sconosciuto

Targeting della posizione dell'annuncio video

stringa, elenco

Sì

Elenco delle posizioni degli annunci video da scegliere come target. Seleziona uno o più valori accettati:

sconosciuto
Pre-roll
Mid-roll
Post-roll

Targeting per dimensione del video player

stringa, elenco

Sì

Elenco delle dimensioni del player di annunci video da scegliere come target. Seleziona uno o più valori accettati:

sconosciuto
small
large
HD

Genere del targeting demografico

stringa, elenco

Sì

Elenco di generi da scegliere come target. Seleziona uno o più valori accettati:

Donna
UomoMaschio
Sconosciuto

Età del targeting demografico

stringa, elenco

Sì

Scegli come target una fascia d'età utente. Specifica un intervallo Da/A selezionando un'unica età Da e A e se includere età sconosciute vero/falso. Consulta l'elenco delle fasce di età Da/A accettabili.
Esempio 1: per scegliere come target i bambini tra i 18 e i 55 anni e includere le fasce di età sconosciute, specifica il formato {From; 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 accettati per Da:

Valori accettabili per A:

Reddito del nucleo familiare con targeting demografico

stringa, elenco

Sì

Scegli come target una fascia di reddito del nucleo familiare. Specifica un intervallo da/a selezionando un singolo intervallo di reddito Top_of_Range e un singolo intervallo di reddito Bottom_of_Range e se includere i nuclei familiari con reddito sconosciuto vero/falso. Consulta l'elenco degli intervalli Top_of_Range/Bottom_of_Range accettabili.
Esempio 1: per scegliere come target il 10-50% dei nuclei familiari più popolari e includere i nuclei familiari con reddito sconosciuto, specifica il formato {Top_of_Range; Bottom_of_Range; Includi sconosciuto Vero/Falso} = Top 10%;41-50%;true;
Esempio 2: per scegliere come target solo il 50% dei nuclei familiari più bassi ed escludere i nuclei familiari con reddito sconosciuto, specifica il formato {Top_of_Range; Bottom_of_Range; Includi Vero/Falso sconosciuto} = 50% inferiore; 50% inferiore;true;
Valori accettati per Intervallo_superiore_o_sotto_intervallo_di_intervallo:

10% superiore
11-20%
21-30%
31-40%
41-50%
50% inferiore

Stato parentale del targeting demografico

Sì

stringa, elenco

Sì

Elenco di stati parentali da scegliere come target. Seleziona uno o più valori accettabili.

Genitore
Senza figli
Sconosciuto

Targeting per velocità di connessione

string

Sì

Scegli come target una velocità di connessione specifica. Seleziona uno dei valori accettati:

Tutte
2G
3G
DSL
4G

Targeting per operatore - Includi

stringa, elenco

Sì

Elenco di ISP o operatori da scegliere come target. Formato elenco = {ISP.id; ISP.id;}

Targeting per operatore - Escludi

stringa, elenco

Sì

Elenco di ISP o operatori da escludere. Formato elenco = {ISP.id; ISP.id;}