Mục tiêu trong vòng đời

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 đặt resource_name và không đặt update_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, đặt resource_name của mục tiêu và đặt update_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ủa CustomerLifecycleGoal.
  • 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.

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:

  1. 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.

  2. 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