このガイドでは、アプリでイベントをログに記録する方法について説明します。
イベントは、ユーザー アクション、システム イベント、エラーなど、アプリで何が起こっているかについての洞察を提供します。
Analytics は自動的にいくつかのイベントを記録します。それらを受け取るためにコードを追加する必要はありません。アプリで追加のデータを収集する必要がある場合は、アプリで最大 500 の異なる Analytics イベントタイプをログに記録できます。アプリがログに記録するイベントの総量に制限はありません。イベント名は大文字と小文字が区別されることに注意してください。名前の大文字と小文字が異なる 2 つのイベントをログに記録すると、2 つの異なるイベントが発生することに注意してください。
あなたが始める前に
プロジェクトをセットアップし、Analytics の使用開始の説明に従って Analytics にアクセスできることを確認してください。
ログイベント
FirebaseAnalytics
インスタンスを作成したら、それを使用してlogEvent()
メソッドでイベントをログに記録できます。
開始を支援するために、Analytics SDK では、小売、e コマース、旅行、ゲームなど、さまざまな種類のアプリに共通する推奨イベントが多数定義されています。これらのイベントの詳細と使用時期については、推奨イベントを参照してください。
推奨されるイベント タイプの実装の詳細については、次の場所を参照してください。
- 推奨されるイベント:
com.google.firebase.analytics.FirebaseAnalytics.Event
クラス リファレンスをご覧ください。 - 規定のパラメータ:
com.google.firebase.analytics.FirebaseAnalytics.Param
リファレンスを参照してください。
次の例は、 SELECT_CONTENT
イベントをログに記録する方法を示しています。
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
所定のパラメータに加えて、次のパラメータを任意のイベントに追加できます。
カスタム パラメータ: カスタム パラメータは、アナリティクス レポートのディメンションまたは指標として使用できます。数値以外のイベント パラメータ データにはカスタム ディメンションを使用し、数値でより適切に表現されたパラメータ データにはカスタム指標を使用できます。 SDK を使用してカスタム パラメータを記録したら、ディメンションまたは指標を登録して、これらのカスタム パラメータが Analytics レポートに表示されるようにします。これを行う方法: [分析] > [イベント] > [カスタム定義の管理] > [カスタム ディメンションの作成]
カスタム パラメータは、すべてのレポートに適用されるオーディエンス定義で使用できます。アプリが BigQuery プロジェクトにリンクされている場合、カスタム パラメータはBigQuery にエクスポートされるデータにも含まれます。 Google アナリティクス 4 BigQuery Exportで、サンプル クエリなどを見つけてください。
VALUE
パラメーター:VALUE
は、イベントに関連する重要な指標を蓄積するのに役立つ汎用パラメーターです。例には、収益、距離、時間、およびポイントが含まれます。
推奨されるイベント タイプでは対応できない特定のニーズがアプリケーションにある場合は、次の例に示すように、独自のカスタム イベントをログに記録できます。
Kotlin+KTX
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
デフォルトのイベント パラメータを設定する
setDefaultEventParameters
を使用して、イベント全体でパラメーターをログに記録できます。デフォルトのパラメーターは、ログに記録される今後のすべてのイベントに関連付けられています。
カスタム パラメータと同様に、デフォルトのイベント パラメータを登録して、Analytics レポートに確実に表示されるようにします。
Kotlin+KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.putInt("level_difficulty", 4); mFirebaseAnalytics.setDefaultEventParameters(parameters);
logEvent()
メソッドでパラメータが指定されている場合、デフォルトの代わりにその値が使用されます。
デフォルトのパラメーターをクリアするには、パラメーターをnull
に設定してsetDefaultEventParameters
メソッドを呼び出します。
Android Studio デバッグ ログでイベントを表示する
詳細ログを有効にして、SDK によるイベントのログを監視し、イベントが適切にログに記録されていることを確認できます。これには、自動的に記録されたイベントと手動で記録されたイベントの両方が含まれます。
一連の adb コマンドを使用して詳細ログを有効にできます。
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
このコマンドは、Android Studio の logcat にイベントを表示するので、イベントが送信されていることをすぐに確認できます。
ダッシュボードでイベントを表示する
Firebase コンソール ダッシュボードで、イベントに関する集計統計を表示できます。これらのダッシュボードは、1 日を通して定期的に更新されます。すぐにテストするには、前のセクションで説明した logcat 出力を使用します。
このデータには、Firebase コンソールのイベントダッシュボードからアクセスできます。このダッシュボードには、アプリによって記録されたイベントの種類ごとに自動的に作成されるイベント レポートが表示されます。