使用 Google Ads API 的 CustomerLifecycleGoal
和 CampaignLifecycleGoal
资源来配置与客户生命周期相关的目标。从 v15 开始,Google Ads API 开始支持客户获取目标,以便通过 Google Ads 搜索广告系列和效果最大化广告系列高效获取新客户。
如果您的 Google Ads 帐号使用的是跨帐号转化跟踪,那么您必须在 Google Ads 转化客户帐号中配置客户生命周期目标,而不是直接在 Google Ads 帐号中配置。不过,您仍然应该在帐号中设置广告系列生命周期目标。这与您使用跨帐号转化跟踪时管理其他目标的方式类似。
处理创建和更新操作(仅适用于 v15)
在 Google Ads API v15 中,CustomerLifecycleGoalService
和 CampaignLifecycleGoalService
中支持的操作与 Google Ads API 中的其他服务略有不同。v15 CustomerLifecycleGoalOperation
和 CampaignLifecycleGoalOperation
没有单独的 create
和 update
操作,而是只有 create
操作,您需要使用 update_mask
指示您的 intent,如下所示:
如需使用 v15 创建生命周期目标,请使用该目标填充
create
,但不要设置其resource_name
,也不设置操作的update_mask
。如需使用 v15 更新生命周期目标,请使用该目标填充
create
,设置目标的resource_name
,并设置update_mask
以列出要更新的字段。
配置客户生命周期目标
在客户级别,通过创建或更新 CustomerLifecycleGoal
来配置生命周期目标。每个 Google Ads 帐号最多只能有一个 CustomerLifecycleGoal
。customer_acquisition_goal_value_settings.value
字段定义了要向新客户的首次购买转化添加的额外价值调整项。您可以读取目标的 customer_acquisition_goal_value_settings.high_lifetime_value
,但此字段在 Google Ads API 中不可更改。
细分您的受众群体
从 Google Ads API v17 开始,您必须使用 UserListCustomerType
资源来细分受众群体,以实现客户生命周期目标。直接在 CustomerLifecycleGoal
资源上配置受众群体的功能已被弃用。以下是详细信息:
- v17 之前的版本:
- 将用户列表添加到
CustomerLifecycleGoal
的existing_user_lists
集合中。
- 将用户列表添加到
- 从 v17 开始:
- 通过为用户列表和类别的每个组合创建
UserListCustomerType
,将每个用户列表与一个或多个类别相关联。
- 通过为用户列表和类别的每个组合创建
在 Google Ads API v17 及更高版本中
使用 UserListCustomerTypeService
创建 UserListCustomerType
实例。如果您已填充 CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
字段,则您的帐号已包含相关的 UserListCustomerType
实例。
UserListCustomerTypeService
仅支持 create
和 remove
操作,因此,如果您要更新现有的 UserListCustomerType
操作,则需要将其移除,然后创建包含必要更新的新操作。
一个 UserListCustomerType
只能分配给一个用户列表,但一个用户列表可以有多个关联的 UserListCustomerType
实例,前提是 UserListCustomerType
实例之间不冲突。尝试将包含以下 customer_type_category
组合的 UserListCustomerType
实例分配给同一用户列表将导致 UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
错误:
前 customer_type_category |
第二个customer_type_category |
---|---|
购买者 | CONVERTED_LEADS |
购买者 | QUALIFIED_LEADS |
购买者 | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
在 Google Ads API v16 及更早版本中
在帐号的 CustomerLifecycleGoal
中设置以下字段:
lifecycle_goal_customer_definition_settings.existing_user_lists
表示哪些用户名单包含现有客户。lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
字段可表明哪些用户名单包含高生命周期价值客户。您可以读取此字段,但在 Google Ads API 中它是不可更改的。
共享资源行为
在 Google Ads API v16 于 2025 年 1 月停用之前,请务必注意 UserListCustomerType
和 CustomerLifecycleGoal
上的受众群细分字段属于共享资源,这意味着,在 v17 及更高版本中创建新的 UserListCustomerType
实例会导致 v16 及更低版本中的 CustomerLifecycleGoal
实例被修改,反之亦然。
以下是两个资源上的字段的映射方式:
在 v16 中转变“CustomerLifecycleGoal”字段 | v17 中对“UserListCustomerType”的副作用 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
创建或移除 UserListCustomerType 实例。user_list 字段包含关联的用户列表资源名称。
|
在 v17 中转变 `UserListCustomerType` | 对 v16 中的“CustomerLifecycleGoal”字段的负面影响 |
---|---|
创建或移除 UserListCustomerType 实例。
|
单个资源名称将添加到 lifecycle_goal_customer_definition_settings.existing_user_lists 中或从中移除 |
创建或移除 UserListCustomerType 实例,其中 customer_type_category 设置为 HIGH_VALUE_CUSTOMERS
|
单个资源名称将添加到 lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists 中或从中移除 |
配置广告系列生命周期目标
在广告系列一级,通过创建或更新 CampaignLifecycleGoal
来配置生命周期目标。每个广告系列最多可以有一个 CampaignLifecycleGoal
。
通过广告系列级目标的 customer_acquisition_goal_settings
字段,您可以设置广告系列的优化模式,并替换父级客户目标的价值设置。
optimization_mode
可以是以下值之一:
TARGET_ALL_EQUALLY
- 广告系列平等定位新客户和现有客户。这是默认的优化模式。
BID_HIGHER_FOR_NEW_CUSTOMERS
- 此广告系列同时定位新客户和现有客户,但针对预计是新客户且不属于
existing_user_lists
范围内的客户提高出价。 TARGET_NEW_CUSTOMERS
- 广告系列仅定位到新客户。
value_settings
与客户级目标中的 customer_acquisition_goal_value_settings
相同。使用这些广告系列级设置可以替换特定广告系列的值。
检索生命周期目标
与 Google Ads API 中的其他资源一样,请使用 GoogleAdsService
的 search
或 searchStream
方法来检索生命周期目标。
以下查询会检索 Google Ads 帐号中每个 CustomerLifecycleGoal
的详细信息:
SELECT
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal
同样,以下查询会检索每个 CampaignLifecycleGoal
的详细信息:
SELECT
campaign_lifecycle_goal.campaign,
campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal