イベント保存構造¶

概要¶

送信されたイベントログが BigQuery に格納される構造、attributes JSON フィールドの詳細構造、転送ルールに違反したログの分離方法を確認できます。

テーブル構造¶

送信されたイベントログは、会社固有のBigQueryデータセットのt_raw_event_logテーブルに保存されます。

テーブル列構造¶

保存場所¶

列定義¶

attributes 例

{
  "hiveAttributes": {
    "dataSource": "custom_server",
    "geoIpCountry": "KR"
  },
  "eventAttributes": {
    "eventTime": "2026-07-20T14:01:01+09:00",
    "level": 10,
    "character_name": "AA",
    "stage_id": "stage_101"
  }
}

テーブル構造に関する注意事項 & Tips¶

• 再送信などで同じイベントが重複して保存される可能性があるため、照会時にchecksum基準重複排除クエリを一緒に使用することをお勧めします。
• 転送ルールに違反したイベントログは、このテーブルではなくテーブルに保存されます。詳細については、データ分離を参照してください。

attributes詳細属性¶

attributes 例¶

{
  "hiveAttributes": {
    "dataSource": "custom_server",
    "geoIpCountry": "KR"
  },
  "eventAttributes": {
    "eventTime": "2026-07-20T14:01:01+09:00",
    "level": 10,
    "character_name": "AA"
  }
}

hiveAttributes¶

パイプラインが自動的に処理して保存する領域。

dataSource詳細¶

dataSource はイベントログの転送プリンシパルを表し、次のいずれかの値が自動的に設定されます。

eventAttributes¶

ユーザーが送信した属性とSDKが自動的に収集した属性が格納される領域です。

attributes 注意事項 & Tips¶

• hiveAttributes は開発者が直接値を設定する領域ではなく、パイプラインが自動的に埋める領域です。 dataSource、geoIpCountry 以外の値は保存されません。
• カスタム属性とSDK自動収集属性はどちらもeventAttributesにまとめて保存されます。照会時に属性名で区切る必要があります。
• dataSource 値でイベントログの転送パス（SDK/サーバー/MMP など）を区分して照会できます。

データの分離¶

分離理由¶

分離テーブル構造¶

孤立したイベントログは、t_raw_event_log_rescue テーブルに次の構造で保存されます。

関連メニュー¶

• イベント属性転送 — 必須/自動収集/カスタム属性の詳細ルール
• イベントログの送信 — Hive SDK v4、Hive Axyl、Fluentd、HTTPによる送信方法