Potresti dover eseguire la migrazione alla versione 9 per caricare i file di dati strutturati dopo l'8 settembre 2025. Per ulteriori dettagli, consulta la nostra pagina relativa al ritiro e la nostra guida alla migrazione alla versione 9 per istruzioni passo passo.
Eseguire la migrazione ai file di dati strutturati v9
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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.
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.
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:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-21 UTC."],[],[],null,["# Migrate to Structured Data Files v9\n\n*Last update: 2025-08-21*\n\nThis guide leads you through these processes:\n\n- Update your selected Structured Data Files version to v9 using the Display \\& Video 360 UI or API.\n- Migrate your integration from deprecated Structured Data Files versions (v7, v7.1, v8, or v8.1) to v9. It points you to pages detailing the changes between your current version and v9 that may impact your integration. In some cases, you will have to use v9 to upload SDFs starting on September 8, 2025.\n\nSee the [migration pages specific to each version](#migrate_from_your_current_sdf_version) for an\nexhaustive list of differences between your version and v9.\n\nUpdate your Structured Data Files version\n-----------------------------------------\n\nTo use v9, you must update your resources and SDF generation actions to use v9\nwhen downloading and uploading Structured Data Files.\n\n### Update Structured Data Files version\n\nTo use a new Structured Data Files version, update the assigned version in your\nparent Partner and Advertiser resources and use the new version when creating\nindividual download tasks in the [Display \\& Video 360 API](/display-video/api/guides/getting-started/overview).\n\n#### Update parent resource settings\n\nYou set the default Structured Data Files version at the partner and advertiser\nresource level. This version is used as the default when downloading Structured\nData Files through the interface or API.\n\n##### Set in the interface\n\n**At the partner level:**\n\n1. Navigate to the intended partner.\n2. Go to the **Basic Details** page under the **Partner Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the Structured Data Files section to **v9**.\n\n**At the advertiser level:**\n\n1. Navigate to the intended advertiser.\n2. Go to the **Basic Details** page under the **Advertiser Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v9**. If the default version is set at the Partner level, this setting may not be editable.\n\n#### Set in the API\n\n**At the partner level:** You cannot set the default SDF version at the Partner\nlevel in the API.\n\n**At the advertiser level:** Make an [`advertisers.patch`](/display-video/api/reference/rest/current/advertisers/patch) request to\nupdate the\n[`dataAccessConfig.sdfConfig.sdfConfig.version`](/display-video/api/reference/rest/current/SdfConfig#FIELDS.version) to\n`SDF_VERSION_9` and, if needed,\n[`dataAccessConfig.sdfConfig.overridePartnerSdfConfig`](/display-video/api/reference/rest/current/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config)\nto True.\n\n### Update `sdfdownloadtasks.create` requests in the API\n\nWhen making a [`sdfdownloadtasks.create`](/display-video/api/reference/rest/current/sdfdownloadtasks/create) request using the\nDisplay \\& Video 360 API, set the [`version`](/display-video/api/reference/rest/current/sdfdownloadtasks/create#body.request_body.FIELDS.version) field of the request body to\n`SDF_VERSION_9`.\n\nMigrate from your current SDF version\n-------------------------------------\n\n| **Important:** The only new feature in v9 is the ability to declare whether a line item will serve EU political ads. This column will be required starting **September 8, 2025**.\n\nThe following pages walk you through the necessary updates to make to your\nintegration when migrating from your current version to v9 and provide a\ncomprehensive list of all changes between the versions:\n\n- [Migrate from v7](/display-video/api/structured-data-file/v7/migrate-to-v9)\n- [Migrate from v7.1](/display-video/api/structured-data-file/v7-1/migrate-to-v9)\n- [Migrate from v8](/display-video/api/structured-data-file/v8/migrate-to-v9)\n- [Migrate from v8.1](/display-video/api/structured-data-file/v8-1/migrate-to-v9)"]]
