I file di dati strutturati (SDF) sono file CSV con una formattazione speciale. Consentono il recupero, la creazione e la modifica collettivi delle risorse in Display & Video 360. Aggiorna le risorse collettivamente scaricando, modificando e ricaricando i file SDF.
L'interfaccia utente di Display & Video 360 supporta download e caricamenti di SDF. L'API Display & Video 360 supporta i download di SDF.
Formati
Un SDF utilizza uno dei due formati di base, Standard e QA:
- Puoi scaricare e caricare file in formato Standard. I dati in questi file potrebbero utilizzare ID numerici per garantire l'accuratezza al momento del caricamento. Per interpretare i dati potrebbero essere necessarie informazioni di riferimento.
- Puoi scaricare file in formato QA. Questi file forniscono gli stessi dati dei file in formato standard, ma utilizzano valori più leggibili. Ad esempio, alcune colonne potrebbero utilizzare nomi visualizzati al posto degli ID. Le colonne specifiche per questo formato utilizzano il suffisso "Qa".
Tipi di file
SDF supporta sette tipi di risorse. Ogni tipo di risorsa ha il proprio tipo di file con la propria struttura a colonne. I tipi di risorse supportati sono:
- Campagna
- Ordine di inserzione
- Elemento pubblicitario
- Gruppo di annunci
- Annuncio
- Origine dell'inventario
- Prodotto multimediale
Solo i tipi di file Elemento pubblicitario e Gruppo di annunci supportano il formato QA.
Le nuove versioni di SDF vengono rilasciate regolarmente e le versioni precedenti vengono ritirate. Le nuove versioni aggiornano la struttura della colonna del tipo di file. Se necessario, una nuova versione di SDF includerà una guida alla migrazione al momento del lancio.
Scarica errori
I download di SDF possono generare due tipi di errori: errori di generazione di file e risorse ignorate.
Errori di generazione dei file
La generazione di SDF può terminare con un errore. Se la generazione non riesce quando utilizzi l'API Display & Video 360, l'attività completata imposterà il campo error con l'oggetto Status. L'oggetto
Status conterrà un messaggio che descrive in dettaglio la causa
dell'errore.
Scopri di più su questi errori nella nostra pagina della guida a errori e avvisi.
Errori ignorati
I file SDF non supportano tutti i sottotipi di risorse. Se una risorsa non può essere inclusa in un
SDF, nel download verrà incluso un file "Ignorato" (ad esempio: SDF-LineItems-Skipped.csv). Questo file ha una struttura a due colonne. La prima colonna identifica
la risorsa ignorata. La seconda colonna spiega l'esclusione.
Caricamento file
Carica i file SDF utilizzando l'interfaccia utente di Display & Video 360 per creare nuove risorse o aggiornare quelle esistenti.
Per ridurre al minimo gli errori durante l'aggiornamento o la creazione di risorse con SDF:
- Scarica i file SDF utilizzando l'API Display & Video 360 o l'interfaccia utente.
- Modifica le voci dei file esistenti per apportare aggiornamenti alle risorse esistenti.
- Aggiungi voci di file per creare nuove risorse.
- Rimuovi le voci non nuove o aggiornate. In questo modo si riduce la dimensione del file e si elimina la possibilità di aggiornamenti involontari.
- Carica il file nell'interfaccia utente di Display & Video 360.
Una volta caricato ed elaborato un file SDF, è disponibile un file SDF-ResultFile.zip
per il download. Questo file ZIP può contenere due possibili file:
SDF-{ResourceType}-Updated-ResultFile.csv, che elenca le risorse aggiornate o create correttamente.SDF-{ResourceType}-Failed-ResultFile.csv, che elenca le operazioni non riuscite e i messaggi di errore pertinenti.
Il file ZIP può contenere uno o entrambi i file.