Consulte a visão geral para conferir uma explicação sobre o formato.
Campo | Obrigatório | Tipo | Gravável | Descrição |
---|---|---|---|---|
ID do anúncio | Obrigatório apenas ao editar anúncios existentes | 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.
|
Tipo de anúncio | Obrigatório para anúncios do YouTube e de Geração de demanda | string | Sim | O formato do anúncio. Os anúncios 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é seis segundos vendidos com base no CPM. Os anúncios em vídeo não puláveis são anúncios in-stream do 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 de áudio do YouTube. Os anúncios em vídeo responsivos são tipos de anúncios do YouTube veiculados em vários formatos. Os anúncios de alcance eficiente vão ser 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 ao YouTube. Os anúncios gráficos da Geração de demanda mostram imagens. Os cards dos anúncios de carrossel da Geração de demanda. Os anúncios de produtos da Geração de demanda mostram itens. Selecione um dos seguintes valores:
|
ID do vídeo | Obrigatório para anúncios em vídeo do YouTube e da Geração de demanda | string | Sim | O ID do vídeo do YouTube |
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 de 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 o 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 o anúncio de rastreamento do DCM | número inteiro | Sim | Valor do ID numérico do anúncio do DCM 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". |
Rastreamento do DCM: ID do criativo | Obrigatório apenas ao atualizar o anúncio de rastreamento do DCM | número inteiro | Sim | 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 do rastreador de cliques do anúncio |
Parâmetros de URL do Rastreador de cliques | Não | string, lista de listas | Sim | Os parâmetros personalizados do URL do Rastreador de cliques. Formato = (nome1; valor1;); (nome2; valor2;); etc. |
Call-to-action | Obrigatório quando o item de linha pai é um item de linha de ação em vídeo do YouTube, o "Título" não está vazio ou o "Tipo de anúncio" é "Vídeo da Geração de demanda", "Imagem da Geração de demanda" ou "Carousel da Geração de demanda" | string | Sim | Rótulo do botão de call-to-action (uma linha com até 10 caracteres). |
Título | Obrigatório para anúncios da Geração de demanda | string | Sim | Título da sobreposição de call-to-action (1 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 o vídeo in-feed | string | Sim | A miniatura do vídeo que será usada nos anúncios video discovery
|
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 Discovery ou responsivo ou o título longo de 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ídeos 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 o 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 | string | Sim | O nome da empresa que está sendo anunciada |
Sufixo do URL da página de destino | Não | string | Sim | Sufixo do URL da página de destino |
IDs de recursos de logotipo | Obrigatório para anúncios da Geração de demanda | string, lista | Sim | Lista de IDs de recursos dos logotipos. Essa lista é gerada em ordem numérica crescente. |
Códigos dos recursos de imagem de marketing | Obrigatório quando "Tipo de anúncio" for "Imagem da Geração de demanda" | string, lista | Sim | 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" é "Carrosel 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 CTA; ID de recurso de imagem de marketing; IDs de recursos de marketing adicionais...) Por exemplo: (google.com; mobile.google.com; Manchete; Clique aqui; 10020; 20020; 30020).Cada recurso 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 do banner complementar | Não | string, lista | Sim | Lista de IDs de recursos dos banners complementares. Essa lista é gerada em ordem numérica crescente. Isso é compatível com anúncios de performance em vídeo, Geração de demanda em vídeo, In-stream, Bumper e não puláveis. Formato da lista = 100; 200; |