用事件範本定義日誌收集結構：事件日誌傳送 第1篇
Hive Analytics 以事件範本提供遊戲分析中常用的用戶行為。範本已預先定義事件名稱與屬性，不必從頭設計事件結構，也能決定日誌收集結構。分析人員在 Data > Event 選擇事件以確認可用指標，於 Property Setting 修改或新增預先定義的屬性後，再到 Source Generation 確認適合開發環境的原始碼。在請求正式開發之前，先傳送測試日誌，驗證資料是否依預期的結構收集。
遊戲事件日誌為何需要一致的定義
要準確分析遊戲用戶的行為，就必須以一致的標準定義事件名稱與屬性。遊戲需要分析的用戶行為相當多樣，不只是登入與購買，還包括完成內容、取得貨幣、使用道具等。要分析這些行為，必須將行為發生當下的資訊收集為事件日誌，因此需要事先定義事件名稱、發生時機，以及一併傳送的屬性與資料型別。
如果每款遊戲都從頭設計這些項目，即使是意義相同的行為，也可能以不同的名稱或結構收集。若要在分析過程中清楚掌握每筆日誌的意義，並以相同標準比較多款遊戲的資料，就必須從事件定義開始保持一致。
什麼是 Hive Analytics 的事件範本
Hive Analytics 的事件範本，是將遊戲分析中常用的行為，以預先定義事件名稱與屬性的形式提供的功能。在了解事件範本之前，先整理日誌收集中使用的主要用語。
| 用語 | 說明 |
|---|---|
| 事件 | 將用戶在遊戲中執行的特定行為記錄為資料的單位，包含何時、何人、做了什麼。 |
| 屬性 | 事件發生時一併記錄的詳細資訊，表示行為是在什麼條件下、以什麼值發生。 |
| 原始碼 | 為了將事件傳送至 Hive Analytics，在 Source Generation 分頁中依開發環境自動產生的程式碼。 |
app_login 事件的傳送時機，在 Property Setting 確認屬性，在 Source Generation 確認原始碼。事件範本也包含串接 Hive SDK 後會自動收集的登入、購買等事件。範本中的事件已在 Data > Event 預先定義事件名稱與屬性，不必從頭設計結構即可使用，日誌傳送完成後就能立即在 Hive Analytics 開始以事件為基礎的分析。即使未事先登錄事件或屬性就傳送日誌，也能在 Hive Analytics 中使用。
在開發者網站確認事件範本
即使不登入 Hive Analytics，也能在 Hive 開發者網站的事件範本指南中，確認各個預先定義事件的傳送時機與可用指標範例、是否由 Hive SDK 自動收集，以及屬性清單。
選擇事件後，可以確認能用該事件建立的指標。在 Property Setting 中檢視預先定義的項目，依分析目的修改或新增屬性。屬性設定完成後，在 Source Generation 選擇遊戲的開發環境，即可確認已反映所設定事件與屬性的原始碼。
將產生的原始碼套用到正式開發之前，先傳送測試日誌，驗證事件與屬性值是否依預期的結構收集，以及能否用這些資料組成所需的指標。反映驗證結果後，就能具體確定要交給開發人員的事件結構與原始碼。
分析人員依照以下順序，選擇符合要分析之行為的事件，並準備所需的屬性與日誌傳送原始碼。
- 選擇事件
確認與要分析之行為相符的事件範本。 - 設定屬性
檢視預先定義的屬性，並修改或新增需要的屬性。 - 產生原始碼
選擇遊戲的開發環境，產生包含所設定事件與屬性的原始碼。
用 contents_success 準備內容完成事件
若要分析完成內容的用戶數與平均遊玩時間等，就需要準備 contents_success 事件與日誌傳送原始碼。從選擇事件到產生原始碼的流程如下。
選擇事件
在 Data > Event 選擇 contents_success 並確認說明。contents_success 是在用戶完成遊戲內容時發生的事件，可用於建立內容完成次數、完成用戶數、平均遊玩時間與平均分數等指標。分析人員根據這些資訊決定要使用的指標，並具體定義事件應在遊戲中的哪個時機發生。
contents_success 的 Basic Info 中確認事件的意義與可用的指標。設定屬性
在 Property Setting 中確認 contents_success 預先定義的屬性，以及各屬性的說明與資料型別。屬性之後會在 Create 建立圖表時，用來組成測量值、維度值與篩選條件。contents_success 包含表示使用環境的 market 與 hive_country、用來識別用戶的 userId 與 deviceId，以及表示內容完成詳細條件的 characterLv 與 modeTypeId 等。
appId、appIdGroup、dateTime、userId、deviceId、eventName、eventTime、identifierProvider 是由系統管理的共通屬性，無法在 Property Setting 中修改。其中 userId、deviceId、identifierProvider、eventTime、eventName 以及 appId 或 appIdGroup，是傳送事件日誌時必須包含的必要屬性。dateTime 是將傳送的 eventTime 轉換為 UTC 後儲存的時間。
預先定義的屬性可依需要修改。若缺少分析所需的值，請點擊編輯畫面左下角的 Add Event + 新增屬性。例如，若要在分析中使用角色名稱，可新增 characterName 屬性，並將資料型別設為字串。即使是未在 Hive Analytics 預先定義的屬性，只要包含在傳送的日誌中，也能用於分析。以這種方式儲存的事件與屬性，可在多個專案中作為相同的收集標準使用，讓相同的行為以一致的屬性名稱、資料型別、值的格式與單位傳送。
產生原始碼
完成屬性設定後，在 Source Generation 選擇用戶端或伺服器的開發方式，並指定遊戲實際使用的開發環境。產生的原始碼包含所設定的事件名稱與屬性，因此分析人員要確認實作所需的項目是否正確反映。
產生的原始碼可交給開發人員，用於實作實際的日誌傳送功能。在請求開發之前，可以先傳送測試日誌，事先驗證事件與屬性是否依預期的結構收集，以及能否用這些資料組成所需的指標。以測試日誌驗證的方法，將在「用測試日誌驗證收集結構與指標：事件日誌傳送 第2篇」中詳細介紹。
開始使用 Hive Analytics
運用事件範本，分析人員可以自行設定所需的事件與屬性，並以適合開發環境的原始碼形式，準備日誌傳送標準。
Hive Analytics 是遊戲專用的分析解決方案，能以透過 Hive SDK 收集的遊戲事件為基礎，分析用戶行為與遊戲指標。現在就到 Hive Analytics 確認符合您要分析之遊戲行為的事件範本，並準備所需的屬性與開發用原始碼。
