游戏分析内容日志
游戏玩法分析仪表板中内容索引所需的日志。您可以检查每个内容的使用次数、成功/取消/完成率、详细状态等。
发送日志¶
利用Hive SDK客户端日志传输技术发送内容指标的日志。
可以从日志定义 - 创建客户端源检查发送日志的示例日志。
日志规范¶
该字段以 CamelCase 形式配置（例如 serverId），并区分大小写。以下情况下不会保存值：
- 如果字段名称未在下面定义（例如 uid）。
- 如果字段名称与字段名称不完全匹配（例如 serverid）。
- 如果每个字段的类型未定义（例如“474392047”用于 vid）。
注意事项
- 字符串：最多 1MB 的字符串数据
- 整数：带符号 64 位（-9,223,372,036,854,775,808 到 9,223,372,036,854,775,807）数据
- 如果传输的数据与每个字段的类型不匹配，则该字段可能无法正确存储，因此必须发送与该类型匹配的值。
| 字段名称 | 描述 | 类型 | 必需 |
|---|---|---|---|
| playerId | 唯一键，用于识别Hive认证中的用户 使用Hive SDK客户端日志传输功能时自动传输。 | 整数 | 是 |
| appid | App Center发布的应用ID 使用Hive SDK客户端日志传输功能时自动传输。 | 字符串 | 是 |
| guid | 日志行的唯一键值 推荐使用uuid等随机字符串形式。使用Hive SDK客户端日志传输功能时自动传输。 | 字符串 | 是 |
| dateTime | 日志时间戳，格式为“YYYY-MM-DD hh:mm:ss” （例如“2022-11-15 10:20:10”） 使用Hive SDK客户端日志传输功能时自动传输。 | 字符串 | 是 |
| timezone | dateTime的时区 可以通过时区检查方法使用客户端IP获取。如果为空或没有值，则根据KST决定（例如“GMT+09:00”）使用Hive SDK客户端日志传输功能时自动传输。 | 字符串 | 是 |
| category | 区分内容日志类别的值，固定为“pub_contents_log” | 字符串 | 是 |
| modeTypeName | 内容模式类型名称（例如“raid”） 用作“内容使用次数”或“内容使用详情”索引的内容名称 | 字符串 | 是 |
| modeTypeId | 内容模式类型ID，与内容modeTypeName字段1:1对应的数字ID * 如果小于或等于20000000，则用于按升序聚合“教程漏斗”指标 * 如果超过20000000，则用于按升序聚合“主线任务漏斗”指标 | 整数 | |
| contentStatus | 在内容模式类型状态下按以下流程进行。 * 接受 (-> 等待) -> 失败/成功/取消 您可以设置以下五个值中的一个。 * “接受”：接受 * “等待”：等待 * “失败”：失败 * “成功”：成功 * “取消”：取消 用于“内容接受与状态比率”指标或“内容使用详情”指标。 | STRING | Y |
| serverId | 服务器 ID 用作搜索条件，使用 Hive SDK 客户端日志传输功能 时自动传输。 | STRING | |
| userId | 游戏中用户的唯一 ID | STRING | |
| userLevel | 游戏中用户等级或等效值 用作搜索条件或在“内容使用详情”指标的“用户等级（平均）”项目中使用 | INTEGER | |
| characterLv | 角色等级 用于“内容使用详情”指标的“角色等级（平均）”项目 | INTEGER | |
| playTimeSec | 每种内容模式类型的基于状态的游戏时间或等待时间（秒） 用于“内容使用详情”指标的“游戏时间（分钟/平均）”项目 | INTEGER | |
| score | 游戏中获得的分数或等效值 用于“内容使用详情”指标的“分数（平均）”项目 | INTEGER |
检查发送的日志¶
- 发送游戏日志后，您可以在 日志定义功能 中检查日志
- 如果内容日志定义所需字段中的所有值都正确输入，则传输将被反映并显示在索引中。