Ultimo aggiornamento: 18/10/2023
Questa guida illustra la procedura di migrazione alla versione 7 dei file di dati strutturati (SDF) 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
Per eseguire la migrazione alla versione 7 dei file di dati strutturati da una versione precedente, devi specificare la nuova versione, aggiornare gli spazi ID per un sottoinsieme di colonne esistenti e aggiungere l'integrazione con nuove colonne.
Aggiornare 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 della risorsa principale
Una versione predefinita dei file di dati strutturati è impostata a livello di risorsa del partner e dell'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 nel riquadro di navigazione a sinistra. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati in v7.
- A livello di inserzionista
- Accedi all'inserzionista previsto. Vai alla pagina Dettagli di base nel menu Impostazioni inserzionista nel riquadro di navigazione a sinistra. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati in 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 aggiornare il valoredataAccessConfig.sdfConfig.sdfConfig.versionaSDF_VERSION_7e, se necessario,dataAccessConfig.sdfConfig.overridePartnerSdfConfigaTrue.
Aggiorna le 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 File di lettura delle entità ritirato e allinearsi ulteriormente agli strumenti supportati, come l'API Display & Video 360.
Questa sezione elenca 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
| Istruzioni per la migrazione delle colonne alla versione 7 | |
|---|---|
|
Targeting per app - Escludi Targeting per app - Includi |
Queste colonne sono state aggiornate per utilizzare gli identificatori delle app nel formato " Le piattaforme di app sono identificate da un valore di stringa. Gli ID app sono gli ID forniti dalla piattaforma pertinente, ad esempio un ID gruppo del Play Store di Android o un ID app dell'App Store di Apple. |
|
Targeting per browser - Escludi Targeting per browser: includi |
Questa colonna è stata aggiornata in modo da utilizzare
Recupera le risorse
|
|
Targeting per operatore - Escludi Targeting per operatore - Includi |
Questa colonna è stata aggiornata in modo da utilizzare
Recupera le risorse
|
|
Targeting per canale - Escludi Targeting per canale: includi |
Questa colonna è stata aggiornata per utilizzare il valore
Recupera le risorse
|
|
Targeting per dispositivo - Escludi Targeting per dispositivo: includi |
Questa colonna è stata aggiornata per utilizzare
Recupera le risorse
|
| Misurare il canale DAR |
Questa colonna è stata aggiornata per 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 delle colonne alla versione 7 | |
|---|---|
|
Targeting per app - Escludi Targeting per app - Includi |
Queste colonne sono state aggiornate per utilizzare gli identificatori delle app nel formato " Le piattaforme di app sono identificate da un valore di stringa. Gli ID app sono gli ID forniti dalla piattaforma pertinente, ad esempio un ID gruppo del Play Store di Android o un ID app dell'App Store di Apple. |
| Moltiplicatori di offerta |
Questa colonna è stata aggiornata per utilizzare nuovi ID criteri per i tipi di riga app e sito. Il tipo di riga app è stato aggiornato in modo da utilizzare valori di stringa concatenati della piattaforma per app e dell'ID piattaforma per app, separati da due punti, per gli ID criteri. Le piattaforme di app sono identificate da un valore di stringa. Gli ID app sono gli ID forniti dalla piattaforma pertinente, ad esempio un ID gruppo del Play Store di Android o un ID app dell'App Store di Apple. Il tipo di riga site è stato aggiornato per utilizzare le stringhe URL come ID criteri. |
|
Targeting per browser - Escludi Targeting per browser: includi |
Questa colonna è stata aggiornata in modo da utilizzare
Recupera le risorse
|
|
Targeting per operatore - Escludi Targeting per operatore - Includi |
Questa colonna è stata aggiornata in modo da utilizzare
Recupera le risorse
|
|
Targeting per canale - Escludi Targeting per canale: includi |
Questa colonna è stata aggiornata per utilizzare il valore
Recupera le risorse
|
|
Targeting per dispositivo - Escludi Targeting per dispositivo: includi |
Questa colonna è stata aggiornata per utilizzare
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 delle colonne alla versione 7 | |
|---|---|
|
Targeting per canale - Escludi Targeting per canale: includi |
Questa colonna è stata aggiornata per utilizzare il valore
Recupera le risorse
|
| Targeting per dispositivo: includi |
Questa colonna è stata aggiornata per utilizzare
Recupera le risorse
|
Aggiungere l'integrazione con le colonne aggiunte dalla versione 6
Se esegui la migrazione dalla versione 6 alla versione 7, devi aggiungere le seguenti colonne ai file pertinenti:
| Tipo di file | Colonna |
|---|---|
| Elemento pubblicitario | Conteggio della frequenza target TrueView |
| Elemento pubblicitario | Finestra temporale della frequenza target TrueView |
| Gruppo di annunci di YouTube | Targeting ottimizzato |
Se esegui la migrazione da una versione precedente di 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 di SDF.
Ulteriori modifiche
Nella versione 7 abbiamo anche apportato alcune modifiche superficiali che dovrebbero aiutarti a semplificare l'integrazione e ad abbandonare l'utilizzo dei file di lettura delle entità ritirati come riferimento.
Nuovo ordinamento dell'elenco per un sottoinsieme di colonne
La versione 7 del formato SDF garantisce un ordinamento stabile di determinate colonne dell'elenco al momento della generazione del file. Il risultato è un comportamento più coerente e una revisione più facile. Questo ordine non viene applicato al caricamento del file, ma 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.
Nuovi consigli per gli ID di riferimento
Abbiamo aggiornato le definizioni di una serie di colonne per rimuovere il riferimento ai file di lettura delle entità ritirati e consigliamo di utilizzare altri metodi di ricerca dell'ID.
I valori restituiti dalle seguenti colonne non sono diversi da quelli della versione 6 del file SDF, ma ti consigliamo di aggiornare l'integrazione per recuperare gli ID utilizzando il nuovo metodo consigliato, che puoi trovare 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 |
|
|||||||||||||||||||||