跳轉至

傳送事件

什麼是事件?

事件是將使用者在遊戲中執行的特定操作記錄為資料的單元。它包含“誰做了什麼、何時、做了什麼”,是最基本的分析單位。

  • 範例:使用者購買商品 → 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 為保留字。使用這些名稱的屬性會被隔離。詳細內容請參閱傳送事件屬性。

根據事件結構設計的事件範例可以在事件範本中找到。


注意事項 & Tips

  • 事件名稱和屬性名稱一旦分發就很難更改。發送前請檢查傳送事件屬性 的命名約定。
  • 不要為相同目的建立多個具有多個名稱的事件,並先檢查事件範本中是否已定義事件名稱。

相關菜單