Observação: a partir de 8 de setembro de 2025, o Display & Video 360 vai exigir a autodeclaração para anúncios políticos da UE. Ao criar um item de linha, você precisa declarar se ele veiculará anúncios políticos da UE. Com o lançamento da v9, a coluna Contém anúncios políticos da UE foi adicionada à guia "Item de linha" no arquivo de dados estruturados (SDF, na sigla em inglês). Use essa nova coluna para verificar se cada item de linha criado tem uma declaração válida.
Saiba mais sobre as mudanças para apoiar a Regulamentação de Anúncios Políticos da União Europeia na API Display & Video 360 e nos SDFs.
Arquivos de dados estruturados serão úteis se você precisar:
- Criar muitas campanhas, pedidos de inserção ou itens de linha
- Editar em massa várias campanhas, pedidos de inserção ou itens de linha ao mesmo tempo
Este artigo descreve como realizar algumas das tarefas mais comuns usando os arquivos de dados estruturados (SDFs, na sigla em inglês) do Display & Video 360. Saiba mais sobre as diferentes versões e recursos dos SDFs.
Recomendamos o formato CSV ao editar ou criar um SDF.
Evite usar Excel, Python, TextEditor ou outras ferramentas para editar ou criar SDFs.
O uso de outros formatos ou ferramentas pode corromper suas configurações de segmentação, alterar essas definições inesperadamente ou impedir o upload dos arquivos. Saiba mais sobre download, edição e upload de SDFs.
Criar campanhas, pedidos de inserção e itens de linha
Com os SDFs, você pode criar itens de linha e pedidos de inserção do início ao fim ou adicionar itens de linha aos pedidos atuais.
- Para começar, consulte as especificações do SDF.
- No Display & Video 360, faça upload dos SDFs (para anúncios e grupos de anúncios do YouTube, pedidos de inserção e itens de linha) na página de pedidos de inserção do seu anunciante. Para isso, clique em Mais opções
> Fazer upload.
Usar identificadores temporários para vincular arquivos
Se você criar itens de linha simultaneamente em um novo pedido de inserção ou novos anúncios do YouTube em um novo grupo, faça o upload dos arquivos SDF com identificadores personalizados temporários (IDs temporários) para vincular os arquivos.
O formato desses IDs é "
ext[identificador personalizado]" (por exemplo,ext123). Os IDs temporários são inseridos no campo ID do pedido de inserção para vincular itens de linha a pedidos desse tipo e no campo ID do grupo de anúncios para vincular anúncios a grupos do YouTube.Quando os arquivos forem enviados e processados, todos os IDs temporários serão substituídos por IDs gerados exclusivamente pelo Display & Video 360, e todos os itens vão manter suas associações adequadas com base nos identificadores temporários.
Faça o upload dos arquivos interdependentes ao mesmo tempo.
Observação: caso você esteja usando uma versão de SDF anterior à 5.3, os identificadores temporários correspondentes a itens já enviados não serão substituídos nos arquivos retornados. Substitua os identificadores temporários nos arquivos
SDF-{EntityName}-Failed-ResultFile.csveSDF-{EntityName}-Unprocessed-ResultFile.csvpelos IDs gerados recentemente antes de reenviar as entidades. - Escolha seu arquivo CSV e clique em Fazer upload.
- O Display & Video 360 vai verificar seus arquivos e mostrar um status para cada um deles. Você também vai receber um e-mail confirmando que os pedidos de inserção, itens de linha, anúncios e grupos de anúncios do YouTube foram criados ou informando que foram encontrados erros durante a criação da campanha.
-
Atualizações aplicadas: todas as atualizações feitas no SDF foram implementadas. Para confirmar as atualizações, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar o arquivoSDF-{EntityName}-Updated-ResultFile.csve confirmar as atualizações. -
Envio parcial: algumas atualizações de um ou mais arquivos foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar os arquivosSDF-{EntityName}-Updated-ResultFile.csveSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivoSDF-{EntityName}-Failed-ResultFile.csvpara localizar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente. -
Falha: as atualizações feitas no SDF não foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Em seguida, extraia-o para localizar o arquivoSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivo para encontrar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente.
-
- Quando terminar, clique em Fechar para concluir as alterações.
Adicionar novos itens de linha a pedidos de inserção existentes
- No Display & Video 360, verifique se os pedidos de inserção que você quer usar para seus itens de linha foram criados.
Se você já souber criar SDFs com uma formatação adequada, pule para a etapa 4 abaixo.
- Acesse a lista de itens de linha abaixo do anunciante e clique em Ações e Fazer download do SDF.
- Na janela que será aberta, selecione os tipos de itens a serem criados (como itens de linha, grupos de anúncios e/ou anúncios do YouTube). Depois, clique no botão Fazer o download para baixar os SDFs relevantes.
Você também pode usar esses SDFs para editar ao mesmo tempo os itens de linha. - Preencha seu SDF (confira a especificação para SDF aqui) com todos os detalhes dos itens de linha que você quer criar.
- No Display & Video 360, faça upload do SDF na página de pedidos de inserção do anunciante clicando em Ações e em Fazer upload.
- Escolha seu arquivo CSV e clique em Fazer upload.
- O Display & Video 360 vai verificar seus arquivos e mostrar um status para cada um deles. Você também vai receber um e-mail confirmando que seus itens foram criados ou uma notificação sobre erros encontrados.
-
Atualizações aplicadas: todas as atualizações feitas no SDF foram implementadas. Para confirmar as atualizações, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar o arquivoSDF-{EntityName}-Updated-ResultFile.csve confirmar as atualizações. -
Envio parcial: algumas atualizações de um ou mais arquivos foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar os arquivosSDF-{EntityName}-Updated-ResultFile.csveSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivoSDF-{EntityName}-Failed-ResultFile.csvpara localizar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente. -
Falha: as atualizações feitas no SDF não foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Em seguida, extraia-o para localizar o arquivoSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivo para encontrar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente.
-
- Quando terminar, clique em Fechar para concluir as alterações.
Editar campanhas, pedidos de inserção e itens de linha existentes
Economize tempo com a API Display & Video 360
Há duas formas de fazer o download de pedidos de inserção e de itens de linha. Você pode usar a API Display & Video 360 e a interface do Display & Video 360. Para saber como usar a API Display & Video 360, consulte as especificações da API Create Task para SDF.
Pule para a etapa 3 (abaixo) caso você se sinta confortável em baixar os itens de linha com a API Display & Video 360.
- No Display & Video 360, acesse a lista de pedidos de inserção, a lista de itens de linha (ambas no anunciante) ou a lista de itens de linha em um pedido de inserção individual.
- Escolha uma destas opções para saber como baixar seus itens de linha: Todos os itens de linha em um ou mais pedidos de inserção
Itens de linha individuais
- Comece acessando um destes locais:
- Anunciante e Pedidos de inserção
- Anunciante e Itens de linha
- Anunciante > Pedido de inserção > Itens de linha
- Clique em Mais opções
- (Opcional) Como alternativa, você pode exportar os itens de linha para as Planilhas Google. Basta clicar em "Salvar nas Planilhas Google".
- Acesse a lista de itens de linha no anunciante ou a lista de itens de linha em um pedido de inserção individual. Depois, marque as caixas de seleção ao lado dos itens que você quer editar.
- Clique em Ações > Download na barra de menus no topo da lista de itens de linha. Seus itens serão baixados em um SDF.
- (Opcional) Como alternativa, você pode exportar os itens de linha para as Planilhas Google. Basta clicar em "Salvar nas Planilhas Google".
- Comece acessando um destes locais:
- No SDF transferido, faça mudanças nos itens de linha e depois salve o arquivo. Salve o SDF como um arquivo CSV. Caso use o Excel para fazer as modificações, não edite os carimbos de data/hora no SDF, porque eles podem ser corrompidos e impedir que o arquivo seja importado pelo Display & Video 360.
- No Display & Video 360, faça upload do SDF na página de pedidos de inserção do anunciante. Para isso, clique em Ações e em Fazer upload da planilha.
- Escolha seu arquivo CSV e clique em Fazer upload.
- O Display & Video 360 vai verificar seus arquivos e mostrar um status para cada um deles. Você também receberá um e-mail com os detalhes de cada arquivo. Esse e-mail vai confirmar que os itens de linha foram criados ou notificar você sobre erros.
-
Atualizações aplicadas: todas as atualizações feitas no SDF foram implementadas. Para confirmar as atualizações, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar o arquivoSDF-{EntityName}-Updated-ResultFile.csve confirmar as atualizações. -
Envio parcial: algumas atualizações de um ou mais arquivos foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar os arquivosSDF-{EntityName}-Updated-ResultFile.csveSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivoSDF-{EntityName}-Failed-ResultFile.csvpara localizar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente. -
Falha: as atualizações feitas no SDF não foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Em seguida, extraia-o para localizar o arquivoSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivo para encontrar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente.
-
- Quando terminar, clique em Fechar para concluir as alterações.
Download das origens de inventário
- Acesse a lista de origens de inventário na página "Meu inventário".
- Escolha uma destas opções para saber como baixar suas origens de inventário em um SDF: Todas as origens de inventário
Origens de inventário individuais
- Clique em Mais opções
- Marque as caixas de seleção ao lado das origens de inventário que você quer transferir por download.
- Clique em Fazer o download do SDF na barra azul na parte superior da lista de origens de inventário. Suas origens de inventário serão transferidas por download a um SDF.
- Clique em Mais opções
Criar, modificar e fazer upload de origens de inventário
Saiba mais sobre as diferentes linhas no SDF, incluindo campos disponíveis, tipos diversos e valores que podem ser registrados no upload.
- Depois de fazer o download das origens de inventário como um SDF, abra o arquivo CSV no aplicativo escolhido por você para fazer as alterações. Se estiver usando o Excel, não edite os carimbos de data/hora no SDF porque eles podem ser corrompidos e impedir que seu arquivo seja importado pelo Display & Video 360.
- Escolha uma destas opções para saber como criar e modificar origens de inventário: Modificar uma origem de inventário
Como arquivar uma origem de inventário existente
- Encontre a linha da origem de inventário que você quer modificar e faça alterações nos campos relevantes.
Observação: só é possível arquivar uma transação de reserva após a data de término da transação.Como pausar uma origem de inventário existente (somente transações de reserva)- Encontre a linha da origem de inventário que você quer arquivar.
- No campo "Status", insira Arquivadas.
Como retomar uma origem de inventário existente- Localize a linha da origem de inventário que você quer pausar.
- No campo "Status", insira Pausadas.
- No campo "Motivo da pausa", insira o motivo da pausa da origem de inventário.
Como criar uma nova origem de inventário não garantida- Localize a linha da origem de inventário que você quer retomar.
- No campo "Status", insira Ativas.
- (Opcional) No campo "Motivo da pausa", exclua o motivo da pausa da origem de inventário antes de retomá-la.
- Crie uma nova linha para cada nova origem de inventário.
- Preencha os seguintes campos para cada nova origem de inventário:
- Troca (observação: não pode ser atualizada depois de salva)
- ID da transação (observação: não pode ser atualizado depois de salvo)
- Nome
- Tipo de negociação
- (Opcional) Nome do vendedor
- CPM mínimo (siga o formato: $ X.XX)
- Código da moeda
- Data de início
- Data de término
- Anunciante autorizado
- Após terminar o processo, salve o arquivo CSV.
- De volta à página "Meu inventário" no Display & Video 360 (a mesma em que você fez o download das origens de inventário), clique em Mais opções
- O Display & Video 360 vai verificar seus arquivos e mostrar um status para cada um deles.
-
Atualizações aplicadas: todas as atualizações feitas no SDF foram implementadas. Para confirmar as atualizações, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar o arquivoSDF-{EntityName}-Updated-ResultFile.csve confirmar as atualizações. -
Envio parcial: algumas atualizações de um ou mais arquivos foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Depois, extraia-o para localizar os arquivosSDF-{EntityName}-Updated-ResultFile.csveSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivoSDF-{EntityName}-Failed-ResultFile.csvpara localizar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente. -
Falha: as atualizações feitas no SDF não foram implementadas. Para determinar os erros, clique em Fazer o download dos arquivos e transfira o arquivo
SDF-ResultFile.zip. Em seguida, extraia-o para localizar o arquivoSDF-{EntityName}-Failed-ResultFile.csv. Abra o arquivo para encontrar e corrigir os erros. Quando terminar, faça o upload do seu arquivo novamente.
-
- Quando terminar, clique em Fechar para concluir as alterações.
Fazer o download dos metadados
- Acesse Anunciante e Campanhas e Mais opções
- Os arquivos de metadados podem ser muito grandes, dependendo da configuração do anunciante.
- Para acompanhar o progresso de download dos metadados, clique em Status em massa
na parte de cima da página. Saiba como acompanhar o histórico de edições das ações em massa.
Limitações
Os seguintes recursos não são compatíveis com SDF:
- Segmentação por categoria de aplicativos instalados
- Segmentação de empresas por fronteira geográfica virtual
- Compra de GRP para itens de linha selecionados por parceiros
- Itens de linha de mídia digital out of home (DOOH)
Recomendamos que você compare regularmente as configurações da campanha no Display & Video 360 com os campos de SDF disponíveis em developers.google.com.
Perguntas frequentes
O Display & Video 360 poderá enviar e-mails para outras pessoas quando meus SDFs forem processados?Sim. Todos os e-mails com SDFs também podem ser enviados ao endereço de e-mail do administrador. Isso pode ser útil se você quiser que uma lista de distribuição da equipe veja os e-mails de processamento do SDF ou se quiser analisar esses e-mails por um sistema. Os e-mails "Administrador" podem ser configurados na seção "Arquivos de dados estruturados" do seu parceiro ou nos detalhes básicos do anunciante.
Sim. Para fazer o download e o upload de arquivos que abrangem vários anunciantes do mesmo parceiro, acesse a lista de anunciantes do seu parceiro, selecione seus anunciantes e faça o download de um SDF no menu Ações. Depois de editar seus SDFs, retorne à lista de anunciantes para enviar seus arquivos.
Sim. A versão do SDF pode ser alterada no nível de parceiro e anunciante.
- Nível do parceiro: para mudar a versão do SDF do parceiro, acesse [Nome do parceiro] > Configurações > Detalhes básicos. Na seção "Arquivos de dados estruturados" da página, clique no menu suspenso para selecionar a versão do SDF.
- Nível do anunciante: para mudar a versão do SDF do anunciante, acesse [Nome do anunciante] > Configurações > Detalhes básicos. Na seção "Arquivos de dados estruturados" da página, clique no menu suspenso para selecionar a versão do SDF. Além disso, você tem a opção de substituir as configurações no nível do parceiro.
O recomendado é usar a versão mais recente possível do SDF.
Há dois métodos de fazer o download de itens de linha: pela API Display & Video 360 e manualmente, dentro da plataforma.
- Usar a API: para baixar SDFs usando a API, consulte Dados estruturados em developers.google.com.
- Usar a interface: para baixar manualmente os itens de linha na interface do Display & Video 360, acesse uma destas opções na plataforma:
- Anunciante > Pedidos de inserção > Ações > Download
- Anunciante, Itens de linha, Ações e Fazer o download
- Anunciante, Pedido de inserção, Itens de linha e Fazer o download
Consulte Criar pedidos de inserção e itens de linha ou Editar pedidos de inserção e itens de linha existentes acima.
Sim. O Display & Video 360 vai adicionar os SDFs a uma fila e processar na ordem em que forem enviados. Verifique se você sabe usar os identificadores temporários para vincular arquivos.
No entanto, para prevenir erros, evite fazer upload de vários arquivos ao mesmo tempo caso eles incluam o mesmo item de linha.
Faça o download de um SDF de itens de linha que você quer copiar e remova o Line Item Id no arquivo. Uma linha do SDF sem um Line Item Id vai informar o Display & Video 360 que é preciso criar itens de linha. Altere os nomes desses itens de linha para os novos nomes.
Se você quiser copiar itens de linha entre pedidos de inserção, não se esqueça de atualizar o campo Io Id.
Os arquivos da leitura de entidades são arquivos simples no Google Cloud Storage que contêm valores de busca para entidades do Display & Video 360, como áreas geográficas, criativos, listas de públicos-alvo e muito mais. Esses valores de busca podem ser usados a fim de atribuir criativos e segmentá-los para itens de linha por ID.
Sim. No entanto, algumas configurações de segmentação são de propriedade do anunciante, como canais, listas de público-alvo e origens de inventário específicas do anunciante, como ofertas.
Então, se você fizer o download de um SDF de itens de linha do "Anunciante A" e depois fizer upload dos itens de linha para o "Anunciante B", não se esqueça de remover primeiro todos os canais ou listas de público-alvo próprias do SDF, uma vez que eles não podem ser usados com um anunciante diferente.
Consulte Arquivo de dados estruturados do Display & Video 360 em developers.google.com para informações sobre as opções de segmentação compatíveis.
