カスタムユーザープロパティログ
セグメントは、Hive SDKから収集された情報であり、事前定義されたプロパティに加えて、プロパティ値を自由に定義することで送信および選択できます。
プロパティの送信¶
ユーザー定義のプロパティ値を送信するには、Hive SDKクライアントログ送信を使用できます。
ログ送信のサンプルコードは、ログ定義機能のクライアントソース生成機能を通じて確認できます。
プロパティ送信仕様¶
フィールドはキャメルケース（例：dateTime）で構成され、大文字と小文字を区別します。値は次のケースでは保存されません。
- フィールド名が指定された通りに定義されていない場合（例: “time“）
- フィールド名が正確にフィールド名と一致しない場合（例: “app_id“）
- 値が各フィールドに定義された型でない場合（例: “playerid”フィールドの“474392047”）
注意事項
- STRING: 最大1 MBの文字列データ
- INTEGER: 符号付き64ビット（-9,223,372,036,854,775,808から9,223,372,036,854,775,807まで）のデータ
- 各フィールドの型に一致しないデータが送信された場合、対応するフィールドが正しく保存されない可能性があるため、型に一致する値を送信する必要があります。
| フィールド名 | 説明 | タイプ | 必須 |
|---|---|---|---|
| playerId | Hive 認証でユーザーを識別するユニークキー [Hive SDK クライアントログ送信機能]を使用する場合、自動的に送信されます | 整数 | はい |
| uid | Hive メンバーシップのユーザーキー。UID が 90000000000 を超える場合、ゲストユーザーキーを表します Hive SDK クライアントログ送信機能を使用する場合、自動的に送信されます | 整数 | |
| appId | App Centerによって発行されたappId Hive SDKクライアントログ送信機能を使用する際、自動的に送信されます | STRING | Y |
| guid | プロパティの行の一意のキー値 uuidのようなランダムな文字列形式が推奨されます Hive SDKクライアントログ送信機能を使用する際、自動的に送信されます | STRING | Y |
| datatime | プロパティ発生時間の形式は「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 | Y |
| category | “pub_user_property_log”に固定 | STRING | Y |
| propertyDataType | ゲーム内ユーザーのプロパティ値のデータ型として設定できる値は以下の4つのいずれかです（例：“string”）。 * “string“: プロパティ値を文字列として区別する必要がある場合 * “integer“: プロパティ値を整数として区別する必要がある場合。集計を必要とするプロパティの場合、集計結果は整数であるべきです * “float“: プロパティ値を浮動小数点数として区別する必要がある場合。集計を必要とするプロパティの場合、集計結果は浮動小数点数であるべきです * “timestamp“: プロパティ値を時間値として区別する必要がある場合。形式はyyyy-mm-dd hh:mm:ssであるべきです セグメントを作成する際にプロパティのデータ型に対してプロパティ値を選択する能力を提供するために使用されます | STRING | Y |
| propertyName | ゲーム内でユーザーが持つプロパティ値の名前（例：“成功ステータス”） プロパティ値が英語の場合、大文字と小文字は区別されません プロパティ値がスペースを含む28バイトを超えると、送信されたプロパティがセグメントページに表示される際に改行が発生する可能性があります。 セグメントを作成する際にプロパティを選択するために使用されます | STRING | Y |
| propertyValue | ゲーム内ユーザーのプロパティ値（例：“失敗”） セグメントを作成する際にプロパティ名に対応する値を選択するために使用されます | STRING | Y |
送信されたプロパティの確認¶
- ユーザープロパティを送信した後、ログ定義機能で確認できます。
- ユーザープロパティ定義のすべての必須フィールドに値が正常に入力されている場合、セグメントを作成する際にユーザーを選択できます。