このクイックスタートでは、アプリに Google アナリティクスを追加し、イベントのロギングを始める方法について説明します。
Google アナリティクスは、アプリの使用状況や動作に関するデータを収集します。この SDK は主に次の 2 種類の情報を記録します。
- イベント: ユーザーの操作、システム イベント、エラーなど、アプリで起こっていること。
- ユーザー プロパティ: 言語や地理的位置など、ユーザー層を示す属性。自由に定義できます。
アナリティクスでは、一部のイベントとユーザー プロパティが自動的にロギングされます。こうしたロギングを有効にするコードを追加する必要はありません。
始める前に
firebase_core
をインストールし、初期化コードをアプリに追加します(まだ行っていない場合)。- Firebase コンソールでアプリを Firebase プロジェクトに追加します。
アプリにアナリティクス SDK を追加する
Flutter プロジェクトのルートから、次のコマンドを実行してプラグインをインストールします。
flutter pub add firebase_analytics
完了したら、Flutter アプリケーションを再ビルドします。
flutter run
インストール後、Dart コードにインポートすると、
firebase_analytics
プラグインにアクセスできます。import 'package:firebase_analytics/firebase_analytics.dart';
FirebaseAnalytics
のinstance
ゲッターを呼び出して、Firebase 向け Google アナリティクスの新しいインスタンスを作成します。FirebaseAnalytics analytics = FirebaseAnalytics.instance;
イベントのロギングを開始する
FirebaseAnalytics
インスタンスを作成したら、ライブラリの log
メソッドを使ってイベントのロギングを開始できます。
イベントには、すべてのアプリで推奨されるイベントと、特定のビジネスや業種で推奨されるイベントがあります。推奨イベントと既定のパラメータを一緒に送信することで、レポートに詳しい情報を表示できます。また、リリースされる最新の機能や統合を活用することもできます。このセクションでは、あらかじめ定義されているイベントのロギングについて説明します。イベント ロギングの詳細については、イベントをロギングするを参照してください。
次のコードは購入手続きイベントをロギングします。
await FirebaseAnalytics.instance
.logBeginCheckout(
value: 10.0,
currency: 'USD',
items: [
AnalyticsEventItem(
itemName: 'Socks',
itemId: 'xjw73ndnw',
price: '10.0'
),
],
coupon: '10PERCENTOFF'
);
次のステップ
- DebugView を使用して、イベントを検証する。
- Firebase コンソールでデータを探索する。
- イベントやユーザー プロパティのガイドを読む。
- データを BigQuery にエクスポートする方法を学習する。