イベント設計および送信ガイド¶

イベントタクソノミーとは？¶

イベントタクソノミー(Event Taxonomy)は、収集するイベントと属性を一貫した構造と命名規則で体系化した分類体系です。

ゲームで発生する多数の行動データ（ログイン、購入、レベルアップなど）を何の規則もなく収集すると、チームごとに異なる名前で同じデータを送ったり、分析時にどのデータが何を意味するのか把握しにくくなります。イベントタクソノミーは、このような混乱を防ぎ、収集したデータをすぐに分析へ活用できるよう支援します。

なぜ必要なのですか？¶

構造¶

Analyticsのイベントタクソノミーは イベント と 属性 の2階層で構成されます。

イベント (Event)
├── プラットフォーム属性 (Platform Attribute)   ← SDK連携だけで自動収集
└── イベント属性 (Event Attribute)      ← イベントと一緒に直接送信

イベントとは？¶

イベントは、ユーザーがゲーム内で実行した特定の行動をデータとして記録した単位です。「いつ、誰が、何をしたか」を含み、分析の最も基本となる単位です。

• 例: ユーザーがアイテムを購入した → item_purchase イベント発生
• 例: ユーザーが特定ステージをクリアした → stage_clear イベント発生
• 例: ユーザーがアプリにログインした → login イベント発生

属性とは？¶

属性は、イベント発生時に一緒に記録される詳細情報です。イベントだけでは「何が起きたか」しか分かりませんが、属性によって「どの条件で、どの値で」発生したのかまで把握できます。

• 例: item_purchase イベントの属性 → アイテムID、決済金額、通貨単位
• 例: stage_clear イベントの属性 → ステージ番号、クリア時間、使用キャラクター

属性は、収集元に応じて2つに分かれます。

• プラットフォーム属性: 別途設定なしにSDK連携だけでHiveが基本収集する属性です。国、OS、アプリバージョン、サーバーIDなどが含まれます。
• イベント属性: イベントと一緒に直接送信する属性です。分析に必要な項目を直接定義して送信します。

ユーザー定義イベント送信¶

ゲームで直接定義したイベント（ユーザー定義イベント）は、以下の収集スキーマに合わせて送信すると、Analyticsで分析に活用できます。

実際のデータ送信には Hive SDKクライアントログ送信 の方法を使用します。送信に必要なソースコードは イベント の [ソース生成] タブ で言語ごとに自動生成できます。

イベント送信前に イベント でイベント名と属性をあらかじめ定義しておくと、チーム内での共有と管理が便利です。ただし、事前定義なしにデータを送信してもAnalyticsは受信データを自動認識し、最大1時間以内にイベント一覧へ反映されます。

Analytics収集スキーマ¶

ユーザー定義イベント送信時に使用する基本スキーマです。すべてのイベントは以下の形式で送信する必要があります。

イベント名の命名規則¶

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

• 推奨文字: 英字(a–z, A–Z, 大/小文字区別)、数字(0–9)、アンダーバー(_)、ハイフン(-)
• 区切り文字: 単語間はスペースではなくアンダーバー(_)で区切る
• 形式: イベントを明確に説明する 名詞_動詞 形式を推奨
• 例: item_purchase, level_up, tutorial_complete, stage_start

hiveAttribute / eventAttribute 構造例¶

hiveAttribute と eventAttribute は、それぞれJSONオブジェクト形式で送信します。

hiveAttribute — Hiveプロビジョニングサーバーから提供されるプラットフォーム属性です。マーケット、サーバーIDなどが該当し、現在は開発者が直接値を設定して送信する必要があります。将来的には自動収集方式に変更される予定です。

{
  "market": "GO",
  "serverId": "Asia"
}

eventAttribute — イベントと一緒に直接送信する属性です。該当イベントを分析するために必要な詳細情報を含みます。

{
  "level": "100",
  "contentsType": "dungeon"
}

属性名の命名規則¶

eventAttribute および hiveAttribute のキー名は、以下の規則に従って作成することを推奨します。

• 推奨文字: 英字(a–z, A–Z, 大/小文字区別)、数字(0–9)、アンダーバー(_)、ハイフン(-)
• 区切り文字: 単語間はスペースではなくアンダーバー(_)で区切る
• 例: item_id, contents-type, stage_level

属性キー変換規則¶

属性を送信すると、システムが以下の規則に従って一部のキー名を自動変換します。分析時に実際に参照されるキー名が変わるため注意してください。

-Hive 接尾辞 (hiveAttribute)¶

hiveAttribute の すべて のキー末尾に -Hive が自動で付与されます。

-Event 接尾辞 (eventAttribute)¶

eventAttribute のキーのうち、以下の 8つの共通フィールド と名前が重複する場合にのみ -Event が自動で付与されます。

• timezone, dateTime, identifierProvider, userId, deviceId, appId, category, eventName

推奨イベント¶

以下は、Analyticsで活用度の高いイベント例です。各イベントを eventName と eventAttribute に合わせて送信すると、チャート・ファネル・リテンションなどAnalyticsの各機能ですぐに分析できます。

レベルアップ¶

eventAttribute (共通):

通貨¶

eventAttribute (共通):

コンテンツ¶

eventAttribute (共通):

インアプリストア¶

eventAttribute (共通):

メイト¶

eventAttribute (共通):

社会活動¶

関連メニュー¶

• イベント — イベントおよび属性の登録・管理
• メトリック — よく使うイベント集計設定をメトリックとして保存