このクイックスタートでは、Google アナリティクスをアプリに追加し、イベントのログ記録を開始する方法を示します。
Google アナリティクスは、アプリの使用状況と行動に関するデータを収集します。 SDK は、主に次の 2 種類の情報をログに記録します。
- イベント:ユーザー アクション、システム イベント、エラーなど、アプリで発生していること。
- ユーザー プロパティ:言語設定や地理的位置など、ユーザー ベースのセグメントを説明するために定義する属性。
Analytics は一部のイベントとユーザー プロパティを自動的に記録します。それらを有効にするためにコードを追加する必要はありません。
あなたが始める前に
- まだ行っていない場合は、
firebase_core
をインストールし、初期化コードをアプリに追加します。 - Firebase コンソールでアプリを Firebase プロジェクトに追加します。
Analytics SDK をアプリに追加する
Flutter プロジェクトのルートから、次のコマンドを実行してプラグインをインストールします。
flutter pub add firebase_analytics
完了したら、Flutter アプリケーションを再構築します。
flutter run
インストールしたら、Dart コードにインポートすることで
firebase_analytics
プラグインにアクセスできます。import 'package:firebase_analytics/firebase_analytics.dart';
FirebaseAnalytics
でinstance
ゲッターを呼び出して、新しい Firebase Analytics インスタンスを作成します。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にエクスポートする方法を学びます。
このクイックスタートでは、Google アナリティクスをアプリに追加し、イベントのログ記録を開始する方法を示します。
Google アナリティクスは、アプリの使用状況と行動に関するデータを収集します。 SDK は、主に次の 2 種類の情報をログに記録します。
- イベント:ユーザー アクション、システム イベント、エラーなど、アプリで発生していること。
- ユーザー プロパティ:言語設定や地理的位置など、ユーザー ベースのセグメントを説明するために定義する属性。
Analytics は一部のイベントとユーザー プロパティを自動的に記録します。それらを有効にするためにコードを追加する必要はありません。
あなたが始める前に
- まだ行っていない場合は、
firebase_core
をインストールし、初期化コードをアプリに追加します。 - Firebase コンソールでアプリを Firebase プロジェクトに追加します。
Analytics SDK をアプリに追加する
Flutter プロジェクトのルートから、次のコマンドを実行してプラグインをインストールします。
flutter pub add firebase_analytics
完了したら、Flutter アプリケーションを再構築します。
flutter run
インストールしたら、Dart コードにインポートすることで
firebase_analytics
プラグインにアクセスできます。import 'package:firebase_analytics/firebase_analytics.dart';
FirebaseAnalytics
でinstance
ゲッターを呼び出して、新しい Firebase Analytics インスタンスを作成します。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にエクスポートする方法を学びます。