Flutter 埋点 SDK
GrowingIO 埋点 SDK 仅自动采集设备信息和您埋点内容数据
Flutter插件集成
1. Flutter插件获取安装
根据dart pub文档获取安装
2. Android集成(Native部分)
此Flutter插件运行在Android手机上时依赖于GrowingIO Android SDK (可以是无埋 点SDK也可以是埋点SDK)2.6.0及以上, 原生部分请参考:
Android官方文档集成SDK部分(无埋点) 或Android官方文档集成SDK部分(埋点)
接入集成,可以参考仓库中的example项目.
3. iOS集成(Native部分)
添加iOS埋点SDK依赖
Flutter埋点插件是在 iOS 原生 SDK 上的扩展,请参照 iOS 埋点 SDK 集成步骤 1~3 ,操作完全一致
4. 常见问题
4.1 IOS: App Store 提交应用
如果您添加了库AdSupport.framework, GrowingIO则会启用IDFA,所以在向App Store 提交应用时,需要:
对于问题Does this app use the Advertising Identifier (IDFA),选择YES。
对于选项Attribute this app installation to a previously served advertisement,打勾。
对于选项Attribute an action taken within this app to a previously served advertisement,打勾。
4.2 IOS: 为什么GrowingIO使用IDFA
GrowingIO 使用IDFA 来做来源管理激活设备的精确匹配,让你更好的衡量广告效果。如果你不希望跟踪这个信息,可以选择不引入AdSupport.framework
4.3 Android: 初始化Android SDK时, GrowingIO类可能会报红色
这个应该是Flutter项目结构的问题,并不影响运行,可以放心编译. 不过需要手动import-_-|
4.4 为什么不在flutter中单独初始化
因为GrowingIO需要获取Android的Activity生命周期,为了数据的准确性,需要在Activity出现前就初始化完成
开发者相信很多用户都会使用flutter + native形式的进行开发,为了同时服务flutter于native
API说明
1. track
说明:发送自定义事件, 对应于cstm事件
参数
是否必填
说明
eventId
是
事件Id
num
否
数值, double型
variable
否
变量, Map型
调用示例:
import 'package:growingioflutter/growingio_track.dart';
GrowingIO.track('eventId');
GrowingIO.track('testEventId', num: 23.0, variable: {'testKey': 'testValue', 'testNumKey': 233});
GrowingIO.track('eventId', num: 23.0);
GrowingIO.track('eventId', variable: {'testkey': 'testValue', 'testNumKey': 2333});
2. setEvar
说明:发送转化变量, 对应于evar事件
函数原型为: setEvar(Map<String, dynamic> variable), 调用示例:
import 'package:growingioflutter/growingio_track.dart';
GrowingIO.setEvar({
'testKey': 'testValue', 'testNumKey': 2333.0
});
3. setPeopleVariable
说明:发送用户变量, 对应于ppl事件
函数原型为: setPeopleVariable(Map<String, dynamic> variable)
调用示例:
import 'package:growingioflutter/growingio_track.dart';
GrowingIO.setPeopleVariable({
'testKey': 'testValue', 'testNumKey': 2333.0
});
4. setUserId
说明:设置登录用户Id, 对应于cs1字段
参数
类型
描述
userId
String
登录用户Id
函数原型: setUserId(String userId)
调用示例:
import 'package:growingioflutter/growingio_track.dart';
GrowingIO.setUserId("testUserId");
5. clearUserId
说明:清除登录用户Id
函数原型: clearUserId()
调用示例:
import 'package:growingioflutter/growingio_track.dart';
GrowingIO.clearUserId();
6. setVisitor
说明:设置访问用户变量, 对应于vstr事件
函数原型: setVisitor(Map<String, dynamic> variable)
调用示例:
import 'package:growingioflutter/growingio_track.dart';
GrowingIO.setVisitor({
"visitorKey": 'key', "visitorValue": 34
});
Last updated