ゲームプレイ分析通貨ログ
各ゲームインジケーターのゲームプレイインジケーターダッシュボードにおける通貨変動インジケーターは、分析のためにこのログを必要とします。ゲーム内での商品の取得または消費によって変化が発生した場合、各商品の変化と各ユーザーの商品の平均変化を確認するためにログが送信され、商品の変化量のデイリー変化と各商品の最高変化量に基づいてTOP 10の行動を確認できます。
ログを送信する¶
財務指標のログを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 ss” 形式のログタイムスタンプ (例: “2022-11-15 10:20:10”) Hive SDK クライアントログ送信機能を使用する際に自動的に送信されます。 | STRING | Y |
| timezone | dateTime のタイムゾーンは、クライアント IP を使用して タイムゾーンチェックメソッドを通じて取得できます。空白または値がない場合は KST に基づいて決定されます (例: "GMT+09:00")。 Hive SDK クライアントログ送信機能を使用する際に自動的に送信されます。 | STRING | |
| category | 商品ログのカテゴリ分類値、値は “pub_asset_log” に固定されています。 | STRING | Y |
| assetName | 通貨名 (例: ダイヤモンド) 検索条件として使用され、すべての指標テーブル/グラフの標準商品名として使用されます。 | STRING | Y |
| actionName | 通貨の変更理由 (例: アプリ内購入) “アクションによる通貨の消費” および “アクションによる通貨の取得” 指標アクション項目に使用されます。 | STRING | Y |
| serverId | サーバーID 検索条件として使用されます Hive SDKクライアントログ送信機能を使用する際に自動的に送信されます。 | STRING | |
| userId | ゲーム内のユーザーのユニークID playerIdフィールドが0またはnullの値を含む場合、アイテムを計算するためのユーザー識別キーとして使用されます。 | STRING | |
| amountPrev | 変更前の通貨の金額 | INTEGER | |
| amountVar | 通貨の変化量 * 消費: 負の数として送信（例: -100） * 獲得: 正の数として送信（例: 100） すべての通貨変化指標の変化を計算する際に使用されます。 | INTEGER | Y |
| amountCurr | 変更後の通貨の金額 ゲーム内の通貨指標の所有を計算する際に使用されます。 | INTEGER | Y |
| contentsModeTypeName | コンテンツ使用による通貨変化がある場合、コンテンツごとの通貨変化を計算する際に使用されるコンテンツモードタイプ名（例: "raid"） | STRING | |
| isPaid | 通貨が有料かどうかを示す値 * "Y": 有料通貨 * "N": 無料通貨 | STRING | Y |
送信されたログの確認¶
- ゲームログを送信した後、ログ定義機能でログを確認できます。
- すべての必須フィールドが正しく記入されている場合、送信は指標に反映され、表示されます。