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

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

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

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

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

あなたが始める前に

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

ログイベント

FirebaseAppインスタンスを構成したら、 logEvent()メソッドを使用してイベントのログ記録を開始できます。

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

実装の詳細については、 SwiftおよびObjective-Cの定数リファレンスを参照してください。

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

迅速

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])ViewController.swift

Objective-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];ViewController.m

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

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

推奨されるイベントタイプでは対応できない特定のニーズがアプリケーションにある場合は、次の例に示すように、独自のカスタムイベントをログに記録できます。

迅速

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])PatternTabBarController.swift

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];PatternTabBarController.m

デフォルトのイベントパラメータを設定する

setDefaultEventParametersを使用して、イベント全体でパラメーターをログに記録できます。デフォルトのパラメーターは、ログに記録される今後のすべてのイベントに関連付けられています。

カスタムパラメータと同様に、デフォルトのイベントパラメータを登録して、それらのカスタムパラメータが Analytics レポートに表示されるようにします。

迅速

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

logEvent()メソッドでパラメータが指定されている場合、デフォルトの代わりにその値が使用されます。

デフォルトのパラメーターをクリアするには、パラメーターをnilに設定してsetDefaultEventParametersメソッドを呼び出します。

Xcode デバッグコンソールでイベントを表示する

詳細ログを有効にして、SDK によるイベントのログを監視し、イベントが適切にログに記録されていることを確認できます。これには、自動的に記録されたイベントと手動で記録されたイベントの両方が含まれます。

次のように詳細ログを有効にできます。

Xcode で、[製品] > [スキーム] > [スキームの編集... ] を選択します。
左側のメニューから [実行] を選択します。
引数タブを選択します。
[起動時に渡される引数] セクションで、 -FIRAnalyticsVerboseLoggingEnabledを追加します。

次回アプリを実行すると、イベントが Xcode デバッグコンソールに表示されるため、イベントが送信されていることをすぐに確認できます。

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

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

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

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

あなたが始める前に

ログイベント

迅速

Objective-C

迅速

Objective-C

デフォルトのイベント パラメータを設定する

迅速

Objective-C

Xcode デバッグ コンソールでイベントを表示する

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

デフォルトのイベントパラメータを設定する

Xcode デバッグコンソールでイベントを表示する