イベントをロギングする

このガイドでは、アプリでイベントをロギングする方法について説明します。

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

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

始める前に

プロジェクトを設定し、Firebase 向け Google アナリティクスの説明に従ってアナリティクスにアクセスできることを確認してください。

イベントをロギングする

firebase.analytics() インスタンスを構成すると、logEvent() メソッドを使ってイベントをログに記録できるようになります。これは、Google アナリティクスで gtag.jsevent コマンドを使用する場合と同じ結果になります。

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

注: できる限り詳細なレポートを取得するには、アプリと既定のパラメータに対して適切な推奨イベントをログに記録します。これにより、Google アナリティクスに新しい機能が追加されたときにその機能を確実に利用できます。

イベントとそのパラメータの実装方法については、gtag.js イベント リファレンスをご覧ください。

次の例では、select_content イベントをログに記録する方法を説明します。

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

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

  • カスタム パラメータ: アナリティクス レポートに報告するように登録できます。オーディエンスの定義の際にフィルタとして使用できます。定義したユーザーリストはあらゆるレポートに適用できます。アプリが BigQuery プロジェクトとリンクされている場合、カスタム パラメータは BigQuery にエクスポートされるデータにも含まれます。
  • value パラメータ: value は、イベントに関連する主要な指標の蓄積に役立つ汎用パラメータです。そのようなイベントにはたとえば収益、距離、時間、得点などがあります。

推奨されるイベントの種類では収集できないデータをアプリで収集したい場合は、独自のカスタム イベントを記録できます。たとえば、開発中のゲームで、プレーヤーが達成した目標を追跡できるようにするには、次のようにイベントを記録します。

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

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

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

このデータにアクセスするには、Firebase コンソールの [イベント] ダッシュボードに移動します。このダッシュボードには、アプリによってロギングされたイベントの種類ごとに自動的に作成されたイベント レポートが表示されます。