Campagnes vidéo

Les campagnes vidéo vous permettent de diffuser des annonces vidéo sur YouTube, ainsi que sur les sites Web et dans les applications des partenaires vidéo Google.

Limites de l'API

L'API Google Ads permet principalement d'extraire des données et de générer des rapports sur les campagnes vidéo, les groupes d'annonces, les annonces et les critères existants. Vous ne pouvez pas créer ni modifier de campagnes vidéo à l'aide de l'API Google Ads, à l'exception des comportements et exceptions spécifiques aux versions suivants :

  • Mutabilité de VideoResponsiveAdInfo : à partir de v24, les objets VideoResponsiveAdInfo sont mutables (ils sont immuables dans les versions antérieures). Lorsque vous créez ou modifiez des VideoResponsiveAdInfo, les champs videos, business_name et logo_images sont obligatoires.
  • Brand safety et brand suitability : à partir de v24, les campaign.video_brand_safety_suitability au niveau de la campagne seront supprimées. Interrogez la brand safety au niveau du compte à l'aide de customer.video_brand_safety_suitability.
  • Tests de campagnes vidéo : à partir du v24, experiment.video_experiment, vous pouvez configurer des tests YOUTUBE_CUSTOM composés de campagnes vidéo.

Alternatives pour la gestion des campagnes

Si vous devez créer ou gérer des campagnes vidéo de manière programmatique, envisagez les options suivantes :

  • Scripts Google Ads : vous pouvez gérer vos campagnes vidéo à l'aide des scripts Google Ads. Cela permet une gestion automatisée dans l'interface Google Ads.
  • Campagnes Demand Gen : si votre objectif est de diffuser des annonces vidéo sur les propriétés Google, y compris YouTube, les campagnes Demand Gen sont entièrement compatibles avec l'API Google Ads pour la création et la gestion.

Obtenir des données sur les performances

Vous pouvez récupérer les données sur les performances de vos campagnes vidéo, groupes d'annonces et critères à l'aide de GoogleAdsService.SearchStream en filtrant sur campaign.advertising_channel_type = 'VIDEO'.

Performances des groupes d'annonces

La requête suivante récupère les métriques des campagnes vidéo et des groupes d'annonces, y compris les vues de vidéo TrueView et les taux de lecture complète par quartile, à partir de la ressource 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'

Rapports sur les emplacements vidéo et les critères

Étant donné que ad_group_criterion ne prend pas en charge directement les métriques ni les segments, utilisez des ressources de vue de critères telles que managed_placement_view pour récupérer les métriques de performances pour les vidéos YouTube ciblées, les chaînes YouTube ou d'autres emplacements gérés :

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