游戏领域数据格式
为最大化Ofnil 平台提供的数据价值,我们建议用户在数据接入时,提供以下字段。用户不需要手动转换字段,用户只需要在Ofnil 平台提供的字段映射工具中关联对应字段即可。
1. 用户信息相关字段:
1.1. 用户信息基础字段
字段 | 类型 | 描述 |
---|---|---|
account_id | string or list(string) | 玩家id, 玩家id应该是玩家身份的唯一标识。举例:当上传不同区玩家时,若玩家的id在不同区有重叠,请把玩家所在区一起标记为account_id |
account_name | string | 玩家用户名 |
signup_date | date or string | 玩家注册事件 |
region | int or string | 玩家所在区 |
timezone | string | 玩家所在时区 |
device | int or string | 玩家使用设备 |
app_version | string | 客户端版本号 |
gender | int or string | 玩家性别 |
age | int | 玩家年龄 |
ip | string | 玩家登陆ip地址 |
exp | int or string | 玩家段位或者经验值 |
2. 事件信息相关字段
事件信息记录了 玩家在游戏内的行为
,包括:登陆客户端,玩牌行为,充值行为(包括游戏币,道具购买等所有用户付费行为),道具消耗事件,好友互动事件,系统任务模块,异常账号封禁事件,公会互动事件,道具消耗事件,用户金流事件。
2.1. 登陆事件字段
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 玩家进入游戏的时间戳 |
is_signup | bool | 当前玩家是否为注册玩家 |
ip_address (Optional) | string | ip地址 |
2.2. 对局事件字段
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 对局结束时间 |
start_timestamp | unixtime or timestamp | 对局开始时间 |
event_id | int or string or list(int) or list(string) | 每一个对局的唯一标识 |
event_type (Optional) | string | 这个对局的类型(如有) |
benifits | int | 玩家赚取的奖励(奖励为正: 赢取奖励,奖励为负:输掉奖励) |
2.3. 充值事件字段
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 充值时间戳 |
topup_value | int | 充值数额 |
topup_type (Optional) | int or string | 充值类型 |
topup_status (Optional) | int or string | 充值状态(比如充值成功,退款等) |
2.4. 好友互动事件字段
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 互动时间戳 |
friend_id | int or string | 好友id |
friend_name | string | 好友名称 |
friend_action | int or string | 好友行为 |
2.5. 系统任务模块
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 互动时间戳 |
task_id | int or string | 任务id |
task_name | string | 任务名称 |
task_status | int or string | 任务状态 |
2.6. 异常账号封禁事件
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 封禁时间戳 |
ban_type | int or string | 封禁类型 |
ban_desc | string | 封禁描述 |
2.7. 公会互动事件
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 互动时间戳 |
guild_id | int or string | 公会id |
guild_name | string | 公会名称 |
guild_action | int or string | 公会行为 |
2.8. 道具消耗事件
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 消耗时间戳 |
item_id | int or string | 道具id |
item_name | string | 道具名称 |
item_type | int or string | 道具类型 |
2.9. 用户金流事件
字段 | 类型 | 描述 |
---|---|---|
account_id | int or string | 玩家id |
timestamp | unixtime or timestamp | 时间戳 |
transaction_type | int or string | 交易类型 |
transaction_amount | int or string | 交易金额 |