ゲームプレイ分析メイトログ
これは、各ゲームインジケーターのゲームプレイ分析ダッシュボードにおけるメイトインジケーターに必要なログです。メイトとは、ゲームユーザーキャラクターの従属的な仲間であり、ペット、アバター、またはモンスターなどを指します。メイトの取得と消費の変化が発生すると、ログが送信され、取得と消費の比率や差異の数、ルートごとの取得/消費の数、グレードごとの取得/消費/総変化のユーザー数を調査できるようになります。
ログの送信¶
マテ指標のログをSDKクライアントログ配信方法を使用して送信します。
送信するログのサンプルは、ログ定義 – クライアントソースの作成から確認できます。
ログ仕様¶
フィールドはCamelCase形式（例：serverId）で構成されており、大文字と小文字を区別します。以下の場合、値は保存されません：
- フィールド名が以下に定義されていない場合（例：uid）。
- フィールド名がフィールド名と正確に一致しない場合（例：serverid）。
- 各フィールドでタイプが定義されていない場合（例：「474392047」は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 | mate ログのカテゴリ分類値、値は “pub_mate_log” に固定されています | STRING | Y |
| mateId | 各 mate を識別する値である mate ID | STRING | |
| mateGrade | メイトグレード（例：レア） すべてのインジケーターメイトグレードを分類するために使用 | STRING | Y |
| serverId | サーバーID 検索条件として使用 Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。 | STRING | |
| userId | ゲーム内のユーザーのユニークID playerIdフィールドに値0またはnullが含まれている場合、アイテムを計算するためのユーザー識別キーとして使用されます。 | STRING | |
| mateChangeFlag | メイトの変動フラグ（例：引き分け） * 購入、引き、昇進、合成、販売、削除など アイテムパス、グレード別の取得パス、グレード別の消費パスに使用 | STRING | Y |
| mateChangeAmount | メイトの変化量 * 消費：負の数（例：-1）として送信 * 取得：正の数（例：1）として送信 アイテムパス、グレード別の取得パス、グレード別の消費パスに使用 | INTEGER | Y |
送信されたログの確認¶
- ゲームログを送信した後、ログ定義機能でログを確認できます。
- すべての必須値がマテログ定義に従って入力されている場合、送信は指標に反映され表示されます。