Affiliate (Tiếp thị liên kết)

I. Tổng quan

Lưu ý: Các thuộc tính, quy tắc phân quyền và tính năng chung của đối tượng này được kế thừa từ tài liệu Objects (Đối tượng CRM).

1. Vấn đề & Ý nghĩa

Đối với các doanh nghiệp có mô hình kinh doanh nhiều cộng tác viên, nhiều tầng, Đối tác, Đại lý, hoặc Khách hàng cũ giới thiệu Khách hàng mới: Việc theo dõi thủ công nguồn gốc khách hàng và đóng góp của người giới thiệu rất khó khăn, dễ sai sót.
Tính năng Affiliate (Tiếp thị liên kết) giúp doanh nghiệp tự động thống kê được khách hàng của mình được giới thiệu bởi ai, từ đó có số liệu vào cuối Tháng/Quý/Năm để đánh giá xem ai là người giới thiệu hiệu quả nhất, mang về giá trị giới thiệu là bao nhiêu.
Giúp doanh nghiệp dễ dàng đưa ra các chính sách tri ân, thưởng hoa hồng hợp lý cho người giới thiệu.
Đây cũng là một chiến lược Marketing hiệu quả, vì nguồn khách hàng từ Affiliate có tỷ lệ chốt sale cao hơn do độ tin cậy và uy tín từ người giới thiệu.

2. Giải pháp

Khách hàng mới được ghi nhận giới thiệu bởi một khách hàng cũ hoặc một User (Nhân viên) đã có trên hệ thống CRM.

II. Yêu cầu chức năng

1. Danh sách tính năng

Hệ thống ghi nhận người giới thiệu qua các hình thức cơ bản sau:

Quản lý thông tin Affiliate trên mỗi Khách hàng:
- Mỗi khách hàng có một trường Người giới thiệu được liên kết với một khách hàng khác hiện có trong hệ thống.
- Mỗi khách hàng được cấp một Mã tiếp thị liên kết duy nhất để lấy mã này gửi cho người khác nhằm thực hiện giới thiệu khách hàng mới.
Thêm mới khách hàng: Cho phép tích chọn người giới thiệu là Khách hàng hoặc Nhân viên (User) đã có trên hệ thống CRM.
Import từ file excel: Hỗ trợ thêm đồng loạt nhiều khách hàng được giới thiệu bởi khách hàng/nhân viên khác từ file Excel.
Ghi nhận tự động qua Automation Workflow: Hỗ trợ tích hợp với hệ thống Automation để tự động nhận mã giới thiệu từ link affiliate (qua Catch Hook) và tự động gán Người giới thiệu khi tạo Contact.
Dashboard thống kê Affiliate: Cung cấp hệ thống báo cáo và biểu đồ thống kê mặc định về hiệu quả tiếp thị liên kết của doanh nghiệp.

2. Đặc tả chi tiết

Trường Người giới thiệu (Referrer):
- Loại dữ liệu: Liên kết đối tượng (Lookup/Relationship) trỏ đến một Khách hàng (Contact) khác trong hệ thống.
- Ràng buộc: Khi tạo mới hoặc chỉnh sửa thông tin khách hàng, người dùng có thể tìm kiếm và chọn 1 khách hàng làm người giới thiệu.
- Nghiệp vụ Import từ Excel: Khi thực hiện import khách hàng hàng loạt từ file Excel, người dùng có thể điền Mã tiếp thị liên kết của người giới thiệu vào cột thông tin người giới thiệu. Hệ thống sẽ tự động truy vấn và ánh xạ (mapping) mã này để tìm ra khách hàng tương ứng sở hữu mã đó, sau đó tự động thiết lập liên kết làm Người giới thiệu.
Trường Mã tiếp thị liên kết (Affiliate Code):
- Loại dữ liệu: Chuỗi ký tự (String), duy nhất (Unique).
- Hoạt động: Hệ thống tự động tạo mã này cho mỗi khách hàng mới hoặc cho phép tùy chỉnh thủ công. Mã này được dùng để ghép vào đường dẫn giới thiệu (Referral Link) nhằm ghi nhận tự động khách hàng mới đăng ký.
Cơ chế xử lý tự động qua Automation Workflow:
- Cấu trúc đường dẫn giới thiệu: Khách hàng chia sẻ đường dẫn chứa tham số truy vấn (query parameter) ref (Ví dụ: ucall.vn?ref=REF5522, trong đó REF5522 là mã tiếp thị liên kết của khách hàng đó).
- Luồng xử lý Automation:
  1. Node Catch Hook: Tiếp nhận thông tin khi khách hàng mới gửi biểu mẫu đăng ký (Form). Dữ liệu đẩy về Node Catch Hook phải bao gồm thông tin cá nhân và tham số ref (Ví dụ: ref = REF5522).
  2. Node Tạo Contact (Create Contact): Node Catch Hook được nối trực tiếp với Node Tạo Contact. Node Tạo Contact tiếp nhận dữ liệu, thực hiện tạo mới khách hàng trên CRM và tự động phân tích tham số ref để gán khách hàng sở hữu mã tiếp thị liên kết đó vào ô Người giới thiệu của khách hàng mới tạo.
Dashboard thống kê Affiliate mặc định:
- Lưu ý: Hệ thống thiết lập sẵn một dashboard thống kê mặc định và các biểu đồ (charts) phân tích affiliate bằng cách sử dụng module Dashboard của hệ thống.
- Các biểu đồ thống kê mặc định cần thiết bao gồm:
  - Top người giới thiệu hiệu quả (Top Referrers): Thống kê và xếp hạng những đối tượng giới thiệu mang lại lượng khách hàng mới hoặc doanh số cao nhất. (Số lượng khách hàng được giới thiệu bởi mỗi ngừoi giới thiệu)
  - Số lượng khách hàng từ Affiliate theo thời gian: Biểu đồ đường (Line Chart) hoặc biểu đồ cột (Bar Chart) thể hiện xu hướng tăng trưởng khách hàng mới đến từ tiếp thị liên kết theo Ngày/Tuần/Tháng/Quý.
  - Doanh thu mang lại từ Affiliate: Thống kê tổng giá trị đơn hàng chốt thành công từ nguồn khách hàng giới thiệu.
  - Tỷ lệ chuyển đổi của nguồn Affiliate: Báo cáo so sánh tỷ lệ chốt cơ hội/đơn hàng của khách hàng từ affiliate so với các nguồn marketing khác để đánh giá chất lượng nguồn.

3. Danh sách nghiệp vụ

Nghiệp vụ tính hoa hồng: Tạm hoãn (Pending) do hệ thống hiện tại chưa xây dựng cơ chế tính và phân phối hoa hồng cho tiếp thị liên kết.
Ghi nhận lịch sử giới thiệu (Contact Activity History):
- Khi khách hàng mới được tạo và gán Người giới thiệu thành công, hệ thống cần tự động ghi nhận hoạt động vào lịch sử tương tác (Activity Log) của cả hai khách hàng liên quan:
  - Tại khách hàng giới thiệu: Ghi nhận sự kiện “Cập nhật người giới thiệu: Rỗng –> Nguyễn Văn A”.
  - Tại khách hàng được giới thiệu: Ghi nhận sự kiện “Được liên kết với khách hàng “Nguyễn Văn B”.

4. Giao diện

Figma: https://www.figma.com/design/tBBrdtHlG1LAYJUfJsvyS3/UCALL-2026–Ant-Design-5.10.1-?node-id=43519-75398&t=KFdoAaW4qhrxqFeA-4
Giao diện Chi tiết khách hàng (Thông tin liên hệ ở cột bên trái):
- Hiển thị ô Người giới thiệu: Hiển thị tên người giới thiệu dưới dạng link liên kết (ví dụ: Khách hàng A)
- Hiển thị ô Mã tiếp thị liên kết: Hiển thị mã tiếp thị liên kết hiện tại của khách hàng (ví dụ: UC0221), hỗ trợ người dùng sao chép nhanh để gửi cho người khác.

III. Yêu cầu phi chức năng

Bảo mật và chính xác: Đảm bảo mã tiếp thị liên kết không bị giả mạo hoặc ghi đè sai lệch nguồn giới thiệu.
Hiệu năng: Xử lý ghi nhận nguồn giới thiệu nhanh chóng khi khách hàng đăng ký qua Landing page mà không gây nghẽn hệ thống.