新規ユーザーログ
このログは、ゲームに新しいプレイヤーがいるときに保存されます。つまり、各ゲームサーバー（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タイプ（ログ定義に基づく）
| サーバー (2つのサーバーへの負荷分散) | 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 のような未指定の形式で送信されたログは、その列に保存されません。
| フィールド名 | 説明 | タイプ | 必須 |
|---|---|---|---|
| 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の3番目の項目です 例: "derbyday_new_user_log" | string | Y |
| timezone | ログの時間パラメータのUTCオフセット * ログ定義をscribeまたはftpタイプとして送信する際、日付の値は常にKSTであるため、タイムゾーンの値を**空白またはGMT+09:00**として固定します。 例: "GMT+09:00" * ログ定義をfluentdまたはhttpタイプとして送信する際、dateTimeの値に応じてタイムゾーンの値を柔軟に設定します。 例: "GMT+10:30" | string | Y |
| channel | ログインチャネル C2S: HIVE KAK: Kakao Talk LIN: LINE WEI: Weibo GVL: Gamevile Live | string(3) | Y |
| user_id | 設定されたチャネルフィールドで使用されるユーザー識別子 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 | OSバージョン情報 例: 9.2.1 | string(10) | 必須ではありませんが、推奨されます。 |
| game_language | ゲームに設定された言語（2文字） 参考: 識別子ポリシー 例: 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を実装することでリアルタイムプレイヤーの状態を提供します。
- 新しいリリースやゲームのマーケティングを通じて、ユーザーの量をすぐに確認するのに役立ちます。
