事件¶
概要¶
事件是用來確認並管理構成 Analytics 所有分析基礎的事件，以及在事件下建立的屬性之功能。
只要串接 SDK，登入、購買、安裝等 50 種以上的事件就會在無需額外開發的情況下自動收集。若再加入所需事件的自訂定義，就能進行更精細的分析。
若要直接傳送自訂事件，請參考 事件設計與傳送指南。
可以做什麼？¶
商務/行銷負責人¶
- 若在此畫面定義分析所需的事件與屬性，可直接作為提供給開發團隊的企劃文件使用。
- 一眼掌握目前收集中的事件清單，就能立即知道可用哪些資料進行分析。
資料分析師¶
- 在事件清單中掌握可分析事件與屬性的整體狀況，可快速設計分析範圍。
- 透過資料預覽可直接確認事件的實際值，在分析前驗證資料品質。
開發者¶
- 可直接在此畫面確認事件名稱與屬性清單，提升 SDK 串接作業效率。
- 在傳送事件後，透過 資料預覽 確認接收到的屬性值，可立即驗證傳送結果。
- 善用 ETL 模擬 功能，可在實際發佈前預先確認事件傳送結果。
快速開始¶
如果是第一次註冊事件，請依照以下步驟建立第一個事件。
- 在左側側邊欄點擊 資料 > 事件 選單。
- 點擊右上角 註冊 按鈕。
- 輸入事件名稱與事件說明。
- 移至 屬性分頁，新增要與事件一起傳送的屬性。
- 設定屬性名稱、說明、資料型別。
- 點擊 儲存 按鈕。
- 將事件名稱與屬性清單提供給開發部門，請其傳送事件資料。
Note
事件屬性・資料預覽・ETL 模擬等細部設定，請參考 全部功能。
全部功能¶
主要概念¶
| 概念 | 說明 |
|---|---|
| 事件 | 使用者在遊戲中執行的特定行為之資料記錄單位（例如：登入、購買、升級） |
| 平台事件 | 只要串接 SDK，Hive 就會預設收集的事件 |
| MMP 事件 | 透過 Airbridge、AppsFlyer、Adjust 等 MMP 傳送的事件 |
| 自訂事件 | 自行定義並傳送的客製事件 |
| 屬性 | 事件分類法結構中附屬於事件的細節資料項目。分為平台屬性與事件屬性 |
| 平台屬性 | 只要串接 SDK，Hive 就會預設收集的屬性（例如：國家、市場、伺服器 ID、OS 等） |
| 事件屬性 | 與事件一起傳送的屬性（例如：購買事件的道具 ID、金額、貨幣單位） |
事件清單查詢¶
以清單方式查看註冊到 Analytics 的所有事件。 
篩選與搜尋¶
| 選項 | 說明 |
|---|---|
| 事件類型 | 依事件類型（自訂事件、AppsFlyer、Airbridge 等）篩選清單 |
| 事件名稱/建立者搜尋 | 選擇搜尋基準（事件名稱或建立者）後輸入關鍵字來搜尋事件 |
| 只顯示使用中的事件 | 開啟切換鈕時，只顯示啟用中的事件 |
清單欄位¶
| 欄位 | 說明 |
|---|---|
| 編號 | 事件註冊順序 |
| 事件類型 | 自訂 / AppsFlyer / Airbridge 等事件來源 |
| 事件名稱 | 事件名稱。點擊後會移至詳細頁面 |
| 說明 | 註冊事件時輸入的說明 |
| 建立日 | 事件第一次註冊的日期時間 |
| 建立者 | 註冊事件的帳號。系統自動建立的事件會顯示為 system |
| 資料最後輸入日 | 該事件資料最後一次被收集的日期時間。每 10 分鐘同步一次，若沒有收集紀錄則顯示為 - |
| 使用與否 | 透過切換鈕控制事件啟用/停用。關閉時，會從事件選擇清單中隱藏 |
事件註冊¶
點擊事件清單畫面右上角的 註冊 按鈕後，會移至事件註冊頁面。 
| 項目 | 必填 | 說明 |
|---|---|---|
| 事件名稱 | 必填 | 實際傳送資料時使用的唯一代碼 |
| 說明 | 選填 | 說明事件的發生條件與目的 |
Note
Analytics 建議的事件名稱命名規則，請參考 事件設計與傳送指南。
事件詳細查詢¶
[基本資訊] 分頁¶
查看與編輯已註冊事件的事件名稱與說明。 
[屬性] 分頁¶
定義各事件一起傳送的屬性。 
| 項目 | 說明 |
|---|---|
| 屬性名稱 | 實際傳送時使用的代碼 |
| 說明 | 屬性值的意義與範例 |
| 資料型別 | 文字 / 數字 / 日期型 中擇 1 |
資料型別說明¶
| 類型 | 說明 | 範例 |
|---|---|---|
| 文字 | 字串值 | 國家代碼(KR)、道具名稱(sword) |
| 數字 | 整數或小數值 | 等級(50)、付款金額(9.99) |
| 日期 | 日期/時間值 | 事件發生時間(2026-03-29T10:00:00) |
貨幣屬性 / 金額屬性¶
可在事件已註冊的屬性中指定哪一個屬性承載 貨幣值 與 營收金額。必須完成此設定，才能在 圖表 中依照所需貨幣基準查詢營收數值。
| 項目 | 說明 |
|---|---|
| 貨幣屬性 | 指定包含貨幣代碼值的屬性（例如：包含 KRW, USD 等貨幣單位的屬性） |
| 金額屬性 | 指定用於營收計算的數值屬性（例如：包含付款金額的屬性） |
Note
貨幣屬性與金額屬性可在事件詳細頁面的 [屬性] 分頁中設定。請從屬性清單中選擇該屬性後，分別指定各項目。
Warning
若未指定貨幣屬性或金額屬性，圖表將無法以貨幣基準查詢營收相關指標。若要將購買事件用於分析，務必同時指定這兩個屬性。
[資料預覽] 分頁¶
查看實際由 Analytics 收集的事件資料樣本。可用於驗證事件是否正確傳送、屬性值是否如預期被收集。
查詢條件¶
| 項目 | 說明 |
|---|---|
| 查詢期間 | 選擇要查詢資料的日期範圍。開始日與結束日的範圍最多限制為 1 個月。 |
| 欄位名稱 | 選擇要套用篩選器的屬性（欄位）。 |
| 條件 | 選擇要套用在所選欄位上的比較條件。 |
| 搜尋 | 輸入條件使用的值。 |
| 重設 | 將所有已設定的篩選條件初始化。 |
Warning
若查詢期間超過 1 個月，將無法查詢資料。請縮短期間後重新查詢。
[建立來源] 分頁¶
自動產生將該事件傳送到 Analytics 的原始碼。開發者無需另外撰寫程式碼，也可直接使用此分頁產生的來源傳送資料。 
| 分頁 | 說明 |
|---|---|
| 客戶端開發者 | 提供在遊戲客戶端傳送事件的原始碼 |
| 伺服器開發者 | 提供在遊戲伺服器傳送事件的原始碼 |
| 文件 | 提供事件收集資料表 schema 的參考文件 |
[ETL 模擬] 分頁¶
用於事件傳送測試的模擬功能。
- 在各事件收集資料表欄位中輸入適當資料。
- 點擊 傳送 按鈕。
- 在 [資料預覽] 分頁中確認事件是否接收與屬性解析結果。
Warning
appId 欄位必須輸入已註冊於 Hive 控制台 > App Center 的 App ID。若輸入錯誤值，資料可能無法被收集。
事件顯示控制¶
- 可透過事件清單中的 使用與否 切換鈕設定各事件是否顯示。 - 設定為 OFF 時，該事件會在圖表/漏斗/留存等分析畫面中的選擇清單裡隱藏。 - 資料仍會持續收集，但不會顯示在分析 UI 中。
事件複製與刪除¶
- 複製：以既有事件為基礎快速建立相似事件
- 刪除：刪除不再使用的事件
Warning
若有正在使用已刪除事件的圖表/指標，相關內容可能會受到影響。
注意事項 & Tips¶
- 事件名稱在發佈後若變更，會與既有資料產生不一致。請審慎決定事件名稱。
- 若屬性型別設定錯誤，可能導致資料彙總錯誤。
- 若要使用 MMP 事件，請先在 資料 > 整合 選單中設定該 MMP 整合。
- 不使用的事件請設為 顯示 OFF，以整理分析 UI。
- 當事件數量變多時，清楚撰寫名稱與說明可提升整個團隊的分析效率。