Flutter数据分析插件spreeloop_analytics的使用

Flutter 数据分析插件 spreeloop_analytics 的使用

spreeloop_analytics 是一个用于应用测量的解决方案，它提供了有关应用使用情况和用户参与度的洞察。

特性

• 注册事件。
• 注册商品列表视图事件。
• 注册商品视图事件。
• 注册选择商品视图事件。
• 注册添加到购物车事件。
• 注册用户调用合作伙伴事件。
• 注册从购物车移除商品事件。
• 注册查看购物车事件。
• 注册开始结账事件。
• 注册购买事件。
• 设置用户属性或受众。
• 在分析中注册当前屏幕。

安装

在你的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  spreeloop_analytics: ^0.0.1

使用

在 Dart 代码中导入该包：

import 'package:spreeloop_analytics/spreeloop_analytics.dart';

Analytics 类是一个接口，其构造函数通过可选的 AnalyticsType 返回不同的实例。对于 Firebase 实现，可以这样做：

Analytics(AnalyticsType.firebase);

对于一些测试，可以这样做：

Analytics(AnalyticsType.fake);

示例代码

以下是一个完整的示例，演示如何使用 spreeloop_analytics 插件记录各种事件和设置用户属性。

import 'package:flutter/material.dart';
import 'package:spreeloop_analytics/spreeloop_analytics.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final Analytics _analytics = Analytics(AnalyticsType.firebase);

  [@override](/user/override)
  void initState() {
    super.initState();
    // 初始化时设置当前屏幕
    _analytics.setCurrentScreen(screenName: "Home Page");
  }

  void _logEvent() async {
    // 记录事件
    await _analytics.logEvent(
      eventType: EventType.click,
      parameters: {'button': 'login'},
    );

    // 记录商品视图事件
    await _analytics.logViewItem(
      items: [
        AnalyticsCommerceEventItem(
          itemId: "1",
          itemName: "T-shirt",
          itemCategory: "Clothing",
          price: 19.99,
          quantity: 1,
        ),
      ],
      currency: "USD",
      value: 19.99,
    );

    // 记录选择商品视图事件
    await _analytics.logSelectItem(
      itemListId: "1",
      itemListName: "T-shirts",
      items: [
        AnalyticsCommerceEventItem(
          itemId: "1",
          itemName: "T-shirt",
          itemCategory: "Clothing",
          price: 19.99,
          quantity: 1,
        ),
      ],
    );

    // 记录添加到购物车事件
    await _analytics.logAddToCart(
      items: [
        AnalyticsCommerceEventItem(
          itemId: "1",
          itemName: "T-shirt",
          itemCategory: "Clothing",
          price: 19.99,
          quantity: 1,
        ),
      ],
      value: 19.99,
      currency: "USD",
    );

    // 记录从购物车移除商品事件
    await _analytics.logRemoveFromCart(
      items: [
        AnalyticsCommerceEventItem(
          itemId: "1",
          itemName: "T-shirt",
          itemCategory: "Clothing",
          price: 19.99,
          quantity: 1,
        ),
      ],
      value: 19.99,
      currency: "USD",
    );

    // 记录查看购物车事件
    await _analytics.logViewCart(
      items: [
        AnalyticsCommerceEventItem(
          itemId: "1",
          itemName: "T-shirt",
          itemCategory: "Clothing",
          price: 19.99,
          quantity: 1,
        ),
      ],
      value: 19.99,
      currency: "USD",
    );

    // 记录开始结账事件
    await _analytics.logBeginCheckout(
      items: [
        AnalyticsCommerceEventItem(
          itemId: "1",
          itemName: "T-shirt",
          itemCategory: "Clothing",
          price: 19.99,
          quantity: 1,
        ),
      ],
      value: 19.99,
      currency: "USD",
      coupon: "DISCOUNT10",
    );

    // 记录购买事件
    await _analytics.logPurchase(PurchaseEventParameter(
      transactionId: "123456",
      affiliation: "Online Store",
      revenue: 19.99,
      tax: 0.0,
      shipping: 0.0,
      coupon: "DISCOUNT10",
      currency: "USD",
      items: [
        AnalyticsCommerceEventItem(
          itemId: "1",
          itemName: "T-shirt",
          itemCategory: "Clothing",
          price: 19.99,
          quantity: 1,
        ),
      ],
    ));

    // 设置用户属性
    await _analytics.setUserProperty(
      propertyType: PropertyType.gender,
      value: "Male",
    );

    // 注册当前屏幕
    await _analytics.setCurrentScreen(
      screenName: "Checkout Page",
      screenClassOverride: "CheckoutPage",
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("Spreeloop Analytics Example")),
      body: Center(
        child: ElevatedButton(
          onPressed: _logEvent,
          child: Text("Log Events"),
        ),
      ),
    );
  }
}