使用 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
上設定下列欄位:
lifecycle_goal_customer_definition_settings.existing_user_lists
會指出哪些使用者名單包含現有客戶。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