Sử dụng các tài nguyên CustomerLifecycleGoal
và
CampaignLifecycleGoal
của
API Google Ads để định cấu hình các mục tiêu liên quan đến vòng đời của khách hàng. Kể từ phiên bản 15, API Google Ads sẽ hỗ trợ các mục tiêu thu nạp khách hàng để thu nạp khách hàng mới một cách hiệu quả thông qua các chiến dịch Tối đa hoá hiệu suất và chiến dịch Tìm kiếm trên Google Ads.
Nếu tài khoản Google Ads của bạn đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì bạn phải thiết lập các mục tiêu trong vòng đời của khách hàng trong tài khoản khách hàng lượt chuyển đổi trên Google Ads thay vì thiết lập ngay trong tài khoản Google Ads. Tuy nhiên, bạn vẫn nên đặt các mục tiêu trong vòng đời của chiến dịch trong tài khoản của mình. Điều này tương tự như cách bạn quản lý các mục tiêu khác khi sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản.
Xử lý các thao tác tạo và cập nhật (chỉ dành cho phiên bản 15)
Trong API Google Ads phiên bản 15, các thao tác được hỗ trợ trong
CustomerLifecycleGoalService
và
CampaignLifecycleGoalService
có sự khác biệt đôi chút so với các dịch vụ khác trong API Google Ads. Thay vì có các toán tử create
và update
riêng biệt, CustomerLifecycleGoalOperation
và CampaignLifecycleGoalOperation
phiên bản 15 chỉ có một toán tử create
và bạn cho biết ý định của mình bằng cách sử dụng update_mask
như sau:
Để tạo mục tiêu trong vòng đời bằng phiên bản 15, hãy điền mục tiêu vào
create
nhưng không đặtresource_name
và không đặtupdate_mask
của toán tử.Để cập nhật mục tiêu trong vòng đời bằng phiên bản 15, hãy điền mục tiêu vào
create
, đặtresource_name
của mục tiêu và đặtupdate_mask
để liệt kê các trường bạn muốn cập nhật.
Thiết lập các mục tiêu trong vòng đời của khách hàng
Ở cấp khách hàng, hãy định cấu hình mục tiêu vòng đời bằng cách tạo hoặc cập nhật CustomerLifecycleGoal
. Bạn có thể có tối đa một CustomerLifecycleGoal
cho mỗi tài khoản Google Ads. Trường customer_acquisition_goal_value_settings.value
xác định mức điều chỉnh bổ sung cho giá trị cần thêm vào lượt chuyển đổi giao dịch mua đầu tiên của khách hàng mới. Bạn có thể đọc customer_acquisition_goal_value_settings.high_lifetime_value
của mục tiêu, nhưng trường này không thể thay đổi được trong API Google Ads.
Phân khúc đối tượng của bạn
Kể từ API Google Ads phiên bản 17, bạn phải sử dụng tài nguyên
UserListCustomerType
để phân đoạn
đối tượng cho các mục tiêu trong vòng đời của khách hàng. Ngừng định cấu hình đối tượng ngay trên
tài nguyên CustomerLifecycleGoal
. Dưới đây là các chi tiết:
- Trước phiên bản 17:
- Thêm danh sách người dùng vào bộ sưu tập
existing_user_lists
củaCustomerLifecycleGoal
.
- Thêm danh sách người dùng vào bộ sưu tập
- Bắt đầu từ phiên bản 17:
- Liên kết mỗi danh sách người dùng với một hoặc nhiều danh mục bằng cách tạo
UserListCustomerType
cho mỗi tổ hợp danh mục và danh sách người dùng.
- Liên kết mỗi danh sách người dùng với một hoặc nhiều danh mục bằng cách tạo
Trong API Google Ads phiên bản 17 trở lên
Sử dụng UserListCustomerTypeService
để tạo các thực thể UserListCustomerType
.
Nếu bạn đã điền sẵn trường
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
, thì tài khoản của bạn sẽ chứa các thực thể UserListCustomerType
có liên quan.
UserListCustomerTypeService
chỉ hỗ trợ các thao tác create
và remove
. Vì vậy, nếu muốn cập nhật UserListCustomerType
hiện có, bạn cần xoá nó rồi tạo một thao tác mới với nội dung cập nhật cần thiết.
Một UserListCustomerType
chỉ có thể được gán cho một danh sách người dùng, nhưng một danh sách người dùng có thể có nhiều thực thể UserListCustomerType
liên kết miễn là không có xung đột giữa các thực thể UserListCustomerType
. Việc cố gắng chỉ định các thực thể UserListCustomerType
có tổ hợp customer_type_category
sau đây cho cùng một danh sách người dùng sẽ dẫn đến lỗi UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
:
customer_type_category đầu tiên |
Thứ hai customer_type_category |
---|---|
NGƯỜI MUA | CONVERTED_LEADS |
NGƯỜI MUA | QUALIFIED_LEADS |
NGƯỜI MUA | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
Trong API Google Ads phiên bản 16 trở xuống
Đặt các trường sau trên CustomerLifecycleGoal
của tài khoản:
lifecycle_goal_customer_definition_settings.existing_user_lists
cho biết những danh sách người dùng nào chứa khách hàng hiện tại.Trường
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
cho biết danh sách người dùng nào chứa khách hàng có giá trị vòng đời cao. Bạn có thể đọc trường này, nhưng trường này không thể thay đổi được trong API Google Ads.
Hành vi của tài nguyên dùng chung
Cho đến khi API Google Ads phiên bản 16 ngừng hoạt động vào tháng 1 năm 2025, bạn cần nhớ rằng
UserListCustomerType
và các trường phân khúc đối tượng trên
CustomerLifecycleGoal
là một tài nguyên dùng chung, có nghĩa là việc tạo các phiên bản
UserListCustomerType
mới trong phiên bản 17 trở lên sẽ dẫn đến việc sửa đổi
thực thể CustomerLifecycleGoal
của bạn trong phiên bản 16 trở về trước, và ngược lại.
Dưới đây là cách liên kết các trường trên hai tài nguyên:
Thay đổi trường "CustomerLifecycleTarget" trong phiên bản 16 | Tác dụng phụ đối với "UserListCustomerType" trong phiên bản 17 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
Tạo hoặc xoá các thực thể UserListCustomerType . Trường user_list chứa tên tài nguyên danh sách người dùng được liên kết.
|
Thay đổi "UserListCustomerType" trong phiên bản 17 | Tác dụng phụ đối với trường "CustomerLifecycleTarget" trong phiên bản 16 |
---|---|
Tạo hoặc xoá các thực thể UserListCustomerType .
|
Tên tài nguyên riêng lẻ sẽ được thêm vào hoặc bị xoá khỏi lifecycle_goal_customer_definition_settings.existing_user_lists
|
Tạo hoặc xoá các thực thể UserListCustomerType , trong đó customer_type_category được đặt thành HIGH_VALUE_CUSTOMERS
|
Tên tài nguyên riêng lẻ sẽ được thêm vào hoặc bị xoá khỏi lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
|
Định cấu hình mục tiêu trong vòng đời của chiến dịch
Ở cấp chiến dịch, hãy định cấu hình mục tiêu trong vòng đời bằng cách tạo hoặc cập nhật CampaignLifecycleGoal
. Có thể có tối đa một CampaignLifecycleGoal
cho mỗi chiến dịch.
Trường customer_acquisition_goal_settings
của mục tiêu ở cấp chiến dịch cho phép bạn
đặt chế độ tối ưu hoá của chiến dịch, cũng như ghi đè các chế độ cài đặt giá trị
từ mục tiêu khách hàng chính.
optimization_mode
có thể là một trong những giá trị sau:
TARGET_ALL_EQUALLY
- Chiến dịch này nhắm đến khách hàng mới và khách hàng hiện tại như nhau. Đây là chế độ tối ưu hoá mặc định.
BID_HIGHER_FOR_NEW_CUSTOMERS
- Chiến dịch này nhắm đến cả khách hàng mới và khách hàng hiện tại, nhưng đặt giá thầu cao hơn cho những khách hàng được dự đoán là mới và không thuộc một trong các
existing_user_lists
. TARGET_NEW_CUSTOMERS
- Chiến dịch chỉ nhắm đến khách hàng mới.
value_settings
giống với customer_acquisition_goal_value_settings
trên mục tiêu cấp khách hàng. Hãy sử dụng các chế độ cài đặt cấp chiến dịch này để ghi đè các giá trị cho một chiến dịch cụ thể.
Truy xuất mục tiêu trong vòng đời
Tương tự như với các tài nguyên khác trong API Google Ads, hãy sử dụng phương thức search
hoặc searchStream
của GoogleAdsService
để truy xuất các mục tiêu trong vòng đời.
Truy vấn sau đây truy xuất thông tin chi tiết của từng CustomerLifecycleGoal
trong
tài khoản 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
Tương tự, truy vấn sau đây truy xuất thông tin chi tiết của mỗi 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