视频广告系列

您可以使用视频广告系列在 YouTube 上以及 Google 视频合作伙伴运营的各个网站和应用中投放视频广告。

API 限制

Google Ads API 主要支持提取现有视频广告系列、广告组、广告和定位条件并生成相关报告。无法使用 Google Ads API 创建或更改视频广告系列，但以下版本有特定例外情况和行为：

  • VideoResponsiveAdInfo 可变性：从 v24 开始，VideoResponsiveAdInfo 对象是可变的（在早期版本中，它们是不可变的）。创建或变异 VideoResponsiveAdInfo 时，videos、business_name 和 logo_images 字段是必需的。
  • 品牌保障适宜性：自 v24 起，系统将移除广告系列级 campaign.video_brand_safety_suitability。使用 customer.video_brand_safety_suitability 查询账号级品牌保障适宜性。
  • 视频广告系列实验：从 v24 开始，experiment.video_experiment 可用于配置包含视频广告系列的 YOUTUBE_CUSTOM 实验。

广告系列管理替代方案

如果您需要以程序化方式制作或管理视频广告系列，可以考虑以下选项：

  • Google Ads 脚本：您可以使用 Google Ads 脚本管理视频广告系列。这样一来，您就可以在 Google Ads 界面中自动管理广告系列。
  • 需求开发广告系列：如果您的目标是在包括 YouTube 在内的 Google 媒体资源中投放视频广告，则 Google Ads API 完全支持需求开发广告系列的创建和管理。

获取效果数据

您可以使用 GoogleAdsService.SearchStream 通过过滤 campaign.advertising_channel_type = 'VIDEO' 来检索视频广告系列、广告组和条件的效果数据。

广告组效果

以下查询从 ad_group 资源中检索视频广告系列和广告组指标，包括 TrueView 视频观看次数和四分位完成率：

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'

视频展示位置和条件报告

由于 ad_group_criterion 不直接支持指标或细分，因此请使用条件视图资源（例如 managed_placement_view）来检索定位的 YouTube 视频、YouTube 频道或其他受管理的展示位置的效果指标：

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