Ultimo aggiornamento: 18-10-2023
Questa guida illustra il processo di migrazione a File di dati strutturati (SDF) v7 da una versione precedente e le modifiche, obbligatorie e suggerite, che puoi apportare per ottimizzare meglio l'integrazione.
Consulta le note di rilascio per un elenco completo delle differenze tra la versione 6 e la versione 7.
Esegui la migrazione della versione dei file di dati strutturati
La migrazione a File di dati strutturati v7 da una versione precedente richiede di specificare la nuova versione, aggiornare gli spazi ID per un sottoinsieme di colonne esistenti e aggiungere l'integrazione con nuove colonne.
Aggiorna la versione dei file di dati strutturati
Per eseguire l'aggiornamento a una nuova versione dei file di dati strutturati, devi aggiornare la versione assegnata alle risorse Partner e Inserzionista principali e le singole attività di download nell'API Display & Video 360.
Aggiorna le impostazioni delle risorse padre
Una versione predefinita dei file di dati strutturati è impostata a livello di risorsa di partner e inserzionista. Questa versione viene utilizzata come predefinita per il download dei file di dati strutturati tramite l'interfaccia o l'API.
Impostato nell'interfaccia
- A livello di partner
- Vai al partner previsto. Vai alla pagina Dettagli di base nel menu Impostazioni partner nella barra di navigazione a sinistra. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati a v7.
- A livello di inserzionista
- Accedi all'inserzionista desiderato. Vai alla pagina Dettagli di base nel menu Impostazioni inserzionista nella barra di navigazione a sinistra. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati a v7. Se la versione predefinita è impostata a livello di partner, questa impostazione potrebbe non essere modificabile.
Impostato nell'API
- A livello di inserzionista
- Invia una richiesta
advertisers.patchper aggiornaredataAccessConfig.sdfConfig.sdfConfig.versioninSDF_VERSION_7e, se necessario,dataAccessConfig.sdfConfig.overridePartnerSdfConfigaTrue.
Aggiorna sdfdownloadtasks.create richieste nell'API
Quando effettui una richiesta sdfdownloadtasks.create utilizzando l'API Display & Video 360, imposta il campo version del corpo della richiesta su SDF_VERSION_7.
Aggiorna gli ID nelle colonne obbligatorie
Nella versione 7, gli spazi ID utilizzati da un sottoinsieme di colonne sono stati aggiornati per disaccoppiare i file di dati strutturati dal prodotto File per la lettura delle entità deprecato e allinearsi ulteriormente agli strumenti supportati come l'API Display & Video 360.
In questa sezione sono elencate tutte le colonne che utilizzano ID diversi rispetto alla versione 6 e le istruzioni su come recuperare le informazioni di riferimento sui nuovi valori.
Ordine di inserzione
| v7 Istruzioni per la migrazione delle colonne | |
|---|---|
|
Targeting per app - Escludi Targeting per app - Includi |
Queste colonne sono state aggiornate in modo da utilizzare gli identificatori di app nel
formato " Le piattaforme app sono identificate da un valore stringa. Gli ID app sono gli ID forniti dalla piattaforma pertinente, ad esempio un ID bundle del Play Store di Android o l'ID app dell'App Store di Apple. |
|
Targeting per browser - Escludi Targeting per browser - Includi |
Questa colonna è stata aggiornata in modo da utilizzare i valori
Recupera le risorse |
|
Targeting per operatore - Escludi Targeting per operatore - Includi |
Questa colonna è stata aggiornata in modo da utilizzare i valori
Recupera le risorse |
|
Targeting per canale - Escludi Targeting per canale - Includi |
Questa colonna è stata aggiornata in modo da utilizzare il valore
Recupera le risorse |
|
Targeting per dispositivo - Escludi Targeting per dispositivo - Includi |
Questa colonna è stata aggiornata in modo da utilizzare i valori
Recupera le risorse |
| Misura canale DAR |
Questa colonna è stata aggiornata in modo da utilizzare il valore
Recupera le risorse |
Targeting per sito - Escludi Targeting per sito - Includi |
Questa colonna è stata aggiornata in modo da identificare i siti tramite stringhe URL. |
Elemento pubblicitario
| v7 Istruzioni per la migrazione delle colonne | |
|---|---|
|
Targeting per app - Escludi Targeting per app - Includi |
Queste colonne sono state aggiornate in modo da utilizzare gli identificatori di app nel
formato " Le piattaforme app sono identificate da un valore stringa. Gli ID app sono gli ID forniti dalla piattaforma pertinente, ad esempio un ID bundle del Play Store di Android o l'ID app dell'App Store di Apple. |
| Moltiplicatori di offerta |
Questa colonna è stata aggiornata in modo da utilizzare nuovi ID criteri per i tipi di righe app e site. Il tipo di riga app è stato aggiornato in modo da utilizzare valori stringa concatenati dell'ID piattaforma di app e dell'ID piattaforma app, separati da due punti, per gli ID criteri. Le piattaforme app sono identificate da un valore stringa. Gli ID app sono gli ID forniti dalla piattaforma pertinente, ad esempio un ID bundle del Play Store di Android o un ID app dell'App Store di Apple. Il tipo di riga site è stato aggiornato in modo da utilizzare le stringhe URL come ID criteri. |
|
Targeting per browser - Escludi Targeting per browser - Includi |
Questa colonna è stata aggiornata in modo da utilizzare i valori
Recupera le risorse |
|
Targeting per operatore - Escludi Targeting per operatore - Includi |
Questa colonna è stata aggiornata in modo da utilizzare i valori
Recupera le risorse |
|
Targeting per canale - Escludi Targeting per canale - Includi |
Questa colonna è stata aggiornata in modo da utilizzare il valore
Recupera le risorse |
|
Targeting per dispositivo - Escludi Targeting per dispositivo - Includi |
Questa colonna è stata aggiornata in modo da utilizzare i valori
Recupera le risorse |
Targeting per sito - Escludi Targeting per sito - Includi |
Questa colonna è stata aggiornata in modo da identificare i siti tramite stringhe URL. |
Prodotto multimediale
| v7 Istruzioni per la migrazione delle colonne | |
|---|---|
|
Targeting per canale - Escludi Targeting per canale - Includi |
Questa colonna è stata aggiornata in modo da utilizzare il valore
Recupera le risorse |
| Targeting per dispositivo - Includi |
Questa colonna è stata aggiornata in modo da utilizzare i valori
Recupera le risorse |
Aggiungi integrazione con colonne aggiunte dalla versione 6
Se esegui la migrazione dalla versione 6 alla v7, devi aggiungere le seguenti colonne ai file pertinenti:
| Tipo di file | Colonna |
|---|---|
| Elemento pubblicitario | Conteggio frequenza target TrueView |
| Elemento pubblicitario | Finestra temporale di frequenza target TrueView |
| Gruppo di annunci di YouTube | Targeting ottimizzato |
Se stai eseguendo la migrazione da una versione precedente dei file di dati strutturati, consulta le note di rilascio dei file di dati strutturati per informazioni sulle colonne aggiuntive aggiunte tra la versione corrente e SDF v6.
Ulteriori modifiche
Nella versione 7, abbiamo anche introdotto alcune modifiche superficiali che dovrebbero aiutarti a semplificare l'integrazione e ad abbandonare l'utilizzo dei file per la lettura delle entità deprecati come riferimento.
Nuovo ordinamento elenco per alcune colonne
SDF v7 garantisce un ordine stabile di determinate colonne dell'elenco al momento della generazione dei file. Ciò si traduce in un comportamento più coerente e in una revisione più semplice. Questo ordinamento non viene applicato in modo forzato al caricamento del file, ma viene applicato successivamente durante la generazione del file aggiornato.
Consulta le note di rilascio della versione 7 per un elenco completo delle colonne che ora vengono generate in ordine numerico crescente o alfabetico.
Nuovi suggerimenti di riferimento ID
Abbiamo aggiornato le definizioni di una serie di colonne per rimuovere il riferimento ai file per la lettura delle entità deprecati e suggeriamo invece altri metodi di ricerca degli ID.
I valori restituiti dalle seguenti colonne non sono diversi da quelli in SDF versione 6, ma ti consigliamo di aggiornare l'integrazione per recuperare gli ID utilizzando il nuovo metodo consigliato, disponibile nelle descrizioni delle colonne v7.
| Tipi di file e relative colonne | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campagna |
|
|||||||||||||||||||||
| Ordine di inserzione |
|
|||||||||||||||||||||
| Elemento pubblicitario |
|
|||||||||||||||||||||
| Prodotto di comunicazione |
|
|||||||||||||||||||||
| Gruppo di annunci di YouTube |
|
|||||||||||||||||||||