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 suivants spécifiques à la version :

• Mutabilité de VideoResponsiveAdInfo : à partir de la version 24, 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 safety et brand suitability : à partir de la version 24, campaign.video_brand_safety_suitability au niveau de la campagne est supprimé. 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 24, 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 vos 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, de vos groupes d'annonces et de vos 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 la version 25, 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éo 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

Pour les campagnes vidéo, vous pouvez interroger les métriques de couverture Unique Reach sur les ressources campaign et customer (à partir de la version 26) 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 d'utilisateurs 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, sur 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). Cette métrique n'est disponible que sur la ressource campaign, ne peut pas être agrégée 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 d'utilisateurs uniques 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 associés metrics.unique_users*_info sont des métriques MESSAGE avec filterable: false et sortable: false. Vous ne pouvez donc pas les utiliser dans les clauses WHERE ou ORDER BY. Sélectionnez ces champs 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 dédupliquée sur 30 jours et leurs états de suppression pour les campagnes vidéo, segmentées par appareil et par format d'annonce. Omettez le segment segments.date de la clause SELECT afin que les métriques de couverture et de fréquence N+ soient dédupliquées sur l'ensemble de la période plutôt que par jour :

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Ressources, périodes et segments compatibles

Les requêtes de couverture et de fréquence nécessitent un filtre segments.date fini dans la période maximale de la métrique. Les requêtes sans filtre de date ou dépassant la période renvoient des champs de couverture non définis :

Métrique	Ressources	Plage de dates maximale	Segments compatibles
metrics.unique_users	campaign, customer (v26 et versions ultérieures)	92 jours	segments.date, segments.device, segments de format d'annonce (v26 et versions ultérieures), segments de réseau publicitaire (v26 et versions ultérieures) et segments démographiques ajustés
metrics.average_impression_frequency_per_user	campaign	92 jours	segments.date, segments.device et segments démographiques ajustés
metrics.unique_users_two_plus à metrics.unique_users_ten_plus	campaign, customer (v26 et versions ultérieures)	31 jours	segments.date, segments.device, segments de format d'annonce (v26 et versions ultérieures) et segments de réseau publicitaire (v26 et versions ultérieures)
metrics.unique_users*_info (v26 et versions ultérieures)	campaign, customer	Correspond à la métrique de base	segments.date, segments.device, segments de format d'annonce et segments de réseau publicitaire

Lorsque vous segmentez des requêtes de couverture, appliquez les contraintes de segment conjointes suivantes :

• Segments de format d'annonce et de réseau publicitaire : vous pouvez segmenter par format d'annonce (segments.ad_format_type, éventuellement avec segments.ad_sub_format_type) ou par réseau publicitaire (segments.ad_network_type, éventuellement avec segments.ad_sub_network_type), mais vous ne pouvez pas combiner les segments de format d'annonce et de réseau publicitaire dans la même requête. Sélectionnez toujours le segment parent (segments.ad_format_type ou segments.ad_network_type) lorsque vous sélectionnez son sous-segment. Le segment segments.ad_sub_format_type ventile les annonces InStream non désactivables par durée et renvoie UNSEGMENTED pour les autres formats d'annonces, tandis que le segment segments.ad_sub_network_type ventile les surfaces YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED et YOUTUBE_SHORTS) uniquement pour les campagnes Demand Gen et renvoie UNSEGMENTED pour les campagnes vidéo.
• Segments démographiques ajustés : les segments segments.adjusted_age_range et segments.adjusted_gender ne sont disponibles que pour les comptes figurant sur la liste d'autorisation. Ils doivent être sélectionnés ensemble et ne peuvent pas être combinés avec les métriques metrics.unique_users_*_plus, les champs metrics.unique_users*_info ou les segments de réseau publicitaire.

Remarque : Les métriques de couverture et de fréquence ne peuvent pas être agrégées sur plusieurs lignes. Sur la ressource customer, les champs campaign ne peuvent pas être filtrés, et les métriques de couverture par utilisateur unique dédupliquent la couverture pour tous les types de campagnes compatibles dans le compte. Pour en savoir plus, consultez Suppression des métriques de couverture et valeurs nulles.