コンテンツにスキップ

ゲームプレイ分析レベルアップログ

これは、各ゲームインジケーターのゲームプレイ分析ダッシュボードにおけるレベルアップインジケーターに必要なログです。ゲーム内のユーザーアカウントまたはキャラクターでレベルアップイベントが発生すると、検索期間の種類ごとのレベルアップの変更回数、ユーザー数、および最終レベルに基づくユーザー数を確認するためにログが送信されます。

ログ送信

レベルアップインジケーターのログをSDKクライアントログ配信方法を使用して送信します。

送信するログのサンプルは、ログ定義 - クライアントソースの作成から確認できます。

ログ仕様

フィールドはCamelCase(例:serverId)の形式で構成されており、大文字と小文字を区別します。以下の場合、値は保存されません:

  • フィールド名が以下に定義されていない場合 (例: uid)。
  • フィールド名がフィールド名と正確に一致しない場合 (例: serverid)。
  • 各フィールドでタイプが定義されていない場合 (例: “474392047” for vid)。

注意事項

  • STRING: 最大1MBの文字列データ
  • INTEGER: 符号付き64ビット(-9,223,372,036,854,775,808から9,223,372,036,854,775,807まで)のデータ
  • 各フィールドの型と一致しないデータが送信されると、フィールドが正しく保存されない可能性があるため、型に一致する値で送信する必要があります。
フィールド名 説明 必須
playerId Hive認証でユーザーを識別するユニークキー
Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。
INTEGER Y
appId App Centerによって発行されたアプリID
Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。
STRING Y
guid ログの行に対するユニークキー値
uuidのようなランダム文字列形式が推奨されます
Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。
STRING Y
dateTime “YYYY-MM-DD hh:mm:ss”形式のログタイムスタンプ
(例: “2022-11-15 10:20:10”)
Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。
STRING Y
timezone dateTimeのタイムゾーン
クライアントIPを使用してタイムゾーン確認メソッドを通じて取得できます。空白または値がない場合はKSTに基づいて決定されます(例: “GMT+09:00”)
Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。
STRING
category レベルアップログのカテゴリ分類値、値は“pub_levelup_log”として固定されています。 STRING Y
levelUpType レベルアップタイプ(例:“アカウント”) 
設定可能な値は以下の4つのいずれかです 
* “アカウント”
* “キャラクター”
* “ギルド”
* “スキル”
すべての指標レベルアップタイプ分類を計算する際に使用されます
セグメント作成ページでは、アカウントにレベル値を送信する際に要素を選択できます
STRING Y
serverId サーバーID
検索条件として使用されます
Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。
STRING
userId ゲーム内のユーザーのユニークID
playerIdフィールドが0またはnullの値を含む場合、アイテムを計算するためのユーザー識別キーとして使用されます。
STRING
levelPrev レベルアップ前のレベル INTEGER
level レベルアップ後のレベル
“最後にレベルアップしたユーザーの数”を計算する際に使用されます
INTEGER Y

送信されたログの確認

  • ゲームログを送信した後、ログ定義機能でログを確認できます。
  • すべての必須値がレベルアップログ定義フィールドに正しく入力されている場合、インジケーターは送信を反映して表示します。