イベントテンプレートでログ収集構造を定義する：イベントログ送信 第1回
Hive Analyticsは、ゲーム分析でよく必要になるユーザー行動をイベントテンプレートとして提供します。テンプレートにはイベント名とプロパティがあらかじめ定義されているため、イベント構造を一から設計しなくてもログ収集構造を決められます。分析担当者はData > Eventでイベントを選んで活用できる指標を確認し、Property Settingで定義済みのプロパティを編集・追加した後、Source Generationで開発環境に合ったソースコードを確認します。実際の開発を依頼する前には、テストログを送信してデータが意図した構造で収集されるかを検証します。
ゲームのイベントログに一貫した定義が必要な理由
ゲームユーザーの行動を正確に分析するには、イベント名とプロパティを一貫した基準で定義する必要があります。ゲームでは、ログインや購入だけでなく、コンテンツのクリア、通貨の獲得、アイテムの使用など、さまざまなユーザー行動を分析します。こうした行動を分析するには、行動が発生した時点の情報をイベントログとして収集する必要があり、そのためにはイベント名と発生タイミング、一緒に送信するプロパティとデータ型をあらかじめ定義しておかなければなりません。
ゲームごとにこれらの項目を一から設計すると、同じ意味の行動でも異なる名前や構造で収集されることがあります。分析の過程で各ログの意味を明確に把握し、複数のゲームのデータを同じ基準で比較するには、イベント定義の段階から一貫性を持たせる必要があります。
Hive Analyticsのイベントテンプレートとは
Hive Analyticsのイベントテンプレートは、ゲーム分析でよく必要になる行動を、イベント名とプロパティが定義済みの形で提供する機能です。イベントテンプレートを見る前に、ログ収集で使う主な用語を整理します。
| 用語 | 説明 |
|---|---|
| イベント | ユーザーがゲーム内で行った特定の行動をデータとして記録した単位で、いつ、誰が、何をしたかを含みます。 |
| プロパティ | イベントの発生時に一緒に記録される詳細情報で、行動がどのような条件で、どのような値で発生したかを示します。 |
| ソースコード | イベントをHive Analyticsに送信するために、Source Generationタブで開発環境ごとに自動生成されるコードです。 |
app_loginイベントの送信タイミングを、Property Settingではプロパティを、Source Generationではソースコードを確認できます。イベントテンプレートには、Hive SDKを連携すると自動で収集されるログインや購入などのイベントも含まれています。テンプレートに含まれるイベントはData > Eventにイベント名とプロパティが定義済みのため、構造を一から設計せずに活用でき、ログの送信が完了すればすぐにHive Analyticsでイベントに基づく分析を始められます。イベントやプロパティを事前に登録せずにログを送信した場合でも、Hive Analyticsで活用できます。
開発者サイトでイベントテンプレートを確認する
Hive Analyticsにアクセスしなくても、Hive開発者サイトのイベントテンプレートガイドで、定義済みのイベントごとの送信タイミングと活用指標の例、Hive SDKによる自動収集の有無、プロパティ一覧を確認できます。
イベントを選ぶと、そのイベントで作れる指標を確認できます。Property Settingでは、定義済みの項目を確認して分析目的に合わせて編集したり、新しいプロパティを追加したりします。プロパティの構成を終えた後、Source Generationでゲームの開発環境を選ぶと、設定したイベントとプロパティが反映されたソースコードを確認できます。
生成したソースコードを実際の開発に適用する前には、テストログを送信して、イベントとプロパティの値が意図した構造で収集されるか、そのデータで必要な指標を構成できるかを検証します。検証結果を反映すれば、開発者に渡すイベント構造とソースコードを具体化できます。
分析担当者は、次の手順で分析したい行動に合ったイベントを選び、必要なプロパティとログ送信用のソースコードを準備します。
- イベントの選択
分析したい行動に一致するイベントテンプレートを確認します。 - プロパティの設定
定義済みのプロパティを確認し、必要なプロパティを編集・追加します。 - ソースコードの生成
ゲームの開発環境を選び、設定したイベントとプロパティを含むソースコードを生成します。
contents_successでコンテンツクリアイベントを準備する
コンテンツをクリアしたユーザー数や平均プレイ時間などを分析するには、contents_successイベントとログ送信用のソースコードを準備する必要があります。イベントの選択からソースコードの生成までの流れは次のとおりです。
イベントの選択
Data > Eventでcontents_successを選び、説明を確認します。contents_successはゲームコンテンツをクリアした時点で発生するイベントで、コンテンツのクリア数やクリアしたユーザー数、平均プレイ時間、平均スコアなどの指標を作るのに活用されます。分析担当者はこの情報をもとに活用する指標を決め、ゲーム内でイベントが発生すべきタイミングを具体化します。
contents_successのBasic Infoで、イベントの意味と活用できる指標を確認します。プロパティの設定
Property Settingでは、contents_successに定義済みのプロパティと、各プロパティの説明、データ型を確認します。プロパティは、後でCreateでチャートを作成する際に、測定値やディメンション値、フィルター条件を構成するのに使われます。contents_successには、利用環境を表すmarketとhive_country、ユーザーを識別するuserIdとdeviceId、コンテンツクリアの詳細条件を表すcharacterLvとmodeTypeIdなどが含まれています。
appId、appIdGroup、dateTime、userId、deviceId、eventName、eventTime、identifierProviderはシステムが管理する共通プロパティで、Property Settingでは編集できません。このうちuserId、deviceId、identifierProvider、eventTime、eventNameと、appIdまたはappIdGroupは、イベントログを送信する際に必ず含めなければならない必須プロパティです。dateTimeは、送信されたeventTimeをUTCに変換して保存した時刻です。
定義済みのプロパティは必要に応じて編集できます。分析に必要な値が足りない場合は、編集画面の左下にあるAdd Event +をクリックして新しいプロパティを追加します。たとえばキャラクター名を分析に活用したい場合は、characterNameプロパティを追加し、データ型を文字列に設定します。Hive Analyticsで事前に定義していないプロパティでも、ログに含めて送信すれば分析に活用できます。こうして保存したイベントとプロパティは複数のプロジェクトで同じ収集基準として使えるため、同じ行動を一貫したプロパティ名とデータ型、値の形式と単位で送信できます。
ソースコードの生成
プロパティの構成を終えたら、Source Generationでクライアントまたはサーバーの開発方式を選び、実際のゲームで使っている開発環境を指定します。生成されたソースコードには設定したイベント名とプロパティが含まれるため、分析担当者は実装に必要な項目が正しく反映されているかを確認します。
生成したソースコードは開発者に渡し、実際のログ送信機能の実装に活用します。開発を依頼する前には、テストログを送信して、イベントとプロパティが意図した構造で収集されるか、そのデータで必要な指標を構成できるかを事前に検証できます。テストログによる検証方法は「テストログで収集構造と指標を検証する：イベントログ送信 第2回」で詳しく紹介します。
Hive Analyticsを始める
イベントテンプレートを活用すれば、分析担当者が必要なイベントとプロパティを自ら構成し、開発環境に合ったソースコードの形でログ送信の基準を準備できます。
Hive Analyticsは、Hive SDKで収集したゲームイベントをもとに、ユーザー行動とゲーム指標を分析できるゲーム特化型の分析ソリューションです。今すぐHive Analyticsで分析したいゲーム行動に合ったイベントテンプレートを確認し、必要なプロパティと開発用のソースコードを準備しましょう。
