App 埋點規格

版本 0.2.0 · 更新於 2026-09-23

所有 app 用同一套事件名稱。每個 app 各自在 Firebase/GA4 看報表,但同一個名稱在每個 app 代表同一件事,所以可以直接比較。

「哪個功能」「哪個遊戲」不是寫在事件名稱裡,而是在報表中用功能代號、遊戲代號篩選。每個代號的中文名稱,請點下方的 app 查看。

各 App 代號對照

latent · flutter
questari · flutter
vocastory · flutter
  1. 安裝與開啟
  2. 新手引導
  3. 註冊與登入
  4. 畫面與功能
  5. 小遊戲
  6. 付費與廣告
  7. 錯誤

安裝與開啟

安裝後第一次打開 app(不是下載數)
自動收集
first_open
使用者開始一次使用
自動收集
session_start

新手引導

開始新手引導
有此功能的 app
tutorial_begin
新手引導的每一步(看出使用者卡在第幾步離開)
有此功能的 app
cfd_onboarding_step
完成新手引導
有此功能的 app
tutorial_complete

註冊與登入

註冊成功
有此功能的 app
sign_up
登入成功
有此功能的 app
login

畫面與功能

使用者看到某個畫面
自動收集
screen_view
使用者點了某個功能或遊戲入口
所有 app 都有
select_content
使用者真正進入某個功能(含從推播、連結直接進入)
所有 app 都有
cfd_feature_enter
使用者分享內容
選用
share

小遊戲

開始玩一局小遊戲
有此功能的 app
cfd_game_start
一局小遊戲結束(贏、輸、或中途離開)
有此功能的 app
cfd_game_end
開始遊戲中的某一關
選用
level_start
遊戲中的某一關結束
選用
level_end
送出分數
選用
post_score
解鎖成就
選用
unlock_achievement

付費與廣告

使用者看到付費牆
有此功能的 app
cfd_paywall_view
付款成功
有此功能的 app
purchase
使用者看到廣告
有此功能的 app
ad_impression

錯誤

使用者遇到錯誤(例如載入失敗、付款失敗)
所有 app 都有
cfd_error

使用者屬性(可用來分群)

是否已註冊
account_status
付費狀態(免費、試用、付費、過期)
paid_status