Flutter数据分析插件reelevant_analytics的使用
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。
标签
每个事件类型都允许你通过labels
(Map<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
更多关于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
插件进行数据分析了。