イベントをロギングする

イベントは、ユーザー操作、システム イベント、エラーなど、アプリで起こっていることを把握するのに役立ちます。

Google Analytics では、一部のイベントが自動的にロギングされます。それらのイベントを受信するためのコードを追加する必要はありません。アプリがそれら以外のデータを収集する必要がある場合は、アプリで最大 500 種類の異なる Analytics イベントをロギングできます。アプリでロギングできるイベントの量に上限はありません。イベント名では大文字と小文字が区別されます。そのため、大文字と小文字の使い方だけが異なっている同じ名前の 2 つのイベントは、2 つの別個のイベントとしてロギングされます。

始める前に

Google Analytics を使用するには、次の作業が必要です。

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

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

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

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

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

イベントをロギングする

Firebase.Analytics.FirebaseAnalytics モジュールを初期化すると、そのモジュールで LogEvent() メソッドを使って、イベントをロギングできるようになります。

Analytics SDK には、小売、e コマース、旅行、ゲームなど、さまざまな種類のアプリでよく使われる推奨イベントが多数定義されており、すぐに使うことができます。これらのイベントの詳細と使い方については、Google アナリティクス ヘルプセンターの推奨イベントの記事をご覧ください。

推奨イベントの実装方法の詳細については、次の記事をご覧ください。

  • 推奨イベント: Event 定数のリストをご覧ください。
  • 既定のパラメータ: Parameters 定数のリストをご覧ください。

次の例は、推奨イベントである SELECT_CONTENT イベントをログに記録する方法を示しています。

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

既定のパラメータの他にも、次のパラメータをあらゆるイベントに追加できます。

  • カスタム パラメータ: カスタム パラメータは Analytics レポートには記載されませんが、ユーザーリストの定義の際にフィルタとして使用できます。定義したユーザーリストはあらゆるレポートに適用できます。アプリが BigQuery プロジェクトとリンクされている場合、カスタム パラメータは BigQuery にエクスポートされるデータにも含まれます。

  • VALUE パラメータ: VALUE は、Analytics イベントに関連する主要な指標の収集に役立つ汎用パラメータです。そのようなイベントにはたとえば収益、距離、時間、得点などがあります。

推奨される Analytics イベントの種類では収集できないデータをアプリで収集する必要がある場合は、次の例で示すように独自のカスタム Analytics イベントをロギングすることができます。

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

ログ出力でイベントを表示する

Android

Android Studio のデバッグログで詳細ログを有効にして、SDK によってイベントが正しく記録されているかどうかを確認することができます。対象となるのは、自動で記録されるイベントと手動で記録されるイベントの両方です。

詳細ログを有効にするには、次の一連の adb コマンドを入力します。

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

このコマンドを入力すると Android Studio の logcat にイベントが表示され、イベントが送信されているかどうかを即座に確認できます。

iOS+

イベントはコンソールにロギングされるため、Xcode でアプリを実行しながら確認できます。

ダッシュボードでアナリティクス イベントを表示する

Firebase コンソールのダッシュボードでは、Analytics イベントに関する集約された統計情報を表示できます。これらのダッシュボードは、一日を通して定期的に更新されます。即座にテストを行いたい場合は、前のセクションで説明した logcat の出力を使用してください。

Firebase コンソールでこのデータにアクセスするには:

  1. Firebase コンソールでプロジェクトを開きます。
  2. メニューから [Analytics] を選択して、Analytics レポート ダッシュボードを表示します。

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