分数日志 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 | |
| 類別 欄位的值 | [遊戲的簡短名稱]_score2_log | 例如，{"category":"samplegame_score2_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_score2_log" | 字串 | Y |
| timezone | 日誌中時間參數的 UTC 偏移量 * 將時區的值固定為 空白或 GMT+09:00，因為當以 scribe 或 ftp 類型發送日誌定義時，日期總是 KST。 例如: "GMT+09:00" * 在以 fluentd 或 http 類型發送日誌定義時，根據 dateTime 的值靈活設置時區的值。 例如: "GMT+10:30" | 字串 | Y |
| channel | C2S: HIVE KAK: Kakao LIN: LINE WEI: 微博 | 字串(3) | Y |
| channel_uid | 登錄通道上的用戶識別符 (通常使用 bigint，但某些通道可能使用字串類型) 如果信息未知（例如 LINE），則發送 0 | 字串(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 | 字串(50) | Y |
| server_id | 伺服器代碼 參考 伺服器代碼表 輸入伺服器代碼 (JSON 輸入代碼) | 字串 | 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。使用韓文 | 字串(50) | Y |
| submode_id | 子遊戲模式的識別符 (從 1 開始)。沒有子模式時，設置為 0 | int | Y |
| submode_name | 子遊戲模式的名稱。沒有子模式時，設置為 0 用於顯示 ims。使用韓文 | 字串(50) | Y |
| grade_id | 等級 ID 的識別符 (從 1 開始)。沒有等級時，設置為 0 | int | Y |
| grade_name | 等級名稱。沒有等級時，設置為 0 用於顯示 ims。使用韓文 | 字串(50) | Y |
| score | 用戶的遊戲得分 如果遊戲僅記錄勝負，則平均得分為勝率；100 表示勝利，0 表示失敗 | int | Y |
| client_ip | 客戶端 IP。此值從 GeoIP 中提取國家值 | 字串(32) | Y |
| server_ip | 伺服器 IP | 字串(32) | Y |
| company | 遊戲發行公司，日誌的目標: 例如: "C2S": Com2uS, "GVI": Com2uS Holdings | 字串(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 | 字串(2) | Y |
| country | 如果未提供 client_ip，則直接輸入國家代碼 例如: KR | 字串(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 | AppID 由 Hive SDK 使用 例如，‘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規劃團隊討論如何區分模式 > 子模式 > 等級。