イベントをロギングする

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

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

準備

まだアプリにアナリティクスを追加していない場合は、Activitycom.google.firebase.analytics.FirebaseAnalytics オブジェクトを初期化します。

private FirebaseAnalytics mFirebaseAnalytics;

// ...

// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

イベントのログを記録する

FirebaseAnalytics インスタンスを作成すると、そのインスタンスで logEvent() メソッドを使ってイベントを記録できるようになります。

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

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

次の例は、推奨イベントである SELECT_CONTENT イベントを記録する方法を示したものです。

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

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

  • カスタム パラメータ: アナリティクス レポートに報告するように登録できます。ユーザーリストの定義でフィルタとして使用でき、あらゆるレポートに適用できます。 アプリが BigQuery プロジェクトとリンクされている場合、カスタム パラメータは BigQuery にエクスポートされるデータにも含まれます。

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

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

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

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 にイベントが表示され、イベントが送信されているかどうかを即座に確認することができます。

ダッシュボードでイベントを表示する

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

Firebase コンソールでこのデータにアクセスするには、次のように操作します。

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

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

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。