イベント属性の送信¶

概要¶

ゲームイベントログは、必須属性、カスタム属性で構成されます。 Hive SDK v4 を連動すると、別途転送せずに自動的に収集される属性が追加されます

必須属性¶

ゲームイベントログを送信するときに**必ず含める**する属性です。

eventName命名規則¶

eventNameに使用するイベント名は、以下の規則に従って作成することをお勧めします。

• 推奨文字: 英字（a–z、A–Z、大文字と小文字を区別）、数字（0–9）、アンダースコア（_）
• 区切り文字：単語間は空白ではなくアンダーバー（_）で区切ります
• 形式: イベントを明確に説明する英語の noun_verb 形式を推奨します。
• 例: item_purchase, level_up, tutorial_complete, stage_start

eventTime フォーマット規則 (RFC 3339)¶

eventTime は RFC 3339 形式に従い、タイムゾーン情報を含める必要があります。

形式:

YYYY-MM-DDTHH:MM:SS[.sss]+HH:MM または YYYY-MM-DDTHH:MM:SSZ

許可の例：

2026-07-20T14:01:01+09:00 (KST, 韓国標準時)
2026-07-20T05:01:01Z            (UTC)
2026-07-20T14:01:01.123+09:00 (ミリ秒含む)
2026-07-20T23:01:01-05:00 (米国東部時間)

許可されていない例：

2026-07-20 14:01:01 (タイムゾーンなし → 隔離)
2026-07-20(時間なし→隔離)
1719835261 (Unix timestamp → 分離)
14:01:01 (日付なし → 隔離)

eventTime¶

• eventTime はパイプラインで UTC に変換 され、テーブルの dateTime 列に保存されます。元の値はattributes.eventAttributes.eventTimeにそのまま保存されます。

カスタム属性¶

ゲームから送信したい情報を属性名と属性値で構成し、必須属性とともに直接送信します。

属性名規則¶

使用できない属性名（予約語）¶

属性値ルール¶

属性値が JSON オブジェクト , JSON 配列 , JSON 型の文字列型の場合 rescue テーブルとして分離 になります。

// JSON オブジェクト (許可されていません)
"info": {"key": "value"}

// JSON 配列（許可されていません）
"items": [1, 2, 3]

// JSON 形式の文字列（許可されていません）
"data": "{\"key\": \"value\"}"

同じ属性名の重複送信¶

同じ属性名を 2 つ以上転送すると、属性値はランダムに選択され、1 つだけ保存 されます。

Hive SDK v4 自動収集属性¶

クライアントから Hive SDK v4 にイベントログを送信する場合にのみ自動的に収集されます。

• ユーザーが同じ属性名で直接値を転送すると、SDKが自動収集した値の代わりに**ユーザーが送信した値**が保存されます。
• 以下の属性はテーブルのattributes.eventAttributesに保存されます。

Hive SDK v4 イベントログ送信機能を使用する場合、SDK がクライアントデバイスから直接収集して送信する属性です。

必須属性¶

必須属性 のうち、SDK v4 が自動的に収集する属性です。 (eventName を除く)

ユーザー/アカウント識別情報¶

時間/識別情報¶

属性名	説明	ドメイン	例
dateTime	イベントログの送信時に生成されるイベント発生日時。 （yyyy-MM-dd HHss形式）	Hive SDK (コア)	2026-01-01 00:00:00
guid	イベントログの送信ごとに生成される UUID (ハイフン除去)。イベントログの一意の識別と重複排除に使用されます。	Hive SDK (コア)	ecbfbd7fcdc340e1b8a433999c5290c1
is_hive_time	イベントログのタイムスタンプがサーバーの時刻と同期しているかどうかフラグ。 （Y/N）	Hive SDK (コア)	Y
timezone	dateTime 値の基準となるタイムゾーンオフセット情報です。	Hive SDK (コア)	GMT+09:00
is_url_encode	イベントログ送信時にURLエンコーディングを適用するかどうかを示すフラグ。 （Y固定）	Hive SDK (コア)	Y

デバイス情報¶

SDK/アプリビルド情報¶

SDK設定情報¶

受信サーバー情報¶

注意事項 & Tips¶

• 必須属性名はキャメルケースまたは小文字で送信する必要があります。スネークケース（user_id）で送信すると、rescueテーブルに隔離されます。
• appId または appIdGroup のいずれかを必ず含める必要があり、両方がない場合は隔離されます。
• eventTime は RFC 3339 形式（タイムゾーン含む）のみ許可され、現在時刻基準過去・未来 31 日を超えれば隔離されます。
• カスタム属性名として、attributes、eventAttributes、hiveAttributes は使用できません（大文字と小文字を問わない）。
• 属性値は数値型・文字型のみ許可され、JSON オブジェクト・配列・JSON 型の文字列は分離されます。
• 隔離されたログを確認して再送信する方法については、データ分離を参照してください。

関連メニュー¶

• イベント転送 — イベント・属性概念案内
• イベントテンプレート — 区分別基本自動収集イベント一覧
• イベントログの送信 — Hive SDK v4、Hive Axyl、Fluentd、HTTPによる送信方法
• イベント記憶構造 — テーブル構造、attributes 詳細属性、データ分離