生命週期目標

請使用 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 中是不可變動的。

區隔目標對象

您必須使用 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 組合，並指派給相同的使用者清單，就會導致 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.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

廣告活動目標