生命週期目標
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
使用 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 中的其他資源一樣，請使用 search 或 searchStream 方法的 GoogleAdsService 擷取生命週期目標。
下列查詢會擷取 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
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：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"]],["上次更新時間：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"]]
