Sử dụng 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. API Google Ads hỗ trợ 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 chiến dịch Tìm kiếm và chiến dịch Tối đa hoá hiệu suất 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 mục tiêu trong vòng đời của khách hàng trong tài khoản chuyển đổi trên Google Ads thay vì thiết lập trực tiếp trong tài khoản Google Ads. Tuy nhiên, bạn vẫn nên đặt mục tiêu trong vòng đời của chiến dịch trong tài khoản. Cách 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.
Thiết lập mục tiêu trong vòng đời của khách hàng
Ở cấp khách hàng, hãy thiết lập mục tiêu trong vòng đời bằng cách tạo hoặc cập nhật CustomerLifecycleGoal
. Mỗi tài khoản Google Ads có thể có tối đa một CustomerLifecycleGoal
. Trường customer_acquisition_goal_value_settings.value
xác định mức điều chỉnh giá trị bổ sung để 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 trong API Google Ads.
Phân khúc đối tượng
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. Việc định cấu hình đối tượng trực tiếp trên tài nguyên CustomerLifecycleGoal
không còn được dùng nữa. 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
- Kể 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 sách người dùng và danh mục.
- 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 vào 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 một UserListCustomerType
hiện có, bạn sẽ cần xoá UserListCustomerType
đó rồi tạo một UserListCustomerType
mới với các nội dung cập nhật cần thiết.
Bạn chỉ có thể chỉ định một UserListCustomerType
cho một danh sách người dùng, nhưng danh sách người dùng có thể có nhiều thực thể UserListCustomerType
được 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
bằng các tổ hợp sau của customer_type_category
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 |
customer_type_category thứ hai |
---|---|
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
Đặ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 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 những danh sách người dùng 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 trong API Google Ads.
Hành vi của tài nguyên dùng chung
Cho đến khi Google Ads API phiên bản 16 ngừng hoạt động vào tháng 2 năm 2025, điều quan trọng là bạn phải nhớ rằng UserListCustomerType
và các trường phân đoạn đối tượng trên CustomerLifecycleGoal
là tài nguyên dùng chung, nghĩa là việc tạo thực thể 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
trong phiên bản 16 trở xuống 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 "CustomerLifecycleGoal" trong phiên bản 16 | Tác dụng phụ trên `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ụ trên trường `CustomerLifecycleGoal` 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 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 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
. Mỗi chiến dịch có thể có tối đa một CampaignLifecycleGoal
.
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 đè chế độ cài đặt giá trị từ mục tiêu khách hàng gốc.
optimization_mode
có thể là một trong các giá trị sau:
TARGET_ALL_EQUALLY
- Chiến dịch 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 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
Cũng như 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 về mọi 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 sẽ 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