Integrar com arquivos de dados estruturados e API

Os arquivos de dados estruturados (SDF, na sigla em inglês) e a API Display & Video 360 são compatíveis com o gerenciamento em massa de configurações de recursos do Display & Video 360. Cada ferramenta tem limitações únicas. Este guia sugere maneiras de otimizar sua implementação atual usando as duas ferramentas.

Se você já usa arquivos de dados estruturados

Use a API Display & Video 360 para oferecer suporte à integração do SDF por meio da recuperação programática dos arquivos e metadados relevantes.

Gerar e fazer o download de arquivos usando a API

Por padrão, você faz o download de arquivos de dados estruturados manualmente usando a interface do Display & Video 360. Em geral, esses downloads são restritos a um único anunciante e precisam ser iniciados em páginas de recursos específicas. O download de muitos dados do SDF pela interface pode ser complexo e demorado.

Simplifique esse processo gerando e fazendo o download de arquivos de dados estruturados de forma programática com a API Display & Video 360. Leia nosso guia para ver instruções detalhadas sobre como implementar esse recurso.

Procurar IDs de referência usando a API

Os arquivos de dados estruturados refletem as configurações dos recursos do Display & Video 360. A maioria das colunas do SDF usa IDs numéricos para identificar outros recursos ou configurações de segmentação. Muitas vezes, você precisa de uma referência para entender esses IDs ao ler e modificar dados do SDF.

Use a API Display & Video 360 para recuperar informações de referência em massa. É possível recuperar os IDs disponíveis usados pela maioria das colunas do SDF usando as funções GET ou LIST do recurso relevante.

Recupere e armazene em cache as informações de referência de maneira programática para usar essas informações ao analisar e modificar seus arquivos de dados estruturados. É possível atualizar regularmente seu cache e, se necessário, procurar IDs desconhecidos em tempo real ao analisar seus SDFs para recuperar informações sobre novos recursos.

Leia a documentação de referência da API para ver uma lista completa dos serviços e métodos de API disponíveis.

Exceções existentes

Um pequeno número de IDs de referência usados por arquivos de dados estruturados não pode ser recuperado com a API Display & Video 360:

  • Segmentação por afinidade e no mercado: recupere os IDs de público-alvo usados nessas colunas da interface do Display & Video 360.
  • IDs de atividades do Floodlight de conversão: recupere os IDs de atividades do Floodlight usados nessas colunas da interface do Display & Video 360.
  • Segmentação da origem de inventário: recupere os IDs de troca usados nessas colunas da referência publicada de troca de SDF. Recupere os IDs da origem de inventário e da subtroca usados nessas colunas com a API Display & Video 360.
  • Segmentação de apps: recupere os IDs de apps usados nessas colunas da plataforma de apps relevante.

Se você já usa a API Display & Video 360

Use o SDF para oferecer suporte à integração da API Display & Video 360 com a criação e atualização em massa de recursos do YouTube e parceiros.

Atualizar os recursos do YouTube e parceiros com o upload de SDF

Não é possível criar ou atualizar recursos do YouTube e parceiros, como tipos específicos de itens de linha, grupos de anúncios e anúncios, usando a API Display & Video 360. É possível recuperar as configurações e a segmentação atribuída a esses recursos, mas todas as atualizações precisam ser feitas na interface do Display & Video 360. Isso restringe as ações em massa e limita a taxa em que esses recursos podem ser atualizados.

Use o upload de arquivos de dados estruturados para criar ou atualizar recursos do YouTube e parceiros em massa por meio da interface do Display & Video 360. Embora seja necessário fazer o upload manual dos arquivos de dados estruturados, é possível concluir a maior parte do processo, ou seja, recuperar e modificar os arquivos de maneira programática.

Leia o guia da API sobre como fazer o download de SDFs e a documentação sobre upload de SDF para mais informações.