Campanhas de vídeo

Com as campanhas de vídeo, você pode mostrar anúncios em vídeo no YouTube e em vários sites e apps parceiros de vídeo do Google.

Limitações da API

A API Google Ads oferece suporte principalmente à busca e à geração de relatórios sobre campanhas, grupos de anúncios, anúncios e critérios de vídeo atuais. Não é possível criar ou mudar campanhas de vídeo usando a API Google Ads, com as seguintes exceções e comportamentos específicos da versão:

• Mutabilidade de VideoResponsiveAdInfo: a partir do v24, os objetos VideoResponsiveAdInfo são mutáveis. Em versões anteriores, eles eram imutáveis. Ao criar ou fazer mutações em VideoResponsiveAdInfo, os campos videos, business_name e logo_images são obrigatórios.
• Adequação de brand safety: a partir de v24, a campaign.video_brand_safety_suitability no nível da campanha será removida. Consulte a adequação de brand safety no nível da conta usando customer.video_brand_safety_suitability.
• Experimentos de campanha de vídeo: a partir de v24, o experiment.video_experiment estará disponível para configurar experimentos de YOUTUBE_CUSTOM que consistem em campanhas de vídeo.

Alternativas para o gerenciamento de campanhas

Se você precisar criar ou gerenciar campanhas de vídeo de forma programática, considere as seguintes opções:

• Scripts do Google Ads: você pode gerenciar campanhas de vídeo usando os scripts do Google Ads. Isso permite o gerenciamento automatizado na interface do Google Ads.
• Campanhas Geração de demanda: se sua meta é veicular anúncios em vídeo em todas as propriedades do Google, incluindo o YouTube, as campanhas Geração de demanda são totalmente compatíveis com a API Google Ads para criação e gerenciamento.

Receber dados de performance

Você pode recuperar dados de performance das suas campanhas de vídeo, grupos de anúncios e critérios usando GoogleAdsService.SearchStream ao filtrar por campaign.advertising_channel_type = 'VIDEO'.

Observação: use metrics.video_trueview_views, metrics.video_trueview_view_rate e metrics.trueview_average_cpv (renomeados dos campos legados metrics.video_views, metrics.video_view_rate e metrics.average_cpv em v22). A partir de v25, também é possível selecionar segments.ad_sub_format_type (junto com segments.ad_format_type) para detalhar os anúncios in-stream não puláveis por duração, além das métricas de engajamento social em vídeo (metrics.youtube_comments, metrics.youtube_likes e metrics.youtube_shares).

Desempenho do grupo de anúncios

A consulta a seguir recupera métricas de campanhas de vídeo e grupos de anúncios, incluindo visualizações de vídeo TrueView e taxas de conclusão de quartil, do recurso ad_group:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

Relatórios de posição e critérios de vídeo

Como o ad_group_criterion não oferece suporte direto a métricas ou segmentos, use recursos de visualização de critérios, como managed_placement_view, para recuperar métricas de performance de vídeos e canais do YouTube segmentados ou outros canais gerenciados:

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS