傳送事件¶
什麼是事件?¶
事件是將使用者在遊戲中執行的特定操作記錄為資料的單元。它包含“誰做了什麼、何時、做了什麼”,是最基本的分析單位。
- 範例:使用者購買商品 →
item_purchase事件發生 - 範例:使用者清除特定階段 →
stage_clear事件發生 - 範例:使用者登入應用程式 → 發生
login事件
有關如何傳送事件的訊息,請參閱傳送事件日誌。
事件命名規則¶
eventName 中使用的事件名稱,建議依照以下規則命名。
- 建議字元:英文字母(a–z、A–Z,區分大小寫)、數字(0–9)、底線(
_) - 分隔符:以底線(
_)而非空格分隔單字 - 格式:建議使用能清楚描述事件的
名詞_動詞格式 - 範例:
item_purchase、level_up、tutorial_complete、stage_start
Warning
未遵循上述規則的事件名稱,在分析運用上可能會受到限制。
什麼是屬性?¶
屬性是事件發生時記錄的詳細資訊。事件本身只能告訴您“發生了什麼”,但屬性可以讓您弄清楚“在什麼條件下、以什麼值”發生了。
- 範例:事件
item_purchase的屬性→商品ID、付款金額、貨幣單位 - 範例:
stage_clear事件屬性 → 關卡編號、通關時間、使用角色
有關如何透過事件傳輸屬性的信息,請參閱傳送事件屬性。
屬性命名規則¶
自訂屬性(eventAttributes)的鍵,建議依照以下規則命名。
- 建議字元:英文字母(a–z、A–Z,區分大小寫)、數字(0–9)、底線(
_) - 首字元:以英文字母開頭
- 分隔符:以底線(
_)而非空格分隔單字 - 範例:
item_id、contentsType、stage_level
Warning
- 未遵循上述規則的屬性鍵,在分析運用上可能會受到限制。
attributes、eventAttributes、hiveAttributes為保留字。使用這些名稱的屬性會被隔離。詳細內容請參閱傳送事件屬性。
根據事件結構設計的事件範例可以在事件範本中找到。