イベント¶
概要¶
イベントは、アナリティクスのすべての分析の基礎となるイベントおよびイベントサブに生成された属性を確認および管理する機能です。
SDKを連動するだけでログイン、購入などのイベントが別途開発せずに自動的に収集されます。ここで必要なイベントを直接定義して追加すると、より正確な分析が可能になります。
カスタムイベントを直接送信するには、イベント転送を参照してください。
何ができますか？¶
ビジネス/マーケティング担当者¶
- 分析に必要なイベントと属性をこの画面で定義すれば、開発チームに伝える企画文書としてすぐに活用できます。
- 現在収集中のイベントのリストを一目で把握すると、どのデータで分析が可能かをすぐに確認できます。
データアナリスト¶
- イベントリストから分析可能なイベントと属性の全体的な現状を把握すれば、分析範囲を素早く設計できます。
- データプレビューでイベントの実際の値を直接確認し、分析前にデータ品質を検証できます。
開発者¶
- イベント名と属性リストをこの画面ですぐに確認することで、SDK連動作業を効率的に進めることができます。
- イベント送信後データプレビューで受信した属性値を確認すると、転送結果を即座に検証できます。
- ETL シミュレーション 機能を利用すると、実際の展開前にイベント転送結果を事前に確認できます。
クイックスタート¶
最初のイベントを登録する場合は、次の手順に従って最初のイベントを作成してみてください。
1.左サイドバーで、**データ>イベント**メニューをクリックします。 2.右上の**登録**ボタンをクリックします。 3. イベント名とイベントの説明を入力します。 4. プロパティタブに移動して、イベントとともに送信するプロパティを追加します。 5. 属性名、説明、データ型を設定します。 6. **保存**ボタンをクリックします。 7.開発部門にイベント名と属性のリストを渡してイベントデータの転送を要求します。
Note
イベント属性・データプレビュー・ETLシミュレーションなどの詳細設定については、全機能をご参照ください。
フル機能¶
主な概念¶
| コンセプト | 説明 |
|---|---|
| イベント | ユーザーがゲームで行った特定の行動のデータ記録単位（例：ログイン、購入、レベルアップ） |
| ロ自動収集イベント | SDK連動のみでHiveから基本に収集するイベント |
| ㄴMMPイベント | Airbridge、AppsFlyer、AdjustなどMMP を介して送信されるイベント |
| ㄴカスタムイベント | 直接定義して送信するカスタムイベント |
| プロパティ | イベントが発生したときに一緒に記録される詳細データ項目 |
| ロ自動収集プロパティ | SDK 連動のみで Hive で基本的に収集する属性 (例: 国、マーケット、サーバー ID、OS など) |
| ロカスタム属性 | イベントと共に直接送信する属性（たとえば、購入イベントのアイテム、金額、通貨単位） |
イベントリストの照会¶
アナリティクスに登録されているすべてのイベントを一覧表示します。 
フィルタと検索¶
| オプション | 説明 |
|---|---|
| イベントの種類 | イベントの種類（カスタムイベント、AppsFlyer、Airbridgeなど）によるリストフィルタ |
| イベント名/作成者検索 | 検索条件（イベント名またはコンストラクタ）を選択し、検索語を入力してイベントを検索します。 |
| 使用中のイベントのみを表示 | トグル ON 使用するかどうかがアクティブなイベントのみを表示します。 |
リスト列¶
| 列 | 説明 |
|---|---|
| 番号 | イベント登録順番 |
| イベントの種類 | カスタム/ AppsFlyer / Airbridgeなどイベントソース |
| イベント名 | イベント名。クリックすると詳細ページに移動します。 |
| 説明 | イベント登録時に入力した説明 |
| 作成日 | イベントが最初に登録された日時 |
| 作成者 | イベントを登録したアカウント。システム自動生成イベントはsystemで表示されます。 |
| データ最終入力日 | そのイベントのデータが最後に収集された日時。 10分単位で同期し、収集履歴がない場合は- |
| 使用可否 | トグルでイベントのアクティブ/非アクティブ制御。 OFF時イベントを選択するとリストから非表示になります。 |
イベント登録¶
イベント一覧画面右上の**登録**ボタンをクリックするとイベント登録ページに移動します。 
| アイテム | 必須 | 説明 |
|---|---|---|
| イベント名 | 必須 | 実際のデータ転送に使用する固有のコード |
| 説明 | 選択 | イベントの発生条件と目的説明 |
Note
アナリティクスが推奨するイベント名の命名規則については、イベント転送を参照してください。
イベント詳細検索¶
[基本情報]タブ¶
登録されたイベントのイベント名と説明を確認して修正します。 
[プロパティ]タブ¶
各イベントに一緒に送信される属性を定義します。 
| アイテム | 説明 |
|---|---|
| 属性名 | 実際の転送に使用するコード |
| 説明 | 属性値の意味と例 |
| データタイプ | 文字/数字/日付型のうち1 |
データ型の説明¶
| タイプ | 説明 | 例 |
|---|---|---|
| 文字 | 文字列値 | 国コード（KR）、アイテム名（sword） |
| 番号 | 整数値または 10 進数値 | レベル (50)、支払い金額 (9.99) |
| 日付 | 日付/時刻値 | イベント発生時刻 (2026-03-29T10:00:00) |
通貨属性 / 金額属性¶
イベントに登録されている属性のうち、通貨値と売上金額が入れる属性をシステムに割り当てることができます。この設定が必要な場合は、チャートで希望の通貨で売上高を照会できます。
| アイテム | 説明 |
|---|---|
| 通話属性 | 通貨コード値が入ってくる属性の指定 KRW USD |
| 金額属性 | 売上計算に使用する数値を含む属性を指定します（例：支払い金額を含む属性）。 |
Note
通貨属性と金額属性は、イベント詳細ページの [プロパティ]タブで設定できます。プロパティリストでそのプロパティを選択し、各項目を指定します。
Warning
通貨属性または金額属性が指定されていない場合、チャートは売上関連指標を通貨ベースで照会できません。購入イベントを分析に活用するには、必ず両方のプロパティを指定してください。
[データプレビュー]タブ¶
実際のアナリティクスから収集したイベントデータのサンプルを確認します。イベントが正しく送信されていること、属性値が意図したとおりに収集されることを検証するときに活用します。
検索条件¶
| アイテム | 説明 |
|---|---|
| 照会期間 | データを照会する日付範囲を選択します。開始日と終了日の範囲は最大1ヶ月に制限されます。 |
| フィールド名 | フィルタを適用するプロパティ（フィールド）を選択します。 |
| 条件 | 選択したフィールドに適用する比較条件を選択します。 |
| 検索 | 条件に使用する値を入力します。 |
| 初期化 | 設定したフィルタ条件をすべて初期化します。 |
Warning
照会期間の範囲が1ヶ月を超えると、データを照会できません。期間を短くしてもう一度検索してください。
[ソース生成]タブ¶
そのイベントをアナリティクスに送信するためのソースコードを自動的に生成します。開発者が別々にコードを書かなくても、このタブで生成されたソースをそのまま使用してデータを転送できます。 
| タブ | 説明 |
|---|---|
| クライアント開発者 | ゲームクライアントからイベントを送信するソースコードを提供 |
| サーバー開発者 | ゲームサーバーからイベントを送信するソースコードを提供します。 |
| 文書 | イベント収集テーブルスキーマの参照文書を提供する |
[ETLシミュレーション]タブ¶
イベント転送テスト用のシミュレーション機能です。
- 各イベント収集テーブルフィールドに適切なデータを入力します。
- **転送**ボタンをクリックします。
- [データプレビュー]タブで、イベントが受信されているかどうかとプロパティ解析結果を確認します。
Warning
appIdフィールドには、Hiveコンソール>アプリセンターに登録されているアプリIDを入力する必要があります。誤った値を入力すると、データが収集されないことがあります。
イベント表示制御¶
- イベントリストの**使用可否**トグルで各イベントの露出可否を設定します。 - OFFに設定すると、チャート/ファンネル/リテンションなどの分析画面で該当イベントが選択リストから非表示になります。 - データは引き続き収集されますが、分析UIでは表示されません。
イベントのコピーと削除¶
- コピー：既存のイベントに基づいて同様のイベントをすばやく作成
- 削除: 廃止予定のイベントを削除
Warning
削除されたイベントを使用しているチャート/メトリックがある場合は、そのコンテンツに影響を与える可能性があります。
注意事項 & Tips¶
- イベント名は、配布後に変更すると以前のデータと不一致が発生します。イベント名を慎重に決定してください。
- 属性タイプが正しく設定されていないと、データ集約エラーが発生する可能性があります。
- MMPイベントを利用するには、**データ>インターロック**メニューで対応するMMPインターロックを最初に設定する必要があります。
- 未使用のイベントは表示OFFで処理して分析UIを整えてください。
- イベントの数が増えると、名前と説明を明確に作成することでチーム全体の分析効率が向上します。