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 bắt đầu nhanh này trình bày cách thêm Google Analytics vào ứng dụng và bắt đầu ghi nhật ký sự kiện.

Google Analytics thu thập dữ liệu hành vi và mức sử dụng 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, chẳng hạn như thao tác của người dùng, các sự kiện của hệ thống hoặc lỗi phát sinh.
  • Thuộc tính người dùng: Các thuộc tính do 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ư ngôn ngữ ưu tiên hoặc vị trí địa lý.

Analytics 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 của bạn nếu bạn chưa làm.

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

  3. (Nên dùng) 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ừ thư mục 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 tạo 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ợ đó 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 nhật ký 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.

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 sự kiện được đề xuất cùng với thông số được quy định cho sự kiện đó để đảm bảo báo cáo có được lượng thông tin chi tiết tối đa, đồng thời để khai thác lợi ích từ các tính năng cũng như công cụ tích hợp sẽ ra mắt trong tương lai. Phần này minh hoạ cách ghi nhật ký một sự kiện được xác định trước. Để biết thêm thông tin về cách ghi nhật ký sự kiện, hãy xem bài viết Ghi nhật ký sự kiện.

Đoạ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