1.0.1-cdp • Published 3 years ago

react-native-growing-tracker v1.0.1-cdp

Weekly downloads
3
License
MIT
Repository
github
Last release
3 years ago

react-native-growing-tracker

GrowingIO Tracker SDK 3.0, CDP版本

环境配置

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

添加依赖

$ npm install react-native-growing-tracker@1.0.1-cdp --save

使用本地模块(进行自定义修改)

  1. git clone 插件仓库
git clone git@github.com:growingio/react-native-growingio-sdk-tracker-plugin.git
git checkout cdp
  1. 在项目的package.json中添加对应模块
"dependencies": {
    ...
    "react-native-growing-tracker": "file:path/react-native-growingio-sdk-tracker-plugin"
  },
  1. 获取依赖
yarn
  1. 执行项目
react-native run-ios
react-native run-android

自动安装 (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';

// TODO: What to do with the module?
GrowingTracker;

API说明

1 设置登录用户标识

1.1 GrowingTracker.setLoginUserId(userId)

设置登录用户标识。

1.2 参数说明

参数名类型必填默认值说明
userIdstringundefine设置登录用户标识

1.3 代码示例

GrowingTracker.setLoginUserId('loginUserId');

2 清除登录用户标识

2.1 GrowingTracker.cleanLoginUserId()

清除登录用户标识。

2.2 代码示例

GrowingTracker.cleanLoginUserId();

3 设置坐标

3.1 GrowingTracker.setLocation(latitude, longitude)

设置坐标。

3.2 参数说明

参数名类型必填默认值说明
latitudenumberundefine设置纬度
longitudenumberundefine设置经度

3.3 代码示例

GrowingTracker.setLocation(100.0, 100.0);

4 清除坐标

4.1 GrowingTracker.cleanLocation()

清除坐标。

4.2 代码示例

GrowingTracker.cleanLocation();

5 获取设备标识

5.1 GrowingTracker.getDeviceId()

设置坐标。

5.2 代码示例

GrowingTracker.getDeviceId().then(setDeviceId);

6 设置坐标

6.1 GrowingTracker.setDataCollectionEnabled(enabled)

是否采集数据。

6.2 参数说明

参数名类型必填默认值说明
enabledbooleanundefine是否采集数据

6.3 代码示例

GrowingTracker.setDataCollectionEnabled(true);

7 设置登录用户属性

7.1 GrowingTracker.setLoginUserAttributes(attributes)

设置登录用户属性。

7.2 参数说明

参数名类型必填默认值说明
attributesobjectundefine登录用户属性

7.3 代码示例

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

8 自定义事件

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

自定义事件。

8.2 参数说明

参数名类型必填默认值说明
eventNamestringundefine事件名称
attributesobjectnull事件属性
itemKeystringnull物品模型唯一标识属性
itemIdstringnull物品模型唯一标识属性的值

8.3 代码示例

GrowingTracker.trackCustomEvent('trackCustomEvent(string)', null);

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

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT