Consulte a visão geral para ver uma explicação do 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 | 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 | Valor do ID numérico do grupo de anúncios principal. É possível especificar um identificador personalizado (por exemplo, "ext[custom ad group ID]") para um grupo de anúncios que você está criando 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. In-stream e Os vídeos In-feed são tipos de anúncio em vídeo do YouTube vendidos com base no CPV. Os anúncios bumper são anúncios em vídeo de seis segundos ou menos do YouTube vendidos com base no CPM. Anúncios em vídeo não puláveis são anúncios in-stream do YouTube com duração de 6 a 15 segundos e vendidos com base no CPM. Os áudios do YouTube são anúncios em áudio do YouTube. Os anúncios responsivos em vídeo são tipos de anúncio do YouTube veiculados em vários formatos. Os anúncios de alcance eficiente serão veiculados como bumper do YouTube se o vídeo for curto o suficiente. Caso contrário, serão veiculados como in-stream do YouTube. 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 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 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 veiculação do DCM do 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 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: código 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 do canal", 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 do 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 for um item de linha de ação em vídeo do YouTube, "Título" não está em branco ou o "Tipo de anúncio" é "Vídeo da Geração de demanda", "Imagem da Geração de demanda", "Carrossel da Geração de demanda" | string | Sim | Identificador 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 1 do URL de visualização | Não | string | Sim | Caminho 1 do URL de visualização |
| Caminho 2 do URL de visualização | Não | string | Sim | Caminho 2 do URL de visualização |
| 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 video discovery
|
| Título do vídeo In-feed | Obrigatório para anúncios em vídeo In-feed e de 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 da Geração de demanda. |
| Descrição 1 | Obrigatório para anúncios em vídeo In-feed e de 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 | 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 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 | 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 o "Tipo de anúncio" é "Imagem da Geração de demanda" | string, lista | 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 CTA; ID de recurso de imagem de marketing; IDs de recursos de marketing adicionais...) Por exemplo: (google.com; mobile.google.com; Headline; Click Here; 10020; 20020; 30020).Cada recurso de marketing precisa ter uma proporção exclusiva. Se um cartão em um anúncio tiver uma imagem de marketing quadrada, todos os cards desse anúncio precisarão ter uma imagem de marketing quadrada (isso também se aplica às outras proporções). |
| Códigos do recurso 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. Essa opção é compatível com anúncios de performance de vídeo, em vídeo da Geração de demanda, in-stream, bumper e não puláveis. List format = 100; 200 |