生命周期目标
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
使用 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
用于定义高价值新客户的增量转化价值。如果设置了高生命周期价值,则该值应大于价值。
细分受众群体
您必须使用 UserListCustomerType
资源来细分受众群体,以实现客户生命周期目标。您必须通过为用户名单和类别的每种组合创建 UserListCustomerType
,将每个用户名单与一个或多个类别相关联。
使用 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 |
在广告系列一级,通过创建或更新 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.owner_customer,
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
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-09-05。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-09-05。"],[[["\u003cp\u003eLeverage the Google Ads API's \u003ccode\u003eCustomerLifecycleGoal\u003c/code\u003e and \u003ccode\u003eCampaignLifecycleGoal\u003c/code\u003e resources to manage goals throughout the customer lifecycle, including efficient customer acquisition through Search and Performance Max campaigns.\u003c/p\u003e\n"],["\u003cp\u003eWhen using cross-account conversion tracking, configure customer lifecycle goals in the Google Ads conversion account while setting campaign lifecycle goals directly in your Google Ads account.\u003c/p\u003e\n"],["\u003cp\u003eStarting with Google Ads API v17, utilize the \u003ccode\u003eUserListCustomerType\u003c/code\u003e resource for audience segmentation, replacing the deprecated method of adding user lists directly to \u003ccode\u003eCustomerLifecycleGoal\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eConfigure campaign-level lifecycle goals with \u003ccode\u003eCampaignLifecycleGoal\u003c/code\u003e to control optimization modes and override customer-level value settings, targeting new and existing customers strategically.\u003c/p\u003e\n"],["\u003cp\u003eRetrieve lifecycle goal details using \u003ccode\u003eGoogleAdsService\u003c/code\u003e search methods, querying for \u003ccode\u003eCustomerLifecycleGoal\u003c/code\u003e and \u003ccode\u003eCampaignLifecycleGoal\u003c/code\u003e attributes.\u003c/p\u003e\n"]]],[],null,["# Lifecycle Goals\n\nUse the [`CustomerLifecycleGoal`](/google-ads/api/reference/rpc/v21/CustomerLifecycleGoal) and\n[`CampaignLifecycleGoal`](/google-ads/api/reference/rpc/v21/CampaignLifecycleGoal) resources of the\nGoogle Ads API to configure goals related to the customer lifecycle. The\nGoogle Ads API supports [customer acquisition\ngoals](//support.google.com/google-ads/answer/12080169) for efficiently\nacquiring new customers through your Google Ads Search and Performance Max\ncampaigns.\n\nIf your Google Ads account is using cross-account conversion tracking, then you\nmust configure customer lifecycle goals in the\n[Google Ads conversion account](/google-ads/api/docs/conversions/getting-started)\ninstead of directly in your Google Ads account. You should still set\ncampaign lifecycle goals in your account, however. This is similar to how you\nmanage [other goals](/google-ads/api/docs/conversions/goals/overview) when using\ncross-account conversion tracking.\n\nConfigure customer lifecycle goals\n----------------------------------\n\nAt the customer-level, configure a lifecycle goal by creating or updating a\n[`CustomerLifecycleGoal`](/google-ads/api/reference/rpc/v21/CustomerLifecycleGoal). There can be at\nmost one `CustomerLifecycleGoal` per Google Ads account. The\n`customer_acquisition_goal_value_settings.value` field defines the additional\nvalue adjustment to add to a new customer's first purchase conversion. The\n`customer_acquisition_goal_value_settings.high_lifetime_value` defines the\nincremental conversion value for new customers who are of high value. High\nlifetime value should be greater than value, if set.\n\nSegment your audiences\n----------------------\n\nYou must use the\n[`UserListCustomerType`](/google-ads/api/reference/rpc/v21/UserListCustomerType) resource to segment\nyour audiences for customer lifecycle goals. You must associate each user list\nwith one or more categories by creating a `UserListCustomerType` for each\ncombination of user list and category.\n\nUse the\n[`UserListCustomerTypeService`](/google-ads/api/reference/rpc/v21/UserListCustomerTypeService) to\ncreate [`UserListCustomerType`](/google-ads/api/reference/rpc/v21/UserListCustomerType) instances.\nIf you have previously populated the\n`CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists`\nfield, then your account will already contain related `UserListCustomerType`\ninstances.\n\nThe `UserListCustomerTypeService` only supports `create` and `remove`\noperations, so if you want to update an existing `UserListCustomerType` you must\nremove it and then create a new one with the necessary updates.\n\nA `UserListCustomerType` can only be assigned to one user list, but a\nuser list can have multiple associated `UserListCustomerType` instances\n**as long as there are no conflicts** between the `UserListCustomerType`\ninstances. Trying to assign `UserListCustomerType` instances with the\nfollowing combinations of\n[`customer_type_category`](/google-ads/api/reference/rpc/v21/UserListCustomerTypeCategoryEnum.UserListCustomerTypeCategory)\nto the same user list will result in a\n`UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES` error:\n\n| First `customer_type_category` | Second `customer_type_category` |\n|--------------------------------|---------------------------------|\n| PURCHASERS | CONVERTED_LEADS |\n| PURCHASERS | QUALIFIED_LEADS |\n| PURCHASERS | CART_ABANDONERS |\n| CONVERTED_LEADS | QUALIFIED_LEADS |\n| DISENGAGED_CUSTOMERS | CONVERTED_LEADS |\n| DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |\n| DISENGAGED_CUSTOMERS | CART_ABANDONERS |\n\nConfigure campaign lifecycle goals\n----------------------------------\n\nAt the campaign level, configure a lifecycle goal by creating or updating a\n[`CampaignLifecycleGoal`](/google-ads/api/reference/rpc/v21/CampaignLifecycleGoal). There can be at\nmost one `CampaignLifecycleGoal` per campaign.\n\nThe `customer_acquisition_goal_settings` field of a campaign-level goal lets you\nset the optimization mode of the campaign as well as override the value settings\nfrom the parent customer goal.\n\nThe `optimization_mode` can be one of the following values:\n\n`TARGET_ALL_EQUALLY`\n: The campaign targets new and existing customers equally. This is the default\n optimization mode.\n\n`BID_HIGHER_FOR_NEW_CUSTOMERS`\n: The campaign targets both new and existing customers, but bids higher for\n customers that are predicted be new and are not in one of the\n `existing_user_lists`.\n\n`TARGET_NEW_CUSTOMERS`\n: The campaign only targets new customers.\n\nThe `value_settings` are the same as the\n`customer_acquisition_goal_value_settings` on the customer-level goal. Use these\ncampaign-level settings to override the values for a specific campaign.\n\nRetrieve lifecycle goals\n------------------------\n\nAs with other resources in the Google Ads API, use the `search` or `searchStream`\nmethods of [`GoogleAdsService`](/google-ads/api/reference/rpc/v21/GoogleAdsService) to retrieve\nlifecycle goals.\n\nThe following query retrieves the details of every `CustomerLifecycleGoal` in a\nGoogle Ads account: \n\n SELECT\n customer_lifecycle_goal.owner_customer,\n customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,\n customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value\n FROM customer_lifecycle_goal\n\nSimilarly, the following query retrieves the details of every\n`CampaignLifecycleGoal`: \n\n SELECT\n campaign_lifecycle_goal.campaign,\n campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,\n campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,\n campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value\n FROM campaign_lifecycle_goal"]]