Última atualização: 18/10/2023
Este guia orienta o processo de migração de uma versão anterior para arquivos de dados estruturados (SDF, na sigla em inglês) v7 e as alterações, obrigatórias e sugeridas, que podem ser feitas para otimizar melhor sua integração.
Consulte as notas da versão para encontrar uma lista completa das diferenças entre a v6 e a v7.
Migrar sua versão dos arquivos de dados estruturados
Migrar de uma versão anterior para arquivos de dados estruturados v7 exige que você especifique a nova versão, atualize os espaços de ID de um subconjunto de colunas existentes e adicione integração com novas colunas.
Atualizar versão dos arquivos de dados estruturados
Se quiser atualizar para uma nova versão dos arquivos de dados estruturados, você precisa atualizar a versão atribuída aos recursos pais de parceiro e anunciante, além das 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 por meio da interface ou da API.
Definido na interface
- No nível do parceiro
- Acesse o parceiro. 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 v7.
- No nível do anunciante
- Acesse o anunciante desejado. Acesse a página Detalhes básicos no menu Configurações do anunciante no painel de navegação à esquerda. Atualize a configuração da versão do SDF na seção Arquivos de dados estruturados para v7. Se a versão padrão for definida no nível do parceiro, essa configuração não poderá ser editada.
Definido na API
- No nível do anunciante
- Faça uma solicitação de
advertisers.patchpara atualizar odataAccessConfig.sdfConfig.sdfConfig.versionparaSDF_VERSION_7e, se necessário,dataAccessConfig.sdfConfig.overridePartnerSdfConfigparaTrue.
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_7.
Atualizar IDs nas colunas obrigatórias
Na v7, os espaços de ID usados por um subconjunto de colunas foram atualizados para separar os arquivos de dados estruturados do produto descontinuado, arquivos de leitura de entidades e alinhar ainda mais as ferramentas com suporte, como a API Display & Video 360.
Esta seção lista cada coluna usando IDs diferentes da v6 e instruções sobre como recuperar informações de referência sobre os novos valores.
Pedido de inserção
| Instruções de migração para colunas da v7 | |
|---|---|
|
Segmentação de aplicativo: excluir Segmentação de aplicativo: incluir |
Essas colunas foram atualizadas para usar identificadores de apps seguindo o
formato " As plataformas de apps são identificadas por um valor de string. IDs de apps são aqueles fornecidos pela plataforma relevante, como o ID do pacote da Play Store do Android ou o ID do app da App Store da Apple. |
|
Segmentação por navegador: excluir Segmentação por navegador: incluir |
Esta coluna foi atualizada para usar valores
Recupere
recursos de
|
|
Segmentação por operadora: excluir Segmentação por operadora: incluir |
Esta coluna foi atualizada para usar valores
Recupere
recursos de
|
|
Segmentação de canal: excluir Segmentação de canal - Incluir |
Esta coluna foi atualizada para usar o valor
Recupere recursos de |
|
Segmentação por dispositivo: excluir Segmentação por dispositivo: incluir |
Esta coluna foi atualizada para usar valores
Recupere
recursos de
|
| Medir o canal do revendedor autorizado de distribuição |
Esta coluna foi atualizada para usar o valor
Recupere recursos de |
Segmentação por site - Excluir Segmentação por site - Incluir |
Essa coluna foi atualizada para identificar sites pelas strings de URL. |
Item de linha
| Instruções de migração para colunas da v7 | |
|---|---|
|
Segmentação de aplicativo: excluir Segmentação de aplicativo: incluir |
Essas colunas foram atualizadas para usar identificadores de apps seguindo o
formato " As plataformas de apps são identificadas por um valor de string. IDs de apps são aqueles fornecidos pela plataforma relevante, como o ID do pacote da Play Store do Android ou o ID do app da App Store da Apple. |
| Multiplicadores de lance |
Esta coluna foi atualizada para usar novos IDs de critérios para os tipos de linha app e site. O tipo de linha app foi atualizado para usar valores de string concatenados da plataforma do app e do ID da plataforma do app, separados por dois pontos, para os IDs de critérios. As plataformas de apps são identificadas por um valor de string. IDs de apps são aqueles fornecidos pela plataforma relevante, como o ID do pacote da Play Store do Android ou o ID do app da App Store da Apple. O tipo de linha site foi atualizado para usar strings de URL como IDs de critérios. |
|
Segmentação por navegador: excluir Segmentação por navegador: incluir |
Esta coluna foi atualizada para usar valores
Recupere
recursos de
|
|
Segmentação por operadora: excluir Segmentação por operadora: incluir |
Esta coluna foi atualizada para usar valores
Recupere
recursos de
|
|
Segmentação de canal: excluir Segmentação de canal - Incluir |
Esta coluna foi atualizada para usar o valor
Recupere recursos de |
|
Segmentação por dispositivo: excluir Segmentação por dispositivo: incluir |
Esta coluna foi atualizada para usar valores
Recupere
recursos de
|
Segmentação por site - Excluir Segmentação por site - Incluir |
Essa coluna foi atualizada para identificar sites pelas strings de URL. |
Produto de mídia
| Instruções de migração para colunas da v7 | |
|---|---|
|
Segmentação de canal: excluir Segmentação de canal - Incluir |
Esta coluna foi atualizada para usar o valor
Recupere recursos de |
| Segmentação por dispositivo: incluir |
Esta coluna foi atualizada para usar valores
Recupere
recursos de
|
Adicionar integração com colunas adicionadas desde a v6
Se você migrar da v6 para a v7, será necessário adicionar as seguintes colunas aos arquivos relevantes:
| Tipo de arquivo | Coluna |
|---|---|
| Item de linha | Contagem de frequência desejada de TrueView |
| Item de linha | Janela de tempo da frequência desejada do TrueView |
| Grupo de anúncios do YouTube | Segmentação otimizada |
Se você estiver migrando de uma versão anterior dos arquivos de dados estruturados, consulte as notas da versão dos arquivos de dados estruturados para ver informações sobre outras colunas adicionadas entre a versão atual e o SDF v6.
Alterações adicionais
Na v7, também instituímos algumas mudanças superficiais que ajudam a simplificar sua integração e deixar de usar arquivos de leitura de entidades descontinuados para referência.
Nova ordem de lista para algumas colunas
O SDF v7 garante uma ordem estável de determinadas colunas de lista na geração de arquivos. Isso resulta em um comportamento mais consistente e na análise mais fácil. Essa ordem não é aplicada no upload do arquivo, mas é aplicada posteriormente ao gerar o arquivo atualizado.
Consulte as notas da versão v7 para ver uma lista completa de colunas que agora são geradas em ordem numérica ou alfabética crescente.
Novas recomendações de referência de ID
Atualizamos as definições de várias colunas para remover a referência a arquivos da leitura de entidades descontinuados e recomendar outros meios de pesquisa de ID.
Os valores retornados pelas colunas a seguir não são diferentes dos valores no SDF v6, mas sugerimos que você atualize sua integração para recuperar os IDs usando o novo método recomendado, que pode ser encontrado nas descrições de colunas da v7.
| Tipos de arquivos e as colunas deles | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| Pedido de inserção |
|
|||||||||||||||||||||
| Item de linha |
|
|||||||||||||||||||||
| Produto de mídia |
|
|||||||||||||||||||||
| Grupo de anúncios do YouTube |
|
|||||||||||||||||||||