ทำความเข้าใจ Analytics ของ Command Center
โรงแรมส่วนใหญ่ตรวจ Completion Rate, Biggest Drop‑Off และ Issues ได้ภายในไม่ถึง 3 นาที
คู่มือนี้อธิบายว่า AVA คำนวณกราฟแต่ละตัวใน Analytics ของ Command Center อย่างไร และอธิบายการ์ด coverage เช็กอินเพิ่มเติมที่คุณอาจเห็น
ไปที่: Main Menu → Command Center → Analytics
เช็กอินเดโมยังแสดงใน Status และรายละเอียดการจอง แต่จะไม่นับในยอดรวมของ Analytics, drop-offs, การวิเคราะห์เวลา, issues หรือกิจกรรมล่าสุด
ตอนนี้ AVA อ่านแท็บนี้จาก daily rollups เพื่อให้ช่วงวันที่กว้างโหลดได้เร็วขึ้น หากข้อมูล rollup หายไปหรือการเรียก rollup ล้มเหลว AVA จะย้อนกลับไปใช้เส้นทางแบบสด
ช่วงวันที่ขนาดใหญ่ยังอาจใช้เวลาโหลดนานกว่าเดิม ที่พักที่มีทราฟฟิกสูงมากอาจส่ง error ช่วงวันที่แคบได้เร็วขึ้นแทนที่จะค้าง สิ่งนี้ใช้เฉพาะแท็บ Analytics
แท็บ Analytics เน้นกราฟบนหน้าจอ ไม่มีปุ่มดาวน์โหลด PDF หรือปุ่มส่งออกผ่านเบราว์เซอร์
คัดลอกค่า MCP config สำหรับ Codex หรือ Claude
ใช้เวลาไม่ถึง 1 นาที โทเคนมีอายุสั้นและใช้ session เบราว์เซอร์ปัจจุบันของคุณ
ใช้ปุ่มเหล่านี้เมื่อคุณต้องการส่งข้อมูล Analytics ไปยังไคลเอนต์ AI โทเคนที่คัดลอกยังรวมสิทธิ์ Streamliner MCP แบบเต็มด้วย ไคลเอนต์ที่รองรับสามารถใช้เครื่องมือ settings ได้หลังจากรีสตาร์ต หลังคัดลอกแล้ว AVA จะแสดงหน้าต่างโมดัลเฉพาะไคลเอนต์พร้อมคำแนะนำการวาง
| ปุ่ม | สิ่งที่คัดลอก | เหมาะกับ |
|---|---|---|
| Copy Codex MCP Config | MCP config แบบ TOML ที่มี mcp_servers.streamliner | Codex |
| Copy Claude MCP Config | MCP config แบบ JSON ที่มี mcpServers.streamliner | Claude Code หรือ Claude Desktop |
-
คลิก Copy Codex MCP Config หรือ Copy Claude MCP Config
-
รอจนปุ่มเปลี่ยนเป็น Creating MCP token...
-
อ่านคำแนะนำในหน้าต่างโมดัลสำหรับไคลเอนต์ของคุณ
-
วาง config ที่คัดลอกลงในไฟล์ config ของไคลเอนต์ AI
-
รีสตาร์ตไคลเอนต์เพื่อให้โหลด MCP server ใหม่
✓ Claude config ใช้ JSON ✓ Codex config ใช้ TOML ✓ ทั้งสอง config มี
STREAMLINER_MCP_TOKENที่มีอายุสั้น
หากคุณคัดลอกโทเคนก่อนการเปลี่ยนแปลงนี้ ให้คัดลอก config ใหม่ โทเคนเก่าจะคงสิทธิ์เดิมไว้จนกว่าคุณจะต่ออายุ
Codex ใช้ ~/.codex/config.toml
Claude ใช้ Claude Desktop Developer config ซึ่งมักเป็น claude_desktop_config.json
สิ่งที่โมดัลแสดง
หน้าต่างโมดัลจะยืนยันว่าคุณคัดลอก config สำเร็จ จากนั้นจะแสดงพาธไฟล์ ตำแหน่งวาง และขั้นตอนรีสตาร์ตของไคลเอนต์นั้น
หากคุณใช้ Codex
-
เปิด
~/.codex/config.tomlบนเครื่องที่คุณใช้รัน Codex -
วางบล็อก TOML ที่คัดลอกไว้ที่ระดับบนสุดของไฟล์
-
บันทึกไฟล์ แล้วรีสตาร์ต Codex
✓ หากมี
mcp_servers.streamlinerอยู่แล้ว ให้แทนที่ section นั้น
หากคุณใช้ Claude Desktop
-
เปิด Claude Desktop
-
ไปที่ Settings → Developer → Edit Config
-
วาง JSON ที่คัดลอกไว้ลงใน
claude_desktop_config.json -
บันทึกไฟล์ แล้วปิด Claude Desktop ให้สนิทและเปิดใหม่
✓ บน macOS ไฟล์มักอยู่ที่
~/Library/Application Support/Claude/✓ หากมีmcpServersอยู่แล้ว ให้รวมเฉพาะรายการstreamliner
สรุปอ้างอิง
| มุมมอง | สิ่งที่นับเป็น session | กฎการจบ |
|---|---|---|
| Pre‑Arrival | การจองใด ๆ ที่ไปถึงขั้น Pre‑Arrival | PRE_ARRIVAL สำเร็จ |
| Check‑In → All | การจองใด ๆ ที่มีขั้นตอนใน flow เช็กอิน รวม early check-in หรือ pre-registration แต่ไม่นับ pre-arrival ล้วน | 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 และเลือกมุมมอง

-
เลือกแท็บ Analytics
-
เลือก Pre‑Arrival, Check‑In, หรือ Check‑Out
-
หากเลือก Check‑In ให้ใช้แท็บย่อย All Check‑Ins, Early Check‑In, Pre‑Registration, หรือ Full Check‑In
✓ กราฟทั้งหมดจะอัปเดตตามมุมมองและช่วงวันที่นั้น
AVA สร้าง session อย่างไร
- session คือเรคคอร์ดการเช็กอินของการจองหนึ่งรายการ ไม่ใช่ผู้เข้าพักแต่ละคน
- session จะถูกนับเมื่อมีอย่างน้อยหนึ่งขั้นตอนจากมุมมองนั้นถูกบันทึก
- session ที่ติดแท็กเป็น demo จะไม่ถูกนับในกราฟ Analytics เหล่านี้
- ขั้นตอนที่ล้มเหลวยังถูกนับรวมในยอดทั้งหมด เพื่อให้เห็นจุดหลุดและปัญหา
session ของ pre-arrival ไม่ ถูกรวมใน All Check‑Ins ให้ใช้มุมมอง Pre‑Arrival สำหรับรายการเหล่านั้น
การ์ดสรุป (ด้านบนของแท็บ)
| การ์ด | วิธีคำนวณ |
|---|---|
| Total Logs | จำนวน session ที่ไม่ใช่ demo ในมุมมองที่เลือก |
| Completion Rate | session ที่เสร็จสมบูรณ์ ÷ total non-demo logs |
| Avg Completion Time | เวลาตั้งแต่ขั้นแรกที่สำเร็จ (โดยปกติคือ Entry) จนจบ |
| Successful Check‑Ins / Check‑Outs | จำนวน session ที่เสร็จสมบูรณ์สำหรับมุมมองนั้น |
สิ่งที่นับว่าเสร็จสมบูรณ์ ขึ้นอยู่กับมุมมอง (ดูตาราง Quick Reference)
ใช้ตารางนี้เพื่อยืนยันว่า session ใดนับว่าเสร็จแล้วก่อนเปรียบเทียบช่วงเวลา
หาก Total Logs เท่ากับ 40 และ Successful Check‑Ins เท่ากับ 28 อัตราการสำเร็จคือ 70%
การ์ด coverage ของ check-in
เมื่อ AVA ได้รับข้อมูล coverage จาก PMS ของคุณ คุณอาจเห็นการ์ดเพิ่มอีกสองใบหลัง Completion Rate ใช้ได้กับ AVA PMS, Cloudbeds, Opera, Mews, และ eZee
| การ์ด | แสดงอะไร | ทำไมจึงสำคัญ |
|---|---|---|
| Eligible Check-In Units | หน่วย confirmation หรือ sub-reservation ที่แตกต่างกันในช่วงเวลาที่เลือก | นี่คือตัวหารของ coverage |
| AVA Check-In Share | เปอร์เซ็นต์ของหน่วยที่เข้าเกณฑ์ซึ่ง AVA ประมวลผลอย่างน้อยหนึ่งครั้ง | แสดงการใช้งาน AVA ในช่วงเวลานั้น |
การ์ดเหล่านี้นับ units ไม่ใช่การจองทั้งก้อน การจองหลายห้องสามารถเพิ่มหน่วยที่เข้าเกณฑ์ได้มากกว่าหนึ่งหน่วย
หาก PMS ของคุณคือ OPERA AVA จะไม่นับห้องจำลอง PM, PF, และ PX ในจำนวน unit ที่เข้าเกณฑ์ และจะใช้ฟิลด์ room type ระดับบนเมื่อแถวห้องมีข้อมูลบางส่วน เพื่อให้ห้องผู้เข้าพักจริงนับได้ถูกต้อง
AVA ยัง dedupe ครอบครัวการจอง OPERA ที่เชื่อมโยงกันโดยอ้างอิง parent confirmation วิธีนี้ป้องกันไม่ให้แถว sibling ที่สิ้นสุดแล้วไปทำให้ Eligible Check-In Units สูงเกินจริง
หาก AVA ทำเครื่องหมาย sessionsMapMeta.truncated เป็น true จะไม่ใช้แผนที่บางส่วนนั้น
จากนั้นจะใช้ check-in logs แบบเต็มสำหรับการคำนวณ share เมื่อมีให้ใช้
หาก AVA ดึง logs แบบครบไม่ได้ การ์ด coverage จะยังถูกซ่อน
AVA จะนับการจองที่ประมวลผลแล้วแต่ละรายการเพียงครั้งเดียว จะใช้ session map เมื่อ map นั้นสมบูรณ์ หาก session map หายไปหรือถูกตัด จะใช้ raw log identities แทน วิธีนี้ทำให้ AVA Check-In Share สอดคล้องกับ coverage ของการจอง และควรไม่เกิน 100%
หากคุณรีเฟรชช่วงวันที่เดิมอีกครั้ง AVA อาจใช้ผล coverage ล่าสุดเดิมชั่วครู่ วิธีนี้ช่วยให้แท็บ Analytics ตอบสนองเร็วระหว่างการตรวจซ้ำ
Check-In Share ดูผิดปกติ
สิ่งที่เห็น: AVA Check-In Share สูงเกินที่คาดไว้
วิธีแก้:
- รีเฟรชแท็บ Analytics
- ยืนยันว่าช่วงวันที่ตรงกับรายงาน PMS ของคุณ
- ตรวจสอบว่าที่พักของคุณใช้ PMS ที่รองรับ
- หากยังดูผิด ให้ติดต่อฝ่ายสนับสนุนพร้อมภาพหน้าจอ
หากคุณไม่เห็นการ์ดเหล่านี้ ข้อมูล PMS ปัจจุบันของคุณอาจไม่มี metrics coverage ระดับ unit ผู้ให้บริการ PMS ที่ไม่รองรับจะไม่แสดงการ์ดเหล่านี้
กราฟ Funnel (การหลุดและเวลาของแต่ละขั้น)
กราฟ funnel แสดงเปอร์เซ็นต์ของ session ที่ไปถึงแต่ละขั้น
- Drop‑off เปรียบเทียบแต่ละขั้นกับขั้นก่อนหน้า
- Avg Stage Duration วัดเวลาที่ใช้ภายใน stage ตั้งแต่เริ่ม stage จน stage สำเร็จ
- Avg Time to Next Step วัดเวลาตั้งแต่ขั้นที่สำเร็จหนึ่งขั้นไปยังขั้นที่สำเร็จถัดไป
- การ์ด Slowest Step ใช้ stage duration ก่อน
- หาก AVA ไม่มี stage timing จะ fallback ไปใช้ duration ของ next-step
- หากขั้นตอนถัดไปเกิดขึ้นก่อนขั้นก่อนหน้า ระยะเวลาจะแสดงเป็น 0
ใช้การ์ด Biggest Drop‑Off เพื่อเลือกขั้นที่ควรโค้ชก่อน
หาก Document Upload มี 60 session และขั้นก่อนหน้ามี 100 drop‑off คือ 40% หาก Document Upload ใช้เวลา 20 วินาที Avg Stage Duration คือ 20 วินาที หาก Document Upload เสร็จที่ 10:05 และ Validation เสร็จที่ 10:07 Avg Time to Next Step คือ 2 นาที
Time Analysis (ปริมาณรายชั่วโมง)
Time Analysis จัดกลุ่ม session ตาม ขั้นตอนแรกที่สำเร็จ ในมุมมองที่เลือก
- ใช้ timezone ของโรงแรมคุณ
- Pre‑Arrival ต้องมีขั้น PRE_ARRIVAL ที่สำเร็จ
- แสดง Peak Hours และ Rush Periods เพื่อช่วยเรื่องการจัดกำลังคน
ใช้ Peak Hours เพื่อวางแผนการครอบคลุมช่วงเวลาที่งานแน่นที่สุด
session ที่สำเร็จครั้งแรกเวลา 7:10 ตามเวลาท้องถิ่นจะถูกนับในชั่วโมง 07:00
Issues (ความล้มเหลวล่าสุด)
Issues จะแสดง session ที่มีขั้นตอนล้มเหลวล่าสุด
- 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
Final Step Distribution (จบที่ขั้นไหน)
กราฟนี้จัดกลุ่มขั้นสุดท้ายของแต่ละ session เป็นหมวดต่าง ๆ:
- Success — ขั้นจบแบบสมบูรณ์
- Timing — ขั้นเช็กอินก่อนกำหนด รวม Room Queued
- Partial — pre-registration
- Room — ขั้นกำหนดห้อง (Room Assignment)
- Documentation — การยืนยันเอกสารหรือบัตรประจำตัว
- Payment — ขั้นการชำระเงิน
- Early — ขั้น Entry / Fetch
หากเกิดความล้มเหลว หลัง ความสำเร็จครั้งสุดท้าย ขั้นที่ล้มเหลวนั้นจะกลายเป็นขั้นสุดท้าย
ใช้กราฟนี้เพื่อดูจุดหยุดที่พบบ่อยที่สุด
จาก 50 session 20 จบที่ Check‑In (success), 10 จบที่ Early Check‑In (timing), 8 จบที่ Document Upload (documentation), และ 12 จบที่ Payment (payment)
เปิด session จาก Final Step Distribution
-
เลือกส่วนแท่งใน Final Step Distribution
-
ตรวจรายการ session ที่เปิดขึ้น
✓ รายการจะแสดงหมายเลขยืนยัน, ผู้เข้าพัก, ห้อง, และความล้มเหลวล่าสุด
-
เลือก Open details บน session ใดก็ได้
✓ แผง Reservation Details จะเปิดสำหรับ session นั้น
รายการนี้แสดง sessions ไม่ใช่การจองแบบจัดกลุ่ม ใช้เพื่อจับความล้มเหลวซ้ำได้เร็ว
Device Analytics (ไม่บังคับ)
Device Analytics ใช้รายละเอียดอุปกรณ์จาก session เช็กอิน/เช็กเอาต์
หากผู้เข้าพักไม่ให้ข้อมูลอุปกรณ์ กราฟนี้อาจว่างเปล่า
ใช้มุมมองนี้เพื่อเปรียบเทียบการใช้งาน kiosk กับมือถือแยกตาม OS
หาก session ส่วนใหญ่เป็น iOS คุณอาจต้องปรับปรุงโฟลว์เช็กอินบนมือถือ
ขีดจำกัดและความสดของข้อมูล
- Analytics ครอบคลุมได้สูงสุด 90 วัน ต่อหนึ่ง query
- หากมีเหตุการณ์มากกว่า 50,000 รายการในช่วงที่เลือก AVA จะขอให้คุณลดช่วงวันที่
- รายการ session ถูกจำกัดเพื่อประสิทธิภาพ (ประมาณ 200 ต่อ step และ 2,000 รวม)
การแก้ไขปัญหา
ทุกกราฟแสดงเป็นศูนย์
สิ่งที่เห็น: การ์ดสรุปแสดง 0 และกราฟว่าง
วิธีแก้:
- ขยายช่วงวันที่
- ยืนยันว่ามี logs ใน Status
- ตรวจสอบว่าแพ็กเกจของคุณรวม Analytics หรือไม่
Completion rate ดูต่ำกว่าที่คาด
สิ่งที่เห็น: Completion rate ต่ำ แม้ว่าผู้เข้าพักจำนวนมากจะเช็กอินแล้ว
ตรวจสอบ:
- Demo check-ins ถูกตัดออก จึงไม่ทำให้ Total Logs เพิ่ม
- session ใน Pre‑Arrival ไม่นับรวมใน All Check‑Ins
- All Check‑Ins จะนับเฉพาะขั้น Full Check‑In ว่าเสร็จสมบูรณ์
- Early Check‑In และ Pre‑Registration ถูกติดตามใน sub-tab ของตัวเอง
การ์ด coverage หายไป
สิ่งที่เห็น: คุณเห็นเฉพาะการ์ดสรุปมาตรฐาน
วิธีแก้:
-
อยู่ที่ Check-In
-
ยืนยันว่าการเชื่อมต่อ PMS ยังใช้งานอยู่
-
รีเฟรชหน้าเมื่อ sync เสร็จ
-
หากช่วงวันที่มีงานเยอะ ให้รีเฟรชอีกครั้งหลังผ่านไปไม่กี่นาที
✓ หาก PMS ของคุณรองรับ reservation coverage จะมี Eligible Check-In Units และ AVA Check-In Share แสดงหลัง Completion Rate
การ์ด coverage ยังดูไม่เปลี่ยน
สิ่งที่เห็น: Eligible Check-In Units หรือ AVA Check-In Share ยังดูเหมือนเดิมหลังรีเฟรช
วิธีแก้:
- รอหนึ่งนาที
- รีเฟรชแท็บ Analytics อีกครั้ง
- ยืนยันว่าช่วงวันที่ตรงกับอัปเดต PMS ที่คุณคาดไว้
- หากยังดูผิด ให้ตรวจว่า PMS sync เสร็จแล้ว
คัดลอก MCP config ไม่สำเร็จ
สิ่งที่เห็น: ปุ่มแสดงข้อผิดพลาดหลังคลิก Copy Codex MCP Config หรือ Copy Claude MCP Config
วิธีแก้:
- อยู่ที่แท็บ Analytics
- ลองปุ่มคัดลอกอีกครั้ง
- รีเฟรชหน้าแล้วลองใหม่หากคำขอโทเคนหมดเวลา
- หากข้อผิดพลาดยังอยู่ ให้ติดต่อฝ่ายสนับสนุนพร้อมข้อความที่แน่นอน
คัดลอก config แล้ว แต่ไคลเอนต์เชื่อมต่อไม่ได้
สิ่งที่เห็น: modal เปิดขึ้น แต่ Codex หรือ Claude ไม่โหลด Streamliner server
วิธีแก้:
- ตรวจว่าคุณวาง config ลงในไฟล์ที่ถูกต้อง
- ยืนยันว่าค่า
STREAMLINER_MCP_TOKENยังอยู่ - รีสตาร์ตไคลเอนต์ให้สนิท
- คัดลอก config ใหม่หากการตั้งค่านานเกินไป
เครื่องมือ Settings หายไป
สิ่งที่เห็น: ไคลเอนต์เชื่อมต่อได้ แต่ไม่เห็นคำสั่ง settings
วิธีแก้:
- คัดลอก config ใหม่จาก Analytics
- รีสตาร์ตไคลเอนต์ให้สนิท
- ยืนยันว่าค่า
STREAMLINER_MCP_TOKENที่วางไว้เป็นค่าล่าสุด - ลบบล็อก config Streamliner เก่าออกหากยังอยู่
การเขียนค่า Settings หมดเวลา
สิ่งที่เห็น: การบันทึก settings ดูเหมือนค้าง แล้วกลับมาพร้อมข้อความ timeout หรือ cancel
วิธีแก้:
-
คัดลอก config ใหม่จาก Analytics
-
รีสตาร์ตไคลเอนต์ให้สนิท
-
ลองเปลี่ยน settings อีกครั้ง
-
หากล้มเหลวอีก ให้ตรวจว่า token หรือ session หมดอายุหรือไม่
✓ การอัปเดต settings ที่ถูกต้องควรจบลงได้ ไม่ใช่ค้าง
Authentication ล้มเหลวตอนเขียน Settings
สิ่งที่เห็น: คุณได้ authentication error ตอนบันทึก merchant settings
วิธีแก้:
-
คัดลอก config ใหม่จาก Analytics
-
รีสตาร์ตไคลเอนต์ให้สนิท
-
ลองเปลี่ยน settings อีกครั้งในโรงแรมเดิม
-
หากคุณสลับโรงแรม ให้รีเฟรช config หลังสลับ
✓ ข้อผิดพลาดใหม่ควรบอกให้คุณสร้าง MCP config/token ใหม่
ปุ่ม Download report หายไป
สิ่งที่เห็น: คุณคาดว่าจะเห็นปุ่ม Download report แต่ไม่มีปุ่มนั้น
วิธีแก้:
- นี่คือพฤติกรรมปกติของแท็บ Analytics เวอร์ชันปัจจุบัน
- ใช้กราฟและตัวกรองช่วงวันที่บนหน้าจอแทน
- ติดต่อฝ่ายสนับสนุนหากคุณต้องการเส้นทาง export แบบอื่น
ยังติดปัญหาอยู่?
ติดต่อ success@vouch-technologies.com หาก:
- ❌ Analytics แสดงข้อมูลใน Status แต่ Analytics ว่าง
- ❌ กราฟไม่อัปเดตหลังเปลี่ยนช่วงวันที่
- ❌ รายการ Issues แสดงเวลาผิด
ข้อมูลที่ควรแนบ:
- ช่วงวันที่ที่คุณเลือก
- ภาพหน้าจอของแท็บ Analytics
- หมายเลขยืนยันของการจองตัวอย่าง