> For the complete documentation index, see [llms.txt](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coreretail.gitbook.io/huong-dan-van-hanh-mini-app/tiep-thi-lien-ket.md).

# Tiếp thị liên kết

Quản lý chương trình affiliate giúp cộng tác viên hoặc đối tác chia sẻ link giới thiệu. Theo dõi hoa hồng và số lượng khách hàng từ kênh tiếp thị liên kết để mở rộng tệp khách hàng hiệu quả.

## Danh sách cộng tác viên

<div data-full-width="false"><figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FntcgpZcXwTuxCwwwIZzF%2F13.png?alt=media&amp;token=332701d1-0c42-4e55-8e56-42e7dcc7bd37" alt=""><figcaption><p>Vị trí hiện thị tiếp thị liên kết trên Mini App - Danh sách tiếp thị liên kết trên CMS</p></figcaption></figure></div>

Tại màn hình chính của module **Tiếp Thị Liên Kết**, admin sẽ thấy bảng danh sách cộng tác viên kèm theo:

| Cột                 | Mô tả                                                   |
| ------------------- | ------------------------------------------------------- |
| Cộng Tác Viên       | Tên hoặc số điện thoại người giới thiệu                 |
| Tổng hoa hồng       | Tổng tiền hoa hồng phát sinh                            |
| Chưa thanh toán     | Số tiền chưa thanh toán                                 |
| Đã thanh toán       | Số tiền đã thanh toán                                   |
| Số người giới thiệu | Số lượng người dùng được giới thiệu từ cộng tác viên đó |
| Thao tác            | Các nút xem/xử lý thêm                                  |

🔍 **Bộ lọc tìm kiếm:**

* Tìm theo tên hoặc số điện thoại
* Lọc theo **trạng thái thanh toán** (Tất cả / Đã thanh toán / Chưa thanh toán)
* Lọc theo khoảng **thời gian phát sinh giao dịch**

## Tính hoa hồng

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FGHLBiodOgIIQM4cOmlwS%2F14.png?alt=media&amp;token=b3412e7a-3566-40af-9613-fe5f95bf42f0" alt=""><figcaption><p>Tính hoa hồng theo khoảng thời gian</p></figcaption></figure>

**✅ Tính theo khoảng thời gian**

Bấm nút **“Tính hoa hồng theo khoảng thời gian”**, hệ thống sẽ mở popup nhập:

* **Ngày bắt đầu**
* **Ngày kết thúc**

Sau khi bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FgqShF3HB81I5Gwy5jtPV%2FScreenshot%202025-07-09%20at%2018.23.43.png?alt=media\&token=149143ff-22df-4c86-8c86-0a7e91bc7b03) hoặc ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FmzOBXA97fwxkWwzzgx55%2FScreenshot%202025-07-09%20at%2018.24.34.png?alt=media\&token=f03e59ae-141f-4b64-9b31-8202f3ad2d2c), hệ thống sẽ tính toán lại hoa hồng cho tất cả cộng tác viên trong khoảng thời gian đó.

📌 Khi xử lý thành công, hệ thống sẽ hiển thị thông báo:

> ✅ *"Tính hoa hồng thành công!"*

## Xuất Excel báo cáo

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FI3Cjzz7bsEjIDsMU6Jxa%2F15.png?alt=media&amp;token=fc872907-ddf1-4a64-abbf-657f7a1c76ad" alt=""><figcaption><p>Xuất báo cáo cộng tác viên</p></figcaption></figure>

Bấm nút **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F3OcDgqo55p8iKClO1HTg%2FScreenshot%202025-07-09%20at%2018.25.00.png?alt=media\&token=98cacf84-af2e-4e37-8fd2-82bf44266660)**”**, popup sẽ xuất hiện cho phép chọn:

* Ngày bắt đầu – Ngày kết thúc

Sau đó bấm **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FdfRYtORH6ZLIi8SecmlG%2FScreenshot%202025-07-09%20at%2018.25.23.png?alt=media\&token=daae2211-43a4-49c8-8f73-cce5c6e92aba)**”** để tải về file báo cáo cộng tác viên dưới dạng Excel.

## Cài đặt tỷ lệ hoa hồng

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F82BOnHnSTUPuv71GPS38%2F16.png?alt=media&amp;token=46584a5a-eea5-4c89-b319-db30f62e046f" alt=""><figcaption><p>Cài đặt tỷ lệ hoa hồng</p></figcaption></figure>

Bấm **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F6CseVnDXkaGYq8DlFZhx%2FScreenshot%202025-07-09%20at%2018.25.45.png?alt=media\&token=f82afdaa-1245-4558-a960-846d7c754fd6)**”** để mở danh sách các mức hoa hồng theo cấp.

Trong bảng hiển thị:

| Cột           | Mô tả                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cấp           | Cấp giới thiệu (1 = trực tiếp, 2 = gián tiếp...)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Tỷ lệ (%)     | Phần trăm hoa hồng                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Trạng thái    | Hoạt động / Không hoạt động                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Ngày hiệu lực | Thời điểm cấu hình này có hiệu lực                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Thao tác      | Sửa ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FZ7X1RD892rB56eLBgU9A%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=436d2976-d4d6-4c8c-b1ab-5912d65cf1a7) hoặc xóa ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FJvTr9Q8LacTlJhjqpKrJ%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=5ab491a2-29fd-438f-874f-c758e86f830f) cấu hình |

### Thêm cấp hoa hồng:

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FXzg2t5hdsTwGufMTAeZm%2F17.png?alt=media&amp;token=bb8b9ac5-bcd8-4273-b2f4-4dda6c2d2ec4" alt=""><figcaption><p>Thêm cấp hoa hồng</p></figcaption></figure>

* Bấm nút **“**![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F0XicbswiknogPvkvFqPT%2FScreenshot%202025-07-09%20at%2018.26.08.png?alt=media\&token=16ad28ed-de02-44fe-b384-e6af83498f03)**”**
* Nhập:
  * **Cấp hoa hồng**
  * **Tỷ lệ (%)** *(ví dụ: 5 = 5%)*
  * **Trạng thái**
  * **Ngày hiệu lực**

Bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2Ft9dLiZWArHJA3wEABU5u%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=a80999ba-795b-4872-903f-c737a9f0bc32) để áp dụng.

**📝 Chỉnh sửa tỷ lệ:**

* Bấm nút ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2Fr1JGsSw5zsWHUSf4yUpz%2FScreenshot%202025-06-30%20at%2011.50.01.png?alt=media\&token=1df24bd6-d70a-43ba-b91f-ac6296c58f0e) ở dòng tương ứng → sửa thông tin → bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FqXkgZT5qZWuqx0nX9V1n%2FScreenshot%202025-07-08%20at%2011.15.25.png?alt=media\&token=32b42940-5fa7-40a0-84d8-7faf2beb04e1).

### Xóa tỷ lệ

<figure><img src="https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FOtNnes8G3qT7weMhBCgv%2F19.png?alt=media&amp;token=f4c8c0e0-ebb1-4438-963d-9cec7c8d1b32" alt=""><figcaption></figcaption></figure>

* Bấm nút ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2FqqiZrrMM4pdHRm23ubN3%2FScreenshot%202025-06-30%20at%2011.50.14.png?alt=media\&token=03cadd54-0ae2-4433-8385-fe2d08a9f490) → Hệ thống hiện popup xác nhận:

> “Bạn có chắc chắn muốn xóa tỷ lệ hoa hồng này?”\
> → Bấm ![](https://228571522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfNIt2en4A6MxbnQ2RjOR%2Fuploads%2F0OA8VgyoUQ4FNNjm39Z9%2FScreenshot%202025-07-08%20at%2011.15.58.png?alt=media\&token=e29400a6-28f0-450a-9d7a-17511e84407b) để xóa.

### **Gợi ý sử dụng**

* Tỷ lệ hoa hồng phải được cấu hình trước khi có giao dịch giới thiệu.
* Có thể thay đổi tỷ lệ áp dụng theo thời gian mà không làm mất dữ liệu lịch sử.
* Dữ liệu hoa hồng có thể xuất ra báo cáo để phục vụ đối soát & thanh toán.