Ultimo aggiornamento: 21/08/2025
Questa guida ti illustra le seguenti procedure:
- Aggiorna la versione dei file di dati strutturati selezionati alla versione 9 utilizzando l'interfaccia utente o l'API Display & Video 360.
- Esegui la migrazione dell'integrazione dalle versioni deprecate di File di dati strutturati (v7, v7.1, v8 o v8.1) alla v9. Ti indirizza a pagine che descrivono in dettaglio le modifiche tra la versione attuale e la v9 che potrebbero influire sulla tua integrazione. In alcuni casi, dovrai utilizzare la versione 9 per caricare gli SDF a partire dall'8 settembre 2025.
Consulta le pagine di migrazione specifiche per ogni versione per un elenco esaustivo delle differenze tra la tua versione e la v9.
Aggiornare la versione dei file di dati strutturati
Per utilizzare la versione 9, devi aggiornare le risorse e le azioni di generazione di SDF in modo che utilizzino la versione 9 quando scarichi e carichi i file di dati strutturati.
Aggiornare la versione di File di dati strutturati
Per utilizzare una nuova versione dei file di dati strutturati, aggiorna la versione assegnata nelle risorse partner e inserzionista principali e utilizza la nuova versione quando crei singole attività di download nell'API Display & Video 360.
Aggiornare le impostazioni della risorsa principale
Imposti la versione predefinita dei file di dati strutturati a livello di risorsa partner e inserzionista. Questa versione viene utilizzata come predefinita durante il download dei file di dati strutturati tramite l'interfaccia o l'API.
Impostato nell'interfaccia
A livello di partner:
- Vai al partner che ti interessa.
- 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 alla versione 9.
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 a v9. Se la versione predefinita è impostata a livello di partner, questa impostazione potrebbe non essere modificabile.
Impostato nell'API
A livello di partner: non puoi impostare la versione predefinita di SDF a livello di partner nell'API.
A livello di inserzionista:invia una richiesta advertisers.patch per aggiornare dataAccessConfig.sdfConfig.sdfConfig.version a SDF_VERSION_9 e, se necessario, dataAccessConfig.sdfConfig.overridePartnerSdfConfig a True.
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_9.
Eseguire la migrazione dalla versione SDF corrente
Le pagine seguenti ti guidano attraverso gli aggiornamenti necessari da apportare alla tua integrazione durante la migrazione dalla versione attuale alla v9 e forniscono un elenco completo di tutte le modifiche tra le versioni: