Firebase を使用して AI 搭載アプリを構築して実行する方法のデモを、2024 年の Demo Day でご覧ください。ぜひご覧ください。

イベントをロギングする

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

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

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

始める前に

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

イベントをロギングする

firebase.analytics() インスタンスを構成すると、logEvent() メソッドを使ってイベントをロギングできるようになります。Google Analytics にすでに精通されている場合は、このメソッドは、gtag.js で event コマンドを使用する場合と同等です。

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

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

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

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

Web

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

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

Web

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

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

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

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

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

Web

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

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

Web

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

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

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

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