您可以向 GoogleAdsService 发送 Google Ads 查询
语言 (GAQL) 查询,以获取素材资源及其属性的列表。素材资源
由 asset 实体表示,该实体会公开许多
特定于素材资源的字段。
素材资源属性
以下 GAQL 查询会列出广告客户账号中的所有素材资源,以及它们的资源名称和类型。
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
您可以向此查询添加特定于类型的属性,以读取特定于
素材资源的属性,例如 ImageAsset 或
YoutubeVideoAsset。
例如,以下查询会通过
过滤 asset.type 值,列出账号中所有
YoutubeVideoAsset 对象的 YouTube 视频 ID。如需查看 YoutubeVideoAsset 的
可能类型值列表,请点击此处。
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
素材资源来源
Asset.source 仅适用于
mutable
素材资源。
如需了解自适应搜索广告素材资源的使用来源,请使用
AdGroupAdAsset.source。