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 de récupérer des campagnes vidéo, des groupes d'annonces, des annonces et des critères existants, et de générer des rapports les concernant. Les campagnes vidéo ne peuvent pas être créées ni modifiées à l'aide de l'API Google Ads, avec les exceptions et comportements spécifiques à la version suivants :

• Mutabilité de VideoResponsiveAdInfo : à partir de v24, les objets VideoResponsiveAdInfo sont mutables (dans les versions antérieures, ils sont immuables). Lors de la création ou de la modification de VideoResponsiveAdInfo, les champs videos, business_name et logo_images sont obligatoires.
• Brand suitability : à partir de v24, la campaign.video_brand_safety_suitability au niveau de la campagne est supprimée. Interrogez la brand safety et la brand suitability au niveau du compte à l'aide de customer.video_brand_safety_suitability.
• Tests de campagnes vidéo : à partir de la version v24, experiment.video_experiment est disponible pour 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, tenez compte des options suivantes :

• Scripts Google Ads : vous pouvez gérer les campagnes vidéo à l'aide de 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 par campaign.advertising_channel_type = 'VIDEO'.

Remarque : Utilisez metrics.video_trueview_views, metrics.video_trueview_view_rate et metrics.trueview_average_cpv pour les métriques de vue TrueView. À partir de v25, vous pouvez également sélectionner segments.ad_sub_format_type (en plus de segments.ad_format_type) pour ventiler les annonces InStream non désactivables par durée, ainsi que les métriques d'engagement social des vidéos (metrics.youtube_comments, metrics.youtube_likes et metrics.youtube_shares).

Performances des groupes d'annonces

La requête suivante récupère les métriques de campagne vidéo et de groupe d'annonces, y compris les vues de vidéos TrueView et les taux de lecture complète par quart, à 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 et les critères vidéo

Étant donné que ad_group_criterion n'est pas directement compatible avec 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 des vidéos YouTube, des chaînes YouTube ou d'autres emplacements gérés ciblé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

Rapports sur la couverture et la fréquence des campagnes

Pour les campagnes vidéo, vous pouvez interroger les métriques de couverture Unique Reach sur la ressource campaign afin de mesurer le nombre de personnes uniques auprès desquelles vos annonces ont été diffusées à des fréquences d'impression spécifiques.

Les métriques d'utilisateurs uniques suivantes mesurent la couverture d'audience par tranche de fréquence :

• metrics.unique_users : nombre de personnes uniques ayant vu votre annonce au moins une fois au cours de la période sélectionnée (jusqu'à 92 jours). Il ne peut pas être agrégé sur plusieurs lignes.
• metrics.unique_users_two_plus à metrics.unique_users_ten_plus : nombre de personnes uniques ayant vu votre annonce au moins 2 à 10 fois, respectivement, pour des périodes allant jusqu'à 31 jours (metrics.unique_users_six_plus à metrics.unique_users_nine_plus complétant l'ensemble 2+ à 10+ dans la v26 et les versions ultérieures).
• metrics.average_impression_frequency_per_user : nombre moyen de fois qu'un utilisateur unique a vu votre annonce au cours de la période demandée (jusqu'à 92 jours). Il ne peut pas être agrégé sur plusieurs lignes et ne comporte pas de champ _info associé.

Dans la version 26 et les versions ultérieures, chaque métrique de couverture est associée à un champ de métadonnées de type ReachMetricInfo : metrics.unique_users_info et metrics.unique_users_two_plus_info à metrics.unique_users_ten_plus_info.

Dans le langage de requête Google Ads (GAQL), les champs de couverture associée sont des métriques MESSAGE sélectionnées directement dans la clause SELECT (par exemple, metrics.unique_users_info). N'ajoutez pas .reach_metric_states dans la clause SELECT, car la sélection de champs de message imbriqués dans GAQL échoue avec UNRECOGNIZED_FIELD. Au lieu de cela, la sélection de metrics.unique_users_info renvoie un message ReachMetricInfo contenant le champ d'énumération répété reach_metric_states de type ReachMetricState, qui indique si la métrique a été supprimée ou si elle est complète.

Chaque fois qu'une métrique de couverture est supprimée ou se trouve en dehors de la période de conservation (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION ou DATE_RANGE_BEYOND_RETENTION), son champ optional int64 sur Metrics n'est pas défini (ce qui correspond à 0 si la présence du champ n'est pas vérifiée), tandis que LOW_QUALITY renseigne toujours la métrique numérique.

Les valeurs d'énumération ReachMetricState indiquent l'état des données de couverture :

• COMPLETE : la métrique de couverture est complète, sans masquage dû à des limites de confidentialité, de qualité ou autres.
• PRIVACY_SUPPRESSION : les données de couverture ont été supprimées pour protéger la confidentialité des utilisateurs (par exemple, lorsque le volume de l'audience ne respecte pas les seuils de k-anonymat).
• QUALITY_SUPPRESSION : les données de couverture ont été supprimées en raison des exigences de qualité des données.
• LOW_QUALITY : la métrique de couverture a été calculée, mais elle est signalée comme étant de faible qualité.
• DATE_RANGE_BEYOND_RETENTION : les métriques de couverture ne sont pas disponibles, car la période sélectionnée dépasse la période de conservation des données de couverture fixée à trois ans.

La requête suivante récupère les métriques de couverture et leurs états de suppression pour une campagne vidéo :

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

Remarque : Les métriques de couverture et de fréquence ne peuvent pas être agrégées sur plusieurs lignes. Alors que metrics.unique_users et metrics.average_impression_frequency_per_user sont compatibles avec des plages de dates allant jusqu'à 92 jours et peuvent être segmentés par segments.date, segments.device, segments.adjusted_age_range et segments.adjusted_gender, les métriques de tranche de fréquence unique_users_*_plus (jusqu'à 31 jours) et tous les champs metrics.unique_users*_info associés ne sont compatibles qu'avec segments.date et segments.device. De plus, les champs metrics.unique_users*_info associés sont des métriques MESSAGE avec filterable: false et sortable: false. Ils ne peuvent donc pas être utilisés dans les clauses WHERE ou ORDER BY. Pour en savoir plus sur la gestion des métriques de couverture supprimées dans les rapports, consultez Suppression des métriques de couverture et valeurs nulles.