跳转至

游戏分析伙伴日志

这是每个游戏指标的游戏玩法分析仪表板中所需的伴侣指标日志。伴侣是游戏用户角色的从属伙伴，例如宠物、化身或怪物。当伴侣获取和消耗发生变化时，会发送日志，以便您可以检查按等级划分的获取与消耗之间的差异比例和数量、按等级划分的获取/消耗的数量，以及按等级划分的获取/消耗/总变化的用户数量。

传输日志

使用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 应用中心颁发的应用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 mate日志的类别分类值，值固定为“pub_mate_log” 字符串 是
mateId mate ID，用于识别每个mate的值 字符串
mateGrade 伙伴等级（例如：稀有）
用于对所有指标伙伴等级进行分类		 STRING Y
serverId 服务器ID
用作搜索条件
使用Hive SDK客户端日志传输功能时自动传输。		 STRING
userId 游戏中用户的唯一ID
如果playerId字段包含值0或null，则用作计算项目的用户识别键。		 STRING
mateChangeFlag 伙伴变化标志（例如：抽取）
* 购买、抽取、升级、合成、出售、删除等。
用于项目路径、按等级的获取路径、按等级的消费路径		 STRING Y
mateChangeAmount 伙伴变化数量
* 消费：作为负数发送（例如：-1）
* 获取：作为正数发送（例如：1）
用于项目路径、按等级的获取路径和消费路径		 INTEGER Y

检查发送的日志

  • 发送游戏日志后，您可以在日志定义功能中检查日志
  • 如果所有必需值都根据伴侣日志定义输入，则传输会在指标中反映并显示。