コンテンツにスキップ

イベント属性の送信

概要

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

必須属性

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

必須属性ネーミング規則

必須属性名は、キャメルケース（camelCase）または**小文字**（lowercase]）に送信する必要があります。 user_id のようにスネークケース(snake_case) に転送すると正常に処理されず、rescue テーブルとして分離 されます。

属性名 説明 データ型 例
userId アカウントベースのユーザー識別子 STRING 100001
deviceId 端末基準ユーザー識別子 STRING 100000
identifierProvider ユーザー識別子発行システム。 hive固定 STRING hive
appId Hiveコンソール>アプリセンターに登録されているProject ID STRING com.com2us.game.ios
appIdGroup Hiveコンソール>アプリセンターから発行されたGame ID. appId 転送時に自動生成 STRING com.com2us.game
eventTime イベント発生時刻。 RFC 3339国際標準（タイムゾーンを含む） STRING 2026-07-20T14:01:01+09:00
eventName イベントを分類するイベント名 STRING asset_drop
appId / appIdGroup 転送ルール

イベントを送信するときは、appId または appIdGroup のいずれかを必ず含める必要があります。

  • appId を知っている場合: appId のみ送信してください。 appIdGroup は自動生成されます。
  • appIdがわからない場合: appIdGroupを直接送信してください。
  • 2つの値を同時に送信すると、appIdを基準にappIdGroupが再生成されるため、appIdを送信するときはappIdGroupを含めないでください。
必須属性転送時の注意

次のいずれかの条件が該当する場合、イベントログは**rescueテーブルとして分離** になります。

  • appId または appIdGroup の両方がない場合
  • 残りの必須属性（userId、identifierProvider、deviceId、eventTime、eventName）のいずれかが欠落しているか空の値の場合
  • 値が不明な場合でも空のままにしないでください。"0" または "unknown" などの任意の値を入力して転送してください。

eventName命名規則

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

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

上記の規則に準拠していないイベント名は、分析に使用するために制限がある可能性があります。

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にそのまま保存されます。
eventTime 転送時の注意

eventTime は現在の時刻基準 過去 31 日～将来 31 日 の範囲内の値のみ許可されます。この範囲外の場合、イベントログはrescueテーブルとして分離されます。

カスタム属性

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

属性名規則

ルール 説明 例
開始文字 必ず**英語の小文字または大文字**で始まります。 level、Stage
大文字と小文字の区別 カスタム属性は大文字と小文字を区別します。 market != Market != MARket
許可特殊文字 特殊文字はアンダースコア（_）のみを許可します。 item_name

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

ユーザー定義属性を転送する際の注意

以下の予約語を属性名として使用すると、rescue テーブルとして分離 となります。大文字と小文字に関係なく同じことが当てはまります。

予約語 備考
attributes 大文字と小文字の無関係（例：Attributes、ATTRIBUTES）
eventAttributes 大文字と小文字の関係
hiveAttributes 大文字と小文字の関係

属性値ルール

属性値の形式に関する注意事項

属性値は 数値型 と 文字型 2 ですが転送可能です。 JSON オブジェクト , JSON 配列 , JSON 型の文字列形式で転送すると**rescue テーブルとして分離** になります。

データ型 説明 例
数値型 整数または小数。引用符なしで送信 "level": 10、"exp": 1.5
文字型 必ず二重引用符（""）で囲んで送信 "character_name": "AA"

属性値が 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 を除く)

属性名 説明 例
userId アカウントベースのユーザー識別子。 Hive SDK 連動時AuthV4.getPlayerInfo()のplayerId 値 100001
deviceId 端末基準ユーザー識別子。 Hive SDK 連動時AuthV4.getPlayerInfo()のdid 値 100000
identifierProvider ユーザー識別子発行システム。現在Hive SDK連動のみをサポートしているため、hive固定 hive
appId Hiveコンソール>アプリセンターに登録されているProject ID com.com2us.game.ios
appIdGroup Hiveコンソール>アプリセンターから発行されたGame ID. appId 転送時に自動生成 com.com2us.game
eventTime イベント発生時刻。 RFC 3339国際標準（タイムゾーンを含む） 2026-07-20T14:01:01+09:00

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

属性名 説明 ドメイン 例
vid プロジェクト（ゲーム）ごとに発行されるユーザーアカウント固有の識別子（と同じ）。ログイン完了後有効です。 Hiveプラットフォーム（認証） 136910540
uid ハイブ会員登録時に発行されるアカウント固有の識別子で、vidの上位概念です。 Hiveプラットフォーム（メンバーシップ） 223786026
did アプリのインストール時にデバイスごとに発行される一意の識別子（deviceIdと同じ）。アプリの再インストール時に新規発行されます。 Hiveプラットフォーム（プロビジョニング） 938743951
vid_type vid の発行方式とアカウントのタイプ。 Hiveプラットフォーム（アプリセンター） v4
analytics_id デバイスを追跡するためにクライアントが作成して永続化するUUID.アプリが削除されるまで保持され、MMPトラッカーと同じ値を共有します。 Hiveプラットフォーム（プロビジョニング） 1qIXG3uDT4WzhV1e46GIYQ==

時間/識別情報

属性名 説明 ドメイン 例
dateTime イベントログの送信時に生成されるイベント発生日時。 （yyyy-MM-dd HH🇲🇲ss形式） 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

デバイス情報

属性名 説明 ドメイン 例
model デバイスのハードウェアモデル識別子です。 デバイス iPhone17,3
os デバイスのオペレーティングシステムの区切りコードです。 (iOS: I, Android: A) デバイス I
os_version デバイスのオペレーティングシステムのバージョンです。 デバイス 26.5.2
cpu デバイスの CPU アーキテクチャです。 デバイス arm64
language 端末に設定されているユーザーの好みの言語とロケールコード。 デバイス ko-KR
device_country 端末の地域設定に基づく国コードです。 デバイス KR
hive_country 接続IPに基づいてHiveサーバーによって決定された国コード。 VPN 使用時の機器設定と異なる場合があり、判定不可時UNKNOWNとして記録されます。 Hiveプラットフォーム（コア） KR

SDK/アプリビルド情報

属性名 説明 ドメイン 例
app_version アプリの内部ビルドバージョンです。 Hive SDK (ビルド) 1.0.32
app_version_display ストアに公開されるアプリリリース版です。 Hive SDK (ビルド) 1.0.32
sdk_version 現在のプロジェクトに適用されているバージョン Hive SDK。 Hive SDK (ビルド) 4.26.4.0
interface_version 現在適用されているSDKのインタフェースバージョン。 Hive SDK (ビルド) 4.26.4.0
build_time 適用された Hive SDK のビルドタイムスタンプです。 Hive SDK (ビルド) 202605281104

SDK設定情報

属性名 説明 ドメイン 例
server_id クライアントでAPIに設定したゲームサーバー識別子。 Hive SDK (設定) kr
game_language API に設定されたゲーム内標準言語コードです。未設定の場合は、端末の言語に置き換えられます。 Hive SDK (設定) ko
channel 設定ファイル基準のプラットフォームチャネル区切り文字です。 Hive SDK (設定) HIVE
market アプリがリリースされたマーケットコードです。 (Apple: AP, Google: GO) Hive SDK (設定) AP
company アプリをサービスするパブリッシャーまたは会社の区切り文字列。 Hiveプラットフォーム（アプリセンター） hive
companyIndex アプリをサービスするパブリッシャーまたは会社区分インデックス。 Hiveプラットフォーム（アプリセンター） 3
age_gate_u13 13歳未満（COPPA）年齢ゲート対象かどうか。 SDK 初期化の前に null を指定できます。 Hive SDK (設定) false

受信サーバー情報

属性名 説明 ドメイン 例
clientIp イベントログを送信したクライアントの実際の接続IP. 受信サーバから抽出し、保存時に最後のオクテットがマスキングされます。 受信サーバー（WAS） 123.123.123.0

注意事項 & Tips

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

関連メニュー