イベントをロギングする

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

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

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

始める前に

プロジェクトをセットアップし、アナリティクスを使ってみるの説明に沿ってアナリティクスにアクセスできることを確認してください。

イベントをロギングする

firebase.analytics() インスタンスを構成すると、logEvent() メソッドを使ってイベントをロギングできるようになります。Google アナリティクスを使い慣れている方へ: このメソッドの機能は、gtag.js で event コマンドを使用する場合と同等です。

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

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

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

次の例は、select_content イベントをロギングする方法を示しています。

ウェブ向けのモジュラー API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453'
});analytics_log_event_params.js

ウェブ向けの名前空間 API

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

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

カスタムパラメータ: カスタムパラメータは、アナリティクスレポートでディメンションまたは指標として使用できます。数値以外のイベントパラメータデータにはカスタムディメンションを使用し、数値で表すのに適したパラメータデータにはカスタム指標を使用します。SDK を使ってカスタムパラメータをロギングしたら、そのディメンションまたは指標を登録して、アナリティクスレポートにそのカスタムパラメータが表示されるようにします。これを行うには、[アナリティクス] > [イベント] > [カスタム定義を管理] > [カスタムディメンションを作成] の順に選択します。

カスタムパラメータは、すべてのレポートに適用可能なオーディエンスの定義で使用できます。アプリが BigQuery プロジェクトとリンクされている場合、カスタムパラメータは BigQuery にエクスポートされるデータにも含まれます。Google アナリティクス 4 の BigQuery Export で、サンプルクエリなどの情報をご覧ください。
value パラメータ: value は、イベントに関連する主要な指標の収集に役立つ汎用パラメータです。そのような指標には、たとえば収益、距離、時間、得点などがあります。

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

ウェブ向けのモジュラー API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});analytics_log_event_custom_params.js

ウェブ向けの名前空間 API

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

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

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

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