此页面由 Cloud Translation API 翻译。

生命周期目标

使用 Google Ads API 的 CustomerLifecycleGoal 和 CampaignLifecycleGoal 资源配置与客户生命周期相关的目标。Google Ads API 支持客户获取目标，可帮助您通过 Google Ads 搜索广告系列和效果最大化广告系列高效获取新客户。

如果您的 Google Ads 账号使用的是跨账号转化跟踪，则您必须在 Google Ads 转化账号中配置客户生命周期目标，而不是直接在 Google Ads 账号中配置。不过，您仍应在账号中设置广告系列生命周期目标。这与使用跨账号转化跟踪功能时管理其他目标的方式类似。

配置客户生命周期目标

在客户级别，通过创建或更新 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 实例，只要这些 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 年 2 月弃用之前，请务必注意，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

广告系列目标