跳转至

新用户日志

每当游戏有新玩家时，都会存储此日志。这意味着每个游戏服务器（server_id）有新账户（user_id）时。

Note

确保将新用户日志以及登录日志发送到 Hive 服务器。
当用户初始化账户时，请勿发送此日志，因为 user_id 没有更改。

类别

  • 书写类型
公共服务器 new_user_log
测试服务器 test_new_user_log
  • FTP 类型
命名规则 new_user_[日期]_[服务器]_[避免重复的ID].json 例如，new_user_20180705_111500_GLOBAL-4.json
  • Fluentd 类型（基于日志定义）
服务器（将负载平衡到两个服务器） analytics-hivelog-03.withhive.com analytics-hivelog-04.withhive.com
标签命名规则 ha2union.game.[游戏简称].new_user_log 例如，ha2union.game.samplegame.new_user_log
字段category的值 [游戏简称]_new_user_log 例如，{"category":"samplegame_new_user_log","aaa":1}
详细传输方法
  • http 类型（基于日志定义）
服务器 https://analytics-log.withhive.com
类别 字段值 [游戏名称]_new_user_log (例) {"category":"samplegame_new_user_log","aaa":1}
详细传输方式

日志规范

Note

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

字段名称 描述 类型 必需
date 存储日志的时间
格式：yyyy-mm-dd hh🇲🇲ss
例如：2012-01-19 16:24:00
Scribe/FTP类型必需，Fluentd类型可选		 string N
dateTime 存储日志的时间
格式：yyyy-mm-dd hh🇲🇲ss
例如：2012-01-19 16:24:00		 string Y
category [游戏品牌名称]_[日志名称]
游戏品牌名称是app_id的第三项
例如："derbyday_new_user_log"		 string Y
timezone 日志中时间参数的UTC偏移
* 将timezone的值固定为**空白或GMT+09:00**，因为当以scribe或ftp类型发送日志定义时，日期值始终为KST。
例如："GMT+09:00"
* 在以fluentd或http类型发送日志定义时，根据dateTime的值灵活设置timezone的值。
例如："GMT+10:30"		 string Y
channel 登录渠道
C2S: HIVE
KAK: Kakao Talk
LIN: LINE
WEI: Weibo
GVL: Gamevile Live		 string(3) Y
user_id 与配置的channel字段一起使用的用户标识符
C2S: 在使用Hive UI和登录中心的游戏中为vid
KAK: App Center发放的用户标识符
LIN: App Center发放的用户标识符		 bigint Y
app_id Hive SDK使用的AppID
例如：'com.com2us.derbyday.kakao.freefull.google.global.android.common'		 string(200) Y
did Hive SDK使用的设备ID bigint Y
client_ip 客户端IP。此值从GeoIP提取国家值 string(32) Y
server_ip 服务器IP string(32) Y
device_name 用户设备型号
例如：iPhone, iPad, SM-G935, LGM-G600S		 string(32) Y
company 游戏发行公司，日志的目标：
例如："C2S": Com2uS, "GVI": Com2uS Holdings		 string(3) Y
server_id 服务器代码
请参见服务器代码表以输入'JSON输入代码'		 string Y
server_uid 游戏服务器中使用的用户标识符 bigint Y
country 如果未给出client_ip，请直接输入国家代码
参考：标识符政策
例如：KR		 string(2) N
os_version 操作系统版本信息
例如：9.2.1		 string(10) 不必需，但推荐。
game_language 游戏中设置的语言，使用两个小写字母
参考：标识符政策
例如：ko		 varchar 不必需，但推荐。
is_emulator 如果使用如BlueStacks的PC模拟器连接，则返回1；否则返回0
对于PC版本，返回2		 int 不必需，但推荐。
guid 每个日志生成的唯一键
推荐使用uuid等随机格式		 varchar(64) N

日志示例

  • 示例 1
{
    "date": "2012-12-19 16:28:38",
    "dateTime": "2012-11-26 13:32:45",
    "category": "derbyday_new_user_log",
    "channel": "KAK",
    "user_id": 88334245359848288,
    "app_id": "com.com2us.homerunking.kakao.freefull.apple.global.ios.universal",
    "client_ip": "110.70.30.199",
    "server_ip": "112.175.60.47",
    "guid": "ca4bd34c867f4617a819ae139d8d6670"
}
  • 示例 2
{
    "date": "2012-12-19 16:28:41",
    "dateTime": "2012-11-26 13:32:45",
    "category": "derbyday_new_user_log",
    "app_id": "com.com2us.tinypang.kakao.freefull.google.global.android.common",
    "channel": "KAK",
    "user_id": 88517016292546192,
    "server_ip": "112.175.107.41",
    "client_ip": "121.185.37.212",
    "server_id": 1,
    "guid": "ca4bd34c867f4617a819ae139d8d6670"
}

如何使用

  • 日志不显示 server_id（识别服务器），因此它利用表 NEWUSER_LOG。
  • server_id 根据游戏的不同而不同，但通常分为以下几类：
    1（韩国）；2（日本）；3（中国）；4（全球）。
    • NU：基于 user_id 的新用户数量。
    • NU（Did）：基于设备 ID 的新用户数量。
  • 每小时在服务器上提取堆叠日志，通过实现 openQuery 提供实时玩家状态。
  • 它帮助您通过新发布或游戏营销立即检查用户数量。