このページは Cloud Translation API によって翻訳されました。

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

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

イベントは、ユーザーアクション、システムイベント、エラーなど、アプリで何が起こっているかについての洞察を提供します。

Analytics は自動的にいくつかのイベントを記録します。それらを受け取るためにコードを追加する必要はありません。アプリで追加のデータを収集する必要がある場合は、アプリで最大 500 の異なる Analytics イベントタイプをログに記録できます。アプリがログに記録するイベントの総量に制限はありません。イベント名は大文字と小文字が区別されることに注意してください。名前の大文字と小文字が異なる 2 つのイベントをログに記録すると、2 つの異なるイベントが発生することに注意してください。

あなたが始める前に

プロジェクトをセットアップし、Analytics の使用開始の説明に従って Analytics にアクセスできることを確認してください。

ログイベント

firebase.analytics()インスタンスを構成したら、 logEvent()メソッドを使用してイベントのログ記録を開始できます。すでに Google アナリティクスに精通している場合、このメソッドはgtag.jsでeventコマンドを使用するのと同じです。

開始を支援するために、Analytics SDK では、小売、e コマース、旅行、ゲームなど、さまざまな種類のアプリに共通する推奨イベントが多数定義されています。これらのイベントの詳細と使用時期については、推奨イベントを参照してください。

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

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

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

Web version 9

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 version 8

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

所定のパラメータに加えて、次のパラメータを任意のイベントに追加できます。

カスタムパラメータ: カスタムパラメータは、アナリティクスレポートのディメンションまたは指標として使用できます。数値以外のイベントパラメータデータにはカスタムディメンションを使用し、数値でより適切に表現されたパラメータデータにはカスタム指標を使用できます。 SDK を使用してカスタムパラメータを記録したら、ディメンションまたは指標を登録して、これらのカスタムパラメータが Analytics レポートに表示されるようにします。これを行う方法: [分析] > [イベント] > [カスタム定義の管理] > [カスタムディメンションの作成]
カスタムパラメータは、すべてのレポートに適用されるオーディエンス定義で使用できます。アプリが BigQuery プロジェクトにリンクされている場合、カスタムパラメータはBigQuery にエクスポートされるデータにも含まれます。 Google アナリティクス 4 BigQuery Exportで、サンプルクエリなどを見つけてください。
valueパラメーター: valueは、イベントに関連する重要な指標を蓄積するのに役立つ汎用パラメーターです。例には、収益、距離、時間、およびポイントが含まれます。

推奨されるイベントタイプでは対応できない特定のニーズがアプリケーションにある場合は、独自のカスタムイベントをログに記録できます。たとえば、ゲームを開発していて、プレーヤーが特定の目標を達成したときを追跡したい場合は、次の例のようなイベントをログに記録できます。

Web version 9

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

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

Web version 8

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

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

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

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