使用 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
:
lifecycle_goal_customer_definition_settings.existing_user_lists
表示 哪些使用者名單包含現有客戶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