About
什麼是 Umami？
Umami 是一個開源的網站分析平台，定位為「注重隱私的 Google Analytics 替代品」。
它不使用 Cookie、不跨站追蹤使用者，追蹤碼小於 2KB，不影響網站載入速度。
我們使用 Umami Cloud（官方託管版），只需在 HTML 中加入一行 <script> 即可開始收集數據。
🔒
隱私友善不用 Cookie，天生符合 GDPR / CCPA
🛠️
自訂事件可追蹤遊戲特定行為（開局、結束、BGM 等）
📱
即時面板Dashboard 即時更新，手機也能看
How It Works
數據怎麼來？
玩家在居酒屋打開遊戲時，Umami 會自動記錄基本流量資訊。在遊戲的關鍵節點（開始、結束、切換 BGM），我們額外埋設了自訂事件，記錄遊玩細節。
📱玩家開啟遊戲
→
📡Umami 自動追蹤
→
🎮遊戲觸發事件
→
📊Dashboard 即時顯示
Automatic
自動追蹤的指標
以下指標由 Umami 自動收集，不需要額外寫程式。開啟遊戲頁面即開始記錄。
| 指標 | 說明 | 對我們的意義 |
|---|
| Pageviews |
每個頁面被開了幾次 |
首頁 / 可杯 / 菊之花 / 箸拳 各被開了幾次 |
| Unique Visitors |
多少台不同裝置使用 |
最接近「多少桌客人玩過」 |
| Visit Duration |
平均停留時間 |
大家花多少時間在玩 |
| Pages |
各頁面流量排行 |
哪個遊戲最受歡迎 |
| Devices |
手機 / 平板 / 電腦 |
iPhone vs iPad 比例 |
| Browsers |
Safari / Chrome / 其他 |
要優先支援哪個瀏覽器 |
| OS |
iOS / Android |
客群使用什麼系統 |
| Languages |
瀏覽器語系 |
日本客人 vs 台灣客人比例 |
| Countries |
來源地區 |
使用者地理分布 |
| Hours |
按小時流量分布 |
哪個時段最多人玩（營業高峰） |
Custom Events
自訂事件追蹤
在遊戲的關鍵節點，我們埋設了自訂事件，記錄遊玩行為的細節。
這些事件會出現在 Umami Dashboard 的 Events 區塊，可以點進去看各欄位的分布統計。
🎲 可杯（Bekuhai）
bekuhai-start
觸發時機：每次按下「入座！」開始遊戲時
players 幾人遊玩
lang 語言 (zh/ja)
bekuhai-complete
觸發時機：8 回合結束，進入酒豪排行榜畫面時
players 幾人遊玩
rounds 玩了幾回合
duration 遊戲時長（秒）
lang 語言 (zh/ja)
🌸 菊之花（Kikuhai）
kikuhai-start
觸發時機：選好杯數模式後，按下「開始！」時
cups 杯數模式 (6/9/12/15)
lang 語言 (zh/ja)
kikuhai-complete
觸發時機：翻到菊花，進入一輪結束畫面時
cups 杯數模式
penalty 罰酒杯數
flipped 翻了幾杯才中
duration 遊戲時長（秒）
lang 語言 (zh/ja)
🥢 箸拳（Hashiken）
hashiken-start
觸發時機：按下「開始對決！」進入遊戲時
lang 語言 (zh/ja)
tutorialSkipped 是否跳過教學
hashiken-complete
觸發時機：三戰兩勝結束，進入結算畫面時
winner 獲勝方 (player/ai)
playerScore 玩家得分
aiScore AI 得分
rounds 總回合數
duration 遊戲時長（秒）
lang 語言 (zh/ja)
🎵 BGM 偏好
bgm-switch
觸發時機：玩家點擊 BGM 切換按鈕時
game 在哪個遊戲 (bekuhai/kikuhai/hashiken)
to 切到哪首 (enkai/moonlight/summer/festival)
Insights
我們能回答哪些問題？
👥
多少桌玩過？
Unique Visitors
一台裝置 ≈ 一桌客人
🎮
總共玩了幾場？
start 事件次數
bekuhai-start + kikuhai-start + hashiken-start
🏆
哪個遊戲更受歡迎？
Pages 排行
比較可杯 vs 菊之花 vs 箸拳的流量
👨👩👧👦
最常見的人數？
players 分布
4/5/6/7/8 人哪個最多
⏱️
一場平均玩多久？
duration 欄位
從開始到結束的秒數
✅
完成率高嗎？
complete ÷ start
太低 = 中途退出率高
🎵
最受歡迎的 BGM？
bgm-switch 的 to 分布
健身操 / 月夜 / 夏日 / 祭典
🕐
幾點最多人玩？
Hours 分布圖
對應營業高峰時段
Plan
免費版本與限制
我們目前使用 Umami Cloud 的免費方案，對居酒屋的使用量來說綽綽有餘。
Umami Cloud — Hobby
$0 / 月
- ✓ 100K 事件 / 月 — 每次開頁面或觸發事件都算 1 次，居酒屋場景完全夠用
- ✓ 無限制網站數量 — 可以追蹤多個網站
- ✓ 無限制團隊成員 — 團隊都可以看 Dashboard
- ✓ 資料保留 1 年 — 歷史數據保存一年
- ✓ 自訂事件 — 追蹤遊戲專屬行為
- ✓ 即時 Dashboard — 數據秒級更新
💡 以我們的使用情境估算：假設每天 20 桌客人、每桌玩 3 款遊戲各 1 場，
每月約 20 × 3 × 30 × 5（事件）= 9,000 次，遠低於 100K 上限。
如果超過免費額度，可升級付費方案（按用量計費，$0.00002/事件）。
Access
如何查看數據？
🔗 也可以開啟「分享連結」功能，產生一個公開網址，不需要登入也能查看數據。
適合分享給團隊成員快速瀏覽。