跳转至

用于游戏分析的社交活动日志

此日志是游戏玩法分析仪表板中每个游戏指标的社交活动指标所必需的。当发生变化时,例如邀请/加入/添加公会、朋友和聚会等社交活动,您可以通过发送社交活动日志来验证参与每个社交活动的用户数量和平均每日参与用户数量。

传输日志

使用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客户端日志传输功能时自动传输。
INTEGER Y
appId 应用中心发放的应用ID
使用Hive SDK客户端日志传输功能时自动传输。
STRING Y
guid 日志行的唯一键值
推荐使用uuid等随机字符串形式
使用Hive SDK客户端日志传输功能时自动传输。
STRING Y
dateTime 日志时间戳,格式为“YYYY-MM-DD hh:mm:ss”
(例如:“2022-11-15 10:20:10”)
使用Hive SDK客户端日志传输功能时自动传输。
STRING Y
timezone dateTime的时区
可以通过时区检查方法使用客户端IP获取。如果为空或没有值,则基于KST决定(例如:“GMT+09:00”)
使用Hive SDK客户端日志传输功能时自动传输
STRING
category 社交活动日志的类别分类值,值固定为“pub_society_log” STRING Y
societyType 社交活动类型(例如:“party”)
可设置的值为以下三种之一
* “party”
* “friend”
* “guild”
用作所有指标表/图的标准社交活动名称
STRING Y
serverId 服务器ID
用作搜索条件
使用Hive SDK客户端日志传输功能时自动传输。
STRING
userId 游戏中用户的唯一ID
如果playerId字段包含值0或null,则用作计算项目的用户识别键。
STRING

检查发送的日志

  • 发送游戏日志后,您可以在日志定义功能中检查日志
  • 如果所有必填元素都正确填写,则传输会反映在指标中并公开。