生命周期目标

使用 CustomerLifecycleGoal 和 的 CampaignLifecycleGoal 资源 使用 Google Ads API 配置与客户生命周期相关的目标。从 v15 开始， 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 之前： <ph type="x-smartling-placeholder">
  </ph>
  • 将用户名单添加到existing_user_lists CustomerLifecycleGoal。
• 从 v17 开始： <ph type="x-smartling-placeholder">
  </ph>
  • 为每个用户名单与类别的组合创建 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 之间不冲突， 实例。正在尝试为 UserListCustomerType 个实例分配 以下为 customer_type_category 都会导致 UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES 错误：

在 Google Ads API v16 中

在账号的 CustomerLifecycleGoal 中设置以下字段：

1. lifecycle_goal_customer_definition_settings.existing_user_lists 表示 哪些用户列表包含现有客户。

2. 通过 lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists 字段指明哪些用户名单包含高生命周期价值客户。您可以读取此字段，但它在 Google Ads API 中不可更改。

共享资源行为

在 2025 年 1 月 Google Ads API v16 停用之前，请务必注意 UserListCustomerType和 CustomerLifecycleGoal是共享资源，这意味着创建新的 在 v17 及更高版本中，UserListCustomerType 实例将导致修改 CustomerLifecycleGoal 实例（在 v16 及更低版本中）

下面是这两个资源的字段映射方式：

配置广告系列生命周期目标

在广告系列一级，通过创建或更新 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 中的其他资源一样，请使用 search 或 searchStream GoogleAdsService 的方法来检索 生命周期目标

以下查询会检索每个 CustomerLifecycleGoal 中 Google Ads 账号：

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