傳送事件屬性¶

概述¶

遊戲事件日誌由必要的屬性和使用者定義的屬性組成。 **如果連結Hive SDK v4，將會新增自動收集的屬性，無需單獨傳輸。 **

必要屬性¶

傳輸遊戲事件日誌時**必須包含該屬性**。

eventName 命名約定¶

建議用於eventName的事件名稱按照以下規則編寫。

• 建議字元：英文字母（a–z、A–Z，區分大小寫）、數字 (0–9)、底線 (_)
• 分隔符號：單字之間用底線 (_) 分隔，而不是空格。
• 格式：建議使用能清楚說明事件的英文 noun_verb 格式。
• 範例：item_purchase、level_up、tutorial_complete、stage_start

eventTime 格式規則 (RFC 3339)¶

eventTime 遵循格式 RFC 3339 且必須包含時區資訊。

形式：

YYYY-MM-DDTHH:MM:SS[.sss]+HH:MM 或 YYYY-MM-DDTHH:MM:SSZ

可接受的範例：

2026-07-20T14:01:01+09:00（KST，韓國標準時間）
2026-07-20T05:01:01Z            (UTC)
2026-07-20T14:01:01.123+09:00（包括毫秒）
2026-07-20T23:01:01-05:00（美國東部時間）

不允許的範例：

2026-07-20 14:01:01（無時區→隔離）
2026-07-20（沒有時間→隔離）
1719835261（Unix timestamp → 隔離）
14:01:01（無日期 → 隔離）

eventTime¶

• eventTime 會在管線中**轉換為 UTC**，並儲存在資料表的 dateTime 欄位中。原始值會原樣保留在 attributes.eventAttributes.eventTime 中。

使用者定義的屬性¶

遊戲中想要傳輸的資訊由屬性名稱和屬性值組成，並與所需的屬性一起直接傳輸。

屬性名稱規則¶

不能使用的屬性名稱（保留字）¶

屬性取值規則¶

若屬性值的形式為物件JSON、陣列JSON或JSON形式的字串，則**隔離至表格rescue**。

// JSON 物件（不允許）
"info": {"key": "value"}

// JSON 陣列（不允許）
"items": [1, 2, 3]

// 形式為 JSON 的字串（不允許）
"data": "{\"key\": \"value\"}"

相同屬性名稱的重複傳輸¶

如果傳輸兩個或多個相同的屬性名稱，則隨機選擇屬性值並且**僅儲存一個屬性值**。

Hive SDK v4 自動收集的屬性¶

僅當客戶端將事件日誌傳送到 Hive SDK v4 時自動收集。

• 如果使用者直接發送具有相同屬性名稱的值，則儲存**使用者發送的值**，而不是SDK自動收集的值。
• 以下屬性儲存在表中的 attributes.eventAttributes 中。

Hive SDK v4 如果您使用事件日誌傳輸功能，SDK 是直接從客戶端裝置收集和傳輸的屬性。

必需的屬性¶

必需屬性中，SDK和v4是自動收集的屬性。 （不包括 eventName）

使用者/帳戶識別訊息¶

時間/身分資訊¶

屬性名稱	描述	域	範例
dateTime	這是傳送事件日誌時產生的事件的日期和時間。 (yyyy-MM-dd HHss 格式)	Hive SDK（核心）	2026-01-01 00:00:00
guid	UUID（連字號已刪除）每次傳送事件日誌時產生。用於事件日誌的唯一識別和重複資料刪除。	Hive SDK （核心）	ecbfbd7fcdc340e1b8a433999c5290c1
is_hive_time	標記事件日誌中的時間戳記是否Hive與伺服器時間同步。 (Y/N)	Hive SDK（核心）	Y
timezone	dateTime 該值所依據的時區偏移資訊。	Hive SDK （核心）	GMT+09:00
is_url_encode	傳送事件日誌時是否套用URL編碼的標誌。 （Y 已修復）	Hive SDK （核心）	Y

裝置資訊¶

SDK/應用程式建置訊息¶

SDK 設定訊息¶

接收伺服器訊息¶

注意事項 & Tips¶

• 必需的屬性名稱必須以駝峰大小寫或小寫形式發送，如果以蛇形大小寫 (user_id) 發送，它們將被隔離到 rescue 表中。
• 必須包含 appId 或 appIdGroup，否則將被隔離。
• eventTime 只能採用 RFC 3339 格式（包括時區），如果基於當前時間超過過去或未來 31 天，則會被隔離。
• attributes、eventAttributes 和 hiveAttributes 不能用作使用者定義的屬性名稱（不區分大小寫）。
• 屬性值僅允許數字和字元類型，JSON物件、陣列、JSON形式的字串被隔離。
• 有關如何檢查和重新發送隔離日誌的信息，請參閱資料隔離。

相關菜單¶

• 事件傳輸 — 事件/屬性概念指南
• 事件範本 — 依類別自動收集的預設事件列表
• 事件日誌傳輸 — 通過Hive SDK v4、Hive Axyl、
• 事件儲存結構 — 表格結構，attributes詳細屬性，資料隔離