Dados estruturados - v11 - Anúncio

Consulte a visão geral para uma explicação do formato.

Campo	Obrigatório	Tipo	Gravável	Descrição
ID do anúncio	Obrigatório apenas ao editar anúncios	número inteiro	Não	É o valor do ID numérico do anúncio do grupo de anúncios. Se deixado em branco, um novo anúncio será criado e um ID exclusivo será atribuído.
ID do grupo de anúncios	Sim	número inteiro	Não	É o valor do ID numérico do grupo de anúncios principal. Você pode especificar um identificador personalizado (por exemplo, "ext[custom ad group ID]") para um grupo de anúncios criado ao mesmo tempo que este anúncio.
Nome do grupo de anúncios	Não	string	Não	Nome do grupo de anúncios
Nome	Sim	string	Sim	O nome da entrada.
Status	Sim	string	Sim	A configuração de status da entrada. Ativo Pausado Excluído
Tipo de anúncio	Obrigatório para anúncios do YouTube e da Geração de demanda	string	Sim	O formato do anúncio. Os anúncios em vídeo in-stream e in-feed são tipos de anúncios em vídeo do YouTube vendidos com base no CPV. Os anúncios bumper são anúncios em vídeo de até 6 segundos vendidos com base no CPM. Os anúncios em vídeo não puláveis são anúncios no YouTube com duração entre 6 e 15 segundos vendidos com base no CPM. Os anúncios em áudio do YouTube são anúncios no YouTube. Os anúncios responsivos em vídeo são tipos de anúncios do YouTube que veiculam vários formatos. Os anúncios de alcance eficiente serão veiculados como bumper do YouTube se o vídeo for curto o suficiente e como in-stream do YouTube caso contrário. Os anúncios em vídeo da Geração de Demanda são veiculados em vários formatos, incluindo, mas não se limitando a, o YouTube. Os anúncios gráficos da Geração de demanda mostram imagens. Os anúncios de carrossel da Geração de demanda mostram cards. Os anúncios de produto da Geração de demanda mostram produtos. Selecione um dos seguintes valores: In-stream Vídeo In-feed Bumper Não pulável Áudio do YouTube Responsivo Alcance eficiente Produto da Geração de demanda Vídeo da Geração de demanda Imagem da Geração de demanda Carrossel da Geração de demanda
ID do vídeo	Obrigatório para anúncios em vídeo do YouTube e da Geração de demanda	string	Sim	Os IDs dos vídeos do YouTube usados pelo anúncio. Cada ID de vídeo do YouTube também pode ser pareado com um valor de status de atestado de conteúdo sintético que especifica se um rótulo deve ser adicionado ao vídeo como criado ou editado com IA quando veiculado em regiões com regulamentações locais de rotulagem de IA: "ON" atesta que o vídeo foi criado ou editado com IA "OFF" atesta que o vídeo não foi criado nem editado com IA Deixar esse valor em branco não fornece uma atestação. Se uma declaração já tiver sido fornecida para esse ID de vídeo do YouTube no anunciante, o valor da declaração atual será aplicado automaticamente. Se o valor "ON" ou "OFF" for fornecido para um ID de vídeo do YouTube, essa declaração será aplicada a todos os usos atuais desse ID de vídeo do YouTube no anunciante. Leia mais sobre isso em Rotulagem de IA em anúncios usando SDF. Formato da lista = (ID do vídeo do YouTube; status da declaração de conteúdo sintético); (ID do vídeo do YouTube; status da declaração de conteúdo sintético); etc.) Por exemplo: "(abdefg; ON);(hijlk; OFF);(mnopq;)"
URL de visualização	Sim, para in-stream e bumper	string	Sim	O URL de visualização do anúncio
URL da página de destino	Obrigatório para anúncios in-stream, bumper e Geração de demanda	string	Sim	O URL da página de destino do anúncio
Rastreamento do DCM: ID da posição	Obrigatório apenas ao atualizar um anúncio de rastreamento do DCM	número inteiro	Sim	Valor do ID numérico da posição do DCM para o anúncio de rastreamento correspondente. Para remover um anúncio de rastreamento do DCM, deixe as três colunas "Rastreamento do DCM: ID da posição", "Rastreamento do DCM: ID do anúncio" e "Rastreamento do DCM: ID do criativo" em branco.
Rastreamento do DCM: ID do anúncio	Obrigatório apenas ao atualizar um anúncio de rastreamento do DCM	número inteiro	Sim	Valor do ID numérico do anúncio de rastreamento do DCM.Para remover um anúncio de rastreamento do DCM, deixe em branco as três colunas "Rastreamento do DCM: ID da posição", "Rastreamento do DCM: ID do anúncio" e "Rastreamento do DCM: ID do criativo".
Rastreamento do DCM: ID do criativo	Obrigatório apenas ao atualizar um anúncio de rastreamento do DCM	número inteiro	Sim	É o valor do ID numérico do criativo para o anúncio de rastreamento correspondente.Para remover um anúncio de rastreamento do DCM, deixe em branco as três colunas "Rastreamento do DCM - ID da posição", "Rastreamento do DCM - ID do anúncio" e "Rastreamento do DCM - ID do criativo".
URL do rastreador de cliques	Não	string	Sim	O URL de rastreamento de cliques no anúncio
Parâmetros de URL do rastreador de cliques	Não	string, lista de listas	Sim	Os parâmetros personalizados do URL de rastreamento de cliques. Formato = (name1; value1;); (name2; value2;); etc.
Call-to-action	Obrigatório quando "Título" não está vazio ou "Tipo de anúncio" é "Vídeo da Geração de demanda", "Imagem da Geração de demanda" ou "Carrossel da Geração de demanda"	string	Sim	Rótulo do botão de call-to-action (uma linha com até 10 caracteres).
Título	Necessário para anúncios da Geração de demanda	string	Sim	Título da sobreposição de call-to-action (uma linha com até 15 caracteres).
Caminho do URL de visualização 1	Não	string	Sim	Caminho do URL de visualização 1
Caminho do URL de visualização 2	Não	string	Sim	Caminho do URL de visualização 2
Miniatura do vídeo in-feed	Sim para vídeo in-feed	string	Sim	A miniatura do vídeo a ser usada nos anúncios Discovery 0 1 2 3
Título do vídeo in-feed	Obrigatório para anúncios em vídeo in-feed e da Geração de demanda	string	Sim	O texto do título de um anúncio responsivo ou Discovery ou o título longo dos anúncios de Geração de demanda.
Descrição 1	Obrigatório para anúncios em vídeo in-feed e da Geração de demanda	string	Sim	O texto da descrição 1 do anúncio Discovery ou a descrição do anúncio responsivo
Description 2	Obrigatório para vídeo in-feed	string	Sim	O texto da descrição 2 do anúncio Discovery
Página de destino de vídeo in-feed	Sim para vídeo in-feed	string	Sim	A página de destino do anúncio Discovery
URL da página de destino para dispositivos móveis	Não	string	Sim	O URL da página de destino do anúncio para dispositivos móveis
Nome da empresa	Obrigatório para anúncios da Geração de demanda se não estiver definido no nível do anunciante	string	Sim	O nome da empresa que está sendo anunciada. Se não for definida e um valor padrão for definido no nível do anunciante, o valor padrão será aplicado. A partir de 12 de outubro de 2026, essa coluna será obrigatória para todos os anúncios responsivos do YouTube se não for definida no nível do anunciante.
Sufixo do URL da página de destino	Não	string	Sim	O sufixo do URL da página de destino
IDs de código do recurso de logotipo	Obrigatório para anúncios da Geração de demanda se não estiver definido no nível do anunciante	string, lista	Sim	A lista de IDs de recursos para os logotipos. Essa lista é gerada em ordem numérica crescente. Se não for definida e um valor padrão for definido no nível do anunciante, o valor padrão será aplicado. A partir de 12 de outubro de 2026, essa coluna será obrigatória para todos os anúncios responsivos do YouTube se não for definida no nível do anunciante.
Códigos dos recursos de imagem de marketing	Obrigatório quando o "Tipo de anúncio" é "Imagem da Geração de demanda"	string, lista	Sim	A lista de IDs de recursos das imagens de marketing. Essa lista é gerada em ordem crescente.
Cards da Geração de demanda	Obrigatório quando o "Tipo de anúncio" é "Carrossel da Geração de demanda"	string, lista de listas	Sim	Isso define uma lista de cards no seguinte formato: (URL final, URL final para dispositivos móveis, URL, título, texto de call-to-action, ID do recurso de imagem de marketing, IDs de recursos de marketing adicionais etc.). Por exemplo: (google.com; mobile.google.com; Título; Clique aqui; 10020; 20020; 30020). Cada ativo de marketing precisa ter uma proporção exclusiva. Se um card em um anúncio tiver uma imagem de marketing quadrada, todos os cards desse anúncio também precisarão ter uma imagem de marketing quadrada. Isso também se aplica às outras proporções.
IDs de recursos de banner complementar	Não	string, lista	Sim	A lista de IDs de recursos para os banners complementares. Essa lista é gerada em ordem numérica crescente. Esse recurso está disponível para anúncios em vídeo de performance, Geração de Demanda, in-stream, bumper e não puláveis. Formato da lista = 100; 200;
IDs de código do recurso de imagem do anúncio de pausa	Não	string, lista	Sim	A lista de IDs de recursos para as imagens de anúncios pausados. Por exemplo: (100;200;300;) O suporte da SDF para itens de linha de transação instantânea e os grupos de anúncios e anúncios deles está na versão Beta e só está disponível para parceiros na lista de permissões. Os anúncios em itens de linha de transação instantânea não serão incluídos nos arquivos baixados e precisam ser enviados pelo fluxo de trabalho de criação de transação instantânea do YouTube na interface do Display & Video 360.
ID do criativo principal	Não	número inteiro	Não	Valor do ID numérico do criativo principal do Display & Video 360.