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.
|
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 do YouTube 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 em áudio do 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, entre outros, 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 produtos da Geração de demanda mostram produtos. 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 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 numérico do ID 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 numérico do ID 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 numérico do ID do criativo 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. |
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 = (name1; value1;); (name2; value2;); etc. |
Call-to-action | Obrigatório quando o item de linha principal é de ação em vídeo do YouTube, o campo "Título" não está vazio ou o campo "Tipo de anúncio" é "Vídeo de Geração de demanda", "Imagem de Geração de demanda" ou "Carrossel de 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 de vídeo in-feed | Sim para vídeo in-feed | string | Sim | A miniatura do vídeo a 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 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 | Necessá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 | O sufixo do URL da página de destino |
IDs de recursos de logotipo | Necessário para anúncios da Geração de demanda | string, list | Sim | A lista de IDs de recursos para os logotipos. Essa lista é gerada em ordem numérica crescente. |
IDs dos recursos de imagem de marketing | Obrigatório quando o "Tipo de anúncio" é "Imagem da Geração de demanda" | string, list | Sim | A lista de IDs de recursos para as 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 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 nesse anúncio 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, list | Sim | A lista de IDs de recursos para os banners complementares. Essa lista é gerada em ordem numérica crescente. Isso é compatível com anúncios de performance de vídeo, Geração de demanda em vídeo, in-stream, bumper e não puláveis. List format = 100; 200; |