发送事件属性¶

概述¶

游戏事件日志由必需的属性和用户定义的属性组成。 如果链接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、Fluentd、HTTP 传输方法
• 事件存储结构 — 表结构，attributes详细属性，数据隔离