Bắt đầu sử dụng Google Analytics cho Flutter

Chọn nền tảng: iOS+ Android Web Flutter Unity C++


Hướng dẫn nhanh này sẽ chỉ cho bạn cách thêm Google Analytics vào ứng dụng và bắt đầu ghi lại các sự kiện.

Google Analytics thu thập dữ liệu về mức sử dụng và hành vi cho ứng dụng của bạn. SDK ghi lại hai loại thông tin chính:

  • Sự kiện: Những gì đang diễn ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, các sự kiện của hệ thống hoặc lỗi.
  • Thuộc tính người dùng: Các thuộc tính bạn xác định để mô tả các phân khúc trong cơ sở người dùng, chẳng hạn như lựa chọn ưu tiên về ngôn ngữ hoặc vị trí địa lý.

Analytics sẽ tự động ghi lại một số sự kiện và thuộc tính người dùng; bạn không cần thêm mã nào để bật những sự kiện và thuộc tính này.

Trước khi bắt đầu

  1. Cài đặt firebase_core và thêm mã khởi chạy vào ứng dụng nếu bạn chưa làm.

  2. Đăng ký ứng dụng của bạn trong dự án Firebase bằng bảng điều khiển của Firebase Firebase.

  3. (Đề xuất) Thêm khung AdSupport vào dự án của bạn để bật các tính năng bổ sung như đối tượng và mô hình phân bổ cho chiến dịch.

Thêm Analytics SDK vào ứng dụng của bạn

  1. Từ gốc của dự án Flutter, hãy chạy lệnh sau để cài đặt trình bổ trợ:

    flutter pub add firebase_analytics

  2. Sau khi hoàn tất, hãy xây dựng lại ứng dụng Flutter:

    flutter run

  3. Sau khi cài đặt, bạn có thể truy cập vào trình bổ trợ firebase_analytics bằng cách nhập trình bổ trợ này vào mã Dart:

    import 'package:firebase_analytics/firebase_analytics.dart';

  4. Tạo một thực thể Firebase Analytics mới bằng cách truy cập vào thuộc tính instance trên FirebaseAnalytics:

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;

Bắt đầu ghi lại các sự kiện

Sau khi tạo một thực thể FirebaseAnalytics, bạn có thể bắt đầu ghi lại các sự kiện bằng các phương thức log- của thư viện.

Có một số sự kiện được đề xuất cho tất cả ứng dụng; một số sự kiện khác được đề xuất cho các loại hình kinh doanh hoặc ngành dọc cụ thể. Bạn nên gửi các sự kiện được đề xuất cùng với các thông số quy định của sự kiện để đảm bảo báo cáo có được thông tin chi tiết tối đa, đồng thời hưởng lợi từ các tính năng và công cụ tích hợp sẽ ra mắt trong tương lai. Phần này minh hoạ cách ghi lại một sự kiện được xác định trước. Để biết thêm thông tin về cách ghi lại các sự kiện, hãy xem bài viết Ghi lại các sự kiện.

Mã sau đây ghi lại một sự kiện thanh toán:

await FirebaseAnalytics.instance
  .logBeginCheckout(
    value: 10.0,
    currency: 'USD',
    items: [
      AnalyticsEventItem(
        itemName: 'Socks',
        itemId: 'xjw73ndnw',
        price: '10.0'
      ),
    ],
    coupon: '10PERCENTOFF'
  );

Các bước tiếp theo