您可以向 GoogleAdsService 发送 Google Ads 查询语言 (GAQL) 查询,以获取素材资源及其属性的列表。资源由 asset
实体表示,该实体公开了多个特定于资源的字段。
素材资源属性
以下 GAQL 查询列出了广告客户帐号中的所有素材资源及其资源名称和类型。
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
请注意,您可以将特定于类型的属性添加到上述查询中,以读取特定于资产的属性,例如 ImageAsset
或 YoutubeVideoAsset
。
例如,以下查询通过过滤 YoutubeVideoAsset
的 asset.type
值(请参阅文档,查看可能的类型值列表),列出帐号中所有 YoutubeVideoAsset
对象的 YouTube 视频 ID。
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
提供了视图专用属性 performance_label
,可让您深入了解这一特定素材资源与广告搭配的效果特征。下表枚举了 performance_label
字段的可能值。
performance_label | 说明 |
---|---|
BEST | 效果最佳的素材资源。 |
GOOD | 效果出色的素材资源。 |
LOW | 效果最差的素材资源。 |
LEARNING | 素材资源已开始获得展示,但统计数据没有太大意义,无法获得素材资源效果标签。 |
PENDING | 此资产尚无任何性能信息。导致这种情况的原因可能是:该商品仍在审核中。 |
UNKNOWN | 表示此版本中的未知值。 |
UNSPECIFIED | 未指定。 |
以下 GAQL 查询会返回帐号中所有素材资源在上个月的展示次数、点击次数、费用和转化次数,并按 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