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 atuais | número inteiro | Não | É o valor do ID numérico do anúncio do grupo de anúncios. Se o campo ficar 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 pai. 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 6 segundos ou menos vendidos com base no CPM. Os anúncios em vídeo não puláveis são anúncios in-stream do YouTube 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 em vídeo responsivos são tipos de anúncios do YouTube que funcionam como 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 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 | 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 usando IA quando veiculado em regiões com regulamentações locais de rotulagem de IA:
Se o valor "ON" ou "OFF" for fornecido para um ID de vídeo do YouTube, esse atestado será aplicado a todos os usos atuais desse ID de vídeo do YouTube no anunciante. Saiba mais sobre isso em Rotulagem de IA em anúncios usando o SDF. Formato da lista = (ID do vídeo do YouTube; status do atestado de conteúdo sintético); (ID do vídeo do YouTube; status do atestado 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 da 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 | É o 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 | É o 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 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 criativo | Obrigatório apenas ao atualizar o 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 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 no 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 "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 "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 | Obrigató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 para anúncios video discovery
|
| Título do vídeo in-feed | Obrigatório para anúncios in-feed e da Geração de demanda | string | Sim | O texto do título de um anúncio Discovery ou anúncio responsivo ou o título longo de anúncios da Geração de demanda. |
| Descrição 1 | Obrigatório para anúncios 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 |
| Descrição 2 | Obrigatório para vídeo in-feed | string | Sim | O texto da descrição 2 do anúncio Discovery |
| Página de destino do 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 definido e um valor padrão for definido no nível do anunciante, o valor padrão será aplicado. Válido apenas para anúncios responsivos e da Geração de demanda. |
| Sufixo do URL da página de destino | Não | string | Sim | O sufixo do URL da página de destino |
| IDs 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 dos logotipos. Essa lista é gerada em ordem numérica crescente. Se não for definido e um valor padrão for definido no nível do anunciante, o valor padrão será aplicado. Válido apenas para anúncios responsivos e da Geração de demanda. |
| IDs do recurso 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 da CTA; ID do 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 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 do recurso de banner complementar | Não | string, lista | Sim | A lista de IDs de recursos dos banners complementares. Essa lista é gerada em ordem numérica crescente. Isso é compatível com anúncios de performance de vídeo, vídeo da Geração de demanda, in-stream, bumper e não puláveis. Formato da lista = 100; 200; |
| ID do criativo principal | Não | número inteiro | Não | É o valor do ID numérico do criativo principal do Display &Video 360. |