事件¶
大綱¶
事件是一種檢查和管理事件的功能，這些事件是 Analytics 中所有分析以及在事件下建立的屬性的基礎。
只需連結SDK，即可自動收集登入、購買等事件，無需任何額外開發。透過在此處直接定義和添加必要的事件，可以進行更精確的分析。
若要直接傳送自訂事件，請參閱傳送事件。
你能做什麼？¶
業務/行銷經理¶
- 如果您在此畫面上定義了分析所需的事件和屬性，您可以立即將它們用作計劃文件交付給開發團隊。
- 透過一目了然地查看目前正在收集的事件列表，您可以立即了解可以分析哪些數據。
資料分析師¶
- 透過識別事件清單中可分析的事件和屬性的整體狀態，您可以快速設計分析範圍。
- 您可以在分析前透過資料預覽直接檢查事件的實際值來驗證資料品質。
開發者¶
- 您可以直接在此畫面上查看事件名稱和屬性列表，以有效率地進行SDK連動。
- 傳送事件後，您可以透過檢查資料預覽中接收到的屬性值來立即驗證傳送結果。
- 利用**ETL模擬**功能，您可以在實際部署前事先查看事件傳輸結果。
快速上手¶
如果這是您第一次註冊活動，請按照以下步驟建立您的第一個活動。
- 點選左側邊欄上的**資料 > 事件**選單。
- 點選右上角的**註冊**按鈕。
- 輸入事件名稱和事件描述。
- 前往屬性標籤並新增要隨事件傳送的屬性。
- 設定屬性名稱、描述和資料類型。
- 點選“儲存”按鈕。
- 透過將事件名稱和屬性清單傳送給開發部門來請求事件資料傳輸。
Note
事件屬性、資料預覽、ETL模擬等詳細設定請參考所有功能。
全功能¶
關鍵概念¶
| 概念 | 描述 |
|---|---|
| 活動 | 使用者在遊戲中執行的特定操作（例如登入、購買、升級）的資料記錄單位 |
| ㄴ自動收集活動 | 預設情況下，只需連結 SDK 即可從 Hive 收集事件 |
| ㄴ MMP 事件 | 透過 MMP 發送的事件，例如 Airbridge、AppsFlyer、Adjust 等 |
| ㄴ 自訂事件 | 您自己定義與傳送的自訂事件 |
| 屬性 | 事件發生時一起記錄的詳細資料項目 |
| ㄴ 自動收集屬性 | 預設情況下，僅透過連結 SDK 從 Hive 收集的屬性（例如國家/地區、市場、伺服器 ID、OS 等） |
| ㄴ 自訂屬性 | 您直接隨事件發送的屬性（例如購買事件中的商品 ID、金額、貨幣單位） |
事件清單查詢¶
檢查在 Analytics 中以清單形式註冊的所有事件。 
過濾器和搜尋¶
| 選項 | 說明 |
|---|---|
| 事件類型 | 依事件類型過濾清單（自訂事件、AppsFlyer、Airbridge 等） |
| 事件名稱/生成器搜尋 | 選擇搜尋條件（活動名稱或創建者）並輸入搜尋字詞以搜尋活動 |
| 僅顯示活動事件 | 切換 ON 以僅顯示已啟用的事件 |
清單列¶
| 專欄 | 說明 |
|---|---|
| 數量 | 活動報名號碼 |
| 事件類型 | 自訂 / AppsFlyer / Airbridge 等 事件來源 |
| 活動名稱 | 活動名稱。點擊進入詳情頁 |
| 描述 | 註冊活動時輸入的描述 |
| 建立日期 | 首次註冊活動的日期和時間 |
| 發電機 | 註冊事件的帳戶。系統自動產生的事件標記為 system |
| 最後資料輸入日期 | 上次收集此事件資料的日期和時間。每10分鐘同步一次，如果沒有採集歷史則顯示為- |
| 使用或不使用 | 切換以控制事件啟用/停用。當選擇 OFF 處的事件時，它會從清單中隱藏 |
活動報名¶
點選活動清單介面右上角的**註冊**按鈕，進入活動註冊頁面。 
| 項目 | 必填 | 說明 |
|---|---|---|
| 活動名稱 | 必填 | 傳送實際資料時所使用的唯一代碼 |
| 描述 | 選擇 | 事件發生條件及目的描述 |
Note
有關 Analytics 建議的事件命名約定，請參閱事件傳送。
查看活動詳情¶
【基本資訊】選項卡¶
檢查並編輯已註冊事件的事件名稱和描述。 
[屬性] 選項卡¶
定義隨每個事件發送的屬性。 
| 項目 | 描述 |
|---|---|
| 屬性名稱 | 實際傳輸使用的代碼 |
| 描述 | 屬性值意義及範例 |
| 資料類型 | 從字母/數字/日期類型選擇 1 |
資料型別描述¶
| 類型 | 描述 | 範例 |
|---|---|---|
| 文字 | 字串值 | 國家/地區代碼 (KR)、商品名稱 (sword) |
| 數量 | 整數或小數值 | 等級 (50)、付款金額 (9.99) |
| 日期 | 日期/時間值 | 事件發生時間 (2026-03-29T10:00:00) |
貨幣屬性/金額屬性¶
在事件中註冊的屬性中，可以在系統中指定包含貨幣值和銷售的屬性。設定後，您可以在圖表中查看所需貨幣的銷售數據。
| 項目 | 描述 |
|---|---|
| 貨幣屬性 | 指定包含貨幣代碼值的屬性（例如包含貨幣單位的屬性，例如 KRW、USD 等） |
| 金額屬性 | 指定包含要在銷售計算中使用的數字的屬性（例如包含付款金額的屬性） |
Note
貨幣屬性和金額屬性可以在活動詳情頁面的[屬性]標籤中設定。從屬性清單中選擇相關屬性，然後指定每個項目。
Warning
如果未指定貨幣屬性或金額屬性，則無法在圖表中以貨幣形式查看與銷售相關的指標。如果要使用購買事件進行分析，則必須指定這兩個屬性。
[資料預覽] 選項卡¶
查看 Analytics 實際收集的事件資料範例。它用於驗證事件是否正確傳輸以及屬性值是否按預期收集。
搜尋條件¶
| 項目 | 描述 |
|---|---|
| 查詢期間 | 選擇檢視資料的日期範圍。開始日期和結束日期的範圍最多限制為一個月。 |
| 欄位名稱 | 選擇要套用篩選器的屬性（欄位）。 |
| 條件 | 選擇要套用於所選欄位的比較標準。 |
| 搜尋 | 輸入用於條件的值。 |
| 重置 | 重置所有設定的過濾條件。 |
Warning
如果查詢週期範圍超過1個月，則無法查看資料。請縮短時間並再次檢查。
[來源建立] 選項卡¶
它會自動產生原始程式碼以將事件傳送到 Analytics。開發人員可以使用在此標籤中建立的來源傳輸數據，而無需編寫單獨的程式碼。 
| 選項卡 | 說明 |
|---|---|
| 客戶端開發人員 | 提供遊戲客戶端發送事件的原始碼 |
| 伺服器開發人員 | 提供從遊戲伺服器發送事件的原始碼 |
| 文件 | 提供事件集合表架構的參考文檔 |
[ETL 模擬] 選項卡¶
事件傳輸測試的模擬功能。
- 在每個事件收集表格欄位中輸入適當的資料。
- 點選**發送**按鈕。
- 在【資料預覽】標籤中，查看是否接收到事件以及屬性解析結果。
Warning
在appId欄位中，您必須輸入在Hive控制台>應用中心註冊的應用程式ID。輸入不正確的值可能會導致資料無法收集。
控制事件顯示¶
- 透過在事件清單中切換**啟用/停用**來設定是否公開每個事件。 - 如果設定為 OFF，則事件將從分析畫面（例如圖表/頻道/保留）的選擇清單中隱藏。 - 資料將繼續收集，但在分析UI中不可見。
複製並刪除事件¶
- 複製：根據現有事件快速建立類似事件
- 刪除：刪除不再使用的事件
Warning
如果您的圖表/指標正在使用已刪除的事件，則它們的內容可能會受到影響。
注意事項 & Tips¶
- 如果發布後事件名稱發生更改，可能會與先前的資料不一致。仔細選擇您的活動名稱。
- 如果屬性類型設定錯誤，可能會出現資料聚合錯誤。
- 若要利用 MMP 事件，您必須先在 資料 > 連結 選單中設定 MMP 連結。
- 使用顯示OFF 處理未使用的事件，以整理分析UI。
- 隨著事件數量的增加，編寫名稱和描述明顯提高了整個團隊的分析效率。