จัดการแท็กผู้เล่น (Player Tag Management)

คำอธิบาย

ระบบจัดการแท็กผู้เล่นใช้สำหรับจัดกลุ่มและติดป้ายผู้เล่นตามเกณฑ์ต่างๆ เพื่อให้แอดมินสามารถแยกกลุ่มผู้เล่นเพื่อการวิเคราะห์ การตั้งค่าโปรโมชั่นเฉพาะกลุ่ม หรือการติดตามพฤติกรรมผู้เล่นได้ง่ายขึ้น โดยแท็กสามารถกำหนดด้วยตนเองหรือให้ระบบติดแท็กอัตโนมัติตามยอดฝากรวมของผู้เล่นได้

ระบบมี 2 วิธีการติดแท็ก:

1. ติดแท็กด้วยตนเอง - แอดมินเลือกผู้เล่นและแท็กที่ต้องการติด หรือถอดแท็กออกได้
2. ติดแท็กอัตโนมัติ - ตั้งยอดฝากขั้นต่ำในแท็ก ระบบจะติดแท็กให้ผู้เล่นที่มียอดฝากรวมถึงเกณฑ์โดยอัตโนมัติ

ผู้ใช้งาน

• แอดมิน / โอเปอเรเตอร์: จัดการแท็กทั้งหมด สร้าง แก้ไข ลบแท็ก ติดแท็กให้ผู้เล่น และดูสถิติการใช้งานแท็ก
• ระบบ: ติดแท็กอัตโนมัติให้ผู้เล่นที่มียอดฝากถึงเกณฑ์ที่กำหนด

ก่อนใช้งาน

สำหรับแอดมิน:

• ต้องมีสิทธิ์ "จัดการแท็กผู้เล่น" (MANAGE_PLAYER_TAGS)
• ต้องเข้าใจเกณฑ์การแบ่งกลุ่มผู้เล่น เช่น แบ่งตามยอดฝาก พฤติกรรมการเล่น หรือสถานะพิเศษ
• ถ้าต้องการให้ระบบติดแท็กอัตโนมัติ ต้องกำหนดยอดฝากขั้นต่ำตอนสร้างหรือแก้ไขแท็ก

หมายเหตุ:

• แท็กที่มียอดฝากขั้นต่ำจะติดอัตโนมัติให้ผู้เล่นที่มียอดฝากรวมถึงเกณฑ์
• การแก้ไขยอดฝากขั้นต่ำจะรีเซ็ตผู้เล่นทั้งหมดของแท็กนั้น แล้วติดใหม่ให้เฉพาะผู้เล่นที่ยอดฝากถึงเกณฑ์ใหม่

วิธีใช้งาน

สำหรับแอดมิน

---

🏷️ ส่วนที่ 1: จัดการแท็ก (Tag Management)

ดูรายการแท็ก

1. เลือก "จัดการแท็กผู้เล่น"
2. จะเห็นตารางแสดงแท็กทั้งหมด ประกอบด้วย:
   • ชื่อแท็ก - ชื่อที่ตั้งไว้ เช่น "VIP 50K+" "ผู้เล่นใหม่" "ผู้เล่นติดลบ"
   • สีแท็ก - สีที่กำหนดเพื่อความง่ายในการมองเห็น (แสดงเป็นวงกลมสี)
   • ยอดฝากขั้นต่ำ - เกณฑ์ยอดฝากสำหรับติดแท็กอัตโนมัติ (ถ้ามีการตั้งค่า)
   • จำนวนผู้เล่น - จำนวนผู้เล่นที่มีแท็กนี้
   • วันที่สร้าง - วันที่สร้างแท็ก
   • การจัดการ - ปุ่มแก้ไขและลบ
3. สามารถค้นหาชื่อแท็กได้จากช่องค้นหา

สร้างแท็กใหม่

วิธีสร้าง:

1. ที่หน้ารายการแท็ก คลิกปุ่ม "เพิ่มแท็กใหม่" มุมบนขวา

2. กรอกข้อมูลในฟอร์ม:

   ข้อมูลที่ต้องกรอก:

   • ชื่อแท็ก (บังคับ) - ตั้งชื่อที่บอกลักษณะของกลุ่มผู้เล่น

     • ตัวอย่าง: "VIP ฝากเกิน 50k++" (ตามรูป)
     • อื่นๆ เช่น "High Roller", "ผู้เล่นใหม่", "ผู้เล่นปัญหา"

   • สีแท็ก (บังคับ) - เลือกสีเพื่อแยกแยะแท็กได้ง่าย

     • สามารถเลือกจากตัวเลือกสีหรือกรอกรหัสสีแบบ HEX
     • ตัวอย่าง: #0055ff (สีน้ำเงิน ตามรูป)
     • แนะนำให้ใช้สีที่แตกต่างกันชัดเจนเพื่อความง่ายในการมองเห็น

   • ยอดฝากขั้นต่ำ (ไม่บังคับ) - กรอกเป็นตัวเลข

     • ตัวอย่าง: 50000 (ตามรูป)
     • ถ้ากรอก: ระบบจะติดแท็กอัตโนมัติให้ผู้เล่นที่มียอดฝากรวมมากกว่าหรือเท่ากับจำนวนนี้
     • ถ้าไม่กรอก: จะต้องติดแท็กด้วยตนเองเท่านั้น
     • หมายเหตุ: ถ้าตั้งค่านี้ ผู้เล่นที่มียอดฝากมากกว่าหรือเท่ากับจำนวนนี้จะได้รับแท็กอัตโนมัติในมิจฉาชีพ

3. คลิก "สร้างแท็ก" (ปุ่มสีน้ำเงินด้านขวา)

4. ระบบจะแสดงข้อความยืนยันเมื่อสร้างสำเร็จ

หมายเหตุ:

• ชื่อแท็กต้องไม่ซ้ำกับแท็กที่มีอยู่แล้ว
• ถ้าตั้งยอดฝากขั้นต่ำ ระบบจะติดแท็กอัตโนมัติให้ผู้เล่นที่ถึงเกณฑ์ทันทีหลังจากสร้างแท็ก

แก้ไขแท็ก

วิธีแก้ไข:

1. ในตารางรายการแท็ก คลิกปุ่ม "แก้ไข" (ไอคอนดินสอ) ที่แถวของแท็กที่ต้องการแก้ไข
2. หน้าต่างแก้ไขจะเปิดขึ้นมา แสดงข้อมูลปัจจุบันของแท็ก
3. แก้ไขข้อมูลที่ต้องการเปลี่ยน:
   • ชื่อแท็ก - แก้ไขชื่อได้ แต่ต้องไม่ซ้ำกับแท็กอื่น
   • สีแท็ก - เปลี่ยนสีได้ตามต้องการ
   • ยอดฝากขั้นต่ำ - แก้ไขหรือเพิ่มเกณฑ์ยอดฝากได้
4. คลิก "บันทึก"
5. ระบบจะแสดงข้อความยืนยันเมื่อแก้ไขสำเร็จ

สิ่งที่เกิดขึ้นเมื่อแก้ไขยอดฝากขั้นต่ำ:

เมื่อคุณแก้ไขยอดฝากขั้นต่ำ ระบบจะทำดังนี้:

1. ถอดแท็กออกจากผู้เล่นทุกคน ที่มีแท็กนี้อยู่
2. ติดแท็กใหม่ ให้เฉพาะผู้เล่นที่มียอดฝากรวมถึงเกณฑ์ใหม่

ตัวอย่าง:

• แท็ก "VIP 50K+" เดิมตั้งยอดขั้นต่ำ 50,000 บาท มีผู้เล่น 100 คน
• แก้ไขเป็น 100,000 บาท
• ผู้เล่นทั้ง 100 คนจะถูกถอดแท็กออก
• เฉพาะผู้เล่นที่ฝากรวมถึง 100,000 บาทจะได้แท็กกลับ (อาจเหลือ 30 คน)

ลบแท็ก

วิธีลบ:

1. ในตารางรายการแท็ก คลิกปุ่ม "ลบ" (ไอคอนถังขยะ) ที่แถวของแท็กที่ต้องการลบ
2. หน้าต่างยืนยันการลบจะเปิดขึ้นมา แสดงชื่อแท็กและจำนวนผู้เล่นที่มีแท็กนี้
3. คลิก "ยืนยันการลบ" เพื่อดำเนินการลบ
4. ระบบจะลบแท็กและถอดแท็กออกจากผู้เล่นทุกคนที่มีแท็กนี้

คำเตือน:

• การลบแท็กจะถอดแท็กออกจากผู้เล่นทุกคนที่มีแท็กนี้
• ไม่สามารถกู้คืนแท็กที่ลบไปแล้วได้
• แนะนำให้ตรวจสอบว่าแท็กนี้ไม่มีการใช้งานในโปรโมชั่นหรือเงื่อนไขอื่นๆ ก่อนลบ

---

👥 ส่วนที่ 2: จัดการแท็กของผู้เล่น (Player Tag Assignment)

ดูรายการผู้เล่น

1. เข้าไปที่เมนู "ผู้เล่น" → "รายการผู้เล่น" ในเมนูด้านข้าง
2. จะเห็นตารางแสดงผู้เล่นทั้งหมด ประกอบด้วย:
   • เบอร์โทร - เบอร์โทรศัพท์ของผู้เล่น
   • ยอดกระเป๋าหลัก - ยอดเงินในกระเป๋าหลัก
   • ยอดกระเป๋าโปรโมชั่น - ยอดเงินในกระเป๋าโปรโมชั่น
   • ระดับ - ระดับสมาชิก (Rank/VIP)
   • ช่องทาง - ช่องทางที่รู้จักเว็บ
   • สถานะแบน - แสดงว่าถูกแบนหรือไม่
   • วันที่สมัคร - วันที่สมัครสมาชิก
   • ใช้งานล่าสุด - เวลาที่ใช้งานครั้งล่าสุด
   • แท็ก - แท็กที่ผู้เล่นมี (แสดงเป็น Badge สี)
   • การจัดการ - เมนู 3 จุดสำหรับจัดการผู้เล่น
3. สามารถค้นหาจากเบอร์โทร กรองตามระดับ ช่องทาง หรือสถานะได้
4. สามารถโหลดข้อมูลเป็น CSV ด้วยปุ่ม "โหลด CSV" มุมบนขวา

ติดแท็กให้ผู้เล่น (ด้วยตนเอง)

วิธีติดแท็ก:

1. เข้าไปที่เมนู "ผู้เล่น" → "รายการผู้เล่น"

2. หาผู้เล่นที่ต้องการติดแท็ก (ค้นหาจากเบอร์โทร)

3. คลิกปุ่มเมนู 3 จุด ที่แถวของผู้เล่น

4. เลือก "จัดการแท็ก"

5. หน้าต่างจัดการแท็กจะเปิดขึ้นมา มี 2 แท็บ:

   แท็บ "เพิ่มแท็ก" (Add Tags):

   • แสดงรายการแท็กทั้งหมดที่สามารถเพิ่มได้
   • แสดงสีแท็ก ชื่อแท็ก และจำนวนผู้เล่นที่มีแท็กนี้แล้ว
   • เลือกแท็กที่ต้องการติด (สามารถเลือกได้หลายแท็กพร้อมกัน)
   • คลิก "เพิ่มแท็ก" เพื่อยืนยัน

   แท็บ "ถอดแท็ก" (Remove Tags):

   • แสดงเฉพาะแท็กที่ผู้เล่นมีอยู่แล้ว
   • เลือกแท็กที่ต้องการถอดออก (สามารถเลือกได้หลายแท็กพร้อมกัน)
   • คลิก "ถอดแท็ก" เพื่อยืนยัน

6. ระบบจะแสดงข้อความยืนยันเมื่อดำเนินการสำเร็จ

7. หน้าต่างจะปิดอัตโนมัติ และแท็กจะอัปเดตในตารางทันที

หมายเหตุ:

• ผู้เล่นสามารถมีได้หลายแท็กพร้อมกัน
• การติดแท็กด้วยตนเองจะไม่ถูกถอดออกโดยอัตโนมัติ ยกเว้นแอดมินถอดเอง หรือแท็กนั้นถูกลบ
• แท็กที่มียอดฝากขั้นต่ำสามารถติดด้วยตนเองเพิ่มเติมได้ แม้ผู้เล่นจะยอดฝากไม่ถึงเกณฑ์
• แท็กที่ติดอัตโนมัติ (จากเกณฑ์ยอดฝาก) ถ้าถอดออก อาจจะถูกติดกลับมาอัตโนมัติในครั้งถัดไปที่ระบบตรวจสอบ

---

🎬 การทำงานของระบบ

ระบบติดแท็กอัตโนมัติ

ระบบติดแท็กอัตโนมัติทำงานในกรณีดังนี้:

1. เมื่อสร้างแท็กใหม่ที่มียอดฝากขั้นต่ำ

• ระบบจะติดแท็กให้ผู้เล่นทุกคนที่มียอดฝากรวมถึงเกณฑ์ทันที

2. เมื่อแก้ไขยอดฝากขั้นต่ำของแท็ก

• ระบบจะถอดแท็กออกจากผู้เล่นทุกคนที่มีแท็กนั้นอยู่
• จากนั้นติดแท็กใหม่ให้เฉพาะผู้เล่นที่มียอดฝากถึงเกณฑ์ใหม่

3. เมื่อผู้เล่นฝากเงิน

• ระบบจะตรวจสอบว่ายอดฝากรวมของผู้เล่นถึงเกณฑ์ของแท็กใดบ้าง
• ถ้าถึงเกณฑ์และยังไม่มีแท็กนั้น จะติดแท็กให้อัตโนมัติ

4. เมื่อคลิกปุ่ม "ตรวจสอบแท็กทั้งหมดใหม่"

• ระบบจะตรวจสอบผู้เล่นทุกคนและติดแท็กให้ตามเกณฑ์

เกณฑ์การติดแท็กอัตโนมัติ

สูตรคำนวณ:

ยอดฝากรวมของผู้เล่น >= ยอดฝากขั้นต่ำของแท็ก

ตัวอย่าง:

แท็ก	ยอดฝากขั้นต่ำ	ผู้เล่น A (ฝากรวม 30,000)	ผู้เล่น B (ฝากรวม 80,000)	ผู้เล่น C (ฝากรวม 150,000)
VIP Bronze	10,000	✅ ได้แท็ก	✅ ได้แท็ก	✅ ได้แท็ก
VIP Silver	50,000	❌ ไม่ได้	✅ ได้แท็ก	✅ ได้แท็ก
VIP Gold	100,000	❌ ไม่ได้	❌ ไม่ได้	✅ ได้แท็ก

ลำดับความสำคัญของแท็ก

ผู้เล่นสามารถมีได้หลายแท็กพร้อมกัน:

• แท็กที่ติดด้วยตนเอง และ แท็กที่ติดอัตโนมัติ จะแสดงพร้อมกัน
• ไม่มีข้อจำกัดจำนวนแท็กที่ผู้เล่นสามารถมีได้
• แท็กจะแสดงเรียงตามชื่อหรือตามลำดับที่ติด

---

ข้อจำกัด

• ชื่อแท็กต้องไม่ซ้ำกัน - ไม่สามารถสร้างแท็กที่ชื่อเดียวกันได้
• ยอดฝากขั้นต่ำต้องเป็นตัวเลขบวก - ถ้ากรอกต้องเป็นจำนวนเต็มที่มากกว่า 0
• การลบแท็กไม่สามารถกู้คืนได้ - แท็กที่ลบไปแล้วจะถูกลบถาวร ต้องสร้างใหม่ถ้าต้องการใช้อีกครั้ง
• การแก้ไขยอดฝากขั้นต่ำจะรีเซ็ตผู้เล่น - ผู้เล่นทั้งหมดจะถูกถอดแท็กแล้วติดใหม่ตามเกณฑ์ใหม่
• ระบบติดแท็กอัตโนมัติใช้เวลา - กรณีที่มีผู้เล่นจำนวนมาก อาจใช้เวลาสักครู่ในการติดแท็ก
• แท็กที่ติดอัตโนมัติอาจถูกติดซ้ำ - ถ้าผู้เล่นถูกติดแท็กด้วยตนเองก่อน แล้วยอดฝากถึงเกณฑ์ ระบบจะไม่ติดซ้ำ

ข้อผิดพลาดที่พบบ่อย

• แอดมินไม่เห็นเมนูจัดการแท็ก → ตรวจว่ามีสิทธิ์ "จัดการแท็กผู้เล่น" หรือยัง ถ้าเพิ่งได้รับสิทธิ์ ให้ออกจากระบบแล้วเข้าใหม่

• สร้างแท็กแล้วขึ้นว่าชื่อซ้ำ → มีแท็กชื่อนี้อยู่แล้วในระบบ ให้เปลี่ยนชื่อใหม่ เช่น เพิ่มคำว่า "รุ่น 2" หรือเปลี่ยนรูปแบบการเขียน

• ติดแท็กให้ผู้เล่นแล้วไม่เห็นแท็ก → อาจเป็นเพราะ:

  • ยังไม่ได้รีเฟรชหน้า ให้กดรีเฟรชใหม่
  • แท็กที่ติดถูกลบไปแล้ว
  • แท็กถูกถอดออกโดยแอดมินคนอื่น

• ตั้งยอดฝากขั้นต่ำแล้วไม่มีผู้เล่นได้แท็ก → ตรวจสอบว่า:

  • ยอดฝากขั้นต่ำที่ตั้งถูกต้องหรือไม่ (อาจสูงเกินไป)
  • ผู้เล่นในระบบมียอดฝากรวมถึงเกณฑ์หรือยัง
  • ลองคลิกปุ่ม "ตรวจสอบแท็กทั้งหมดใหม่" เพื่อให้ระบบตรวจสอบอีกครั้ง

• แก้ไขยอดฝากขั้นต่ำแล้วจำนวนผู้เล่นลดลง → นี่เป็นเรื่องปกติ เพราะระบบจะรีเซ็ตผู้เล่นทั้งหมดแล้วติดใหม่ตามเกณฑ์ใหม่ ผู้เล่นที่ยอดฝากไม่ถึงเกณฑ์ใหม่จะไม่ได้แท็กกลับ

• ผู้เล่นฝากเงินแล้วไม่ได้แท็กอัตโนมัติ → อาจเป็นเพราะ:

  • ยอดฝากของผู้เล่นยังไม่ถึงเกณฑ์ ให้ตรวจสอบยอดฝากรวม
  • ผู้เล่นมีแท็กนั้นอยู่แล้ว ระบบจะไม่ติดซ้ำ
  • ระบบยังไม่ได้อัปเดต รอสักครู่แล้วรีเฟรชหน้าใหม่

แก้ปัญหา

• ปัญหา: สร้างแท็กแล้วไม่มีผู้เล่นถูกติดอัตโนมัติ แม้ว่าตั้งยอดฝากขั้นต่ำไว้แล้ว
  วิธีแก้:

  • ตรวจสอบว่ายอดฝากขั้นต่ำที่ตั้งไม่สูงเกินไป
  • ดูว่ามีผู้เล่นในระบบที่มียอดฝากถึงเกณฑ์หรือไม่
  • ลองคลิกปุ่ม "ตรวจสอบแท็กทั้งหมดใหม่" เพื่อให้ระบบติดแท็กอีกครั้ง
  • รอสักครู่แล้วรีเฟรชหน้า เพราะการติดแท็กอาจใช้เวลาเล็กน้อย

• ปัญหา: แก้ไขยอดฝากขั้นต่ำแล้วผู้เล่นทุกคนหายไป
  วิธีแก้:

  • นี่เป็นพฤติกรรมปกติ เพราะระบบจะถอดแท็กออกจากผู้เล่นทุกคนก่อน
  • จากนั้นติดแท็กใหม่ให้เฉพาะผู้เล่นที่ยอดฝากถึงเกณฑ์ใหม่
  • ถ้าต้องการให้ผู้เล่นเดิมกลับมามีแท็ก ต้องติดแท็กด้วยตนเองหรือแก้ยอดฝากขั้นต่ำให้ต่ำลง

คำแนะนำ

การตั้งยอดฝากขั้นต่ำ

• วางแผนระดับ VIP ล่วงหน้า - กำหนดเกณฑ์ยอดฝากสำหรับแต่ละระดับให้เหมาะสมกับฐานผู้เล่น เช่น:
  • VIP Bronze: 10,000 บาท
  • VIP Silver: 50,000 บาท
  • VIP Gold: 100,000 บาท
  • VIP Platinum: 500,000 บาท
• เริ่มจากเกณฑ์ที่ต่ำ - ถ้าไม่แน่ใจ ให้ตั้งเกณฑ์ต่ำก่อน แล้วค่อยปรับขึ้นทีหลัง

การใช้งานแท็กอย่างมีประสิทธิภาพ

• แยกประเภทแท็กให้ชัดเจน - แบ่งเป็นหมวดหมู่ เช่น:
  • แท็ก VIP - จัดระดับตามยอดฝาก ใช้ระบบอัตโนมัติ
  • แท็กพฤติกรรม - จัดตามการเล่น เช่น "ชอบสล็อต", "เล่นบ่อย", "เล่นนานๆ ครั้ง"
  • แท็กปัญหา - จัดผู้เล่นที่มีปัญหา เช่น "โกงระบบ", "ร้องเรียนบ่อย", "เล่นติดลบ"
• ตรวจสอบและทบทวนแท็กเป็นประจำ - ดูว่าแท็กไหนยังใช้งานอยู่ แท็กไหนไม่มีผู้เล่นแล้วสามารถลบได้
• บันทึกเกณฑ์การตั้งแท็ก - จดบันทึกไว้ว่าแท็กแต่ละตัวมีเกณฑ์อะไร ใช้สำหรับอะไร เพื่อให้ทีมงานคนอื่นเข้าใจได้