与效果最大化广告系列报告类似,您可以使用 GoogleAdsService.SearchStream
检索广告系列和素材资源组元数据,以优化广告系列并排查常见问题。
广告系列优化
如需了解可通过效果最大化广告系列实现的不同业务目标,请参阅我们的效果最大化广告系列优化提示。这些提示同样适用于通过 Google Ads API 制作的效果最大化广告系列。
广告系列问题排查
如果您的效果最大化广告系列没有达到预期效果,可能是您的广告、出价、定位、转化跟踪或广告系列设置存在问题。如需了解问题排查步骤,请参阅以下指南:
常见的素材资源组错误
如果您创建 AssetGroup
的请求失败,并返回 AssetGroupError
和以 NOT_ENOUGH
开头的枚举值(例如 AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET
),则表示您的 AssetGroup
不符合最低素材资源要求,因此未创建。
例如,AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET
错误表示提交的创建 AssetGroup
请求未包含最小数量的 MARKETING_IMAGES
(在本例中为 1 个)。如需修正此错误,请使用包含 asset_group_operation
和所有缺失的 asset_group_asset_operations
的 GoogleAdsService.mutate
方法,将创建 AssetGroup
的请求重新提交为批量更改请求,如将素材资源组关联到素材资源中所示。
在此示例中,批量更改请求中的更改操作列表需要包含至少一个 AssetGroupAsset
,其 field_type
为 MARKETING_IMAGE
。AssetGroupAsset
引用的资源还必须符合 MARKETING_IMAGE
的规范。
同样,如果您创建 AssetGroup
的请求因 AssetGroupError.SHORT_DESCRIPTION_REQUIRED
而失败,则表示您的 AssetGroup
缺少长度不超过 60 个字符的 TEXT
素材资源和 DESCRIPTION
的 field_type
。解决此问题的步骤与 NOT_ENOUGH_MARKETING_IMAGE_ASSET
示例相同。不过,请求必须包含至少一个 AssetGroupAsset
,且 field_type
为 DESCRIPTION
,并且 AssetGroupAsset
引用的素材资源不得超过 60 个字符。
素材资源组问题排查
asset_group.primary_status
和 asset_group.primary_status_reasons
字段可用于深入了解素材资源组的效果。
SELECT
asset_group.resource_name,
asset_group.primary_status,
asset_group.primary_status_reasons
FROM asset_group
WHERE asset_group.resource_name = "customers/CUSTOMER_ID/assetGroups/ASSET_GROUP_ID"
同样,asset_group_asset.primary_status
、asset_group_asset.primary_status_details
和 asset_group_asset.primary_status_reasons
字段可用于显示素材资源组素材资源是否正在投放,或未投放的原因。
SELECT
asset_group_asset.resource_name,
asset_group_asset.primary_status,
asset_group_asset.primary_status_reasons,
asset_group_asset.primary_status_details
FROM asset_group_asset
WHERE asset_group_asset.resource_name = "customers/CUSTOMER/assetGroupAssets/ASSET_GROUP_ID~ASSET_ID~FIELD_TYPE"
启用了品牌规范的广告系列
使用品牌推广指南来控制贵品牌在效果最大化广告系列中的呈现方式。您可以使用 Campaign.brand_guidelines_enabled
验证是否已为广告系列启用品牌推广指南。
Campaign.brand_guidelines_enabled
设为 true
的效果最大化广告系列使用广告系列级品牌素材资源(BUSINESS_NAME
、LOGO
和 LANDSCAPE_LOGO
),并且必须具有
- 只有一个
BUSINESS_NAME
资源 - 至少一个
LOGO
素材资源
如果您未能正确关联这些 CampaignAsset
资源,则会收到 CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED
或 CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED
错误,具体取决于缺少的资产类型。以下任一操作都可能会触发启用了品牌推广指南的广告系列的这些错误:
- 创建新的
Campaign
,但未在同一请求中同时将BUSINESS_NAME
和LOGO
作为CampaignAsset
资源提供。 - 移除一项或多项
CampaignAsset
资源,导致广告系列不再符合最低品牌素材资源要求。 - 向之前未添加素材资源且以提高线上销售额为目标的效果最大化广告系列添加素材资源组级素材资源,但未在同一请求中提供所有必需的
CampaignAsset
资源。
如果尝试在错误的级别关联品牌资源,也会生成错误,您可以通过以下方式进行修正:
AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL
- 使用CampaignAsset
资源关联品牌资产,因为广告系列已启用品牌推广指南。AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL
- 使用AssetGroupAsset
资源关联品牌素材资源,因为广告系列未启用品牌推广指南。
素材资源来源
效果最大化广告系列的独特之处在于,其投放的广告包含广告客户上传的素材资源和 Google 自动生成的素材资源。作为广告客户,了解素材资源的来源有助于排查问题或评估效果,在这种情况下,您可以使用 asset_group_asset.source
字段,如下所示:
SELECT
asset.id,
asset.name,
asset_group.id,
asset_group_asset.source
FROM asset_group_asset
WHERE campaign.id = CAMPAIGN_ID
“新客户获取”目标带来的转化价值
如果您在效果最大化广告系列或搜索广告系列中设置了新客户获取,系统报告的转化价值可能会高于您手动上传的转化价值。如果您选择了“新客户价值”模式(提高出价),系统会将所有新客户的生命周期价值添加到转化操作的转化价值中。所有新客户生命周期价值仅通过 Google Ads 网页版界面提供。
如果您需要计算转化价值,但不考虑所有新客户的生命周期价值,请参阅以下伪代码。您可以从 Google Ads 网页界面下载全新客户生命周期价值。
nonNewCustomerAcquisitionConversionValueTotal = 0;
// For each campaign that has that conversion...
for (campaign in campaigns) {
// If the new customer acquisition value is 'Bid higher', then subtract.
if (bidHigher == true) {
nonNewCustomerAcquisitionConversionValueTotal +=
campaign.allConversionsValue - campaign.allNewCustomerLifetimeValue;
}
// If the new customer acquisition value is 'Only bid' or not set, then don't subtract.
else {
nonNewCustomerAcquisitionConversionValueTotal += campaign.allConversionsValue;
}
}