Pahami Analytics Command Center

Penyiapan Cepat

Sebagian besar hotel meninjau Completion Rate, Biggest Drop‑Off, dan Issues dalam waktu kurang dari 3 menit.

Panduan ini menjelaskan bagaimana AVA menghitung setiap grafik Analytics di Command Center. Panduan ini juga menjelaskan kartu tambahan cakupan check-in dan ekspor STB EVA yang mungkin Anda lihat.

Buka: Main Menu → Command Center → Analytics

Analytics memuat lebih cepat

AVA kini membaca tab ini dari daily rollup agar rentang tanggal lebar lebih cepat dimuat. Jika data rollup hilang atau panggilan rollup gagal, AVA kembali ke jalur live.

Waktu muat lebih lama untuk rentang tanggal besar

Rentang tanggal besar masih bisa memerlukan waktu lebih lama untuk dimuat. Properti yang sangat sibuk mungkin lebih cepat menampilkan error rentang tanggal sempit daripada terus menunggu. Ini hanya berlaku untuk tab Analytics.

Sesi demo

Check-in demo tetap muncul di Status dan detail reservasi. Namun sesi itu tidak dihitung dalam total Analytics, drop-off, analisis waktu, issues, atau recent activity.

Tidak ada unduhan laporan

Chart Analytics utama tidak menyertakan unduhan PDF dari browser. Saat panel STB EVA submissions muncul, Anda bisa memakai ikon unduhnya untuk mengekspor CSV.

---

Salin Konfigurasi MCP untuk Codex atau Claude

Penyiapan Cepat

Ini memakan waktu kurang dari 1 menit. Token bersifat sementara dan memakai sesi browser Anda saat ini.

Gunakan tombol ini saat Anda ingin mengirim data Analytics ke AI client. Token yang disalin juga menyertakan cakupan penuh Streamliner MCP. Client yang didukung bisa memakai tool settings setelah Anda restart. Setelah Anda menyalin, AVA menampilkan modal khusus client dengan instruksi paste.

Tombol	Yang disalin	Paling cocok untuk
Copy Codex MCP Config	Config MCP TOML dengan mcp_servers.streamliner	Codex
Copy Claude MCP Config	Config MCP JSON dengan mcpServers.streamliner	Claude Code atau Claude Desktop

1. Buka Main Menu → Command Center → Analytics.

2. Klik Copy Codex MCP Config atau Copy Claude MCP Config.

3. Tunggu sampai tombol berubah menjadi Creating MCP token....

4. Baca instruksi modal untuk client Anda.

5. Tempel config yang disalin ke file konfigurasi AI client Anda.

6. Restart client agar server MCP baru dimuat.

   ✓ Config Claude memakai JSON. ✓ Config Codex memakai TOML. ✓ Keduanya menyertakan STREAMLINER_MCP_TOKEN yang berlaku singkat.

Hanya token baru

Jika Anda menyalin token sebelum perubahan ini, salin config baru. Token lama mempertahankan cakupan sebelumnya sampai Anda memperbaruinya.

Tempat menempel masing-masing config

Codex memakai ~/.codex/config.toml.

Claude memakai config Claude Desktop Developer, biasanya claude_desktop_config.json.

Yang ditampilkan modal

Modal mengonfirmasi bahwa Anda berhasil menyalin config. Lalu modal menampilkan file path, lokasi paste, dan langkah restart untuk client tersebut.

Jika Anda memakai Codex

1. Buka ~/.codex/config.toml di mesin tempat Anda menjalankan Codex.

2. Tempel blok TOML yang disalin di level teratas file.

3. Simpan file, lalu restart Codex.

   ✓ Jika mcp_servers.streamliner sudah ada, ganti bagian itu.

Jika Anda memakai Claude Desktop

1. Buka Claude Desktop.

2. Buka Settings → Developer → Edit Config.

3. Tempel JSON yang disalin ke claude_desktop_config.json.

4. Simpan file, lalu keluar sepenuhnya dan buka ulang Claude Desktop.

   ✓ Di macOS, file biasanya berada di ~/Library/Application Support/Claude/. ✓ Jika mcpServers sudah ada, gabungkan hanya entri streamliner.

Referensi Cepat

View	Apa yang dihitung sebagai session	Aturan completion
Pre‑Arrival	Setiap reservasi yang mencapai langkah Pre‑Arrival	PRE_ARRIVAL berhasil
Check‑In → All	Setiap reservasi dengan langkah alur check-in (termasuk early check-in atau pre-registration), tidak termasuk yang hanya pre-arrival	CHECKIN, KEY_COLLECTION, atau GET_DOOR_LOCK_KEY
Check‑In → Early Check‑In	EARLY_CHECKIN_ATTEMPT atau ROOM_ASSIGNMENT_QUEUED	EARLY_CHECKIN_ATTEMPT atau ROOM_ASSIGNMENT_QUEUED berhasil
Check‑In → Pre‑Registration	Setiap reservasi dengan langkah Pre‑Registration	PRE_REGISTRATION berhasil
Check‑In → Full Check‑In	CHECKIN, KEY_COLLECTION, atau GET_DOOR_LOCK_KEY	CHECKIN, KEY_COLLECTION, atau GET_DOOR_LOCK_KEY berhasil
Check‑Out	Setiap reservasi dengan langkah checkout	CHECKOUT atau COMPLETED_CHECKOUT_PAYMENT berhasil

---

Buka Analytics dan pilih view

1. Buka Main Menu → Command Center.

2. Pilih tab Analytics.

3. Pilih Pre‑Arrival, Check‑In, atau Check‑Out.

4. Jika Anda memilih Check‑In, gunakan sub-tab: All Check‑Ins, Early Check‑In, Pre‑Registration, atau Full Check‑In.

   ✓ Semua chart diperbarui sesuai view dan rentang tanggal itu.

---

Bagaimana AVA membangun session

• Session adalah satu record check-in reservasi, bukan per tamu.
• Session dihitung jika setidaknya satu langkah dari view itu dicatat.
• Sesi bertanda demo dikecualikan dari chart Analytics ini.
• Langkah yang gagal tetap dihitung dalam total agar Anda bisa melihat drop-off dan issue.

Pre‑Arrival terpisah

Session pre-arrival tidak termasuk dalam All Check‑Ins. Gunakan view Pre‑Arrival untuk itu.

Kartu ringkasan (bagian atas tab)

Kartu	Cara menghitungnya
Total Logs	Jumlah session non-demo pada view yang dipilih
Completion Rate	Session selesai ÷ total log non-demo
Avg Completion Time	Waktu dari langkah sukses pertama (biasanya Entry) sampai selesai
Successful Check‑Ins / Check‑Outs	Jumlah session selesai untuk view itu

Apa yang dihitung sebagai completion bergantung pada view (lihat tabel Referensi Cepat).

Gunakan tabel ini untuk memastikan session mana yang dihitung selesai sebelum Anda membandingkan periode.

Contoh

Jika Total Logs adalah 40 dan Successful Check‑Ins adalah 28, completion rate adalah 70%.

Kartu cakupan check-in

Saat AVA menerima data cakupan dari PMS Anda, Anda mungkin melihat dua kartu tambahan setelah Completion Rate. Ini berfungsi untuk AVA PMS, Cloudbeds, Opera, Mews, dan eZee.

Kartu	Yang ditampilkan	Mengapa penting
Eligible Check-In Units	Unit confirmation atau sub-reservation yang berbeda dalam periode yang dipilih	Ini adalah penyebut cakupan
AVA Check-In Share	Persentase unit eligible yang pernah diproses AVA setidaknya sekali	Ini menunjukkan adopsi AVA untuk periode itu

Unit vs reservasi

Kartu ini menghitung unit, bukan seluruh reservasi. Booking multi-room bisa menambah lebih dari satu unit eligible.

Reservasi OPERA

Jika PMS Anda adalah OPERA, AVA mengabaikan pseudo room PM, PF, dan PX dalam hitungan unit eligible. AVA juga memakai field room type level atas saat baris room jarang, sehingga room tamu nyata tetap dihitung dengan benar.

Keluarga reservasi OPERA

AVA juga meng-dedupe keluarga reservasi OPERA yang tertaut berdasarkan parent confirmation. Itu mencegah baris sibling terminal menggelembungkan Eligible Check-In Units.

Peta session yang terpotong

Jika AVA menandai sessionsMapMeta.truncated sebagai true, AVA mengabaikan peta parsial itu. Lalu AVA memakai log check-in penuh untuk kalkulasi share ketika tersedia. Jika AVA tidak bisa mendapatkan log lengkap, kartu cakupan disembunyikan.

AVA menghitung setiap reservasi yang diproses hanya sekali. AVA memakai session map saat peta itu lengkap. Jika session map hilang atau terpotong, AVA memakai identity log mentah sebagai gantinya. Ini menjaga AVA Check-In Share tetap selaras dengan cakupan reservasi. Nilainya seharusnya tetap pada atau di bawah 100%.

Hasil terbaru mungkin tertunda sebentar

Jika Anda menyegarkan rentang tanggal yang sama lagi, AVA mungkin memakai ulang hasil cakupan terakhir untuk sementara. Ini menjaga tab Analytics tetap cepat saat pemeriksaan berulang.

Check-In Share terlihat salah

Yang Anda lihat: AVA Check-In Share lebih tinggi dari yang diharapkan.

Perbaikan:

1. Segarkan tab Analytics.
2. Pastikan rentang tanggal cocok dengan laporan PMS Anda.
3. Periksa bahwa properti Anda memakai PMS yang didukung.
4. Jika masih terlihat salah, hubungi support dengan screenshot.

Jika Anda tidak melihat kartu ini, data PMS Anda saat ini mungkin belum menyertakan metrik cakupan unit. Provider PMS yang tidak didukung tidak menampilkan kartu ini.

Ekspor CSV pengiriman STB EVA

Penyiapan Cepat

Ini memakan waktu kurang dari 1 menit. Ekspor hanya muncul pada Check-In saat EVA diaktifkan.

Gunakan ikon unduh kecil pada panel STB EVA submissions untuk mengekspor rentang tanggal yang dipilih.

Item	Yang ditampilkan	Yang bisa Anda lakukan
STB EVA submissions	Pengiriman EVA yang dicoba, berhasil, dan gagal untuk periode yang dipilih	Klik ikon unduh untuk mengunduh CSV
CSV contents	Count ringkasan plus satu baris per percobaan API EVA	Gunakan untuk pelaporan STB atau review audit

1. Buka Main Menu → Command Center.

2. Pilih tab Analytics.

3. Tetap pilih view Check-In.

4. Gulir ke STB EVA submissions.

5. Klik ikon unduh.

6. Simpan file stb-eva-submissions.csv yang diunduh.

   ✓ File menyertakan transaction ID, result code, reservation dan check-in ID, metadata error, serta detail request yang sudah disanitasi. ✓ Nomor paspor dan nomor dokumen disamarkan. ✓ Field MRZ dan base64 dihilangkan. ✓ Jika unduhan gagal, AVA menampilkan pesan error lokal di panel.

---

Chart funnel (drop-off dan timing langkah)

Funnel menunjukkan persentase session yang mencapai setiap langkah.

• Drop-off membandingkan setiap langkah dengan langkah sebelumnya.
• Avg Stage Duration mengukur waktu yang dihabiskan di dalam stage, dari stage start sampai stage success.
• Avg Time to Next Step mengukur waktu dari satu langkah sukses ke langkah sukses berikutnya.
• Kartu Slowest Step memakai stage duration terlebih dahulu.
• Jika AVA tidak punya stage timing, AVA kembali ke durasi next-step.
• Jika langkah yang lebih akhir terjadi lebih awal dari langkah sebelumnya, durasinya ditampilkan sebagai 0.

Gunakan kartu Biggest Drop‑Off untuk memilih langkah yang perlu coaching terlebih dahulu.

Contoh

Jika Document Upload memiliki 60 session dan langkah sebelumnya 100, drop-off adalah 40%.

Jika Document Upload sendiri memakan 20 detik, Avg Stage Duration adalah 20 detik. Jika Document Upload selesai pada 10:05 dan Validation pada 10:07, Avg Time to Next Step adalah 2 menit. :::

---

Analisis Waktu (volume per jam)

Time Analysis mengelompokkan session berdasarkan langkah sukses pertama pada view yang dipilih.

• Menggunakan zona waktu hotel Anda.
• Pre‑Arrival memerlukan langkah PRE_ARRIVAL yang berhasil.
• Menampilkan Peak Hours dan Rush Periods untuk membantu penjadwalan staf.

Gunakan Peak Hours untuk merencanakan cakupan pada blok waktu tersibuk Anda.

Contoh

Session yang pertama kali sukses pada waktu lokal 7:10 dihitung dalam jam 07:00.

Issues (kegagalan terbaru)

Issues menampilkan session dengan langkah gagal paling baru.

• AVA memeriksa 10 event terakhir untuk menemukan kegagalan.
• Jika tidak ada kegagalan terbaru, AVA memakai kegagalan terakhir yang tercatat.

Gunakan View Details untuk melihat histori langkah lengkap.

Contoh

Jika pembayaran gagal pada 3:12 setelah sukses sebelumnya, issue menampilkan Payment pada 3:12. Jika 10 event terakhir semuanya sukses, AVA menampilkan kegagalan terbaru yang tercatat.

Aktivitas Terbaru

Recent Activity menampilkan langkah penting yang berhasil atau gagal, seperti:

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

Daftar ini dibatasi hanya 30 item terbaru.

Gunakan daftar ini untuk memastikan langkah mana yang paling baru selesai.

Contoh

Anda mungkin melihat “Check‑In completed successfully” atau pesan gagal untuk Identity Verification.

Distribusi Langkah Akhir (di mana session berakhir)

Chart ini mengelompokkan langkah terakhir tiap session ke dalam kategori:

• Success - Langkah penyelesaian penuh
• Timing - Langkah early check-in termasuk Room Queued
• Partial - Pre-registration
• Room - Langkah penugasan room (Room Assignment)
• Documentation - Verifikasi dokumen atau ID
• Payment - Langkah pembayaran
• Early - Langkah Entry / Fetch

Jika ada kegagalan setelah sukses terakhir, langkah gagal menjadi final step.

Gunakan chart ini untuk melihat titik berhenti yang paling umum.

Contoh

Dari 50 session, 20 berakhir di Check‑In (success), 10 di Early Check‑In (timing), 8 di Document Upload (documentation), dan 12 di Payment (payment).

Buka session dari Final Step Distribution

1. Pilih segmen bar di Final Step Distribution.

2. Tinjau daftar session yang terbuka.

   ✓ Daftar menampilkan confirmation number, tamu, room, dan kegagalan terbaru.

3. Pilih Open details pada session mana pun.

   ✓ Panel Reservation Details terbuka untuk session itu.

Daftar session vs reservasi

Daftar ini menampilkan session, bukan reservasi yang digabung. Gunakan ini untuk menemukan kegagalan berulang dengan cepat.

Analitik Perangkat (opsional)

Device Analytics memakai detail device dari session check-in/out.

Jika tamu tidak memberikan informasi device, chart ini mungkin kosong.

Gunakan view ini untuk membandingkan penggunaan kiosk vs mobile berdasarkan OS.

Contoh

Jika sebagian besar session adalah iOS, Anda mungkin ingin mengoptimalkan alur check-in mobile.

Batas & kebaruan data

• Analytics mencakup hingga 90 hari per query.
• Saat daily rollup tersedia, rentang lebar dimuat dari data rollup terlebih dahulu.
• Properti yang sangat sibuk mungkin memerlukan rentang yang lebih kecil jika result set terlalu besar.
• Jika AVA meminta Anda mempersempit rentang tanggal, pendekkan periodenya lalu coba lagi.
• Daftar session dibatasi untuk performa (sekitar 200 per step dan 2.000 total).

Pemecahan Masalah

Semua chart menunjukkan nol

Yang Anda lihat: Kartu ringkasan menampilkan 0 dan chart kosong.

Perbaikan:

1. Perluas rentang tanggal.
2. Pastikan ada log di Status.
3. Periksa apakah paket Anda menyertakan Analytics.

Completion rate terlihat lebih rendah dari yang diharapkan

Yang Anda lihat: Completion rate rendah padahal banyak tamu check-in.

Periksa:

• Check-in demo dikecualikan, jadi session test tidak menaikkan Total Logs.
• Session di Pre‑Arrival tidak dihitung ke All Check‑Ins.
• All Check‑Ins hanya menganggap langkah Full Check‑In sebagai selesai.
• Early Check‑In dan Pre‑Registration dilacak di sub-tab masing-masing.

Kartu coverage hilang

Yang Anda lihat: Anda hanya melihat kartu ringkasan standar.

Perbaikan:

1. Tetap di Check-In.

2. Pastikan koneksi PMS aktif.

3. Segarkan halaman setelah sinkron selesai.

4. Jika rentangnya sibuk, segarkan lagi setelah beberapa menit.

   ✓ Jika PMS Anda mendukung coverage reservasi, Eligible Check-In Units dan AVA Check-In Share akan muncul setelah Completion Rate.

Kartu coverage masih tampak tidak berubah

Yang Anda lihat: Eligible Check-In Units atau AVA Check-In Share masih terlihat sama setelah refresh.

Perbaikan:

1. Tunggu satu menit.
2. Segarkan tab Analytics lagi.
3. Pastikan rentang tanggal cocok dengan update PMS yang Anda harapkan.
4. Jika masih salah, periksa apakah sinkron PMS sudah selesai.

Analytics terus memuat atau meminta Anda mempersempit rentang

Yang Anda lihat: Tab Analytics berputar lama, menampilkan timeout, atau meminta Anda mempersempit rentang tanggal.

Mengapa ini terjadi: Rentang yang lebih besar membutuhkan waktu lebih lama untuk diproses. Properti yang sangat sibuk juga bisa mencapai batas request lebih cepat.

Perbaikan:

1. Tunggu sampai 2 menit agar request selesai.

2. Coba rentang tanggal yang lebih kecil jika halaman masih timeout atau meminta Anda mempersempit rentang.

3. Segarkan tab Analytics lalu coba lagi.

4. Jika rentang kecil tetap gagal, hubungi support dengan tanggal yang dipilih.

   ✓ Rentang yang lebih kecil seharusnya selesai lebih cepat dan membantu Anda menentukan apakah masalahnya ukuran rentang atau ketersediaan data.

Salin config MCP gagal

Yang Anda lihat: Tombol menampilkan error setelah Anda klik Copy Codex MCP Config atau Copy Claude MCP Config.

Perbaikan:

1. Tetap di tab Analytics.
2. Coba tombol salin lagi.
3. Segarkan halaman dan coba ulang jika token request time out.
4. Jika error tetap ada, hubungi support dengan pesan persisnya.

Config tersalin, tetapi client tidak bisa tersambung

Yang Anda lihat: Modal terbuka, tetapi Codex atau Claude tidak memuat server Streamliner.

Perbaikan:

1. Periksa apakah Anda menempel config ke file yang benar.
2. Konfirmasi nilai STREAMLINER_MCP_TOKEN masih ada.
3. Restart client sepenuhnya.
4. Salin config baru jika setup memakan waktu terlalu lama.

Tool settings hilang

Yang Anda lihat: Client tersambung, tetapi aksi settings tidak muncul.

Perbaikan:

1. Salin config baru dari Analytics.
2. Restart client sepenuhnya.
3. Pastikan STREAMLINER_MCP_TOKEN yang ditempel adalah yang terbaru.
4. Hapus blok config Streamliner lama jika masih ada.

Write settings time out

Yang Anda lihat: Penyimpanan setting terlihat macet, lalu kembali dengan timeout atau cancel.

Perbaikan:

1. Salin config baru dari Analytics.

2. Restart client sepenuhnya.

3. Coba perubahan settings lagi.

4. Jika gagal lagi, periksa apakah token atau session Anda kedaluwarsa.

   ✓ Update settings yang valid harus selesai, bukan menggantung.

Authentication gagal saat write settings

Yang Anda lihat: Anda mendapat error authentication saat menyimpan merchant settings.

Perbaikan:

1. Salin config baru dari Analytics.

2. Restart client sepenuhnya.

3. Coba lagi perubahan settings di hotel yang sama.

4. Jika Anda berpindah hotel, segarkan config setelah berpindah.

   ✓ Error baru seharusnya meminta Anda membuat config/token MCP baru.

Unduhan PDF browser masih hilang

Yang Anda lihat: Anda mengharapkan tombol Download report untuk seluruh chart analytics.

Perbaikan:

1. Ini memang diharapkan pada tab Analytics saat ini.
2. Gunakan chart dan filter rentang tanggal di layar.
3. Gunakan ikon unduh untuk STB EVA submissions jika Anda memerlukan detail submission.
4. Hubungi support jika Anda memerlukan jalur ekspor yang berbeda.

Ekspor STB EVA hilang

Yang Anda lihat: Anda tidak melihat ikon unduh di bawah STB EVA submissions.

Perbaikan:

1. Pindah ke Check-In.
2. Pastikan EVA diaktifkan untuk Singapore di Settings → Check-in → Government Integration.
3. Segarkan halaman setelah data analytics termuat.
4. Jika panel masih tersembunyi, rentang tanggal yang dipilih mungkin tidak mencakup submission EVA.

Ekspor CSV gagal

Yang Anda lihat: Anda mengklik ikon unduh, tetapi file tidak terunduh.

Perbaikan:

1. Coba lagi setelah ringkasan analytics selesai dimuat.
2. Persempit rentang tanggal.
3. Periksa apakah browser Anda mengizinkan unduhan.
4. Coba lagi setelah error lokal hilang.
5. Hubungi support jika ekspor masih gagal.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Analytics menampilkan data di Status tetapi Analytics kosong
• ❌ Chart tidak pernah diperbarui setelah mengubah rentang tanggal
• ❌ Issues list menampilkan timestamp yang salah

Detail yang membantu untuk disertakan:

• Rentang tanggal yang Anda pilih
• Screenshot tab Analytics
• Confirmation number dari sample reservasi

Panduan Terkait

• Monitor Command Center Activity
• PMS Connection
• Sync Issues