react-native-talkingdata-appanalytics

❗️❗️❗️Warning：本仓库中的提供的静态库和jar包均为演示使用，请勿用作生产环境如果需要用于生产环境的SDK，请到TalkingData官网申请。

App Analytics react-native 平台 SDK 由封装层和Native SDK两部分构成，目前GitHub上提供了封装层代码，需要从 TalkingData官网下载最新版的 Android 和 iOS 平台 Native SDK，组合使用。

Android 平台
- 将最新的 .jar 文件复制到 lib/AppAnalytics/android/src/main/libs/ 目录下
- 修改lib/AppAnalytics/android/build.gradle中jar包的名称为新jar包的名称
- 如果您的React Native版本较低，参考Run Demo & 运行Demo的Android部分的文件差异进行封装层的文件替换
iOS 平台
- 将最新的 .a 文件复制到 lib/AppAnalytics/ios 目录下

按 Native SDK 功能选项对封装层代码进行必要的删减，详见“注意事项”第2条；
- Android 平台
- 如果您直接使用Demo进行代码的删减，那么请直接在Demo相应模块路径下进行操作
将 react-native SDK 集成您需要统计的工程中，并按集成文档进行必要配置和功能调用。

注意事项

分别选择 Android 和 iOS 平台进行功能定制时，请确保两个平台功能项一致。
如果申请 Native SDK 时只选择了部分功能，则需要在本项目中删除未选择功能对应的封装层代码。
a) 未选择自定义事件功能则删除以下4部分删除 lib/AppAnalytics/TalkingDataAppAnalytics.js 文件中如下代码：

...

static onEvent(eventName,label,parameters){
	...
}

static setGlobalKV(k,v){
	...
}

static removeGlobalKV(k){
	...
}

...

删除 lib/AppAnalytics/android/src/main/java/com/talkingdata/appanalytics/TalkingData.java 文件中如下代码：

...

  @ReactMethod
  public void setGlobalKVMap(String key, ReadableMap value) {
      ...
  }
  
  @ReactMethod
  public void setGlobalKVArray(String key, ReadableArray value) {
      ...
  }

  @ReactMethod
  public void setGlobalKVDouble(String key, double value) {
      ...
  }

  @ReactMethod
  public void setGlobalKVString(String key, String value) {
      ...
  }

  @ReactMethod
  public void setGlobalKVBoolean(String key, boolean value) {
      ...
  }

  @ReactMethod
  public void removeGlobalKV(String key) {
      ...
  }
  
  @ReactMethod
  public void onEvent(String eventId, String eventLabel, ReadableMap map) {
      ...
  }
  
  ...

删除 lib/AppAnalytics/ios/RCTTDAppSDK.m 文件中如下代码：

...

RCT_EXPORT_METHOD(onEvent:(NSString *)eventName
                  label:(NSString*)label
                  parameters:(NSDictionary*)parameters)
{
  ...
}

RCT_EXPORT_METHOD(setGlobalKV:(NSString *)key value:(id)value)
{
  ...
}

RCT_EXPORT_METHOD(removeGlobalKV:(NSString *)key)
{
  ...
}

...

删除 src/AppAnalytics/ios/TalkingData.h 文件中如下代码：

...

+ (void)trackEvent:(NSString *)eventId;
+ (void)trackEvent:(NSString *)eventId label:(NSString *)eventLabel;
+ (void)trackEvent:(NSString *)eventId
             label:(NSString *)eventLabel
        parameters:(NSDictionary *)parameters;
+ (void)setGlobalKV:(NSString *)key value:(id)value;
+ (void)removeGlobalKV:(NSString *)key;

...

b) 未选择标准化事件分析功能则删除以下4部分
删除 lib/AppAnalytics/TalkingDataAppAnalytics.js 文件中如下代码：

...

class TalkingDataShoppingCart {
	
	constructor(){
		...
	}

  	addItem(itemId,category,name,unitPrice,amount){
  		...
  	}

  	get shoppingCartString(){
  		...
  	}
}

...

static onPlaceOrder(orderId,amount,currencyType){
	...
}

static onOrderPaySucc(orderId,amount,currencyType,paymentType){
	...
}

static onCancelOrder(orderId,amount,currencyType){
  ...
}
  
static onViewItem(itemId,category,name,unitPrice){
	...
}

static onAddItemToShoppingCart(itemId,category,name,unitPrice,amount){
	...
}

static onViewShoppingCart(shoppingCart){
	...
}

...

删除 lib/AppAnalytics/android/src/main/java/com/talkingdata/appanalytics/TalkingData.java 文件中如下代码：

...

import com.tendcloud.tenddata.ShoppingCart;

...

  @ReactMethod
  public void onPlaceOrder(String orderID, int amount, String currencyType) {
      ...
  }

  @ReactMethod
  public void onOrderPaySucc(String orderID, int amount, String currencyType, String paymentType) {
      ...
  }
  
  @ReactMethod
  public void onCancelOrder(String orderID, int amount, String currencyType) {
      ...
  }

  @ReactMethod
  public void onAddItemToShoppingCart(String itemId, String category, String name, int unitPrice, int count) {
      ...
  }

  @ReactMethod
  public void onViewItem(String itemId, String category, String name, int unitPrice) {
      ...
  }

  @ReactMethod
  public void onViewShoppingCart(String shoppingCart) {
      ...
  }	
  
  ...
  

  private ShoppingCart getShoppingCart(String json){
      ...
  }

...

删除 src/AppAnalytics/ios/RCTTDAppSDK.m 文件中如下代码：

...

RCT_EXPORT_METHOD(onPlaceOrder:(NSString *)orderId amount:(int)amount currencyType:(NSString *)currencyType)
{
	...
}

RCT_EXPORT_METHOD(onOrderPaySucc:(NSString *)orderId amount:(int)amount currencyType:(NSString *)currencyType paymentType:(NSString *)paymentType)
{
  	...
}

RCT_EXPORT_METHOD(onCancelOrder:(NSString *)orderId amount:(int)amount currencyType:(NSString *)currencyType)
{
	...
}

RCT_EXPORT_METHOD(onViewItem:(NSString *)itemId category:(NSString *)category name:(NSString *)name unitPrice:(int)unitPrice)
{
	...
}
RCT_EXPORT_METHOD(onAddItemToShoppingCart:(NSString *)itemId category:(NSString *)category name:(NSString *)name unitPrice:(int)unitPrice amount:(int)amount)
{
	...
}
RCT_EXPORT_METHOD(onViewShoppingCart:(NSString *)shoppingCartString)
{
	...
}

删除 src/AppAnalytics/ios/TalkingData.h 文件中如下代码：

...

@interface TalkingDataShoppingCart : NSObject
+ (TalkingDataShoppingCart *)createShoppingCart;
- (TalkingDataShoppingCart *)addItem:(NSString *)itemId category:(NSString *)category name:(NSString *)name unitPrice:(int)unitPrice amount:(int)amount;
@end

...

+ (void)onPlaceOrder:(NSString *)orderId amount:(int)amount currencyType:(NSString *)currencyType;
+ (void)onOrderPaySucc:(NSString *)orderId amount:(int)amount currencyType:(NSString *)currencyType paymentType:(NSString *)paymentType;
+ (void)onCancelOrder:(NSString *)orderId amount:(int)amount currencyType:(NSString *)currencyType;
+ (void)onViewItem:(NSString *)itemId category:(NSString *)category name:(NSString *)name unitPrice:(int)unitPrice;
+ (void)onAddItemToShoppingCart:(NSString *)itemId category:(NSString *)category name:(NSString *)name unitPrice:(int)unitPrice amount:(int)amount;
+ (void)onViewShoppingCart:(TalkingDataShoppingCart *)shoppingCart;

...

c) 未选择页面统计功能则删除以下4部分
删除 lib/AppAnalytics/TalkingDataAppAnalytics.js 文件中如下代码：

...

static onPageStart(pageName) {
	...
}

static onPageEnd(pageName){
	...
}

...

删除 lib/AppAnalytics/android/src/main/java/com/talkingdata/appanalytics/TalkingData.java 文件中如下代码：

...

  @ReactMethod
  public void onPageStart(String pageName) {
      ...
  }

  @ReactMethod
  public void onPageEnd(String pageName) {
      ...
  }
  
  ...

删除 src/AppAnalytics/ios/RCTTDAppSDK.m 文件中如下代码：

...

RCT_EXPORT_METHOD(onPageStart:(NSString *)pageName)
{
  ...
}
RCT_EXPORT_METHOD(onPageEnd:(NSString *)pageName)
{
  ...
}

...

删除 src/AppAnalytics/ios/TalkingData.h 文件中如下代码：

...

+ (void)trackPageBegin:(NSString *)pageName;
+ (void)trackPageEnd:(NSString *)pageName;

...

d) 未选择用户质量评估功能则删除以下4部分
删除 lib/AppAnalytics/TalkingDataAppAnalytics.js 文件中如下代码：

...

static setAntiCheatingEnabled(enable){
	...
}

...

删除 lib/AppAnalytics/android/src/main/java/com/talkingdata/appanalytics/TalkingData.java 文件中如下代码：

...

  @ReactMethod
  public void setAntiCheatingEnabled(boolean enabled){
      ...
  }
  
 ...

删除 lib/AppAnalytics/ios/RCTTDAppSDK.m 文件中如下代码：

...

RCT_EXPORT_METHOD(setAntiCheatingEnabled:(BOOL)enabled)
{
  ...
}

...

删除 src/AppAnalytics/ios/TalkingData.h 文件中如下代码：

...

+ (void)setAntiCheatingEnabled:(BOOL)enabled;

...

INSTALL & 安装

iOS

将lib/AppAnalytics/ios目录下libTalkingData.a,TalkingData.h,RCTTDAppSDK.h,RCTTDAppSDK.m拖入到工程目录

Android

将lib/AppAnalytics/android以Module方式引入项目中：

在您app模块下的 MainApplication.java 中添加:

+ import com.talkingdata.appanalytics.TalkingDataPackage;

  public class MainApplication extends Application implements ReactApplication {
    //......

    @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
+         new TalkingDataPackage(),
          new MainReactPackage()
      );
    }
    
    ......
  }

IMPORT & 引用

JS层引用头文件

import {TalkingDataAppAnalytics,TDPROFILE,TalkingDataOrder,TalkingDataShoppingCart} from 'TalkingDataAppAnalytics.js'

iOS

添加初始化代码

+ #import "TalkingData.h"

  -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  
+  [TalkingData sessionStarted:@"你的appid" withChannelId:@"appstore"];

  NSURL *jsCodeLocation;

  jsCodeLocation = [[RCTBundleURLProvider sharedSettings] jsBundleURLForBundleRoot:@"index.ios" fallbackResource:nil];

  RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation
                                                      moduleName:@"rnDemo"
                                               initialProperties:nil
                                                   launchOptions:launchOptions];
  rootView.backgroundColor = [[UIColor alloc] initWithRed:1.0f green:1.0f blue:1.0f alpha:1];

  self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds];
  UIViewController *rootViewController = [UIViewController new];
  rootViewController.view = rootView;
  self.window.rootViewController = rootViewController;
  [self.window makeKeyAndVisible];
  return YES;
}

Android

添加初始化代码

在您app模块下的 MainApplication.java 中添加:

+ import com.tendcloud.tenddata.TCAgent;

  public class MainApplication extends Application implements ReactApplication {
    //......

    @Override
    public void onCreate() {
       super.onCreate();
+      TCAgent.init(this, "您的 App ID", "渠道 ID");
+      // 如果已经在AndroidManifest.xml配置了App ID和渠道 ID，调用TCAgent.init(this)即可；或与AndroidManifest.xml中的对应参数保持一致。
       SoLoader.init(this, /* native exopackage */ false);
    }
    ......
  }

在您app模块下的 AndroidManifest.xml 中添加：

<!--?xml version="1.0" encoding="utf-8"?-->
<manifest ......>
+  <uses-permission android:name="android.permission.INTERNET" /><!-- 允许程序联网和发送统计数据的权限。-->
+  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 允许应用检测网络连接状态，在网络异常状态下避免数据发送，节省流量和电量。-->
+  <uses-permission android:name="android.permission.READ_PHONE_STATE"  /><!-- 允许应用以只读的方式访问手机设备的信息，通过获取的信息来唯一标识用户。-->
+  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"  /><!-- 获取设备的MAC地址，同样用来标识唯一用户。-->
+  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"  /><!-- 用于保存设备信息，以及记录日志。-->
+  <uses-permission android:name="android.permission.GET_TASKS"  /><!-- (建议配置) 获取当前应用是否在显示应用，可以更精准的统计用户活跃-->
+  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"  /><!-- (可选权限) 可通过GPS获取设备的位置信息，用来修正用户的地域分布数据，使报表数据更准确。-->
+  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"  /><!-- (可选权限) 用来获取该应用被使用的粗略位置信息。-->

  <application ......>
  <activity ......>
  ......
  </activity>
  ......
+  <meta-data android:name="TD_APP_ID" android:value="Your_app_id" />
+  <meta-data android:name="TD_CHANNEL_ID" android:value="Your_channel_id" />
  </application>
</manifest>

API & 示例

方法	参数	iOS	Android	desc
getDeviceID(callback)	enabled bool	✅	✅	获取设备ID
getOAID(callback)	enabled bool	❌	✅	获取OAID
setLogEnabled(enable)	enabled bool	✅	❌	开启/关闭日志功能
setExceptionReportEnabled(enable)	enabled bool	✅	✅	开启/关闭异常捕获功能(捕获原生代码异常)
setSignalReportEnabled(enable))	enabled bool	✅	❌	开启/关闭异常信号捕获(原生异常信号)
setLatitudeLongitude(lat,lnt)	lat 经度，lnt纬度	✅	❌	自定义经纬度
setAntiCheatingEnabled(enable)	enabled bool	✅	✅	开启/关闭用户质量评估(反作弊功能)
onRegister(profileId,profileType,name)	profileId 账户id，profileType 账户类型，name 账户昵称	✅	✅	注册接口用于记录用户在使用应用过程中的注册行为。建议在注册成功时调用此接口。
onLogin(profileId,profileType,name)	profileId 账户id，profileType 账户类型，name 账户昵称	✅	✅	登录接口用于记录用户在使用应用过程中的登录行为。
onEvent(eventName,label,parameters)	eventName 事件名称，label 事件标签(自定义),parameters 参数	✅	✅	自定义事件用于追踪任何需要了解的用户行为，如：用户点击某功能按钮、填写某个输入框、触发了某个广告等。
onEventWithValue(eventName,label,parameters,value)	eventName 事件名称，label 事件标签(自定义),parameters 参数,value 事件数值	✅	✅	自定义事件用于追踪任何需要了解的用户行为，如：用户点击某功能按钮、填写某个输入框、触发了某个广告等。
setGlobalKV(k,v)	k 全局key ，v 全局的value	✅	✅	移除全局的key,value。
removeGlobalKV(k)	k 需要删除的全局的key	✅	✅	删除全局数据
onPageStart(pageName)	pageName 页面名称	✅	✅	触发页面事件，在页面加载完毕的时候调用，用于记录页面名称和使用时长，和 onPageEnd 配合使用
onPageEnd(pageName)	pageName 页面名称	✅	✅	触发页面事件，在页面加载完毕的时候调用，用于记录页面名称和使用时长，和 onPageBegin 配合使用
onPlaceOrder(orderId,amount,currencyType)	orderId 订单id, amount 总钱数, currencyType 货币类型	✅	✅	下单接口用于记录用户在使用应用过程中的成功下单的行为
onOrderPaySucc(orderId,amount,currencyType,paymentType)	orderId 订单id, amount 总钱数, currencyType 货币类型, paymentType 支付类型	✅	✅	成功支付订单接口用于记录用户完成订单支付的行为。
onCancelOrder(orderId,amount,currencyType)	orderId 订单id, amount 总钱数, currencyType 货币类型	✅	✅	取消订单接口用于记录用户取消订单的行为。
onViewItem(itemId,category,name)	itemId item的id,category 类别,name item的名称	✅	✅	用于记录用户查看商品详情的行为。
onAddItemToShoppingCart(itemId,category,name,unitPrice,amount)	itemId item的ID,category 类别,name 名称,unitPrice 单价,amount 数量	✅	✅	用于记录用户将商品加入购物车的行为。
onViewShoppingCart(shoppingCartString)	shoppingCartString 购物车字符串	✅	✅	查看购物车用于记录用户浏览购物车内商品的行为。这个接口由3个子接口构成：创建购物车、添加购物车详情、查看购物车。调用时需要按顺序完成这3个子接口的调用，否则可能会无法产生正确的查看购物车行为数据。

账户类型ProfileType 枚举

账户类型	枚举含义
ANONYMOUS	匿名账户
REGISTERED	显性注册账户
SINA_WEIBO	新浪微博
QQ	QQ账户
QQ_WEIBO	腾讯微博
ND91	91账户
WEIXIN	微信
TYPE1	自定义类型1
TYPE2	自定义类型2
TYPE3	自定义类型3
TYPE4	自定义类型4
TYPE5	自定义类型5
TYPE6	自定义类型6
TYPE7	自定义类型7
TYPE8	自定义类型8
TYPE9	自定义类型9
TYPE10	自定义类型10

getDeviceID(callback)

获取设备ID

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

TalkingDataAppAnalytics.getDeviceID((device_id)=>{
   //do something with device_id
});

Notes

getOAID(callback)

获取OAID。需要注意的是，这个接口建议您在初始化SDK之后的3-5秒再去调用，以避免您获取到null值

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

this.timer = setTimeout(() => {
  TalkingDataAppAnalytics.getOAID((oaid)=>{
	Alert.alert(oaid);
});
},3000);

Notes

setLogEnabled(enable)

开启/关闭日志功能

Examples

import {TalkingDataAppAnalytics} from 'react-native-talkingdata-appanalytics'

logEnable = false;
TalkingDataAppAnalytics.setLogEnabled(logEnable);

Notes

参数

logEnable (required): Boolean

setExceptionReportEnabled(enable)

开启/关闭异常捕获功能(捕获原生代码异常)

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

excpEnable = false;
TalkingDataAppAnalytics. setExceptionReportEnabled(excpEnable);

Notes

参数

excpEnable (required): Boolean

setSignalReportEnabled(enable)

开启/关闭异常信号捕获(原生异常信号)

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

signalEnable = false;
TalkingDataAppAnalytics. setSignalReportEnabled(signalEnable);

Notes

参数

signalEnable (required): Boolean

setLatitudeLongitude(lat,lnt)

自定义经纬度

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

lat = 30; //纬度
lnt = 50; //经度
TalkingDataAppAnalytics.setLatitudeLongitude(lat,lnt);

Notes

参数

lat (required): number 纬度
lnt (required): number 经度

setAntiCheatingEnabled(enable)

开启/关闭用户质量评估(反作弊功能)

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

acEnable = false;
TalkingDataAppAnalytics. setAntiCheatingEnabled(acEnable)

Notes

参数

acEnable (required): Boolean

onRegister(profileId,profileType,name)

注册接口用于记录用户在使用应用过程中的注册行为。建议在注册成功时调用此接口。

Examples

import {TalkingDataAppAnalytics,TDPROFILE} from 'TalkingDataAppAnalytics.js'

profileId = '123'; //账户id
profileType = TDPROFILE.ANONYMOUS; //账户类型 枚举
profileName = 'NickName'; //账户昵称
TalkingDataAppAnalytics.onRegister(profileId,profileType,profileName);

Notes

参数

profileId (required): string 账户ID
profileType (required): TDPROFILE枚举账户类型
profileName (required): string 账户昵称

onLogin(profileId,profileType,name)

登录接口用于记录用户在使用应用过程中的登录行为。

Examples

import {TalkingDataAppAnalytics,TDPROFILE} from 'TalkingDataAppAnalytics.js'

profileId = '123'; //账户id
profileType = TDPROFILE.ANONYMOUS; //账户类型 枚举
profileName = 'NickName'; //账户昵称
TalkingDataAppAnalytics.onLogin(profileId,profileType,profileName);

Notes

参数

profileId (required): string 账户ID
profileType (required): TDPROFILE枚举账户类型
profileName (required): string 账户昵称

onEvent(eventName,label,parameters)

自定义事件用于追踪任何需要了解的用户行为，如：用户点击某功能按钮、填写某个输入框、触发了某个广告等。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

eventName = 'click_btn'; //事件名称
eventLabel = 'my_custom_label'; //事件标签
parameter = {'btn_name':'xx_btn','btn_color':'xxcolor'} //事件参数
TalkingDataAppAnalytics.onEvent(eventName, eventLabel,parameter);

Notes

参数

eventName (required): string 事件名称
eventLabel (required): string 事件标签
parameters (required): object 事件参数

onEventWithValue(eventName,label,parameters,value)

自定义事件用于追踪任何需要了解的用户行为，如：用户点击某功能按钮、填写某个输入框、触发了某个广告等。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

eventName = 'click_btn'; //事件名称
eventLabel = 'my_custom_label'; //事件标签
parameter = {'btn_name':'xx_btn','btn_color':'xxcolor'} //事件参数
value = 5.21;//事件数值
TalkingDataAppAnalytics.onEventWithValue(eventName, eventLabel,parameter,value);

Notes

参数

eventName (required): string 事件名称
eventLabel (required): string 事件标签
parameters (required): object 事件参数
value(required):double 事件数值

setGlobalKV(k,v)

设置全局的key,value

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

globalKey = 'gkey'; //全局的key
globalValue = 'gvalue'; //全局的value
TalkingDataAppAnalytics.setGlobalKV(globalKey,globalValue);

Notes

参数

globalKey (required): string 全局的key
globalValue (required): any 全局的value

removeGlobalKV(k)

移除全局的key,value。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

globalKey = 'gkey'; //全局的key
TalkingDataAppAnalytics.removeGlobalKV(globalKey);

Notes

参数

globalKey (required): string 全局的key

onPageStart(pageName)

触发页面事件，在页面加载完毕的时候调用，用于记录页面名称和使用时长，和 onPageEnd 配合使用

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

pageName = 'homePage'; //页面名称
TalkingDataAppAnalytics.onPageStart(pageName);

Notes

参数

pageName (required): string 页面名称

onPageEnd(pageName)

触发页面事件，在页面加载完毕的时候调用，用于记录页面名称和使用时长，和 onPageBegin 配合使用

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

pageName = 'homePage'; //页面名称
TalkingDataAppAnalytics.onPageEnd(pageName);

Notes

参数

pageName (required): string 页面名称

onPlaceOrder(orderId,amount,currencyType)

下单接口用于记录用户在使用应用过程中的成功下单的行为。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

orderId = 'oid_123';//订单id
amount = 59900; //总钱数 单位为分
currencyType = 'CNY';//货币类型
TalkingDataAppAnalytics.onPlaceOrder(orderId, amount, currencyType);

Notes

参数

orderId (required): string 订单id
amount (required): string 总钱数单位为分
currencyType (required): string 货币类型

onOrderPaySucc(orderId,amount,currencyType,paymentType)

成功支付订单接口用于记录用户完成订单支付的行为。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

orderId = 'oid_123';//订单id
amount = 59900; //总钱数 单位为分
currencyType = 'CNY';//货币类型
paymentType = '银联支付' //支付类型
TalkingDataAppAnalytics.onOrderPaySucc(orderId, amount, currencyType, paymentType);

Notes

参数

orderId (required): string 订单id
amount (required): number 总钱数单位为分
currencyType (required): string 货币类型
paymentType (required): string 支付方式

onCancelOrder(orderId,amount,currencyType)

下单接口用于记录用户在使用应用过程中的取消订单的行为。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

orderId = 'oid_123';//订单id
amount = 59900; //总钱数 单位为分
currencyType = 'CNY';//货币类型
TalkingDataAppAnalytics.onCancelOrder(orderId, amount, currencyType);

Notes

参数

orderId (required): string 订单id
amount (required): string 总钱数单位为分
currencyType (required): string 货币类型

onViewItem(itemId,category,name,unitPrice)

用于记录用户查看商品详情的行为。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

itemId = 'item_123';//订单id
category = 'item_category'; //类别
name = 'item_name';//道具名称
unitPrice = 123

TalkingDataAppAnalytics.onViewItem(itemId,category,name,unitPrice);

Notes

参数

itemId (required): string 道具id
category (required): string 道具类别
name (required): string 道具名称
unitPrice (required): number 道具单价

onAddItemToShoppingCart(itemId,category,name,unitPrice,amount)

用于记录用户将商品加入购物车的行为。

Examples

import {TalkingDataAppAnalytics} from 'TalkingDataAppAnalytics.js'

itemId = 'item_123';//订单id
category = 'item_category'; //类别
name = 'item_name';//道具名称
unitPrice = 120; //单价 单位为分
amount = 100; //数量

TalkingDataAppAnalytics.onAddItemToShoppingCart(itemId,category,name,unitPrice,amount);

Notes

参数

itemId (required): string 道具id
category (required): string 道具类别
name (required): string 道具名称
unitPrice (required): number 单价单位为分
amount (required): number 数量

onViewShoppingCart(shoppingCartString)

查看购物车用于记录用户浏览购物车内商品的行为。这个接口由3个子接口构成：创建购物车、添加购物车详情、查看购物车。调用时需要按顺序完成这3个子接口的调用，否则可能会无法产生正确的查看购物车行为数据。

Examples

import {TalkingDataAppAnalytics, TalkingDataShoppingCart} from 'TalkingDataAppAnalytics.js'

let talkingdataShoppingCart = new TalkingDataShoppingCart();

itemId = 'item_123';//订单id
category = 'item_category'; //类别
name = 'item_name';//道具名称
unitPrice = 120; //单价 单位为分
amount = 100; //数量                                       
talkingdataShoppingCart.addItem(itemId,category,name,unitPrice,amount); //购物车添加item

TalkingDataAppAnalytics.onViewShoppingCart(talkingdataShoppingCart.shoppingCartString);//记录添加购物车

Notes

参数

itemId (required): string 道具id
category (required): string 道具类别
name (required): string 道具名称
unitPrice (required): number 单价单位为分
amount (required): number 数量

Run Demo & 运行Demo

下载本项目，进入到example文件夹并安装依赖

cd example/demo_aa
npm install

iOS

双击demo_aa.xcodeproj

Xcode11适配

此部分代码作为RN库代码的一部分，并未随着仓库提交，每次新clone项目，需要手动适配。

搜索RCTModuleMethod.m 将 static BOOL RCTParseUnused(const char** input)修改为

static BOOL RCTParseUnused(const char **input)
{
  return RCTReadString(input, "__unused") ||
         RCTReadString(input, "__attribute__((__unused__))") ||
         RCTReadString(input, "__attribute__((unused))");
}

ANDROID

在example/demo_aa路径下执行react-native run-android命令运行程序

可能会遇到的问题：

1.java.lang.RuntimeException: SDK location not found. Define location with sdk.dir in the local.properties file or with an ANDROID_HOME environment variable.

原因：找不到SDK

解决方法：在Demo的android目录下新建一个local.properties的文件，然后在文件中写入

sdk.dir = XXX

XXX是你的Android SDK对应的路径
2.Demo启动成功，但是应用界面是红色的，JS Server没有启动。可以使用命令react-native start启动JS Server。

如果提示
```
Invalid regular expression: /(node_modules[]react[]dist[].*|website\node_modules\.*|heapCapture\bundle.js)$/: Unterminated character class
```
那么请按照以下方式解决

原因：Node的版本较高的原因导致文件内的正则表达式无效

解决方法：进入node_nodules搜索blacklist，如果搜索不到文件，进入路径node_modules\react-native\packager可找到该文件，修改
```
var sharedBlacklist = [
  /node_modules[/\\]react[/\\]dist[/\\].*/,

  /website\/node_modules\/.*/,

  /heapCapture\/bundle\.js/,
];
```
更新为
```
var sharedBlacklist = [
  /node_modules[/\\]react[\/\\]dist[\/\\].*/,

  /website\/node_modules\/.*/,

  /heapCapture\/bundle\.js/,
];
```

3.如果执行完问题2的解决方法，启动了JS Server，并且点击RELOAD重新加载后仍然为红色，内容是:

could not connect to development server

那么可以执行以下两个方法进行解决：

1.终端运行adb reverse tcp:8081 tcp:8081，然后在对应目录执行react-native start启动JS Server并且点击RELOAD重新加载

2.尝试打开：

http://localhost:8081/index.android.bundle?platform=android

如果无法加载，那么执行以下步骤：

1.报错页面晃动手机，显示菜单
2.点击Dev Settings
3.点击Debug server host & port for device
4.设置IP和端口（ex:192.168.0.20:8081）,ip在终端执行ipconfig，使用其中的IPv4地址即可
5.点击返回
6.页面是空白，再次点击摇一摇，选择Reload JS程序就显示出来了

赋予权限

运行成功Android项目后，会弹出设置界面，赋予悬浮窗权限即可

文件差异

此版本的Demo是基于React Native v0.44.3建立的项目。Demo中对应的Module中的封装层代码因为React Native接口和类方法的变动而有所差异。

如果您的React Native项目版本是在v0.46.0-rc.0以下（不包括v0.46.0-rc.0），那么请您使用Demo中的android\react-native-talkingdata-appanalytics\src\main\java\com\talkingdata\appanalytics下的TalkingData.java文件替换封装层对应的文件

如果您的React Native项目版本是在v0.47.0-rc.0以下（不包括v0.47.0-rc.0），那么请您使用Demo中的android\react-native-talkingdata-appanalytics\src\main\java\com\talkingdata\appanalytics下的TalkingDataPackage.java文件替换封装层对应的文件

如果您的React Native项目版本是在v0.47.0-rc.0以及v0.47.0-rc.0以上的话，请直接接入封装层的代码即可

LICENSE & 许可

MIT LICENSE

Files

app.md

Latest commit

History

app.md

File metadata and controls

react-native-talkingdata-appanalytics

目录

集成说明

注意事项

INSTALL & 安装

iOS

Android

IMPORT & 引用

iOS

Android

API & 示例

账户类型ProfileType 枚举

getDeviceID(callback)

getOAID(callback)

setLogEnabled(enable)

setExceptionReportEnabled(enable)

setSignalReportEnabled(enable)

setLatitudeLongitude(lat,lnt)

setAntiCheatingEnabled(enable)

onRegister(profileId,profileType,name)

onLogin(profileId,profileType,name)

onEvent(eventName,label,parameters)

onEventWithValue(eventName,label,parameters,value)

setGlobalKV(k,v)

removeGlobalKV(k)

onPageStart(pageName)

onPageEnd(pageName)

onPlaceOrder(orderId,amount,currencyType)

onOrderPaySucc(orderId,amount,currencyType,paymentType)

onCancelOrder(orderId,amount,currencyType)

onViewItem(itemId,category,name,unitPrice)

onAddItemToShoppingCart(itemId,category,name,unitPrice,amount)

onViewShoppingCart(shoppingCartString)

Run Demo & 运行Demo

iOS

Xcode11适配

ANDROID

赋予权限

文件差异

LICENSE & 许可