Última atualização: 18/10/2023
Este guia explica o processo de migração de uma versão anterior para os arquivos de dados estruturados (SDF, na sigla em inglês) v7 e as alterações, necessárias e sugeridas, que podem ser feitas para otimizar melhor sua integração.
Consulte as Notas de lançamento para ver uma lista completa das diferenças entre a v6 e a v7.
Migrar sua versão dos arquivos de dados estruturados
A migração de uma versão anterior para os 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 a integração com novas colunas.
Atualizar versão dos arquivos de dados estruturados
Para atualizar para uma nova versão dos arquivos de dados estruturados, é necessário atualizar a versão atribuída aos recursos pais de parceiros e anunciantes e as tarefas de download individuais na API Display & Video 360.
Atualizar configurações de recursos pai
Uma versão padrão dos arquivos de dados estruturados é definida no nível de 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 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 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, talvez não seja possível editar essa configuração.
Definir 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.
Atualize os IDs nas colunas obrigatórias
Na v7, os espaços de ID usados por um subconjunto de colunas foram atualizados para dissociar arquivos de dados estruturados do produto descontinuado "Arquivos de leitura de entidades" e se alinhar ainda mais com ferramentas compatíveis, como a API Display & Video 360.
Esta seção lista cada coluna usando IDs diferentes dos 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 da v7 para colunas | |
|---|---|
|
Segmentação por aplicativo: excluir Segmentação por aplicativo: incluir |
Estas colunas foram atualizadas para usar identificadores de apps seguindo o
formato " As plataformas de apps são identificadas por um valor de string. Os IDs do app são os IDs fornecidos pela plataforma relevante, como um ID de pacote da Play Store do Android ou um 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
|
|
Segmentação por operadora: excluir Segmentação por operadora: incluir |
Esta coluna foi atualizada para usar valores
Recupere
|
|
Segmentação de canal: excluir Segmentação de canal - Incluir |
Esta coluna foi atualizada para usar o valor
Recupere recursos
|
|
Segmentação por dispositivo: excluir Segmentação por dispositivo: incluir |
Esta coluna foi atualizada para usar valores
Recupere
|
| Medir canal de revendedor autorizado de distribuição |
Esta coluna foi atualizada para usar o valor
Recupere recursos
|
Segmentação por site: excluir Segmentação por site - Incluir |
Esta coluna foi atualizada para identificar sites usando strings de URL. |
Item de linha
| Instruções de migração da v7 para colunas | |
|---|---|
|
Segmentação por aplicativo: excluir Segmentação por aplicativo: incluir |
Estas colunas foram atualizadas para usar identificadores de apps seguindo o
formato " As plataformas de apps são identificadas por um valor de string. Os IDs do app são os IDs fornecidos pela plataforma relevante, como um ID de pacote da Play Store do Android ou um 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. Os IDs do app são os IDs fornecidos pela plataforma relevante, como um ID de pacote da Play Store do Android ou um 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
|
|
Segmentação por operadora: excluir Segmentação por operadora: incluir |
Esta coluna foi atualizada para usar valores
Recupere
|
|
Segmentação de canal: excluir Segmentação de canal - Incluir |
Esta coluna foi atualizada para usar o valor
Recupere recursos
|
|
Segmentação por dispositivo: excluir Segmentação por dispositivo: incluir |
Esta coluna foi atualizada para usar valores
Recupere
|
Segmentação por site: excluir Segmentação por site - Incluir |
Esta coluna foi atualizada para identificar sites usando strings de URL. |
Produto de mídia
| Instruções de migração da v7 para colunas | |
|---|---|
|
Segmentação de canal: excluir Segmentação de canal - Incluir |
Esta coluna foi atualizada para usar o valor
Recupere recursos
|
| Segmentação por dispositivo: incluir |
Esta coluna foi atualizada para usar valores
Recupere
|
Adicionar integração com colunas adicionadas desde a v6
Se estiver migrando da v6 para a v7, é necessário adicionar as seguintes colunas aos arquivos relevantes:
| Tipo de arquivo | Coluna |
|---|---|
| Item de linha | Contagem de frequência desejada do 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 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 para simplificar a integração e evitar o uso de arquivos de leitura de entidades descontinuados como referência.
Nova ordem de lista para um subconjunto de colunas
O SDF v7 garante uma ordem estável de determinadas colunas de lista na geração do arquivo. Isso resulta em um comportamento mais consistente e uma 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 da v7 para ver uma lista completa de colunas que agora são geradas em ordem alfabética ou numérica crescente.
Recomendações de referência do novo ID
Atualizamos as definições de várias colunas para remover a referência aos arquivos de leitura de entidades descontinuados e, em vez disso, recomendamos 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 das colunas v7.
| Tipos de arquivo e suas colunas | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campaign |
|
|||||||||||||||||||||
| Pedido de inserção |
|
|||||||||||||||||||||
| Item de linha |
|
|||||||||||||||||||||
| Produto de mídia |
|
|||||||||||||||||||||
| Grupo de anúncios do YouTube |
|
|||||||||||||||||||||