使用 Google Ads API 的 CustomerLifecycleGoal
和 CampaignLifecycleGoal
資源,設定與客戶生命週期相關的目標。自 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
。如要使用第 15 版更新生命週期目標,請在
create
中填入目標、設定目標的resource_name
,然後設定update_mask
以列出要更新的欄位。
設定客戶生命週期目標
在客戶層級建立或更新 CustomerLifecycleGoal
來設定生命週期目標。每個 Google Ads 帳戶最多只能有一個CustomerLifecycleGoal
。
客戶生命週期目標包含兩個欄位:
lifecycle_goal_customer_definition_settings
設定
existing_user_lists
欄位,指出哪些使用者名單包含現有客戶。high_lifetime_value_user_lists
欄位會指出哪些使用者名單包含高生命週期價值客戶。您可以讀取這個欄位,但這項資訊在 Google Ads API 中無法變更。customer_acquisition_goal_value_settings
設定
value
欄位,定義要新增至新顧客首次購物轉換的其他價值調整項。您可以讀取目標的
high_lifetime_value
,但這個欄位在 Google Ads API 中無法變更。
設定廣告活動生命週期目標
在廣告活動層級建立或更新 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