生命周期目标

使用 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 中设置以下字段：

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

  2. 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
上一页
广告系列目标