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

生命週期目標

請使用 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，但這個欄位在 Google Ads API 中是不可變動的。

區隔目標對象

自 Google Ads API 第 17 版起，您必須使用 UserListCustomerType 資源，針對顧客生命週期目標區隔目標對象。直接在 CustomerLifecycleGoal 資源上設定目標對象已淘汰。以下為詳細資料：

在 v17 之前：
- 將使用者名單加入 CustomerLifecycleGoal 的 existing_user_lists 集合。
從 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 第 16 版中

請在帳戶的 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 上的目標對象區隔欄位是共用資源。也就是說，在 v17 以上版本建立新的 UserListCustomerType 例項，將導致 v16 以下版本的 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

廣告活動目標