数据接入
游戏领域 Base

游戏领域数据格式

为最大化Ofnil 平台提供的数据价值,我们建议用户在数据接入时,提供以下字段。用户不需要手动转换字段,用户只需要在Ofnil 平台提供的字段映射工具中关联对应字段即可。

1. 用户信息相关字段:

1.1. 用户信息基础字段

字段类型描述
account_id string or list(string) 玩家id, 玩家id应该是玩家身份的唯一标识。举例:当上传不同区玩家时,若玩家的id在不同区有重叠,请把玩家所在区一起标记为account_id
account_namestring玩家用户名
signup_datedate or string玩家注册事件
regionint or string玩家所在区
timezonestring玩家所在时区
deviceint or string玩家使用设备
app_versionstring客户端版本号
genderint or string玩家性别
ageint玩家年龄
ipstring玩家登陆ip地址
expint or string玩家段位或者经验值

2. 事件信息相关字段

事件信息记录了 玩家在游戏内的行为,包括:登陆客户端,玩牌行为,充值行为(包括游戏币,道具购买等所有用户付费行为),道具消耗事件,好友互动事件,系统任务模块,异常账号封禁事件,公会互动事件,道具消耗事件,用户金流事件。

2.1. 登陆事件字段

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp玩家进入游戏的时间戳
is_signupbool当前玩家是否为注册玩家
ip_address (Optional)stringip地址

2.2. 对局事件字段

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp对局结束时间
start_timestampunixtime or timestamp对局开始时间
event_idint or string or list(int) or list(string)每一个对局的唯一标识
event_type (Optional)string这个对局的类型(如有)
benifitsint玩家赚取的奖励(奖励为正: 赢取奖励,奖励为负:输掉奖励)

2.3. 充值事件字段

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp充值时间戳
topup_valueint充值数额
topup_type (Optional)int or string充值类型
topup_status (Optional)int or string充值状态(比如充值成功,退款等)

2.4. 好友互动事件字段

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp互动时间戳
friend_idint or string好友id
friend_namestring好友名称
friend_actionint or string好友行为

2.5. 系统任务模块

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp互动时间戳
task_idint or string任务id
task_namestring任务名称
task_statusint or string任务状态

2.6. 异常账号封禁事件

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp封禁时间戳
ban_typeint or string封禁类型
ban_descstring封禁描述

2.7. 公会互动事件

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp互动时间戳
guild_idint or string公会id
guild_namestring公会名称
guild_actionint or string公会行为

2.8. 道具消耗事件

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp消耗时间戳
item_idint or string道具id
item_namestring道具名称
item_typeint or string道具类型

2.9. 用户金流事件

字段类型描述
account_idint or string玩家id
timestampunixtime or timestamp时间戳
transaction_typeint or string交易类型
transaction_amountint or string交易金额