生命週期目標

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

如果您的 Google Ads 帳戶目前使用跨帳戶轉換追蹤， 必須在 Google Ads 轉換中設定客戶生命週期目標 客戶 ，不必直接在 Google Ads 帳戶中查看。建議您 廣告活動生命週期目標這類似 在使用情境中管理其他目標時 跨帳戶轉換追蹤

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

在 Google Ads API 第 15 版中， CustomerLifecycleGoalService 和 CampaignLifecycleGoalService。 與 Google Ads API 中的其他服務稍有不同有鑑於此 create 和 update 作業，第 15 版 CustomerLifecycleGoalOperation敬上 和 CampaignLifecycleGoalOperation 只有 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 版以前：
    • 將使用者名單加進網站的 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:

  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 第 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」 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 中的其他資源一樣，請使用 search 或 searchStream 擷取 GoogleAdsService 方法 生命週期目標。

以下查詢會擷取陣列中每個 CustomerLifecycleGoal 的詳細資料 Google Ads 帳戶：

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
上一頁
廣告活動目標