ข้ามไปยังเนื้อหาหลัก

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

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

Most hotels review Completion Rate, Biggest Drop‑Off, and Issues in under 3 minutes.

คู่มือนี้อธิบายวิธีที่ AVA calculates each Analytics chart in Command Center. นอกจากนี้ยังอธิบาย check-in and check-out coverage cards and STB EVA export.

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

โหลด Analytics ได้เร็วขึ้น

AVA now reads this tab from daily rollups for faster wide date ranges. If rollup data is missing or a rollup call fails, AVA falls back to the live path.

ช่วงวันที่ขนาดใหญ่ใช้เวลาโหลดนานขึ้น

ช่วงวันที่ขนาดใหญ่ยังอาจใช้เวลาโหลดนานกว่าเดิม ที่พักที่มีการใช้งานสูงอาจได้รับ error ช่วงวันที่แคบเร็วขึ้นแทนที่จะค้าง การทำงานนี้ใช้เฉพาะแท็บ Analytics

เซสชันเดโม

เช็กอินเดโมยังแสดงใน Status and reservation details. แต่จะไม่นับใน Analytics totals, drop-offs, time analysis, issues, or recent activity.

ไม่มีการดาวน์โหลดรายงาน

กราฟหลักของ Analytics ไม่มีการดาวน์โหลด PDF ผ่านเบราว์เซอร์ Funnel reservation lists include a Download CSV action for the displayed reservations. When the STB EVA submissions panel appears, you can use its download icon to export CSV. That export now uses the same EVA submission log source as the dashboard counts.

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

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

This takes under 1 minute. The token is short-lived and uses your current browser session.

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

Buttonสิ่งที่คัดลอกเหมาะกับ
Copy Codex MCP ConfigMCP config แบบ TOML ที่มี mcp_servers.streamlinerCodex
Copy Claude MCP ConfigMCP config แบบ JSON ที่มี mcpServers.streamlinerClaude Code or Claude Desktop

  1. Go to Main Menu → Command Center → Analytics.

  2. Click Copy Codex MCP Config or Copy Claude MCP Config.

  3. Wait for the button to change to Creating MCP token....

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

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

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

    ✓ Claude config ใช้ JSON ✓ Codex config ใช้ TOML ✓ Both configs include a short-lived STREAMLINER_MCP_TOKEN.

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

If you copied a token before this change, copy a fresh config. Older tokens keep their previous scope until you renew them.

ตำแหน่งวางของแต่ละ config

Codex uses ~/.codex/config.toml.

Claude uses Claude Desktop Developer config, usually claude_desktop_config.json.

สิ่งที่โมดัลแสดง​

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

หากใช้ Codex

  1. เปิด ~/.codex/config.toml on the machine where you run Codex.

  2. Paste the copied TOML block at the top level of the file.

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

    ✓ If mcp_servers.streamliner already exists, replace that section.

หากใช้ Claude Desktop

  1. เปิด Claude Desktop.

  2. Go to Settings → Developer → Edit Config.

  3. Paste the copied JSON into claude_desktop_config.json.

  4. Save the file, then fully quit and reopen Claude Desktop.

    ✓ On macOS, the file is usually under ~/Library/Application Support/Claude/. ✓ If mcpServers already exists, merge only the streamliner entry.

สรุปอ้างอิง​

มุมมองสิ่งที่นับเป็น sessionกฎการจบ
Pre‑ArrivalAny reservation with Pre‑Arrival activity, including abandoned attempts and journeys that later complete check-inPRE_ARRIVAL succeeds
Check‑In → AllAny reservation with check-in flow steps, including KEY_ENCODED, excluding pre-arrival-onlyCHECKIN, KEY_COLLECTION, or GET_DOOR_LOCK_KEY
Check‑In → Early Check‑InEARLY_CHECKIN_ATTEMPT or ROOM_ASSIGNMENT_QUEUEDEARLY_CHECKIN_ATTEMPT or ROOM_ASSIGNMENT_QUEUED succeeds
Check‑In → Pre‑RegistrationAny reservation with Pre‑Registration stepsPRE_REGISTRATION succeeds
Check‑In → Full Check‑InCHECKIN, KEY_COLLECTION, GET_DOOR_LOCK_KEY, or KEY_ENCODEDCHECKIN, KEY_COLLECTION, or GET_DOOR_LOCK_KEY succeeds
Check‑OutAny reservation with checkout stepsCHECKOUT or COMPLETED_CHECKOUT_PAYMENT succeeds

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

Check-In/Out Analytics Dashboard

  1. Go to Main Menu → Command Center.

  2. เลือก the Analytics tab.

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

  4. หากเลือก Check‑In, use the sub‑tabs: All Check‑Ins, Early Check‑In, Pre‑Registration, or Full Check‑In.

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

ใช้ช่วงวันที่ตามเวลาท้องถิ่นของโรงแรม​

Analytics uses your hotel's configured timezone when it reads the selected date range. It filters sessions by check-in and check-out activity timestamps, not reservation update times. Only steps inside that local window contribute to the selected day's charts and completion results. A later reservation update cannot add older or future completion steps to that day's analytics. The Successful Check‑Outs card is the exception: it uses the terminal event's completion date.

Compare local operating days

เลือก dates using the hotel's calendar day, even when you review Analytics from another timezone.

AVA สร้าง session อย่างไร​

  • A session is one reservation check-in record (not each guest).
  • session จะถูกนับเมื่อมีอย่างน้อยหนึ่งขั้นตอนจากมุมมองนั้นถูกบันทึก
  • session ที่ติดแท็กเป็น demo จะไม่ถูกนับในกราฟ Analytics เหล่านี้
  • ขั้นตอนที่ล้มเหลวยังถูกนับรวมในยอด เพื่อให้เห็นจุดหลุดและปัญหา
Pre‑Arrival แยกต่างหาก

Sessions that only reach Pre‑Arrival are not included in All Check‑Ins. ใช้ Pre‑Arrival view for those sessions. If a guest completes pre-arrival, then completes check-in on a device, AVA includes that session in both views. An abandoned Pre‑Arrival attempt still appears in the Pre‑Arrival view after the guest starts the flow.

เมื่อผู้เข้าพักดำเนินการต่อหลัง pre-arrival​

The Pre‑Arrival view is a membership cohort, not an exclusive category. A session can belong to Pre‑Arrival and a Check‑In cohort. A session qualifies after Pre‑Arrival activity begins, even if the guest abandons the flow. Reaching PRE_ARRIVAL marks the session as complete. Opening a pre-arrival link without recorded flow activity does not qualify the session. An observed full check-in milestone still keeps that session in the correct Check‑In totals.

Guest activityAnalytics view
Guest opens the link without recorded flow activityNot included in Pre‑Arrival
Guest starts Pre‑Arrival but abandons itPre‑Arrival, incomplete
Guest completes pre-arrival onlyPre‑Arrival, complete
Guest completes pre-arrival, then completes device check-inPre‑Arrival and Check‑In

วิธีนี้ทำให้ mixed journeys visible in both relevant cohorts. Pure pre-arrival journeys remain excluded from All Check‑Ins.

For Pre‑Arrival, Total Logs counts every session with recorded activity. Completion Rate counts sessions that reach PRE_ARRIVAL. ตัวอย่างเช่น three attempts with two completions show a 66.7% completion rate. An abandoned attempt therefore lowers the rate and reveals flow drop-off.

Historical rollups

Previously saved daily rollups can retain completion-based Pre‑Arrival counts until AVA recomputes them. Newly computed rollups include abandoned attempts in the denominator.

เมื่อการเข้ารหัสคีย์เป็นขั้นตอนสุดท้ายที่บันทึกไว้​

AVA treats KEY_ENCODED as a Full Check-In classification signal. This applies even when the session has no KEY_COLLECTION or KEY_RETRIEVED step. The session appears in Full Check-In and All Check-Ins.

KEY_ENCODED does not count as a completion milestone for Completion Rate. The session can therefore increase the Full Check-In total without increasing completed sessions.

Completion rates can change

Properties using keycard encoding may see a slightly lower Full Check-In completion rate. This happens when sessions end at KEY_ENCODED without another completion milestone.

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

Cardวิธีคำนวณ
Total LogsNumber of non-demo sessions in the selected view
Completion RateCompleted sessions ÷ total non-demo logs, using the selected view's completion rule
Avg Completion TimeTime from the first successful step (usually Entry) to the configured completion signal
Successful Check‑InsDistinct sessions with a successful PMS CHECKIN milestone
Successful Check‑OutsDistinct checkout sessions with a successful terminal event, attributed to the completion date

The กฎการจบ column controls Completion Rate and Avg Completion Time. ไม่ได้กำหนด Successful Check‑Ins.

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

Successful Check-Outs ใช้วันที่เสร็จสมบูรณ์​

The Successful Check‑Outs card counts each unique checkout that reaches a successful terminal event. AVA attributes the count to the hotel's local calendar date when checkout succeeds. Checkout attempts, funnel stages, Completion Rate, and Avg Completion Time keep their start-date attribution.

ตัวอย่างเช่น a checkout that starts Monday and succeeds Tuesday appears in Tuesday's Successful Check‑Outs. Its attempt and funnel activity remains in Monday's checkout analytics.

วิธีนี้ทำให้ successful departures aligned with the day they completed.

ตัวอย่าง

If Total Logs is 40 and 28 sessions reach the configured completion signal, the completion rate is 70%. Successful Check‑Ins may show a different number because it counts successful PMS check-in milestones.

แยกการเช็กอิน PMS ออกจากการเสร็จสมบูรณ์ของ journey​

Successful Check‑Ins confirms that AVA completed the PMS CHECKIN request. For OPERA, this is when AVA sends the SCI code to the PMS. AVA counts the milestone only when recorded Check-In evidence is SUCCESS or PARTIAL. Pending or failed legacy milestone data does not count as a successful PMS check-in. AVA excludes checkout-only journeys when event evidence shows no Check-In activity. This prevents a legacy CHECKIN marker on a completed checkout from inflating the count. If a guest completed Check-In before Checkout, AVA keeps that successful Check-In count.

Completion Rate and Avg Completion Time continue using the configured terminal or room-access signals. วิธีนี้ทำให้ journey performance separate from the PMS milestone.

สิ่งที่เกิดขึ้นSuccessful Check‑InsCompletion metrics
PMS CHECKIN succeeds, then keycard encoding failsCounts the PMS check-inMay show an incomplete journey or failure
Only a pending or failed legacy CHECKIN marker remainsDoes not countFollows the selected view's existing completion rule
Room assignment enters a queue without successful PMS CHECKINDoes not countFollows the selected view's existing completion rule
PMS CHECKIN and room access both succeedCounts the PMS check-inCounts as completed when the terminal signal succeeds

The card no longer combines queued, early, and key-collection categories into Successful Check‑Ins.

การ์ด coverage สำหรับเช็กอิน​

When AVA receives coverage data from your PMS, you may see two extra cards after Completion Rate. This works for AVA PMS, Cloudbeds, Opera, Mews, and eZee.

CardWhat it showsWhy it matters
Eligible Check-In UnitsDistinct confirmation or sub-reservation units in the selected periodThis is the coverage denominator
AVA Check-In SharePercentage of eligible units with durable AVA check-in activityThis shows AVA adoption for arrivals in that period
Coverage ใช้วันที่เข้าพัก

Coverage uses each reservation's arrival date in your hotel's timezone. Guests who finish pre-arrival check-in early still count when they arrive in range. The funnel uses activity dates, so these measures answer different questions.

Units vs reservations

These cards count units, not whole reservations. A multi-room booking can add more than one eligible unit.

How AVA decides eligibility

AVA counts only reservations with AVA activity, a valid merchant-local arrival date, and an eligible status. For AVA activity, eligible statuses are RESERVED, CHECKED_IN, CHECKED_OUT, and DUE_OUT. DUE_OUT counts because the reservation already reached check-in before departure. For OPERA, AVA also folds DueOut into the CHECKED_IN PMS coverage bucket. วิธีนี้ทำให้ departure-day and day-use arrivals in the coverage denominator. If AVA cannot verify the required fields, it hides the coverage cards instead of showing a misleading percentage.

OPERA reservations

If your PMS is OPERA, AVA ignores PM, PF, and PX pseudo rooms in the eligible unit count. It also uses top-level room type fields when room rows are sparse, so real guest rooms still count correctly.

OPERA reservation families

AVA also dedupes linked OPERA reservation families by parent confirmation. That keeps terminal sibling rows from inflating Eligible Check-In Units.

OPERA checked-out coverage

If your selected date range includes today before night audit, future-arrival Checked Out legs count as zero. AVA uses the property's business date for that short-circuit, so the coverage read stays fast and consistent.

When the arrival cohort is unavailable

AVA first uses a narrow coverage result for arrivals in your selected date range. If that result is unavailable, incomplete, or still rolling out, AVA uses arrival-filtered logs. If those logs are unavailable, AVA may use an activity-based session map. That fallback can understate coverage for narrow date ranges. An empty result is a valid zero, not missing data. If no source is available, the coverage cards stay hidden.

AVA counts each processed reservation once. It uses the arrival-keyed cohort for normal coverage results. The selected range uses your hotel timezone for arrival-date comparisons. Search-only reservation lookups and PMS or front-desk sync steps do not credit the AVA numerator. If the numerator would exceed the denominator, AVA withholds the share card instead of clamping it. วิธีนี้ทำให้ AVA Check-In Share aligned with reservation coverage.

Fresh results may lag briefly

If you refresh the same date range again, AVA may reuse the last coverage result for a short time. วิธีนี้ทำให้ the Analytics tab fast during repeated checks.

Corrected historical coverage

After a coverage rule update, AVA refreshes older saved coverage results before reusing them. Short date ranges can show corrected cards first. Longer ranges may use live coverage until the scheduled refresh finishes.

Check-In Share Looks Wrong​

สิ่งที่เห็น: AVA Check-In Share is missing, or it looks higher than expected.

วิธีแก้:

  1. รีเฟรช Analytics tab.
  2. ยืนยัน date range matches your PMS report.
  3. Check that the range uses your hotel timezone.
  4. Confirm your PMS is sending arrival dates and reservation statuses.
  5. หากยังดูผิด, contact support with a screenshot.

If you do not see these cards, your PMS data may be missing the fields AVA needs. Unsupported PMS providers do not show these cards.

การ์ด coverage สำหรับเช็กเอาต์​

AVA shows checkout coverage only when your PMS provides a complete departure-scoped cohort. You may see two cards in the Check-Out view. These cards measure AVA checkout activity separately from check-in activity.

CardWhat it showsWhy it matters
Eligible Check-Out UnitsDistinct confirmation or sub-reservation units departing in the selected periodThis is the checkout coverage denominator
AVA Check-Out SharePercentage of eligible units with durable AVA checkout activityThis shows AVA adoption for departures in that period
Coverage ใช้วันที่ออก

Checkout coverage uses each reservation's departure date in your hotel's timezone. Check-in coverage uses arrival dates, so the two cards can cover different units. The checkout numerator credits durable AVA checkout activity only. Search-only lookups and PMS or front-desk sync steps do not count.

Check-out coverage by PMS​

Cloudbeds, Mews, and OPERA provide native departure cohorts for checkout coverage. AVA does not relabel arrival coverage as checkout coverage. Unsupported PMS adapters may show Unavailable instead of a percentage. For OPERA, incomplete reservation pagination also shows Unavailable. AVA does not calculate a percentage from partial departure data.

Check-out coverage is unavailable​

สิ่งที่เห็น: The checkout coverage card shows Unavailable instead of a percentage.

สาเหตุ: AVA cannot verify complete, departure-scoped coverage data. The PMS may not support departure cohorts, or an OPERA reservation page may be incomplete. It hides the rate rather than showing a misleading result.

วิธีแก้:

  1. Confirm you selected Check-Out and the correct date range.

  2. รีเฟรช Analytics tab after PMS sync finishes.

  3. Try the same range again after a few minutes.

  4. ติดต่อฝ่ายสนับสนุน if the card remains unavailable.

    ✓ An unavailable card means the result cannot be trusted yet. It is not a zero.

Export STB EVA submissions CSV​

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

This takes under 1 minute. The export appears only on Check-In when EVA is enabled.

ใช้ small download icon on the STB EVA submissions panel to export the selected date range.

ItemWhat it showsWhat you can do
STB EVA submissionsAttempted, successful, and failed EVA submissions for the selected periodClick the download icon to download the CSV
CSV contentsSummary counts plus one row per EVA API attempt from eva_submission_logsUse it for STB reporting or audit review

  1. เปิด Main Menu → Command Center.

  2. เลือก the Analytics tab.

  3. Keep the Check-In view selected.

  4. Scroll to STB EVA submissions.

  5. Click the download icon.

  6. Save the downloaded stb-eva-submissions.csv file.

    ✓ The file includes transaction IDs, result codes, reservation and check-in IDs, error metadata, and sanitized request details. ✓ Passport and document numbers are masked. ✓ MRZ and base64 fields are omitted. ✓ The export no longer includes legacy reservation rows from older EVA reports. ✓ If the download fails, AVA shows a local error message in the panel.

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

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

  • Drop‑off compares each step to the step before it.
  • Avg Stage Duration measures time spent inside the stage, from stage start to stage success.
  • Avg Time to Next Step measures time from one successful step to the next.
  • The Slowest Step card uses stage duration first.
  • If AVA does not have stage timing, it falls back to the next-step duration.
  • If a later step happens earlier than the prior step, the duration is shown as 0.

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

ตัวอย่าง

If Document Upload has 60 sessions and the prior step has 100, drop‑off is 40%. If Document Upload itself takes 20 seconds, Avg Stage Duration is 20 seconds. If Document Upload completes at 10:05 and Validation at 10:07, Avg Time to Next Step is 2 minutes.

Checkout conversion uses required milestones​

In Check‑Out, AVA calculates conversion from the required checkout milestones.

StageHow AVA treats it
Checkout StartedRequired starting milestone from FETCH_CHECKOUT
Bill ReviewedOptional activity when a guest views the bill
Charges ConfirmedOptional activity when a guest confirms charges
Checkout PaymentOptional activity when payment is collected
Checkout CompleteRequired final milestone from CHECKOUT

A guest can move directly from Checkout Started to Checkout Complete. AVA counts that path as completed instead of showing a false drop‑off.

Observed optional stages appear in Optional checkout activity. They do not lower conversion or create a red loss transition. The dashboard and downloadable analytics report use the same stage rules.

AVA shows Checkout Payment when it observes checkout payment activity. It keeps payment outside the required funnel, even when a saved setting is stale. It does not label missing payment as not required or treat it as a failure.

Direct PMS checkouts look like drop-offs​

สิ่งที่เห็น: A guest completed checkout in the PMS, but skipped bill or payment stages.

วิธีแก้:

  1. เลือก Check‑Out in Command Center → Analytics.

  2. Find Checkout Complete as the final required stage.

  3. Review Optional checkout activity for bill, charge, or payment events.

  4. Compare the dashboard with the downloadable report if you need a saved copy.

    ✓ Direct PMS checkouts count toward final conversion.

มุมมอง reservations from required-step drop-offs​

Required checkout drop-offs can include a มุมมอง list action. Use it to find reservations that reached one required stage but missed the next.

  1. เลือก Check‑Out in Command Center → Analytics.
  2. Find a required-stage transition with a drop-off count.
  3. Click มุมมอง list.
  4. Review the confirmation number, guest name, room, and latest failure details.
  5. Click Download CSV to save the displayed reservations.

AVA shows มุมมอง list only when every matched session equals the displayed drop-off count. If the reservation mapping is incomplete, AVA hides the action for that transition.

Review failed checkout payments​

Payment appears under Optional checkout activity when AVA observes checkout payment activity. It can appear even when a saved payment setting is stale. Payment activity never changes checkout completion or required-stage conversion.

  1. เลือก Check‑Out in Command Center → Analytics.
  2. Find Payment under Optional checkout activity.
  3. Click มุมมอง failed reservations when failed payments are listed.
  4. Review the reservation details and failure message.
  5. Click Download CSV to save the displayed failures.

The CSV includes Confirmation number, Guest name, Room, Failure step, and Failure message. AVA shows มุมมอง failed reservations only when every failed payment maps to a session.

Successful Check-Outs appears on another day​

สิ่งที่เห็น: A checkout started on one day, but Successful Check‑Outs increases on another day.

วิธีแก้:

  1. Check when the terminal checkout event succeeded.

  2. Compare that timestamp with your hotel's local calendar date.

  3. Review the checkout start date when comparing attempts or funnel stages.

  4. รีเฟรช Analytics tab if the checkout completed recently.

    ✓ This is expected when checkout crosses midnight or completes after a delay.

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

Time Analysis groups sessions by the first successful step in the selected view.

  • Hour buckets use UTC.
  • The analytics response labels this with timezone: UTC.
  • Check your hotel's timezone before comparing peaks with local staffing.
  • Pre‑Arrival requires a successful PRE_ARRIVAL step.
  • Shows Peak Hours and Rush Periods to help with staffing.

Use Peak Hours to plan coverage for your busiest time blocks.

ตัวอย่าง

A session that first succeeds at 7:10 local time counts in the 07:00 hour.

Issues (ความล้มเหลวล่าสุด)​

Issues list sessions with the most recent failed steps.

  • AVA checks the last 10 events for failures.
  • If no recent failures exist, it uses the most recent failure on record.

Use มุมมอง Details to see full step history.

ตัวอย่าง

If a payment failed at 3:12 after earlier success, the issue shows Payment at 3:12. If the last 10 events are successful, AVA shows the most recent failure on record.

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

กิจกรรมล่าสุด shows key steps that were successful or failed, such as:

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

This list is capped to the latest 30 items.

Use this list to confirm which steps were completed most recently.

ตัวอย่าง

You may see “Check‑In completed successfully” or a failure message for Identity Verification.

การกระจายขั้นตอนสุดท้าย (จุดที่ session จบ)​

This chart groups the last step of each session into categories:

  • Success — Full completion steps
  • Timing — Early check‑in steps (including Room Queued)
  • Partial — Pre‑registration
  • Room — Room assignment steps (Room Assignment)
  • Documentation — Document or ID verification
  • Payment — Payment steps
  • Early — Entry / Fetch steps

If a failure happens after the last success, the failure step becomes the final step.

Use this chart to see the most common stopping points.

ตัวอย่าง

Out of 50 sessions, 20 end at Check‑In (success), 10 at Early Check‑In (timing), 8 at Document Upload (documentation), and 12 at Payment (payment).

เปิด sessions from the Final Step Distribution​

  1. เลือก a bar segment in Final Step Distribution.

  2. Review the session list that opens.

    ✓ The list shows confirmation number, guest, room, and the latest failure.

  3. เลือก เปิด details on any session.

    ✓ The Reservation Details panel opens for that session.

Session lists vs reservations

The list shows sessions, not grouped reservations. Use it to spot repeat failures fast.

Device Analytics (ตัวเลือกเสริม)​

Device Analytics uses the device details from the check‑in/out session.

If guests did not provide device information, this chart may be empty.

Use this view to compare kiosk vs mobile usage by OS.

ตัวอย่าง

If most sessions are iOS, you may want to optimize the mobile check‑in flow.

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

  • Analytics รองรับไม่เกิน 90 days per query.
  • When daily rollups are available, wide ranges load from rollup data first.
  • Very busy properties may need a smaller range if the result set is too large.
  • หาก AVA ขอให้ลดช่วงวันที่ ให้ลดระยะเวลาแล้วลองอีกครั้ง
  • Session lists are capped for performance (about 200 per step and 2,000 total).

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

All charts show zero​

สิ่งที่เห็น: การ์ดสรุป show 0 and charts are empty.

วิธีแก้:

  1. Expand the date range.
  2. ยืนยันre are logs in Status.
  3. Check if your plan includes Analytics.

Completion rate looks lower than expected​

สิ่งที่เห็น: Completion rate is low even though many guests checked in.

Check:

  • Demo check-ins are excluded, so test sessions do not raise Total Logs.
  • Pre-arrival-only sessions do not count toward All Check‑Ins.
  • A session that completes pre-arrival and later completes check-in appears in both relevant views.
  • A session that starts Pre‑Arrival but abandons it qualifies for Pre‑Arrival and lowers its completion rate.
  • A session that only opens a pre-arrival link does not qualify without recorded flow activity.
  • All Check‑Ins only treats CHECKIN, KEY_COLLECTION, or GET_DOOR_LOCK_KEY as completed.
  • KEY_ENCODED places a session in Full Check‑In, but does not complete it.
  • Early Check‑In and Pre‑Registration are tracked in their own sub‑tabs.
  • Successful Check‑Ins counts successful PMS CHECKIN milestones.
  • Checkout-only records with a legacy CHECKIN marker do not count without Check-In activity evidence.
  • It can differ from Completion Rate when room access is a required terminal signal.

Coverage cards are missing​

สิ่งที่เห็น: You only see the standard summary cards.

วิธีแก้:

  1. Stay on Check-In.

  2. Confirm your PMS connection is active.

  3. รีเฟรช page after sync finishes.

  4. If the date range is busy, refresh again after a few minutes.

    ✓ If your PMS supports reservation coverage, Eligible Check-In Units and AVA Check-In Share appear after Completion Rate.

Coverage cards still look unchanged​

สิ่งที่เห็น: Eligible Check-In Units or AVA Check-In Share still looks the same after a refresh.

วิธีแก้:

  1. Wait a minute.
  2. รีเฟรช Analytics tab again.
  3. ยืนยัน date range matches the PMS update you expect.
  4. หากยังดูผิด, check that PMS sync has finished.

Time Analysis uses the wrong local hour​

สิ่งที่เห็น: Peak hours do not match your hotel's local time.

วิธีแก้:

  1. Check the analytics response's timeAnalysis.timezone value.
  2. Treat UTC buckets as UTC, not hotel-local time.
  3. Use merchantTimezone to convert the buckets for local staffing.
  4. Verify your hotel timezone at Settings → Essentials → Hotel Basic Details.

Analytics keeps loading or asks you to narrow the range​

สิ่งที่เห็น: The Analytics tab spins for a long time, shows a timeout, or asks you to narrow the date range.

สาเหตุ: Larger ranges need more time to process. Very busy properties can also hit request limits sooner.

วิธีแก้:

  1. Wait up to 2 minutes for the request to finish.

  2. Try a smaller date range if the page still times out or asks you to narrow the range.

  3. รีเฟรช Analytics tab and retry.

  4. If small date ranges still fail, contact support with the selected dates.

    ✓ Smaller ranges should finish faster and help you confirm whether the issue is range size or data availability.

Analytics shows a step from another day​

สิ่งที่เห็น: A selected day appears to include a completion from another calendar day.

วิธีแก้:

  1. ยืนยัน hotel's timezone at Settings → Essentials → Hotel Basic Details.
  2. Re-select the date range using the hotel's local calendar day.
  3. รีเฟรช Analytics tab.
  4. If the result still looks wrong, contact support with the selected dates and reservation number.

MCP config copy fails​

สิ่งที่เห็น: The button shows an error after you click Copy Codex MCP Config or Copy Claude MCP Config.

วิธีแก้:

  1. Stay on the Analytics tab.
  2. Try the copy button again.
  3. รีเฟรช page and retry if the token request timed out.
  4. If the error stays, contact support with the exact message.

Config copied, but the client cannot connect​

สิ่งที่เห็น: The modal opens, but Codex or Claude does not load the Streamliner server.

วิธีแก้:

  1. Check that you pasted the config into the correct file.
  2. ยืนยัน STREAMLINER_MCP_TOKEN value is still present.
  3. Restart the client completely.
  4. Copy a fresh config if setup took too long.

Settings tools are missing​

สิ่งที่เห็น: Your client connects, but settings actions do not appear.

วิธีแก้:

  1. Copy a fresh config from Analytics.
  2. Restart the client completely.
  3. ยืนยัน pasted STREAMLINER_MCP_TOKEN is the latest one.
  4. Remove any older Streamliner config block if it is still present.

Settings writes time out​

สิ่งที่เห็น: A settings save looks stuck, then returns a timeout or cancel message.

วิธีแก้:

  1. Copy a fresh config from Analytics.

  2. Restart the client completely.

  3. Try the settings change again.

  4. If it fails again, check whether your token or session expired.

    ✓ Valid settings updates should finish instead of hanging.

Authentication failed on a settings write​

สิ่งที่เห็น: You get an authentication error when saving merchant settings.

วิธีแก้:

  1. Copy a fresh config from Analytics.

  2. Restart the client completely.

  3. Retry the settings change in the same hotel.

  4. If you switched hotels, refresh the config after the switch.

    ✓ The new error should tell you to generate a fresh MCP config/token.

Browser PDF download is still missing​

สิ่งที่เห็น: You expect a Download report button for the full analytics charts.

วิธีแก้:

  1. This is expected in the current Analytics tab.
  2. ใช้ charts and date range filters on screen.
  3. ใช้ download icon for STB EVA submissions if you need submission details.
  4. ติดต่อฝ่ายสนับสนุน if you need a different export path.

STB EVA export is missing​

สิ่งที่เห็น: You do not see the download icon under STB EVA submissions.

วิธีแก้:

  1. Switch to Check-In.
  2. Confirm EVA is enabled for Singapore in Settings → Check-in → Government Integration.
  3. รีเฟรช page after the analytics data loads.
  4. If the panel is still hidden, the selected date range may not include EVA submissions.

CSV export fails​

สิ่งที่เห็น: You click the download icon, but no file downloads.

วิธีแก้:

  1. Retry after the analytics summary finishes loading.
  2. Narrow the date range.
  3. Check that your browser allows downloads.
  4. Try again once the local error clears.
  5. ติดต่อฝ่ายสนับสนุน if the export still fails.

Funnel reservation list is missing​

สิ่งที่เห็น: A required drop-off or failed payment has no list action.

วิธีแก้:

  1. Confirm you selected Check‑Out and the correct date range.
  2. Check that the transition has a non-zero drop-off or failed-payment count.
  3. รีเฟรช Analytics tab after the data finishes loading.
  4. If mapping remains incomplete, use Status to search for the reservation.

AVA hides list actions when it cannot safely match every displayed count.

ยังติดขัดอยู่ใช่ไหม​

ติดต่อ success@vouch-technologies.com if:

  • ❌ Analytics shows data in Status but Analytics is empty
  • ❌ Charts never update after changing the date range
  • ❌ Issues list shows incorrect timestamps

Helpful to include:

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