Talvez seja necessário migrar para a v9 para fazer upload de arquivos de dados estruturados após 8 de setembro de 2025. Consulte nossa página de descontinuações para mais detalhes e nosso guia de migração para a v9 para instruções detalhadas.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Última atualização: 21/08/2025
Este guia orienta você nos seguintes processos:
Atualize a versão dos arquivos de dados estruturados selecionados para a v9 usando a interface ou a API do Display & Video 360.
Migre sua integração das versões descontinuadas dos arquivos de dados estruturados (v7, v7.1, v8 ou v8.1) para a v9. Ela direciona você para páginas que detalham as mudanças entre
sua versão atual e a v9 que podem afetar sua integração. Em alguns casos, será necessário usar a v9 para fazer upload de SDFs a partir de 8 de setembro de 2025.
Atualizar a versão dos arquivos de dados estruturados
Para usar a v9, atualize seus recursos e ações de geração de SDF para usar a v9
ao fazer o download e o upload de arquivos de dados estruturados.
Atualizar a versão dos arquivos de dados estruturados
Para usar uma nova versão dos arquivos de dados estruturados, atualize a versão atribuída nos recursos de parceiro e anunciante principais e use a nova versão ao criar tarefas de download individuais na API Display & Video 360.
Atualizar configurações de recursos da família
Você define a versão padrão dos arquivos de dados estruturados no nível do recurso de parceiro e anunciante. Essa versão é usada como padrão ao fazer o download de arquivos de dados estruturados pela interface ou API.
Definido na interface
No nível do parceiro:
Navegue até o parceiro desejado.
Acesse a página Detalhes básicos no menu Configurações do parceiro na navegação à esquerda.
Atualize a configuração da versão do SDF na seção "Arquivos de dados estruturados" para v9.
No nível do anunciante:
Acesse o anunciante desejado.
Acesse a página Detalhes básicos no menu Configurações do anunciante na navegação à esquerda.
Atualize a configuração da versão do SDF na seção Arquivos de dados estruturados para v9. Se a versão padrão for definida no nível do parceiro, talvez não seja possível editar essa configuração.
Definido na API
No nível do parceiro:não é possível definir a versão padrão do SDF no nível do parceiro na API.
Atualizar solicitações sdfdownloadtasks.create na API
Ao fazer uma solicitação sdfdownloadtasks.create usando a API
Display & Video 360, defina o campo version do corpo da solicitação como
SDF_VERSION_9.
Migrar da sua versão atual do SDF
As páginas a seguir mostram as atualizações necessárias para fazer na sua
integração ao migrar da versão atual para a v9 e fornecem uma
lista abrangente de todas as mudanças entre as versões:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)"]]
