React Native SDK

针对于SDK 3.0 上的 RN 插件,当前仅支持埋点sdk。

源码托管在 growingio/react-native-growingio-sdk-tracker-plugin

环境配置

请确保已经添加埋点SDK, 如果没有, 请移步至原生端SDK集成文档

添加依赖

$ npm install [email protected] --save

自动安装 (React Native 0.6.0版本及其以上可以跳过该步骤)

$ react-native link react-native-growing-tracker

手动安装

iOS

  1. 打开Xcode,在您的工程目录中点击 LibrariesAdd Files to [your project's name]

  2. 选择添加 node_modules ➜ react-native-growingio-tracker ➜ RNGrowingTracker.xcodeproj

  3. 选择您的目标项目, Build PhasesLink Binary With Libraries添加 libRNGrowingTracker.a

  4. 运行项目 (Cmd+R)

Android

  1. 打开您的首页Activity android/app/src/main/java/[...]/MainActivity.java

  • 导入包文件 com.reactnativegrowingtracker.GrowingTrackerPackage;

  • getPackages() 方法中添加 new GrowingTrackerPackage()

  1. 引入Android Native工程 android/settings.gradle:

    include ':reactnativegrowingtracker'
    project(':reactnativegrowingtracker').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-growing-tracker//android')
  2. 在app中添加Android Native依赖 android/app/build.gradle:

    implementation project(':reactnativegrowingtracker')

引入到文件

import GrowingTracker from 'react-native-growing-tracker';
GrowingTracker;

API说明

设置登录用户ID

GrowingTracker.setLoginUserId(userId)

参数说明

参数名

类型

必填

默认值

说明

userId

string

undefine

设置登录用户标识

代码示例

GrowingTracker.setLoginUserId('loginUserId');

清除登录用户ID

GrowingTracker.cleanLoginUserId()

代码示例

GrowingTracker.cleanLoginUserId();

设置坐标

GrowingTracker.setLocation(latitude, longitude)

参数说明

参数名

类型

必填

默认值

说明

latitude

number

undefine

设置纬度

longitude

number

undefine

设置经度

代码示例

GrowingTracker.setLocation(100.0, 100.0);

清除坐标

GrowingTracker.cleanLocation()

代码示例

GrowingTracker.cleanLocation();

获取设备标识

GrowingTracker.getDeviceId()

代码示例

GrowingTracker.getDeviceId().then(setDeviceId);

是否采集数据

GrowingTracker.setDataCollectionEnabled(enabled)

参数说明

参数名

类型

必填

默认值

说明

enabled

boolean

undefine

是否采集数据

代码示例

GrowingTracker.setDataCollectionEnabled(true);

设置登录用户属性

GrowingTracker.setLoginUserAttributes(attributes)

参数说明

参数名

类型

必填

默认值

说明

attributes

object

undefine

登录用户属性

代码示例

GrowingTracker.setLoginUserAttributes({ key1: 'value1', key2: 'value2',});

自定义事件

GrowingTracker.trackCustomEvent(eventName, attributes, itemKey, itemId)

参数说明

参数名

类型

必填

默认值

说明

eventName

string

undefine

事件名称

attributes

object

undefine

事件属性

itemKey

string

undefine

物品模型唯一标识属性

itemId

string

undefine

物品模型唯一标识属性的值

代码示例

GrowingTracker.trackCustomEvent('eventName', null);
GrowingTracker.trackCustomEvent('eventName', { key1: 'value1', key2: 'value2',});