Última atualização: 12/11/2024
Este guia orienta você no processo de migração do uso de arquivos de dados estruturados v7.1 para v8 e explica as mudanças entre as duas versões que podem afetar sua integração.
Consulte as notas da versão para conferir uma lista completa de diferenças entre a v7.1 e a v8.
Migrar a versão dos arquivos de dados estruturados
Para migrar para a versão 8 dos arquivos de dados estruturados (SDFs) de uma versão anterior, faça o seguinte:
- Atualize seus recursos e ações de geração de SDF para usar a v8.
- Atualize a lógica do recurso de anúncio para identificar um tipo na criação.
- Adicione uma nova lógica para ler, criar e atualizar recursos de Geração de demanda.
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 seus recursos de parceiro e anunciante pai e use a nova versão ao criar tarefas de download individuais na API Display & Video 360.
Atualizar as configurações do recurso pai
Uma versão padrão dos arquivos de dados estruturados é definida no nível do recurso do parceiro e do 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.
- Abra o menu Configurações do parceiro no painel de navegação à esquerda e acesse a página Detalhes básicos.
- Atualize a configuração da versão do SDF na seção Arquivos de dados estruturados para v8.
No nível do anunciante
- Acesse o anunciante desejado.
- Abra o menu Configurações do anunciante no painel de navegação à esquerda e acesse a página Detalhes básicos.
- Atualize a configuração da versão do SDF na seção Arquivos de dados estruturados para v8. Se a versão padrão estiver definida no nível do parceiro, essa configuração poderá não ser editável.
Definir 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.patchpara atualizar odataAccessConfig.sdfConfig.sdfConfig.versionparaSDF_VERSION_8e, se necessário,dataAccessConfig.sdfConfig.overridePartnerSdfConfigparaTrue.
Atualização de 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_8.
Especificar o tipo nos recursos de anúncios
A v8 adiciona uma coluna Ad Type aos arquivos Ad, que mostra o tipo de
anúncio representado por cada linha. Essa nova coluna é obrigatória e será preenchida
para recursos existentes ao fazer o download de arquivos de anúncios da v8.
Ao atualizar anúncios, o valor dessa coluna não pode ser alterado.
Ao criar novos anúncios, preencha essa coluna com um dos valores listados na descrição da coluna.
Atualizar a lógica para recursos da Geração de demanda
A v8 oferece suporte à criação, recuperação e atualização de campanhas Geração de demanda usando arquivos Item de linha, Grupo de anúncios e Anúncio. Os recursos de geração de demanda usam uma lógica diferente para a verificação de carimbo de data/hora, exigem a população de colunas adicionais e são limitados por novas restrições nos três tipos de arquivo.
Verificação de carimbo de data/hora
Para todos os itens de linha que não são da Geração de demanda, a coluna Timestamp de um arquivo Item de linha é preenchida no download com a última vez que um item de linha foi modificado. Esse valor é usado ao atualizar um item de linha usando SDF para verificar
se ele não foi atualizado desde o download do arquivo original. Nesse caso, a atualização falha.
Para itens de linha da Geração de demanda, a coluna Timestamp e a verificação
acompanhante funcionam de maneira diferente. Para entradas de itens de linha de Geração de demanda, a coluna é preenchida com o horário atual no download. No upload, o Display & Video 360
verifica se já se passaram mais de 24 horas desde o carimbo de data/hora fornecido. Se já
passaram mais de 24 horas, a entrada do arquivo original é considerada desatualizada e a
atualização falha. Se isso acontecer, faça o download do arquivo novamente e faça as atualizações
com base na versão mais recente. Esse novo método de verificação não impede
que você substitua as mudanças feitas nas últimas 24 horas. Para evitar substituições
acidentais, inclua apenas os itens de linha de Geração de demanda que você quer atualizar nos arquivos
que você fizer upload.
Colunas obrigatórias
Os tipos de arquivo a seguir têm colunas que agora são obrigatórias para alguns recursos do Gerador de demanda, além das colunas obrigatórias para todas as entidades desse tipo de arquivo.
Item de linha
Colunas obrigatórias para os seguintes valores da coluna
Item de linha
Type
|
||||
| Geração de demanda |
|
|||
Anúncio
Colunas obrigatórias para os seguintes valores da coluna
anúncio
Ad Type
|
|||||||||
| Carrossel da Geração de demanda |
|
||||||||
| Imagem da Geração de demanda |
|
||||||||
| Produto da Geração de demanda |
|
||||||||
| Vídeo da Geração de demanda |
|
||||||||
Restrições atualizadas
Além das novas colunas obrigatórias para determinados itens de linha e anúncios da Geração de demanda, várias colunas nos tipos de arquivo Item de linha, Grupo de anúncios e Anúncio têm novas restrições de uso que se aplicam aos recursos da Geração de demanda.
Essas restrições são numerosas e específicas para as colunas em questão. Portanto, este guia não fornece uma lista completa de restrições. Recomendamos que você leia atentamente a documentação de referência da v8 para os tipos de arquivo Item de linha, Grupo de anúncios e Anúncio antes de criar ou atualizar recursos do Gerador de demanda usando o upload de SDF.