Última atualização: 18/10/2023
Este guia orienta você no processo de migração para os Arquivos de dados estruturados (SDFs) v7 de uma versão anterior e as mudanças, obrigatórias e sugeridas, que você pode fazer para otimizar melhor a integração.
Consulte as notas da versão para conferir uma lista completa das diferenças entre a v6 e a v7.
Migrar a versão dos arquivos de dados estruturados
Para migrar para a versão 7 dos arquivos de dados estruturados de uma versão anterior, é necessário especificar a nova versão, atualizar os espaços de ID de um subconjunto de colunas existentes e adicionar a integração com novas colunas.
Atualizar a 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 do parceiro e do anunciante pai e as 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
- Acesse o parceiro desejado. Acesse a página Detalhes básicos no menu Configurações do parceiro no painel de 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 estiver definida no nível do parceiro, essa configuração não poderá ser editada.
Definir na API
- No nível do anunciante
- Faça uma solicitação
advertisers.patchpara atualizar odataAccessConfig.sdfConfig.sdfConfig.versionparaSDF_VERSION_7e, 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_7.
Atualizar IDs em 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 de leitura de entidades descontinuado e se alinhar ainda mais com as ferramentas compatíveis, como a API Display & Video 360.
Esta seção lista todas as colunas que usam 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 da v7 para colunas | |
|---|---|
|
Segmentação por app: excluir Segmentação de apps: incluir |
Essas colunas foram atualizadas para usar identificadores de app seguindo o formato " As plataformas de apps são identificadas por um valor de string. Os IDs de app são os IDs fornecidos pela plataforma relevante, como um ID de 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 os valores
Extraia os recursos |
|
Segmentação por operadora: excluir Segmentação por operadora: incluir |
Esta coluna foi atualizada para usar os valores
Extraia os recursos |
|
Segmentação por canal: excluir Segmentação por canal: incluir |
Essa coluna foi atualizada para usar o valor
Extraia recursos
|
|
Segmentação por dispositivo: excluir Segmentação por dispositivo: incluir |
Essa coluna foi atualizada para usar os valores
Extraia os recursos |
| Medir o canal de DAR |
Essa coluna foi atualizada para usar o valor
Extraia recursos
|
Segmentação por site: excluir Segmentação por site: incluir |
Essa coluna foi atualizada para identificar sites por strings de URL. |
Item de linha
| Instruções de migração da v7 para colunas | |
|---|---|
|
Segmentação por app: excluir Segmentação de apps: incluir |
Essas colunas foram atualizadas para usar identificadores de app seguindo o formato " As plataformas de apps são identificadas por um valor de string. Os IDs de app são os IDs fornecidos pela plataforma relevante, como um ID de pacote da Play Store do Android ou o ID do app da App Store da Apple. |
| Multiplicadores de lance |
Essa 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 de apps são os IDs fornecidos pela plataforma relevante, como um ID de 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 os valores
Extraia os recursos |
|
Segmentação por operadora: excluir Segmentação por operadora: incluir |
Esta coluna foi atualizada para usar os valores
Extraia os recursos |
|
Segmentação por canal: excluir Segmentação por canal: incluir |
Essa coluna foi atualizada para usar o valor
Extraia recursos
|
|
Segmentação por dispositivo: excluir Segmentação por dispositivo: incluir |
Essa coluna foi atualizada para usar os valores
Extraia os recursos |
Segmentação por site: excluir Segmentação por site: incluir |
Essa coluna foi atualizada para identificar sites por strings de URL. |
Produto de mídia
| Instruções de migração da v7 para colunas | |
|---|---|
|
Segmentação por canal: excluir Segmentação por canal: incluir |
Essa coluna foi atualizada para usar o valor
Extraia recursos
|
| Segmentação por dispositivo: incluir |
Essa coluna foi atualizada para usar os valores
Extraia os recursos |
Adicionar integração com colunas adicionadas desde a v6
Se você estiver migrando da versão 6 para a 7, adicione as colunas a seguir 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 colunas adicionais adicionadas entre a versão atual e a SDF v6.
Alterações adicionais
Na v7, também introduzimos algumas mudanças superficiais que devem ajudar a simplificar a integração e evitar o uso de arquivos de leitura de entidade descontinuados como referência.
Nova ordenação de lista para um subconjunto de colunas
A SDF v7 garante uma ordenação estável de determinadas colunas de lista na geração de arquivos. Isso resulta em um comportamento mais consistente e uma análise mais fácil. Essa ordenação não é aplicada no upload do arquivo, mas é aplicada posteriormente ao gerar o arquivo atualizado.
Consulte as notas da versão v7 para conferir 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 de leitura de entidade descontinuados e recomendar outros meios de pesquisa de ID.
Os valores retornados pelas colunas a seguir não são diferentes do 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 colunas | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campanha |
|
|||||||||||||||||||||
| Pedido de inserção |
|
|||||||||||||||||||||
| Item de linha |
|
|||||||||||||||||||||
| Produto de mídia |
|
|||||||||||||||||||||
| Grupo de anúncios do YouTube |
|
|||||||||||||||||||||