このガイドでは、アプリでイベントをログに記録する方法について説明します。
イベントは、ユーザー アクション、システム イベント、エラーなど、アプリで何が起こっているかについての洞察を提供します。
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' });
Web version 8
analytics.logEvent('select_content', { content_type: 'image', content_id: 'P12453', items: [{ name: 'Kittens' }] });
所定のパラメータに加えて、次のパラメータを任意のイベントに追加できます。
カスタム パラメータ: カスタム パラメータは、アナリティクス レポートのディメンションまたは指標として使用できます。数値以外のイベント パラメータ データにはカスタム ディメンションを使用し、数値でより適切に表現されたパラメータ データにはカスタム指標を使用できます。 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'});
Web version 8
analytics.logEvent('goal_completion', { name: 'lever_puzzle'});
ダッシュボードでイベントを表示する
Firebase コンソール ダッシュボードで、イベントに関する集計統計を表示できます。これらのダッシュボードは、1 日を通して定期的に更新されます。すぐにテストするには、前のセクションで説明した logcat 出力を使用します。
このデータには、Firebase コンソールのイベントダッシュボードからアクセスできます。このダッシュボードには、アプリによって記録されたイベントの種類ごとに自動的に作成されるイベント レポートが表示されます。