Google Ads API 支持由 Google Ads 直接管理的自动化素材资源,该 API 的范围仅限于暂停或移除单个素材资源以及检索统计信息。您可以通过 Google Ads 网页界面选择启用或停用自动生成的素材资源。
创建和更新
账号选择启用此功能后,Google Ads 会按如下方式创建自动生成的素材资源:
- 已创建资产。
- 系统会创建
CampaignAsset
、AdGroupAsset
或CustomerAsset
对象,以将素材资源分别与广告系列、广告组或客户资源相关联。
您无法使用 Google Ads API 制作或更新自动生成的素材资源,也无法使用 Google Ads API 为自动生成的素材资源制作CampaignAsset
、AdGroupAsset
或 CustomerAsset
。
您可以暂停或移除将自动生成的素材资源与相应资源相关联的 CampaignAsset
、AdGroupAsset
或 CustomerAsset
实体。
暂停或移除关联
暂停关联后,相应素材资源会暂时无法针对关联的实体投放。暂停关联后,除非通过网页界面或 API 重新启用,否则 Google Ads 不会自动重新启用或针对相应资源投放相应素材资源。如需永久停用素材资源与资源之间的关联,请移除该关联。
Google Ads 会限制可与给定实体(例如每个广告系列的自动生成的站内链接)相关联的给定类型的自动生成的素材资源数量。暂停的关联计入此限额,而移除的关联则不计入。自动生成的素材资源不计入手动添加的素材资源的限额。
检索自动生成的素材资源
您可以通过过滤 AssetSource = AUTOMATICALLY_CREATED
来检索自动生成的素材资源数据。
对于可与广告相关联的素材资源,请检查其 source
。如需查看可与广告相关联的素材资源类型列表,请参阅 AssetType
。
以下是广告中素材资源的查询示例:
SELECT
ad_group.name,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.ad_group_ad
FROM ad_group_ad_asset_view
WHERE asset.source = 'AUTOMATICALLY_CREATED'
对于其他类型的素材资源,请直接查询 Asset
资源:
SELECT
asset.id,
asset.name
FROM asset
WHERE asset.source = 'AUTOMATICALLY_CREATED'
报告
您可以从 asset_field_type_view
报告中请求获取资产效果统计信息。此报告包含自动生成的素材资源和手动添加的素材资源的汇总统计信息。
您可以从 campaign_asset
、customer_asset
和 ad_group_asset
报告中检索各个素材资源的效果统计信息。