使用 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
:
lifecycle_goal_customer_definition_settings.existing_user_lists
表示 哪些用户列表包含现有客户。通过
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