TF
T-Fluencers Docs
Quay lại Wiki

Segment (Phân khúc người dùng)#

Mục tiêu: Admin tạo và quản lý segment (phân khúc) Influencer để dùng trong matching thử thách và targeting notification.

Mục tiêu#

  • Tạo segment MANUAL hoặc AUTOMATIC.
  • Gán/xóa user khỏi segment manual.
  • Áp dụng segment vào thử thách (applyForSegments) và notification.

Điều kiện tiên quyết#

  • Quyền Quản lý segment.

Các loại segment#

MANUAL#

  • Admin gán tay từng user.
  • Phù hợp cho VIP, whitelist nhỏ.

AUTOMATIC#

  • Hệ thống tự match theo điều kiện.
  • Hiện tại support:
    • applyType: "referral_code" — user có referral code trong danh sách.
  • Khi có user mới match → tự add.

Các bước thực hiện#

1. Tạo segment#

  1. Vào /segment.
  2. Bấm Tạo mới.
  3. Điền:
    • Tên segment (ví dụ: "VIP 2026")
    • Loại: MANUAL / AUTOMATIC
    • Nếu AUTOMATIC:
      • applyType: referral_code (hiện tại)
      • referralCodes: danh sách mã.
    • Partner (nếu AT).
  4. Lưu. Segment tạo với status active.

2. Toggle active/inactive#

  • Active: Segment được dùng trong matching.
  • Inactive: Tạm disable (vẫn giữ data).

Click toggle trên row.

3. Xem danh sách user trong segment#

Action View users trên row → list user đã thuộc segment + pagination.

4. Gán user vào segment MANUAL#

  • Mở detail segment.
  • Bấm Add user → search user → add.
  • Hoặc bulk add từ CSV.

5. Áp dụng segment vào thử thách#

Xem Matching Influencer:

  • Trong thử thách → tab Matching → chọn applyForSegments.

6. Áp dụng segment cho notification#

Xem Gửi thông báo:

  • Trong form notification → targetUsers: USER_SEGMENT → chọn segment.

Chi tiết từng bước#

Cột bảng segment#

CộtÝ nghĩa
Tên
LoạiMANUAL / AUTOMATIC
Điều kiện(cho AUTOMATIC)
Số ngườistatistic.userTotal
Partner
Trạng tháiactive / inactive
Ngày tạo

Thay đổi type — không cho phép#

Type không thể đổi sau khi tạo. Nếu cần đổi, xóa và tạo lại.

Segment overlap#

Một user có thể thuộc nhiều segment cùng lúc. Khi match thử thách, chỉ cần thuộc 1 segment trong applyForSegments.

Segment common trong hệ thống#

  • Mass Influencer — đại chúng
  • Tech Comer — CBNV TCB / tech enthusiasts
  • VIP — top tier
  • Emerging — mới nổi
  • Community Builders — community-focused

Admin có thể thêm custom.

Lỗi thường gặp#

1. Segment AUTOMATIC không auto-add user#

  • Cron job match fail. Xem Giám sát Cron Jobs.
  • Điều kiện sai — kiểm tra referralCodes không typo.

2. User không xuất hiện trong segment dù đủ điều kiện#

  • Cache. Chờ job chạy lại (thường mỗi giờ).
  • Partner mismatch — user thuộc partner khác.

3. Xóa segment — data đi đâu?#

Segment inactive thôi, không xóa hẳn (soft delete). Thử thách đã reference segment sẽ bị mất filter này.

4. Segment lớn (> 10k user) load chậm#

  • Pagination giúp. Export CSV để xem offline.

5. Add user manual không save#

  • Quyền user limit (ví dụ admin partner A không add user partner B).
  • Refresh browser.

Câu hỏi thường gặp (FAQ)#

Bao nhiêu segment tối đa?

Không giới hạn cứng. Nhưng > 50 segment active sẽ làm UI matching rối. Nên gộp hợp lý.

User có tự xin vào segment không?

Hiện tại không. Admin assign. Trừ AUTOMATIC với referral_code — user nhập code sẽ tự vào.

Có segment theo điều kiện phức tạp (and/or)?

Chưa. Chỉ support 1 điều kiện đơn giản (referral_code). Feature future có thể mở rộng.

Segment + matching + notification — overlap?

Đúng. Segment là reusable entity:

  • Matching: chọn segment để filter user tham gia thử thách.
  • Notification: chọn segment để target push message.
  • Reporting: filter analytics theo segment.

Segment ảnh hưởng ngược không — add user vào thử thách có auto add segment?

Không. Segment và thử thách là 2 entity riêng. Add user vào thử thách không auto segment.

Liên kết liên quan#

Tham khảo SRS: admin-portal/11-segment-matching