生命週期目標

使用 Google Ads API 的 CustomerLifecycleGoal 和 CampaignLifecycleGoal 資源，設定與客戶生命週期相關的目標。自 v15 版起，Google Ads API 支援獲取新客目標，透過 Google Ads 搜尋和最高成效廣告活動有效獲取新客。

如果您的 Google Ads 帳戶使用跨帳戶轉換追蹤，您必須在 Google Ads 轉換客戶帳戶中設定客戶生命週期目標，而不是直接在 Google Ads 帳戶中設定。不過，建議您還是在帳戶中設定廣告活動生命週期目標。做法類似於使用跨帳戶轉換追蹤時管理其他目標的方式。

處理建立及更新作業 (僅適用於 v15)

在 Google Ads API 第 15 版中，CustomerLifecycleGoalService 和 CampaignLifecycleGoalService 中支援的作業與 Google Ads API 中的其他服務略有不同。第 15 版 CustomerLifecycleGoalOperation 和 CampaignLifecycleGoalOperation 沒有單獨的 create 和 update 作業，而是只有 create 作業，且您可以使用 update_mask 指出您的意圖，如下所示：

  • 如要使用 v15 建立生命週期目標，請將目標填入 create，但不要設定其 resource_name，且不要設定作業的 update_mask。

  • 如要使用 v15 更新生命週期目標，請在 create 中填入目標，設定目標的 resource_name，並設定 update_mask 列出要更新的欄位。

設定客戶生命週期目標

在客戶層級，藉由建立或更新 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 版之前：
    • 將使用者名單新增至 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 執行個體之間沒有衝突即可。如果嘗試將採用 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

在 Google Ads API v16 以下版本中

請在帳戶的 CustomerLifecycleGoal 上設定下列欄位：

  1. lifecycle_goal_customer_definition_settings.existing_user_lists 會指出哪些使用者名單包含現有客戶。

  2. lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists 欄位代表哪些使用者名單含有高生命週期價值客戶。您可以讀取這個欄位，但無法在 Google Ads API 中加以變更。

共用資源行為

在 Google Ads API v16 於 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」 v16 中「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
上一頁
廣告活動目標