ทำความเข้าใจ Analytics ของ Command Center

ตั้งค่าแบบเร็ว

โรงแรมส่วนใหญ่มักตรวจ Completion Rate, Biggest Drop‑Off และ Issues ได้ภายในไม่ถึง 3 นาที

คู่มือนี้อธิบายว่า AVA คำนวณกราฟ Analytics แต่ละแบบใน Command Center อย่างไร รวมถึงการ์ดความครอบคลุมของเช็กอินเพิ่มเติมที่คุณอาจเห็นด้วย

ไปที่: Main Menu → Command Center → Analytics

---

คัดลอกค่า MCP config สำหรับ Codex หรือ Claude

ตั้งค่าแบบเร็ว

ใช้เวลาไม่ถึง 1 นาที โทเค็นมีอายุสั้นและใช้เซสชันเบราว์เซอร์ปัจจุบันของคุณ

ใช้ปุ่มเหล่านี้เมื่อคุณต้องการส่งข้อมูล Analytics ไปยังไคลเอนต์ AI เพื่อให้วิเคราะห์ต่อได้ โทเค็นที่คัดลอกยังรวมขอบเขต Streamliner MCP แบบเต็มด้วย ไคลเอนต์ที่รองรับสามารถใช้เครื่องมือการตั้งค่าได้หลังจากคุณรีสตาร์ต หลังคัดลอกแล้ว AVA จะแสดง modal เฉพาะของไคลเอนต์พร้อมคำแนะนำการวางข้อมูล

ปุ่ม	สิ่งที่คัดลอก	เหมาะสำหรับ
Copy Codex MCP Config	ค่า MCP config แบบ TOML ที่มี mcp_servers.streamliner	Codex
Copy Claude MCP Config	ค่า MCP config แบบ JSON ที่มี mcpServers.streamliner	Claude Code หรือ Claude Desktop

1. ไปที่ Main Menu → Command Center → Analytics.

2. คลิก Copy Codex MCP Config หรือ Copy Claude MCP Config.

3. รอจนปุ่มเปลี่ยนเป็น Creating MCP token....

4. อ่านคำแนะนำใน modal สำหรับไคลเอนต์ของคุณ

5. วาง config ที่คัดลอกไว้ลงในไฟล์ config ของไคลเอนต์ AI ของคุณ

6. รีสตาร์ตไคลเอนต์ของคุณเพื่อให้โหลด MCP server ใหม่

   ✓ config ของ Claude ใช้ JSON ✓ config ของ Codex ใช้ TOML ✓ ทั้งสอง config มี STREAMLINER_MCP_TOKEN ที่มีอายุสั้น

ใช้โทเค็นใหม่เท่านั้น

ถ้าคุณคัดลอกโทเค็นก่อนการเปลี่ยนแปลงนี้ ให้คัดลอก config ใหม่อีกครั้ง โทเค็นเก่าจะยังคงใช้ขอบเขตเดิมจนกว่าคุณจะต่ออายุ

วาง config แต่ละรายการที่ไหน

Codex ใช้ ~/.codex/config.toml

Claude ใช้ Claude Desktop Developer config ซึ่งโดยปกติคือ claude_desktop_config.json

สิ่งที่ modal แสดง

modal จะยืนยันว่าคุณคัดลอก config สำเร็จแล้ว จากนั้นจะแสดง path ของไฟล์ ตำแหน่งที่ให้วาง และขั้นตอนรีสตาร์ตสำหรับไคลเอนต์นั้น

หากคุณใช้ Codex

1. เปิด ~/.codex/config.toml บนเครื่องที่คุณใช้ Codex

2. วางบล็อก TOML ที่คัดลอกไว้ในระดับบนสุดของไฟล์

3. บันทึกไฟล์ แล้วรีสตาร์ต Codex

   ✓ หากมี mcp_servers.streamliner อยู่แล้ว ให้แทนที่ส่วนนั้น

หากคุณใช้ Claude Desktop

1. เปิด Claude Desktop

2. ไปที่ Settings → Developer → Edit Config

3. วาง JSON ที่คัดลอกไว้ลงใน claude_desktop_config.json

4. บันทึกไฟล์ แล้วปิดและเปิด Claude Desktop ใหม่อย่างสมบูรณ์

   ✓ บน macOS ไฟล์มักอยู่ที่ ~/Library/Application Support/Claude/ ✓ หากมี mcpServers อยู่แล้ว ให้รวมเฉพาะรายการ streamliner

สรุปย่อ

มุมมอง	นับเป็นเซสชันเมื่อ	กฎการสำเร็จ
Pre‑Arrival	การจองใดก็ตามที่ไปถึงขั้น Pre‑Arrival	PRE_ARRIVAL สำเร็จ
Check‑In → All	การจองใดก็ตามที่มีขั้นตอนในโฟลว์เช็กอิน รวมถึงเช็กอินก่อนเวลา หรือการลงทะเบียนล่วงหน้า แต่ไม่รวมเฉพาะก่อนเดินทางมาถึง	CHECKIN, KEY_COLLECTION, หรือ GET_DOOR_LOCK_KEY สำเร็จ
Check‑In → Early Check‑In	EARLY_CHECKIN_ATTEMPT หรือ ROOM_ASSIGNMENT_QUEUED	EARLY_CHECKIN_ATTEMPT หรือ ROOM_ASSIGNMENT_QUEUED สำเร็จ
Check‑In → Pre‑Registration	การจองใดก็ตามที่มีขั้นตอน Pre‑Registration	PRE_REGISTRATION สำเร็จ
Check‑In → Full Check‑In	CHECKIN, KEY_COLLECTION, หรือ GET_DOOR_LOCK_KEY	CHECKIN, KEY_COLLECTION, หรือ GET_DOOR_LOCK_KEY สำเร็จ
Check‑Out	การจองใดก็ตามที่มีขั้นตอนเช็กเอาต์	CHECKOUT หรือ COMPLETED_CHECKOUT_PAYMENT สำเร็จ

---

เปิด Analytics และเลือกมุมมอง

1. ไปที่ Main Menu → Command Center.

2. เลือกแท็บ Analytics

3. เลือก Pre‑Arrival, Check‑In หรือ Check‑Out

4. หากเลือก Check‑In ให้ใช้แท็บย่อย All Check‑Ins, Early Check‑In, Pre‑Registration หรือ Full Check‑In

   ✓ กราฟทั้งหมดจะอัปเดตตามมุมมองและช่วงวันที่ที่เลือก

---

AVA สร้างเซสชันอย่างไร

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

Pre‑Arrival แยกต่างหาก

เซสชันก่อนเดินทางมาถึง ไม่รวม อยู่ใน All Check‑Ins ให้ใช้มุมมอง Pre‑Arrival สำหรับกรณีเหล่านั้น

---

การ์ดสรุป (ด้านบนของแท็บ)

การ์ด	วิธีคำนวณ
Total Logs	จำนวนเซสชันในมุมมองที่เลือก
Completion Rate	เซสชันที่เสร็จสมบูรณ์ ÷ บันทึกทั้งหมด
Avg Completion Time	เวลาตั้งแต่ขั้นสำเร็จแรก (ปกติคือ Entry) จนถึงเสร็จสิ้น
Successful Check‑Ins / Check‑Outs	จำนวนเซสชันที่สำเร็จของมุมมองนั้น

สิ่งที่นับว่าเสร็จ ขึ้นอยู่กับมุมมองที่เลือก ดูจากตารางสรุปย่อ

ใช้ตารางนี้เพื่อตรวจว่าเซสชันใดนับเป็นความสำเร็จก่อนเปรียบเทียบช่วงเวลา

ตัวอย่าง

ถ้า Total Logs เท่ากับ 40 และ Successful Check‑Ins เท่ากับ 28 อัตราความสำเร็จคือ 70%

การ์ดความครอบคลุมของเช็กอิน

เมื่อ AVA ได้รับข้อมูลความครอบคลุมจาก PMS คุณอาจเห็นการ์ดเพิ่มอีกสองใบหลัง Completion Rate ฟังก์ชันนี้ใช้ได้กับ AVA PMS, Cloudbeds, Opera, Mews และ eZee

การ์ด	แสดงอะไร	สำคัญอย่างไร
Eligible Check-In Units	หน่วยการยืนยันหรือการจองย่อยที่ไม่ซ้ำกันในช่วงเวลาที่เลือก	เป็นตัวหารสำหรับความครอบคลุม
AVA Check-In Share	เปอร์เซ็นต์ของหน่วยที่เข้าเกณฑ์ซึ่ง AVA ประมวลผลอย่างน้อยหนึ่งครั้ง	แสดงการใช้งาน AVA ในช่วงเวลานั้น

Units ไม่ใช่การจองทั้งหมด

การ์ดเหล่านี้นับ units ไม่ใช่การจองทั้งใบ การจองหลายห้องอาจเพิ่มหน่วยที่เข้าเกณฑ์ได้มากกว่าหนึ่งรายการ

แผนที่เซสชันที่ถูกตัดทอน

หาก AVA ตั้งค่า sessionsMapMeta.truncated เป็น true ระบบจะละเว้นแผนที่เซสชันที่ไม่ครบถ้วนนั้น จากนั้นจะใช้บันทึกเช็กอินแบบเต็มสำหรับการคำนวณ share เมื่อมีข้อมูล หาก AVA ไม่สามารถดึงบันทึกที่ครบถ้วนได้ การ์ดความครอบคลุมจะถูกซ่อนไว้

AVA นับการจองที่ประมวลผลแล้วแต่ละรายการเพียงครั้งเดียว ระบบจะใช้แผนที่เซสชันเมื่อแผนที่นั้นครบถ้วน หากแผนที่เซสชันหายไปหรือถูกตัดทอน จะใช้รหัสบันทึกดิบแทน วิธีนี้ทำให้ AVA Check-In Share สอดคล้องกับความครอบคลุมของการจอง ค่าควรอยู่ที่หรือต่ำกว่า 100%

ผลลัพธ์ใหม่อาจล่าช้าเล็กน้อย

หากคุณรีเฟรชช่วงวันที่เดิมอีกครั้ง AVA อาจนำผลความครอบคลุมล่าสุดมาใช้ซ้ำช่วงสั้น ๆ วิธีนี้ช่วยให้แท็บ Analytics ตอบสนองได้เร็วระหว่างการตรวจซ้ำ

Check-In Share ดูไม่ถูกต้อง

สิ่งที่คุณเห็น: AVA Check-In Share สูงกว่าที่คาดไว้

วิธีแก้:

1. รีเฟรชแท็บ Analytics
2. ยืนยันว่าช่วงวันที่ตรงกับรายงาน PMS ของคุณ
3. ตรวจสอบว่าที่พักของคุณใช้ PMS ที่รองรับ
4. หากยังดูผิดอยู่ ให้ติดต่อซัพพอร์ตพร้อมภาพหน้าจอ

หากคุณไม่เห็นการ์ดเหล่านี้ ข้อมูล PMS ปัจจุบันของคุณอาจยังไม่มีเมตริกความครอบคลุมของหน่วย PMS ที่ไม่รองรับจะไม่แสดงการ์ดเหล่านี้

---

กราฟ Funnel (จุดหลุดและเวลาแต่ละขั้น)

กราฟกรวยแสดงเปอร์เซ็นต์ของเซสชันที่ไปถึงแต่ละขั้น

• Drop‑off เปรียบเทียบแต่ละขั้นกับขั้นก่อนหน้า
• Avg Stage Duration วัดเวลาที่ใช้ภายในขั้นนั้น ตั้งแต่เริ่มขั้นจนขั้นสำเร็จ
• Avg Time to Next Step วัดเวลาตั้งแต่ขั้นสำเร็จหนึ่งไปยังขั้นสำเร็จถัดไป
• การ์ด Slowest Step ใช้ค่าระยะเวลาของขั้นก่อน
• หาก AVA ไม่มีข้อมูลเวลาในแต่ละขั้น ระบบจะสำรองไปใช้ระยะเวลาถึงขั้นถัดไป
• หากขั้นถัดไปเกิดก่อนขั้นก่อนหน้า ระยะเวลาจะแสดงเป็น 0

ใช้การ์ด Biggest Drop‑Off เพื่อเลือกขั้นที่ควรโค้ชก่อน

ตัวอย่าง

ถ้า Document Upload มี 60 เซสชัน และขั้นก่อนหน้ามี 100 เซสชัน drop‑off คือ 40% ถ้า Document Upload เสร็จเวลา 10:05 และ Validation เสร็จเวลา 10:07 ระยะเวลาเฉลี่ยคือ 2 นาที

---

การวิเคราะห์เวลา (ปริมาณรายชั่วโมง)

การวิเคราะห์เวลา จัดกลุ่มเซสชันตาม ขั้นตอนสำเร็จแรก ในมุมมองที่เลือก

• ใช้เขตเวลาของโรงแรมคุณ
• Pre‑Arrival ต้องมีขั้น PRE_ARRIVAL ที่สำเร็จ
• แสดง Peak Hours และ Rush Periods เพื่อช่วยเรื่องการจัดกำลังคน

ใช้ Peak Hours เพื่อวางแผนกำลังคนในช่วงเวลาที่หนาแน่นที่สุด

ตัวอย่าง

เซสชันที่สำเร็จครั้งแรกเวลา 7:10 ตามเวลาท้องถิ่นจะนับอยู่ในชั่วโมง 07:00

---

ปัญหา (ความล้มเหลวล่าสุด)

รายการปัญหาจะแสดงเซสชันที่มีขั้นตอนล้มเหลวล่าสุด

• AVA ตรวจ 10 เหตุการณ์ล่าสุดเพื่อหาความล้มเหลว
• หากไม่มีความล้มเหลวล่าสุด ระบบจะใช้ความล้มเหลวล่าสุดที่บันทึกไว้

ใช้ View Details เพื่อดูประวัติขั้นตอนแบบเต็ม

ตัวอย่าง

หากการชำระเงินล้มเหลวเวลา 3:12 หลังจากสำเร็จก่อนหน้า ส่วนปัญหาจะแสดง Payment เวลา 3:12 หาก 10 เหตุการณ์ล่าสุดสำเร็จทั้งหมด AVA จะแสดงความล้มเหลวล่าสุดที่บันทึกไว้

---

กิจกรรมล่าสุด

กิจกรรมล่าสุดแสดงขั้นตอนสำคัญที่ สำเร็จหรือไม่สำเร็จ เช่น:

• Check‑In, Check‑Out
• Room Assignment
• Pre‑Registration
• Identity Verification
• Payment

รายการนี้จำกัดไว้ที่ 30 รายการล่าสุด

ใช้รายการนี้เพื่อยืนยันว่าขั้นตอนไหนเพิ่งเกิดขึ้นล่าสุด

ตัวอย่าง

คุณอาจเห็น “Check‑In completed successfully” หรือข้อความล้มเหลวสำหรับ Identity Verification

---

การกระจายขั้นสุดท้ายของเซสชัน

กราฟนี้จัดกลุ่มขั้นตอนสุดท้ายของแต่ละเซสชันเป็นหมวดต่าง ๆ:

• Success — ขั้นตอนสำเร็จเต็มรูปแบบ
• Timing — ขั้นเช็กอินก่อนเวลารวมถึง Room Queued
• Partial — การลงทะเบียนล่วงหน้า
• Room — ขั้นตอนการจัดสรรห้อง (Room Assignment)
• Documentation — การยืนยันเอกสารหรือเอกสารประจำตัว
• Payment — ขั้นตอนการชำระเงิน
• Early — ขั้น Entry / Fetch

หากเกิดความล้มเหลว หลัง ความสำเร็จครั้งล่าสุด ขั้นตอนที่ล้มเหลวจะกลายเป็นขั้นสุดท้าย

ใช้กราฟนี้เพื่อดูจุดหยุดที่พบบ่อยที่สุด

ตัวอย่าง

จาก 50 เซสชัน 20 เซสชันจบที่ Check‑In (success), 10 เซสชันจบที่ Early Check‑In (timing), 8 เซสชันจบที่ Document Upload (documentation) และ 12 เซสชันจบที่ Payment (payment)

เปิดเซสชันจากการกระจายขั้นตอนสุดท้าย

1. เลือกส่วนแท่งใน Final Step Distribution

2. ตรวจรายการเซสชันที่เปิดขึ้นมา

   ✓ รายการจะแสดงหมายเลขยืนยัน ผู้เข้าพัก ห้อง และความล้มเหลวล่าสุด

3. เลือก Open details ในเซสชันใดก็ได้

   ✓ แผง Reservation Details จะเปิดสำหรับเซสชันนั้น

รายการเซสชันกับ reservations

รายการนี้แสดง sessions ไม่ใช่ reservations ที่จัดกลุ่มไว้ ใช้เพื่อหาความล้มเหลวซ้ำ ๆ ให้เร็วขึ้น

---

การวิเคราะห์อุปกรณ์ (ตัวเลือกเสริม)

การวิเคราะห์อุปกรณ์ใช้รายละเอียดอุปกรณ์จากเซสชันเช็กอิน/เช็กเอาต์

หากผู้เข้าพักไม่ได้ระบุข้อมูลอุปกรณ์ กราฟนี้อาจว่างเปล่า

ใช้มุมมองนี้เพื่อเปรียบเทียบการใช้งานตู้คีออสก์กับมือถือ ตามระบบปฏิบัติการ

ตัวอย่าง

หากเซสชันส่วนใหญ่เป็น iOS คุณอาจต้องปรับปรุงโฟลว์เช็กอินบนมือถือ

---

ขีดจำกัดและความสดใหม่ของข้อมูล

• Analytics รองรับข้อมูลได้สูงสุด 90 วัน ต่อหนึ่งคำขอ
• หากมีเหตุการณ์มากกว่า 50,000 รายการในช่วงนั้น AVA จะขอให้คุณย่อช่วงวันที่ลง
• รายการเซสชันมีการจำกัดเพื่อประสิทธิภาพ (ประมาณ 200 ต่อขั้น และ 2,000 รวมทั้งหมด)

---

การแก้ไขปัญหา

กราฟทั้งหมดแสดงเป็นศูนย์

สิ่งที่คุณเห็น: การ์ดสรุปแสดง 0 และกราฟว่างเปล่า

วิธีแก้:

1. ขยายช่วงวันที่
2. ยืนยันว่ามีบันทึกใน Status
3. ตรวจสอบว่าแพ็กเกจของคุณรวม Analytics

Completion rate ดูต่ำกว่าที่คาด

สิ่งที่คุณเห็น: อัตราความสำเร็จต่ำ แม้ว่าผู้เข้าพักจำนวนมากจะเช็กอินแล้ว

ตรวจสอบ:

• เซสชันใน Pre‑Arrival ไม่นับรวมใน All Check‑Ins
• All Check‑Ins จะนับเฉพาะขั้น Full Check‑In ว่าเสร็จสมบูรณ์
• Early Check‑In และ Pre‑Registration จะถูกติดตามในแท็บย่อยของตัวเอง

การ์ดความครอบคลุมหายไป

สิ่งที่คุณเห็น: เห็นเฉพาะการ์ดสรุปมาตรฐาน

วิธีแก้:

1. อยู่ที่แท็บ Check-In

2. ยืนยันว่าการเชื่อมต่อ PMS ของคุณยังทำงานอยู่

3. รีเฟรชหน้าเมื่อการซิงก์เสร็จ

4. หากช่วงวันที่มีงานหนาแน่น ให้รีเฟรชอีกครั้งหลังผ่านไปไม่กี่นาที

   ✓ หาก PMS ของคุณรองรับความครอบคลุมของการจอง การ์ด Eligible Check-In Units และ AVA Check-In Share จะปรากฏหลัง Completion Rate

การ์ดความครอบคลุมยังดูไม่เปลี่ยน

สิ่งที่คุณเห็น: Eligible Check-In Units หรือ AVA Check-In Share ยังดูเหมือนเดิมหลังรีเฟรช

วิธีแก้:

1. รอหนึ่งนาที
2. รีเฟรชแท็บ Analytics อีกครั้ง
3. ยืนยันว่าช่วงวันที่ตรงกับการอัปเดต PMS ที่คุณคาดไว้
4. หากยังดูผิดอยู่ ให้ตรวจสอบว่า PMS ซิงก์เสร็จแล้ว

คัดลอก MCP config ไม่สำเร็จ

สิ่งที่คุณเห็น: ปุ่มแสดง error หลังจากคุณคลิก Copy Codex MCP Config หรือ Copy Claude MCP Config

วิธีแก้:

1. อยู่ที่แท็บ Analytics
2. ลองปุ่มคัดลอกอีกครั้ง
3. รีเฟรชหน้าแล้วลองใหม่หากคำขอโทเค็นหมดเวลา
4. หาก error ยังอยู่ ให้ติดต่อซัพพอร์ตพร้อมข้อความที่แสดงตรง ๆ

คัดลอก config แล้ว แต่ไคลเอนต์เชื่อมต่อไม่ได้

สิ่งที่คุณเห็น: modal เปิดขึ้น แต่ Codex หรือ Claude ไม่โหลด Streamliner server

วิธีแก้:

1. ตรวจสอบว่าคุณวาง config ลงในไฟล์ที่ถูกต้อง
2. ยืนยันว่าค่า STREAMLINER_MCP_TOKEN ยังอยู่
3. รีสตาร์ตไคลเอนต์ให้สมบูรณ์
4. คัดลอก config ใหม่หากขั้นตอนตั้งค่านานเกินไป

เครื่องมือการตั้งค่าหายไป

สิ่งที่คุณเห็น: ไคลเอนต์เชื่อมต่อได้ แต่การทำงานของการตั้งค่าไม่แสดง

วิธีแก้:

1. คัดลอก config ใหม่จาก Analytics
2. รีสตาร์ตไคลเอนต์ให้สมบูรณ์
3. ยืนยันว่า STREAMLINER_MCP_TOKEN ที่วางไว้เป็นตัวล่าสุด
4. ลบบล็อก config ของ Streamliner ที่เก่ากว่าหากยังมีอยู่

การบันทึกการตั้งค่าหมดเวลา

สิ่งที่คุณเห็น: การบันทึกการตั้งค่าดูเหมือนค้าง แล้วกลับมาพร้อมข้อความ timeout หรือยกเลิก

วิธีแก้:

1. คัดลอก config ใหม่จาก Analytics

2. รีสตาร์ตไคลเอนต์ให้สมบูรณ์

3. ลองเปลี่ยนการตั้งค่าอีกครั้ง

4. หากยังล้มเหลว ให้ตรวจสอบว่า token หรือ session หมดอายุหรือไม่

   ✓ การอัปเดตการตั้งค่าที่ถูกต้องควรจบลง ไม่ใช่ค้างอยู่

การยืนยันตัวตนล้มเหลวระหว่างบันทึกการตั้งค่า

สิ่งที่คุณเห็น: ได้รับ error ด้านการยืนยันตัวตนขณะบันทึก merchant settings

วิธีแก้:

1. คัดลอก config ใหม่จาก Analytics

2. รีสตาร์ตไคลเอนต์ให้สมบูรณ์

3. ลองเปลี่ยนการตั้งค่าในโรงแรมเดิมอีกครั้ง

4. หากคุณสลับโรงแรม ให้รีเฟรช config หลังสลับ

   ✓ error ใหม่ควรบอกให้คุณสร้าง MCP config/token ใหม่

---

ยังติดอยู่?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ Analytics แสดงข้อมูลใน Status แต่ Analytics ว่างเปล่า
• ❌ กราฟไม่อัปเดตเลยหลังเปลี่ยนช่วงวันที่
• ❌ รายการปัญหาแสดงเวลาไม่ถูกต้อง

ข้อมูลที่ควรแนบ:

• ช่วงวันที่ที่คุณเลือก
• ภาพหน้าจอของแท็บ Analytics
• หมายเลขยืนยันของการจองตัวอย่าง

คู่มือที่เกี่ยวข้อง

• ตรวจสอบกิจกรรม Command Center
• การเชื่อมต่อ PMS
• ปัญหาการซิงก์