Ultimo aggiornamento: 18/10/2023
Questa guida illustra la procedura di migrazione a File di dati strutturati (SDF) v7 da una versione precedente e le modifiche, sia obbligatorie che suggerite, che puoi apportare per ottimizzare meglio l'integrazione.
Consulta le note di rilascio per un elenco esaustivo delle differenze tra la versione 6 e la versione 7.
Esegui la migrazione della versione dei file di dati strutturati
La migrazione ai 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
Viene impostata una versione predefinita dei file di dati strutturati a livello di risorsa di partner e inserzionista. Questa versione viene utilizzata come predefinita quando viene scaricato un file di dati strutturati tramite l'interfaccia o l'API.
Impostati nell'interfaccia
- A livello di partner
- Vai al partner previsto. Vai alla pagina Dettagli di base nel menu Impostazioni partner nel menu di navigazione a sinistra. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati impostandola su v7.
- A livello di inserzionista.
- Accedi all'inserzionista previsto. Vai alla pagina Dettagli di base nel menu Impostazioni inserzionista nel menu di navigazione a sinistra. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati impostandola su v7. Se la versione predefinita è impostata a livello di partner, questa impostazione potrebbe non essere modificabile.
Impostato nell'API
- A livello di inserzionista.
- Effettua una richiesta
advertisers.patchper aggiornaredataAccessConfig.sdfConfig.sdfConfig.versionaSDF_VERSION_7e, se necessario,dataAccessConfig.sdfConfig.overridePartnerSdfConfigaTrue.
Aggiorna richieste sdfdownloadtasks.create 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 deprecato File di lettura delle entità e per allinearli ulteriormente agli strumenti supportati, come l'API Display & Video 360.
Questa sezione elenca tutte le colonne utilizzando ID diversi rispetto alla versione 6 e istruzioni su come recuperare le informazioni di riferimento sui nuovi valori.
Ordine di inserzione
| Istruzioni per la migrazione v7 per le colonne | |
|---|---|
|
Targeting per app - Escludi Targeting per app - Includi |
Queste colonne sono state aggiornate per utilizzare gli identificatori di app nel formato " Le piattaforme di 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 per utilizzare i valori
Recupera le risorse |
|
Targeting per operatore - Escludi Targeting per operatore - Includi |
Questa colonna è stata aggiornata per 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 per 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 per identificare i siti tramite stringhe URL. |
Elemento pubblicitario
| Istruzioni per la migrazione v7 per le colonne | |
|---|---|
|
Targeting per app - Escludi Targeting per app - Includi |
Queste colonne sono state aggiornate per utilizzare gli identificatori di app nel formato " Le piattaforme di 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 riga app e site. Il tipo di riga app è stato aggiornato in modo da utilizzare valori stringa concatenati della piattaforma e dell'ID della piattaforma dell'app, separati da due punti, per gli ID criteri. Le piattaforme di app sono identificate da un valore stringa. Gli ID app sono gli ID forniti dalla piattaforma pertinente, ad esempio un ID pacchetto dal Play Store di Android o l'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 per utilizzare i valori
Recupera le risorse |
|
Targeting per operatore - Escludi Targeting per operatore - Includi |
Questa colonna è stata aggiornata per 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 per utilizzare i valori
Recupera le risorse |
Targeting per sito - Escludi Targeting per sito - Includi |
Questa colonna è stata aggiornata per identificare i siti tramite stringhe URL. |
Prodotto multimediale
| Istruzioni per la migrazione v7 per le 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 per utilizzare i valori
Recupera le risorse |
Aggiungi integrazione con colonne aggiunte dalla versione 6
Se esegui la migrazione dalla versione 6 alla 7, devi aggiungere le colonne seguenti ai file pertinenti:
| Tipo di file | Colonna |
|---|---|
| Elemento pubblicitario | Conteggio frequenza target TrueView |
| Elemento pubblicitario | Finestra temporale frequenza target TrueView |
| Gruppo di annunci di YouTube | Targeting ottimizzato |
Se esegui 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 la versione 6 dell'SDF.
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 dell'elenco per un sottoinsieme di colonne
SDF v7 garantisce un ordine stabile di alcune colonne di elenco al momento della generazione dei file. Ciò si traduce in un comportamento più coerente e una revisione più facile. 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 o alfabetico crescente.
Suggerimenti per i nuovi riferimenti agli ID
Abbiamo aggiornato le definizioni di una serie di colonne per rimuovere i riferimenti ai file per la lettura delle entità deprecati, consigliando invece altri metodi di ricerca degli ID.
I valori restituiti dalle seguenti colonne non sono diversi da quelli della versione 6 di SDF, ma ti consigliamo di aggiornare l'integrazione per recuperare gli ID utilizzando il nuovo metodo consigliato, disponibile nelle descrizioni delle colonne della versione 7.
| Tipi di file e relative colonne | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campagna |
|
|||||||||||||||||||||
| Ordine di inserzione |
|
|||||||||||||||||||||
| Elemento pubblicitario |
|
|||||||||||||||||||||
| Prodotto multimediale |
|
|||||||||||||||||||||
| Gruppo di annunci di YouTube |
|
|||||||||||||||||||||