报告

您可以向 Google Ads 查询语言 (GAQL) 查询发送查询,以获取素材资源及其属性的列表。 GoogleAdsService素材资源由 asset实体表示,该实体会公开许多特定于素材资源的 字段。

素材资源属性

以下 GAQL 查询会列出 Google Ads 账号中的所有素材资源及其资源名称和类型。

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.type
FROM asset

您可以向此查询添加特定于类型的属性,以读取属性 特定于素材资源,例如 ImageAsset 或 YoutubeVideoAsset。

例如,以下查询会通过过滤 asset.type 值,列出 Google Ads 账号中所有 YoutubeVideoAsset 对象的 YouTube 视频 ID。查看可能的 值asset.type列表。

SELECT
  asset.id,
  asset.name,
  asset.resource_name,
  asset.youtube_video_asset.youtube_video_id
FROM asset
WHERE asset.type = 'YOUTUBE_VIDEO'

素材资源指标

您可以通过以下几种资源获取素材资源指标:

借助这些资源,您可以查询每个相应级别的素材资源指标。 例如,当您查询 ad_group_asset 资源时,可以使用 ad_group.id 字段来细分结果,从而检索每个 唯一组合的 ad_group 和 asset 的指标:

SELECT
  ad_group.id,
  asset.id,
  metrics.clicks,
  metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC

广告级指标

要点:ad_group_ad_asset_view 仅返回与应用广告、需求开发广告和自适应搜索广告相关的素材资源的信息。

素材资源的广告级效果指标汇总在 ad_group_ad_asset_view中。此视图会收集每个单个广告的素材资源指标。因此,查询此视图会为每个广告组和广告返回一行。

ad_group_ad_asset_view 会公开 视图专用属性 performance_label,该属性可让您深入了解此特定素材资源-广告 配对的效果特征。下表列出了 performance_label 字段的可能值。

performance_label说明
BEST效果最佳的素材资源。
GOOD效果良好的素材资源。
LOW效果最差的素材资源。
LEARNING素材资源已开始获得 展示,但统计数据不具有统计显著性,无法获得 素材资源效果标签。
PENDING此素材资源尚无任何 效果信息。这可能是因为它仍在审核中。
UNKNOWN表示此版本中的未知值。
UNSPECIFIED未指定。

以下 GAQL 查询会返回 Google Ads 账号中过去一个月内所有素材资源的展示次数、点击次数、费用和转化次数,并按其 performance_label 排序:

SELECT
  ad_group_ad_asset_view.ad_group_ad,
  ad_group_ad_asset_view.asset,
  ad_group_ad_asset_view.field_type,
  ad_group_ad_asset_view.performance_label,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros,
  metrics.conversions
FROM ad_group_ad_asset_view
WHERE segments.date DURING LAST_MONTH
ORDER BY ad_group_ad_asset_view.performance_label

素材资源来源

Asset.source 仅适用于 可变 素材资源。

如需了解自适应搜索广告素材资源的来源,请使用 ad_group_ad_asset_view.source。