本頁面由 Cloud Translation API 翻譯而成。

生命週期目標

使用 CustomerLifecycleGoal 和 CampaignLifecycleGoal 資源 Google Ads API，設定與客戶生命週期相關的目標。自第 15 版起 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 但 Google Ads API 中的這個欄位無法變更。

區隔目標對象

自 Google Ads API v17 起，您必須使用要區隔的 UserListCustomerType 項資源有助於達成客戶生命週期目標的目標對象直接設定目標對象 CustomerLifecycleGoal 資源已淘汰以下為詳細資料：

第 17 版以前：
- 將使用者名單加進網站的 existing_user_lists 集合 CustomerLifecycleGoal。
從 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 和 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 中無法變更。

共用資源行為

在 Google Ads API 第 16 版於 2025 年 1 月停用之前，請務必記住，UserListCustomerType 和 CustomerLifecycleGoal 上的目標對象區隔欄位是共用資源，也就是說，在第 17 版以上版本中建立新的 UserListCustomerType 例項，會導致第 16 版以下版本中的 CustomerLifecycleGoal 例項發生變更，反之亦然。

以下說明兩個資源的欄位對應方式：

修改 v16 中的「CustomerLifecycleGoal」欄位	在 v17 中對 `UserListCustomerType` 的副作用
`lifecycle_goal_customer_definition_settings.existing_user_lists`	建立或移除 `UserListCustomerType` 例項。 `user_list` 欄位包含相關聯的使用者名單資源名稱。

在 v17 中變更 `UserListCustomerType`	在第 16 版中對 `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

廣告活動目標