跳轉至

新用户日志

每當遊戲有新玩家時，這個日誌會被儲存。這意味著每個遊戲伺服器（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類型可選		 字串 N
dateTime 儲存日誌的時間
格式：yyyy-mm-dd hh🇲🇲ss
例如：2012-01-19 16:24:00		 字串 Y
category [遊戲品牌名稱]_[日誌名稱]
遊戲品牌名稱是app_id的第三項
例如："derbyday_new_user_log"		 字串 Y
timezone 日誌中時間參數的UTC偏移
* 當以scribe或ftp類型發送日誌定義時，將timezone的值固定為**空白或GMT+09:00**，因為當發送日誌定義時，日期始終為KST。
例如："GMT+09:00"
* 當以fluentd或http類型發送日誌定義時，根據dateTime的值靈活設置timezone的值。
例如："GMT+10:30"		 字串 Y
channel 登錄渠道
C2S: HIVE
KAK: Kakao Talk
LIN: LINE
WEI: Weibo
GVL: Gamevile Live		 字串(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'		 字串(200) Y
did Hive SDK使用的設備ID bigint Y
client_ip 客戶端IP。此值從GeoIP提取國家值 字串(32) Y
server_ip 伺服器IP 字串(32) Y
device_name 用戶設備型號
例如：iPhone, iPad, SM-G935, LGM-G600S		 字串(32) Y
company 遊戲發行公司，日誌的目標：
例如："C2S": Com2uS, "GVI": Com2uS Holdings		 字串(3) Y
server_id 伺服器代碼
請參見伺服器代碼表以輸入'JSON輸入代碼'		 字串 Y
server_uid 在遊戲伺服器中使用的用戶標識符 bigint Y
country 如果未提供client_ip，則直接輸入國家代碼
參考：標識符政策
例如：KR		 字串(2) N
os_version OS版本信息
例如：9.2.1		 字串(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 提供實時玩家的狀態。
  • 它幫助您通過新版本或遊戲的市場營銷立即檢查用戶數量。