Migrar para arquivos de dados estruturados v9

Ú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.

Consulte as páginas de migração específicas de cada versão para conferir uma lista completa das diferenças entre sua versão e a v9.

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:

  1. Navegue até o parceiro desejado.
  2. Acesse a página Detalhes básicos no menu Configurações do parceiro na navegação à esquerda.
  3. Atualize a configuração da versão do SDF na seção "Arquivos de dados estruturados" para v9.

No nível do anunciante:

  1. Acesse o anunciante desejado.
  2. Acesse a página Detalhes básicos no menu Configurações do anunciante na navegação à esquerda.
  3. 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.

No nível do anunciante:faça uma solicitação advertisers.patch para atualizar o dataAccessConfig.sdfConfig.sdfConfig.version para SDF_VERSION_9 e, se necessário, dataAccessConfig.sdfConfig.overridePartnerSdfConfig para "True".

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: