评分日志 v2

类别¶

记录者类型

常见服务器	service_metrics-score2_log
测试服务器	service_metrics_test-score2_log

FTP 类型

命名规则	score2_[日期][服务器][避免重复的ID].json	例如，score2_20180705_111500_GLOBAL-4.json

Fluentd 类型（基于日志定义）

服务器（将负载平衡到两个服务器）	analytics-hivelog-03.withhive.com analytics-hivelog-04.withhive.com
标签命名规则	ha2union.game.[游戏的简短名称].score2_log	例如，ha2union.game.samplegame.score2_log
字段category的值	[游戏的简短名称]_score2_log	例如，{“category”:”samplegame_score2_log”,”aaa”:1}
详细传输方法

http 类型（基于日志定义）

服务器	https://analytics-log.withhive.com
字段category的值	[游戏的短名称]_score2_log	例如，{"category":"samplegame_score2_log","aaa":1}
详细传输方法

日志规范¶

Note

蛇形命名的字段，例如 server_id，在存储到最终存储（BigQuery）时会转换为驼峰命名，例如 serverId，而以未指定形式发送的日志，例如 serverid，不会保存在其列中。

字段名称	描述	类型	必需
date	存储日志的时间格式：yyyy-mm-dd hhss 例如：2012-01-19 16:24:00 Scribe/FTP类型必需，Fluentd类型可选	string	N
dateTime	存储日志的时间格式：yyyy-mm-dd hhss 例如：2012-01-19 16:24:00	string	Y
category	[游戏品牌名称]_[日志名称] 游戏品牌名称是app_id的第三项例如，“derbyday_score2_log”	string	Y
timezone	日志中时间参数的UTC偏移 * 将时区的值固定为空白或GMT+09:00，因为当以scribe或ftp类型发送日志定义时，日期始终为KST。例如，“GMT+09:00” * 在以fluentd或http类型发送日志定义时，根据dateTime的值灵活设置时区的值。例如，“GMT+10:30”	string	Y
channel	C2S: HIVE KAK: Kakao LIN: LINE WEI: 微博	string(3)	Y
channel_uid	登录渠道上的用户标识符（通常使用bigint，但某些渠道可能使用string类型）如果信息未知（如LINE），发送0	string(64)	Y
game	使用游戏的品牌名称（例如，derbydays）。app_id的第三项例如，com.com2us.littlelegends.kakao.freefull.apple.global.ios.universal => littlelegends * app_id的第三项即使在一个游戏中也可能不匹配，因此确保统一发送游戏字段的值。例如，com.gamevil.basebss.android.google.global.normal 例如，com.gamevil.basebssent.ios.apple.global.normal => basebss	string(50)	Y
server_id	服务器代码请参考服务器代码表输入服务器代码（JSON输入代码）	string	Y
account_id	服务器中的唯一账户标识符（PK）	bigint	Y
account_level	用户的账户等级。在没有等级的游戏中，设置为0	int	Y
character_id	在服务器中使用的角色标识符如果游戏没有角色，则将此标识符设置为0	bigint	Y
character_type_id	在服务器中使用的角色类型的值如果游戏没有角色，则将此值设置为0	int	Y
character_level	在服务器中使用的角色等级如果游戏没有角色，则将此等级设置为0	int	Y
mode_id	游戏模式标识符范围：[1–(2^31−1)]	int	Y
mode_name	游戏模式名称用于显示ims。使用韩语	string(50)	Y
submode_id	子游戏模式的标识符（从1开始）。没有子模式时，设置为0	int	Y
submode_name	子游戏模式的名称。没有子模式时，设置为0 用于显示ims。使用韩语	string(50)	Y
grade_id	等级ID的标识符（从1开始）。没有等级时，设置为0	int	Y
grade_name	等级名称。没有等级时，设置为0 用于显示ims。使用韩语	string(50)	Y
score	用户的游戏得分如果游戏只记录胜负，平均得分为胜率；100表示胜利，0表示失败	int	Y
client_ip	客户端IP。此值从GeoIP提取国家值	string(32)	Y
server_ip	服务器IP	string(32)	Y
company	游戏发布公司，日志的目标：例如，“C2S”：Com2uS，“GVI”：Com2uS Holdings	string(3)	Y
market	市场信息 “TS”：SKT Tstore “OL”：KT OllehMarket “OZ”：LGU+ OzStore “AP”：Apple Appstore “GO”：Google Play “SA”：Samsung Apps “LE”：Com2us Lebi “MM”：ChinaMobile MobileMarket “SN”：新浪微博点 “36”：奇虎360点 “MO”：Momo Momo点 “DN”：DeNA Mobage点 “NA”：NaverAppStore “AM”：亚马逊 “ON”：OneStore	string(2)	Y
country	如果未提供client_ip，请直接输入国家代码例如：KR	string(2)	N
is_emulator	如果使用如BlueStacks的PC模拟器连接，则返回1；否则，返回0 对于PC版本，返回2	int	不要求，但建议。
deviceid	HIVE上的设备ID。抽象广告标识符的标识符（Android：AdvertisingID；iOS：IDFA）	bigint	N（2018年4月12日添加）
app_id	Hive SDK 使用的 AppID 例如，‘com.com2us.misample.normal.freefull.apple.global.ios.universal’	string(200)	N (添加于 2019年1月25日)
guid	每个日志生成的唯一键推荐使用 uuid 等随机格式	varchar(64)	N
playtime	以秒为单位的游戏时间	int	N (添加于 2019年9月4日)
power	战斗开始前卡组中角色的总力量。	int	N (添加于 2019年9月11日)
battle_result	在 pvp 中获胜/失败/平局/放弃时输入 WIN、LOSE、DRAW 和 GIVEUP	string(10)	N (添加于 2021年3月10日)

日志示例¶

{
        "date": datetime.datetime.today().strftime("%Y-%m-%d %H:%M:%S"),
        "dateTime": "2012-11-26 13:32:45",
        "category": "derbyday_score2_log",
        "channel": "C2S",
        "channel_uid": 11111,
        "game": "misample",
        "account_id": 0,
        "account_level": 96,
        "character_id": 0,
        "character_type_id": 0,
        "character_level": 0,
        "mode_id": 6,
        "mode_name": "ub79cub529uc561uc158",
        "submode_id": 9000303,
        "submode_name": "lv043",
        "grade_id": 1,
        "grade_name": "ub2f4uae30",
        "score": 100,
        "market": "GO",
        "server_ip": "111.111.11.111",
        "client_ip": "111.111.11.111",
        "country": "JP",
        "company": "C2S",
        "server_id": 0,
        "app_id": "com.com2us.misample.normal.freefull.apple.global.ios.universal",
        "guid": "ca4bd34c867f4617a819ae139d8d6670",
        "playtime": 10,
        "power" : 1,
        "battle_result" : "GIVEUP"
    }

如何使用¶

Score Log v2 有助于根据模式 > 子模式 > 等级检查用户的游戏频率和位置。
新模式或事件模式可用于分析用户的游戏类型。
在使用日志之前，请确保与游戏项目经理、平台规划团队的负责人和 BI 规划团队讨论如何区分模式 > 子模式 > 等级。