開始使用 Google Analytics


本快速入門導覽課程說明如何在應用程式中加入 Google Analytics,並開始記錄事件。

Google Analytics 會收集應用程式的使用和行為資料。SDK 會記錄兩種主要類型的資訊:

  • 事件:應用程式中的活動,例如使用者動作、系統事件或錯誤。
  • 使用者屬性:您定義的屬性,用來描述使用者族群區隔,例如語言偏好或地理位置。

Analytics 會自動記錄部分事件使用者屬性,您無需加上任何程式碼即可啟用這些屬性。

事前準備

  1. 安裝 firebase_core,並將初始化程式碼新增至應用程式 (如果尚未這麼做)。
  2. Firebase 主控台中,將應用程式新增至 Firebase 專案。

在應用程式中加入 Analytics SDK

  1. 在 Flutter 專案的根目錄中,執行下列指令來安裝外掛程式:

    flutter pub add firebase_analytics
    
  2. 完成後,請重新建構 Flutter 應用程式:

    flutter run
    
  3. 安裝完成後,您可以在 Dart 程式碼中匯入 firebase_analytics 外掛程式,以便存取該外掛程式:

    import 'package:firebase_analytics/firebase_analytics.dart';
    
  4. 存取 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'
  );

後續步驟