Os arquivos de dados estruturados (SDFs, na sigla em inglês) são arquivos CSV formatados de maneira especial. Elas permitem a recuperação, criação e edição de recursos em massa no Display & Video 360. Faça atualizações em massa nos recursos baixando, editando e enviando novamente as SDFs.
A interface do Display & Video 360 oferece suporte a downloads e uploads de SDF. A API Display & Video 360 oferece suporte a downloads de SDFs.
Formatos
Um SDF usa um de dois formatos básicos, Standard e QA:
- É possível fazer o download e upload de arquivos no formato Padrão. Os dados nesses arquivos podem usar IDs numéricos para garantir a precisão no upload. Talvez seja necessário ter informações de referência para interpretar os dados.
- É possível baixar arquivos no formato QA. Esses arquivos fornecem os mesmos dados que os arquivos de formato padrão, mas usam valores mais legíveis por humanos. Por exemplo, algumas colunas podem usar nomes de exibição em vez de IDs. As colunas específicas desse formato usam o sufixo "Qa".
Tipos de arquivo
O SDF é compatível com sete tipos de recursos. Cada tipo de recurso tem um tipo de arquivo com uma estrutura de coluna própria. Os tipos de recursos compatíveis são:
- Campanha
- Pedido de inserção
- Item de linha
- Grupo de anúncios
- Anúncio
- Origem de inventário
- Produto de mídia
Somente os tipos de arquivo Item de linha e Grupo de anúncios são compatíveis com o formato QA.
Novas versões do SDF são lançadas regularmente e as versões anteriores são descontinuadas. As novas versões atualizam a estrutura da coluna "Tipo de arquivo". Se necessário, uma nova versão do SDF vai incluir um guia de migração no lançamento.
Fazer download dos erros
Os downloads de SDF podem resultar em dois tipos de erros: erros de geração de arquivos e recursos ignorados.
Erros de geração de arquivos
A geração de SDF pode ser encerrada com um erro. Se a geração falhar ao usar a API Display & Video 360, a tarefa concluída vai definir o campo error com o objeto Status. O objeto Status vai conter uma mensagem detalhando a causa do erro.
Leia mais sobre esses erros na nossa página do guia de erros e avisos.
Erros ignorados
Os SDFs não são compatíveis com todos os subtipos de recursos. Se um recurso não puder ser incluído em um
SDF, um arquivo "Ignorado" (exemplo: SDF-LineItems-Skipped.csv) será incluído no
download. Ele tem uma estrutura de duas colunas. A primeira coluna identifica o recurso ignorado. A segunda coluna explica a exclusão.
Upload de arquivo
Faça upload de SDFs usando a interface do Display & Video 360 para criar ou atualizar recursos.
Siga estas etapas para minimizar erros ao atualizar ou criar recursos com SDFs:
- Baixe SDFs usando a API Display & Video 360 ou a interface.
- Modifique as entradas de arquivo atuais para atualizar os recursos.
- Adicione entradas de arquivo para criar novos recursos.
- Remova as entradas que não são novas ou atualizadas. Isso reduz o tamanho do arquivo e elimina a chance de atualizações não intencionais.
- Faça o upload do arquivo na interface do Display & Video 360.
Depois que um SDF é enviado e processado, um arquivo SDF-ResultFile.zip fica disponível para download. Esse arquivo ZIP pode conter dois arquivos possíveis:
SDF-{ResourceType}-Updated-ResultFile.csv, que lista os recursos atualizados ou criados com sucesso.SDF-{ResourceType}-Failed-ResultFile.csv, que lista as operações com falha e mensagens de erro relevantes.
O arquivo ZIP pode conter um ou os dois arquivos.