Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

视频广告系列

您可以使用视频广告系列在 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

覆盖面和频次报告

对于视频广告系列，您可以查询 campaign 和 customer（从 v26 开始）资源中的 Unique Reach 覆盖面指标，以衡量在特定展示频次下看到您广告的唯一身份用户数。

以下唯一身份用户指标用于衡量不同频次范围内的受众群体覆盖面：

metrics.unique_users：在所选日期范围（最多 92 天）内至少看过一次广告的唯一身份用户数。无法跨行汇总。
metrics.unique_users_two_plus 到 metrics.unique_users_ten_plus：在最长 31 天的日期范围内，至少看过您广告 2 到 10 次的唯一身份用户数量（metrics.unique_users_six_plus 到 metrics.unique_users_nine_plus 在 v26 及更高版本中补全了 2+ 到 10+ 的集合）。
metrics.average_impression_frequency_per_user：在所请求的时间段（最长 92 天）内，唯一身份用户看到您广告的平均次数。此指标仅适用于 campaign 资源，无法跨行汇总，并且没有配套的 _info 字段。

在 v26 及更高版本中，每个唯一身份用户覆盖面指标都有一个类型为 ReachMetricInfo 的配套元数据字段：metrics.unique_users_info 和 metrics.unique_users_two_plus_info 到 metrics.unique_users_ten_plus_info。

在 Google Ads 查询语言 (GAQL) 中，随播广告 metrics.unique_users*_info 字段是具有 filterable: false 和 sortable: false 的 MESSAGE 指标，因此您无法在 WHERE 或 ORDER BY 子句中使用它们。直接在 SELECT 子句中选择这些字段（例如 metrics.unique_users_info）。请勿在 SELECT 子句中附加 .reach_metric_states，因为在 GAQL 中选择嵌套消息字段会失败，并显示 UNRECOGNIZED_FIELD。相反，选择 metrics.unique_users_info 会返回一个 ReachMetricInfo 消息，其中包含类型为 ReachMetricState 的重复枚举字段 reach_metric_states，该字段描述了指标是被抑制还是完整。

每当覆盖面指标被抑制或超出保留期限（PRIVACY_SUPPRESSION、QUALITY_SUPPRESSION 或 DATE_RANGE_BEYOND_RETENTION）时，其在 Metrics 上的 optional int64 字段将取消设置（如果未检查字段是否存在，则计算结果为 0），而 LOW_QUALITY 仍会填充数值指标。

ReachMetricState 枚举值表示覆盖面数据的状态：

COMPLETE：覆盖面指标完整，未因隐私、质量或其他限制而受到抑制。
PRIVACY_SUPPRESSION：为保护用户隐私，覆盖面数据受到了限制（例如，当受众群体数量未达到 k-匿名性阈值时）。
QUALITY_SUPPRESSION：由于数据质量要求，覆盖面数据已被屏蔽。
LOW_QUALITY：覆盖面指标已计算，但被标记为质量较低。
DATE_RANGE_BEYOND_RETENTION：由于所选日期范围超出了覆盖面数据的 3 年数据保留期限，因此无法查看覆盖面指标。

以下查询会检索视频广告系列的 30 天去重覆盖面指标及其抑制状态，并按设备和广告格式细分。从 SELECT 子句中省略 segments.date 段，以便在整个日期范围内（而不是每天）对覆盖面和N+频次指标进行去重：

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

支持的资源、日期范围和细分

覆盖面和频次查询需要在指标的最大日期时间范围内设置有限的 segments.date 过滤条件。如果查询未设置日期过滤条件或超出时间范围，则会返回未设置的覆盖面字段：

指标	资源	最大日期范围	兼容的细分受众群
`metrics.unique_users`	`campaign`、`customer`（v26 及更高版本）	92 天	`segments.date`、`segments.device`、广告格式细分（v26 及更高版本）、广告联盟细分（v26 及更高版本）和调整后的受众特征细分群
`metrics.average_impression_frequency_per_user`	`campaign`	92 天	`segments.date`、`segments.device`和调整后的受众特征细分群
`metrics.unique_users_two_plus` 至 `metrics.unique_users_ten_plus`	`campaign`、`customer`（v26 及更高版本）	31 天	`segments.date`、`segments.device`、广告格式细分（v26 及更高版本）和广告联盟细分（v26 及更高版本）
`metrics.unique_users*_info`（v26 及更高版本）	`campaign`、`customer`	与基本指标匹配	`segments.date`、`segments.device`、广告格式细分和广告联盟细分

细分覆盖面查询时，请应用以下联合细分约束条件：

广告格式与广告联盟细分：您可以按广告格式（segments.ad_format_type，可选择搭配 segments.ad_sub_format_type）或广告联盟（segments.ad_network_type，可选择搭配 segments.ad_sub_network_type）进行细分，但不能在同一查询中组合使用广告格式和广告联盟细分。选择子细分受众群时，请务必选择父级细分受众群（segments.ad_format_type 或 segments.ad_network_type）。segments.ad_sub_format_type 细分维度会按时长细分不可跳过的插播广告，并针对其他广告格式返回 UNSEGMENTED，而 segments.ad_sub_network_type 细分维度仅针对需求开发广告系列细分 YouTube 平台（YOUTUBE_INSTREAM、YOUTUBE_INFEED 和 YOUTUBE_SHORTS），并针对视频广告系列返回 UNSEGMENTED。
调整后的受众特征细分群：segments.adjusted_age_range 和 segments.adjusted_gender 细分群仅适用于列入许可清单的账号，必须同时选择，并且不能与 metrics.unique_users_*_plus 指标、metrics.unique_users*_info 字段或广告联盟细分群结合使用。