本快速入門導覽課程說明如何將 Google Analytics (分析) 新增至您的應用程式,並開始記錄事件。
Google Analytics (分析) 會收集應用程式的使用情況和行為資料。SDK 會記錄兩種主要類型的資訊:
- 事件:應用程式的實際情況,例如使用者動作、系統事件或錯誤。
- 使用者屬性:您定義用來描述使用者區隔的屬性,例如語言偏好設定或地理位置。
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。