開始使用 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. 存取 instance 屬性，在 FirebaseAnalytics 中建立新的 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'
  );

後續步驟