Flutter数据分析插件reelevant_analytics的使用

发布于 1周前 作者 gougou168 来自 Flutter

Flutter数据分析插件reelevant_analytics的使用

此Flutter插件可用于向Reelevant数据源发送跟踪事件。

安装

运行以下命令:

flutter pub add reelevant_analytics

详情请参阅 pub.dev

如何使用

你需要一个datasourceId和一个companyId才能初始化SDK并开始发送事件:

final reelevantAnalytics = ReelevantAnalytics(companyId: '<公司ID>', datasourceId: '<数据源ID>');

// 生成一个事件
var event = reelevantAnalytics.pageView(labels: {});
// 发送事件
reelevantAnalytics.send(event);

当前URL

如果用户正在浏览某个页面,你应该调用sdk.setCurrentURL方法,以便在Reelevant中进行过滤。

用户信息

要识别用户,你应该调用sdk.setUser('<用户ID>')方法,该方法会将用户ID存储在设备上并将其发送到Reelevant。

标签

每个事件类型都允许你通过labelsMap<String, String>)传递额外的信息,在Reelevant中可以进行过滤。

var event = reelevantAnalytics.addCart(ids: ['my-product-id'], labels: {'lang': 'en_US'});

示例代码

以下是一个完整的示例代码,展示如何使用reelevant_analytics插件发送事件。

import 'package:flutter/material.dart';

import 'package:reelevant_analytics/reelevant_analytics.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  // 声明Reelevant Analytics SDK实例,并提供公司ID和数据源ID。
  final _reelevantAnalyticsPlugin = ReelevantAnalytics(
      companyId: '', // 请联系您的客户成功团队获取
      datasourceId: ''); // 请联系您的客户成功团队获取

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Reelevant Analytics 示例应用'),
        ),
        body: Center(
            child: Column(
          children: [
            const Text(
                '尝试通过点击按钮发送一个page_view事件'),
            ElevatedButton(
              onPressed: () {
                // 创建一个`page_view`事件。
                var event = _reelevantAnalyticsPlugin.pageView(labels: {});
                // 将事件发送到Reelevant事件数据源。
                _reelevantAnalyticsPlugin.send(event);
              },
              child: const Text('发送事件 📤'),
            )
          ],
        )),
      ),
    );
  }
}

更多关于Flutter数据分析插件reelevant_analytics的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter数据分析插件reelevant_analytics的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,以下是如何在Flutter项目中集成和使用reelevant_analytics插件的一个示例代码案例。reelevant_analytics是一个用于Flutter的数据分析插件,可以帮助你追踪和分析用户行为。

第一步:添加依赖

首先,在你的pubspec.yaml文件中添加reelevant_analytics依赖:

dependencies:
  flutter:
    sdk: flutter
  reelevant_analytics: ^最新版本号  # 请替换为实际的最新版本号

然后运行flutter pub get来获取依赖。

第二步:初始化插件

在你的Flutter应用的入口文件(通常是main.dart)中初始化reelevant_analytics插件。

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

void main() {
  // 初始化Reelevant Analytics
  ReelevantAnalytics.initialize('你的API_KEY');  // 请替换为你的实际API密钥

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

第三步:使用插件进行事件追踪

现在,你可以在应用的任何地方使用ReelevantAnalytics来追踪事件。例如,在一个按钮点击事件中追踪用户行为:

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

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Reelevant Analytics Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 追踪按钮点击事件
            ReelevantAnalytics.trackEvent(
              eventName: 'button_clicked',
              properties: <String, dynamic>{
                'button_name': 'example_button',
              },
            );
          },
          child: Text('Click Me'),
        ),
      ),
    );
  }
}

第四步:高级功能(可选)

除了基本的事件追踪,reelevant_analytics可能还支持更多高级功能,比如用户属性设置、页面浏览追踪等。你可以查阅官方文档来获取更多信息。以下是一个设置用户属性的示例:

void setUserProperties() {
  ReelevantAnalytics.setUserProperty(
    propertyName: 'user_level',
    propertyValue: 'premium',
  );
}

完整示例

结合以上步骤,这里是一个完整的示例应用:

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

void main() {
  ReelevantAnalytics.initialize('你的API_KEY');
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Reelevant Analytics Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            ReelevantAnalytics.trackEvent(
              eventName: 'button_clicked',
              properties: <String, dynamic>{
                'button_name': 'example_button',
              },
            );
          },
          child: Text('Click Me'),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: setUserProperties,
        tooltip: 'Set User Properties',
        child: Icon(Icons.edit),
      ),
    );
  }
}

void setUserProperties() {
  ReelevantAnalytics.setUserProperty(
    propertyName: 'user_level',
    propertyValue: 'premium',
  );
}

请确保你替换了你的API_KEY为实际的API密钥,并根据你的具体需求调整事件名称和属性。这样,你就可以在你的Flutter应用中集成并使用reelevant_analytics插件进行数据分析了。

回到顶部