Unity 用 Google アナリティクスを使ってみる

Google アナリティクスは、アプリの使用状況や動作に関するデータを収集します。この SDK は主に次の 2 種類の情報を記録します。

• イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。
• ユーザー プロパティ: 言語や地域など、ユーザー層を示す属性。自由に定義できます。

アナリティクスは、一部のイベントとユーザー プロパティのログを自動的に記録します。こうしたログ記録を有効にするためのコードを追加する必要はありません。それ以外のデータをアプリで収集する場合は、アナリティクスのユーザー プロパティを最大 25 個まで設定し、最大 500 種類までのアナリティクス イベントをログに記録できます。アプリで記録できるログの量に制限はありません。

このデータにアクセスするには:

1. Firebase コンソールでプロジェクトを開きます。
2. メニューで [アナリティクス] を選択し、アナリティクスのレポート ダッシュボードを表示します。

[イベント] タブには、アプリによってロギングされたアナリティクス イベントの異なる種類ごとに自動的に作成されたイベント レポートが表示されます。アナリティクスのレポート ダッシュボードについて詳しくは、Firebase ヘルプセンターをご覧ください。

アナリティクス SDK には、小売、e コマース、旅行、ゲームなど、さまざまな種類のアプリでよく使われる推奨イベントが多数定義されており、使い始めるのに役立ちます。こうしたイベントの詳細と使い方については、Firebase ヘルプセンターのイベントとプロパティをご覧ください。できる限り詳細なレポートを取得するには、アプリと既定のパラメータに対して適切な推奨アナリティクス イベントを記録します。これにより、Google アナリティクスに新しい機能が追加されたときにその機能を確実に利用できます。

始める前に

Google アナリティクスを使用するには、あらかじめ次の作業が必要です。

• Firebase を使用するように Unity プロジェクトを登録して構成する。

  • Unity プロジェクトですでに Firebase を使用している場合、この登録と構成はすでに行われています。

  • Unity プロジェクトがない場合は、サンプルアプリをダウンロードできます。

• Unity プロジェクトに Firebase Unity SDK（具体的には FirebaseAnalytics.unitypackage）を追加する。

Firebase を Unity プロジェクトに追加するには、Firebase コンソールと開いている Unity プロジェクトの両方でタスクを行う必要があります（コンソールから Firebase 構成ファイルをダウンロードし、それを Unity プロジェクトに移動するなど）。

イベントをロギングする

LogEvent() メソッドを使用すると、イベントのロギングをすぐに開始できます。

次の例では、さまざまなタイプの引数を使用してイベントを記録します。

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

次のステップ

• Firebase コンソールで表示されるデータが定期的に更新されることを確認する
• イベントやユーザー プロパティのガイドを読む