Es posible que debas migrar a la versión 9 para subir archivos de datos estructurados después del 8 de septiembre de 2025. Consulta nuestra página de desuso para obtener más detalles y nuestra guía de migración a la versión 9 para obtener instrucciones paso a paso.
Migra a la versión 9 de los archivos de datos estructurados
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Última actualización: 21 de agosto de 2025
En esta guía, se te guiará por los siguientes procesos:
Actualiza la versión de los archivos de datos estructurados seleccionados a la versión 9 con la IU o la API de Display & Video 360.
Migra tu integración de las versiones obsoletas de los archivos de datos estructurados (v7, v7.1, v8 o v8.1) a la versión 9. Te dirige a páginas que detallan los cambios entre tu versión actual y la versión 9 que pueden afectar tu integración. En algunos casos, deberás usar la versión 9 para subir los SDF a partir del 8 de septiembre de 2025.
Actualiza la versión de tus archivos de datos estructurados
Para usar la versión 9, debes actualizar tus recursos y acciones de generación de SDF para usar la versión 9 cuando descargues y subas archivos de datos estructurados.
Actualiza la versión de los archivos de datos estructurados
Para usar una nueva versión de los archivos de datos estructurados, actualiza la versión asignada en tus recursos de socio y anunciante principales, y usa la nueva versión cuando crees tareas de descarga individuales en la API de Display & Video 360.
Actualiza la configuración del recurso principal
Establece la versión predeterminada de los archivos de datos estructurados a nivel del socio y del recurso del anunciante. Esta versión se usa como predeterminada cuando se descargan archivos de datos estructurados a través de la interfaz o la API.
Configuración en la interfaz
A nivel del socio:
Navega al socio deseado.
Ve a la página Detalles básicos en el menú Configuración del socio de la navegación de la izquierda.
Actualiza la configuración de la versión del SDF en la sección Archivos de datos estructurados a v9.
A nivel del anunciante:
Navega al anunciante deseado.
Ve a la página Detalles básicos en el menú Configuración del anunciante en la navegación de la izquierda.
Actualiza la configuración de versión del SDF en la sección Archivos de datos estructurados a v9. Si la versión predeterminada se establece a nivel del socio, es posible que este parámetro de configuración no se pueda editar.
Configuración en la API
A nivel del socio: No puedes establecer la versión predeterminada de SDF a nivel del socio en la API.
Actualiza las solicitudes de sdfdownloadtasks.create en la API
Cuando realices una solicitud de sdfdownloadtasks.create con la API de Display & Video 360, configura el campo version del cuerpo de la solicitud como SDF_VERSION_9.
Migra desde tu versión actual del SDF
En las siguientes páginas, se explican las actualizaciones necesarias que debes realizar en tu integración cuando migres de tu versión actual a la versión 9 y se proporciona una lista completa de todos los cambios entre las versiones:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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)"]]
