生命周期目标

使用 CustomerLifecycleGoal 和 的 CampaignLifecycleGoal 资源 使用 Google Ads API 配置与客户生命周期相关的目标。从 v15 开始， Google Ads API 助力客户获取 目标 通过 Google Ads 搜索广告系列和效果最大化广告系列获取新客户 广告系列。

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

处理创建和更新操作（仅适用于 v15）

在 Google Ads API v15 中， CustomerLifecycleGoalService和 CampaignLifecycleGoalService 与 Google Ads API 中的其他服务略有不同。你不必为每个容器分别 create 和 update 操作，v15 CustomerLifecycleGoalOperation 和 CampaignLifecycleGoalOperation 只有 create 操作，并且您需要使用 update_mask 如下所示：

  • 如需使用 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 之前： <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 个实例分配 以下为 customer_type_category 都会导致 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 中不可更改。

共享资源行为

在 2025 年 1 月 Google Ads API v16 停用之前，请务必注意 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 中的其他资源一样，请使用 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
上一页
广告系列目标