React Native埋点SDK

React Native 埋点 SDK 仅自动采集设备信息和埋点数据,如果想自动采集用户点击事件或者页面访问事件等, 请集成 ReactNative 无埋点 SDK。

版本支持:

  • App适配最低系统版本:iOS 8及以上、Android 4.2-10

1. 集成SDK

Android
iOS
Android

1. 添加跟踪代码

React Native埋点SDK是在Android 原生SDK上的扩展,请参照Android SDK > 埋点SDK,完成添加跟踪代码配置。

添加跟踪代码时注意将SDK版本号换成RN版本: RN-track-2.8.20

集成步骤中,只有版本号不同,适配RN与原生混合开发场景。

代码示例

apply plugin: 'com.android.application'
android {
defaultConfig {
resValue("string", "growingio_project_id", "您的项目ID")
resValue("string", "growingio_url_scheme", "您的URL Scheme")
}
}
dependencies {
//GrowingIO RN 埋点 SDK
implementation 'com.growingio.android:vds-android-agent:RN-track-2.8.22'
}

2. 重要配置

由于 SDK 需要在java代码中进行初始化。

在项目的Application中,添加GrowingIOPackage

public class MainApplication extends Application implements ReactApplication {
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
// 此处加入GrowingIOPackage
new GrowingIOPackage()
);
}
}
iOS

1. 添加跟踪代码

React Native 埋点 SDK 是在 iOS 原生 SDK 上的扩展,请参照iOS SDK > 埋点 SDK集成 ,完成添加跟踪代码配置。

2. 集成React Native埋点SDK

npm install --save https://github.com/growingio/react-native-growingio.git#0.0.7
react-native link react-native-growingio

react-native link react-native-growingio 失败(即发现 Libraries中没有 GrowingIORNPlugin.xcodeproj ,则可手动配置)处理方法:

  1. 打开 XCode 工程中, 右键点击 Libraries 文件夹 ➜ Add Files to <...>

  2. node_modulesreact-native-growingio ➜ iOS ➜ 选择 GrowingIORNPlugin.xcodeproj

  3. 在工程Build PhasesLink Binary With Libraries中添加libGrowingIORNPlugin.a

如果您使用的是pod方式集成:

请添加以下内容到Podfile中,并在添加之后执行pod update

pod 'GrowingReactNativeTrackKit', :path => '../node_modules/react-native-growingio'

重要配置

与原生混合开发的开发者可详细查看 iOS SDK > 无埋点 SDK > 重要配置文档,如果原生控件使用不多,只需关注如下配置即可:

2. 自定义数据上传

React Native 无埋点SDK 自定义数据上传一致。

3. 创建应用

添加代码之后,请先Clean项目,然后再进行编译,并在你的 App 安装了 SDK 后重新启动几次 App,保证行为采集数据自动发送给 GrowingIO,以便顺利完成检测。

在GrowingIO平台的应用创建页面继续完成应用创建的数据检测,检测成功后应用创建成功。

4. 验证SDK是否正常采集数据

了解GrowingIO平台数据采集类型请参考数据模型

GrowingIO为您提供多种验证SDK是否正常采集数据的方式:

方式一:Mobile Debugger​​

方式二:在SDK中设置了Debug模式后,在IDE编译器控制台查看数据采集日志。

方式三:数据校验