react-native-quicktracking-analytics-module 1.0.0 → 1.0.2

package/README.md

@@ -56,7 +56,7 @@ allprojects {
 dependencies {
   implementation fileTree(include:['*.jar'], dir:'libs')
 
-  implementation "com.umeng.umsdk:qt-px-common:1.3.8.PX"
+  implementation "com.umeng.umsdk:qt-px-common:1.3.9.PX"
 }
 ```
 
@@ -141,13 +141,6 @@ QtConfigure.setCustomDomain("收数域名", null);
 QtConfigure.preInit(this,"appkey","Channel");
 ```
 
-3. 初始化
-```java
-// 请务必在用户同意隐私政策后，再初始化SDK。
-// 正式初始化SDK，务必调用
-QtConfigure.init(this,"appkey","unknown",UMConfigure.DEVICE_TYPE_PHONE, "");
-```
-
 
 ## iOS 基座集成
 ### 使用CocoaPods集成
@@ -225,6 +218,21 @@ Podfile示例
 
 ```
 # 埋点API
+## SDK初始化
+### 正式初始化
+务必调用，请务必在用户同意隐私政策后，再初始化SDK。
+```typescript
+function init(appKey: string, channel: string): void
+```
+| 参数 | 含义 |
+| --- | --- |
+| appKey | QT后台提供的唯一应用key值 |
+| channel | 下载渠道 |
+
+### 示例
+```tsx
+QT.init('appkey', 'quicktracking');
+```
 ## 用户账号上报
 ### 用户登录
 该值的上传对应产品中“登录用户”：计算“登录用户”数，就是计算下述API上传值的去重数
@@ -244,7 +252,7 @@ function profileSignIn(ID: string, provider?: string): void
 function profileSignOff(): void
 ```
 
-示例：
+### 示例
 ```typescript
 QT.profileSignIn('用户ID');
 QT.profileSignOff();
@@ -257,7 +265,7 @@ function sendEvent(eventId: string, params: any): void
 ```
 | 参数 | 含义 |
 | --- | --- |
-| eventId | 当前统计的事件ID |
+| eventId | 当前统计的事件编码 |
 | params | 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对 |
 
 注：用户属性上传一定要在用户账号上报后。
@@ -268,7 +276,7 @@ QT.onProfileSignIn("张三");
 
 const user = {
 	gender: "male",
-    age: "8"
+  age: "8"
 }
 QT.sendEvent("$$_user_profile", user);
 ```
@@ -357,7 +365,7 @@ function onPageEnd(pageName: string): void
 ```
 | 参数 | 含义 |
 | --- | --- |
-| pageName | 自定义页面的名称 |
+| pageName | 页面编码 |
 
 示例：
 ```typescript
@@ -373,22 +381,38 @@ onPageStart 和 onPageEnd 必须成对调用。
 ```typescript
   /**
    * 自定义事件埋点
-   * @param eventId 当前统计的事件ID
+   * @param eventId 当前统计的事件编码
    * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+   * @param pageName 当前统计事件的页面编码
    */
-  function sendEvent(eventId: string, params: any): void
+  function sendEvent(eventId: string, params?: any, pageName?: string): void
 ```
 | 参数 | 含义 |
 | --- | --- |
-| eventId | 为当前统计的事件ID。 |
+| eventId | 为当前统计的事件编码。 |
 | params | 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>对”。为单层对象结构，不支持多层嵌套。 |
+| pageName | 当前统计事件的页面编码。 |
 
 **示例：**
 ```typescript
-QT.sendEvent('my_event', {
-  name: 'app_name',
-  options: 'xxx',
-});
+// 携带事件参数的自定义事件
+QT.sendEvent(
+  'event1',
+  {
+    name: 'quick tracking',
+    method: 'func',
+  },
+);
+
+// 携带事件参数和页面编码的自定义事件
+QT.sendEvent(
+  'event2',
+  {
+    name: 'quick tracking',
+    method: 'func',
+  },
+  'main_page'
+);
 ```
 > **_备注：_**
 > - 多参数类型事件能满足原来计算事件/计数事件的分析场景；
@@ -491,7 +515,6 @@ export default function WebPage() {
 ## Umeng4Plus为空
 控制台提示[APLUS] -- jsbridge Android environment error, Umeng4Aplus =  undefined
 Umeng4Plus是桥接的环境变量，若提示undefined，说明在原生端未接入桥接功能，请找负责Android或iOS的同学对接。
-
 ## ruby版本过低
 进入项目时提示，Required ruby-2.7.5 is not installed. To install do: 'rvm install "ruby-2.7.5"'
 注意您的ruby版本，MacOS自带的Ruby为2.6.8，不符合RN项目需求。
@@ -505,19 +528,21 @@ rvm use 2.7.5
 
 ## 嵌入的html可以收发数，但Android端不能
 查看Android Manifest里有没有配置网络权限。
-
 # 参考
 > [QuickTracking Android SDK集成手册](https://help.aliyun.com/document_detail/260238.html)
->
 > [QuickTracking iOS SDK集成手册](https://help.aliyun.com/document_detail/260233.html)
->
 > [React Native Android 本地模块](https://reactnative.dev/docs/native-modules-android)
->
 > [React Native iOS 本地模块](https://reactnative.dev/docs/native-modules-ios)
 
 
 
 
+
+
+
+
+
+
 ## License
 
 MIT

package/android/build.gradle

@@ -134,7 +134,7 @@ dependencies {
 //  implementation fileTree(include:['*.jar'], dir:'libs')
   implementation "com.facebook.react:react-native:+"
   //友盟基础库
-  implementation "com.umeng.umsdk:qt-px-common:1.3.8.PX"
+  implementation "com.umeng.umsdk:qt-px-common:1.3.9.PX"
 }
 
 if (isNewArchitectureEnabled()) {

package/android/src/main/java/com/reactnativequicktrackinganalyticsmodule/QuicktrackingAnalyticsModuleModule.java

@@ -23,6 +23,7 @@ import com.facebook.react.bridge.ReadableType;
 import com.facebook.react.module.annotations.ReactModule;
 
 import com.quick.qt.analytics.QtTrackAgent;
+import com.quick.qt.commonsdk.QtConfigure;
 import com.quick.qt.spm.SpmAgent;
 
 @ReactModule(name = QuicktrackingAnalyticsModuleModule.NAME)
@@ -54,9 +55,18 @@ public class QuicktrackingAnalyticsModuleModule extends ReactContextBaseJavaModu
       QtTrackAgent.onPageEnd(pageName);
     }
 
+    @ReactMethod
+    public void onEvent(String eventID) {
+      QtTrackAgent.onEvent(context, eventID);
+    }
 
     @ReactMethod
-    public void onEventObject(String eventID, ReadableMap property) {
+    public void onEventWithPageName(String eventID, String pageName) {
+      QtTrackAgent.onEvent(context, eventID, pageName);
+    }
+
+    @ReactMethod
+    public void onEventWithParams(String eventID, ReadableMap property) {
       Map<String, Object> map = new HashMap();
       ReadableMapKeySetIterator iterator = property.keySetIterator();
       while (iterator.hasNextKey()) {
@@ -76,6 +86,27 @@ public class QuicktrackingAnalyticsModuleModule extends ReactContextBaseJavaModu
       QtTrackAgent.onEventObject(context, eventID, map);
     }
 
+    @ReactMethod
+    public void onEventWithParamsAndPageName(String eventID, ReadableMap property, String pageName) {
+      Map<String, Object> map = new HashMap();
+      ReadableMapKeySetIterator iterator = property.keySetIterator();
+      while (iterator.hasNextKey()) {
+        String key = iterator.nextKey();
+        if (ReadableType.Array == property.getType(key)) {
+          map.put(key, property.getArray(key).toString());
+        } else if (ReadableType.Boolean == property.getType(key)) {
+          map.put(key, String.valueOf(property.getBoolean(key)));
+        } else if (ReadableType.Number == property.getType(key)) {
+          map.put(key, String.valueOf(property.getInt(key)));
+        } else if (ReadableType.String == property.getType(key)) {
+          map.put(key, property.getString(key));
+        } else if (ReadableType.Map == property.getType(key)) {
+          map.put(key, property.getMap(key).toString());
+        }
+      }
+      QtTrackAgent.onEventObject(context, eventID, map, pageName);
+    }
+
     @ReactMethod
     public void onEventForH5(String content) {
       try {
@@ -157,4 +188,11 @@ public class QuicktrackingAnalyticsModuleModule extends ReactContextBaseJavaModu
     public void profileSignOff() {
       QtTrackAgent.onProfileSignOff();
     }
+
+    // 请务必在用户同意隐私政策后，再初始化SDK
+    // 正式初始化SDK，务必调用
+    @ReactMethod
+    public void initWithAppkey(String AppKey, String Channel) {
+        QtConfigure.init(context, AppKey, Channel, QtConfigure.DEVICE_TYPE_PHONE, "");
+    }
 }

package/ios/QuicktrackingAnalyticsModule.m

@@ -1,5 +1,7 @@
 //#if __has_include(<QTCommon/MobClick.h>)
 #import <QTCommon/MobClick.h>
+#import <QTCommon/UMConfigure.h>
+
 //#else
 //#import "MobClick.h"
 //#endif
@@ -38,7 +40,7 @@ RCT_EXPORT_METHOD(onPageEnd:(NSString *)pageName)
  * @eventId 自定义事件名(字符串类型)
  * @params 一级平铺自定义参数属性键值对，不支持嵌套，并且iOS端不支持值为 null 和 "" 类型的键
  */
-RCT_EXPORT_METHOD(onEventObject:(NSString*)eventId parameters:(NSDictionary*)parameters)
+RCT_EXPORT_METHOD(onEventWithParams:(NSString*)eventId parameters:(NSDictionary*)parameters)
 {
     if (eventId == nil || [eventId isKindOfClass:[NSNull class]]) {
         return;
@@ -49,6 +51,31 @@ RCT_EXPORT_METHOD(onEventObject:(NSString*)eventId parameters:(NSDictionary*)par
     [QTMobClick event:eventId attributes:parameters];
 }
 
+RCT_EXPORT_METHOD(onEvenWithPageName:(NSString*)eventId pageName:(NSString *)pageName)
+{
+    if (eventId == nil || [eventId isKindOfClass:[NSNull class]]) {
+        return;
+    }
+    if (pageName == nil || [pageName isKindOfClass:[NSNull class]]) {
+        return;
+    }
+    [QTMobClick event:eventId pageName:pageName];
+}
+
+RCT_EXPORT_METHOD(onEventWithParamsAndPageName:(NSString*)eventId pageName:(NSString *)pageName parameters:(NSDictionary*)parameters)
+{
+    if (eventId == nil || [eventId isKindOfClass:[NSNull class]]) {
+        return;
+    }
+    if (pageName == nil || [pageName isKindOfClass:[NSNull class]]) {
+        return;
+    }
+    if (parameters == nil && [parameters isKindOfClass:[NSNull class]]) {
+        parameters = nil;
+    }
+    [QTMobClick event:eventId pageName:pageName attributes:parameters];
+}
+
 RCT_EXPORT_METHOD(onEvent:(NSString *)eventId)
 {
   if (eventId == nil || [eventId isKindOfClass:[NSNull class]]) {
@@ -70,7 +97,7 @@ RCT_EXPORT_METHOD(onEventWithParamsAndCount:(NSString *)eventId parameters:(NSDi
 }
 
 RCT_EXPORT_METHOD(onEventForH5:(NSString*)eventId attributes:(NSDictionary *)attributes) {
-    
+
   Class _MobClickEvent = NSClassFromString(@"QTMobClickEvent");
     if (_MobClickEvent){
         SEL sel = NSSelectorFromString(@"eventForH5:attributes:");
@@ -126,6 +153,16 @@ RCT_EXPORT_METHOD(getGlobalProperties:(RCTPromiseResolveBlock)resolve reject:(RC
     }
 }
 
+// RCT_EXPORT_METHOD(preInit:(NSString*)appKey)
+// {
+//     [QTMobClick preInit:appKey];
+// }
+
+RCT_EXPORT_METHOD(initWithAppkey:(NSString *)appKey channel:(NSString *)channel)
+{
+    [QTConfigure initWithAppkey:appKey channel:channel];
+}
+
 //======================================用户账号和用户属性相关===========================================//
 RCT_EXPORT_METHOD(profileSignIn:(NSString*)puid provider:(NSString*)provider)
 {

package/ios/QuicktrackingAnalyticsModule.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

package/lib/commonjs/index.js

@@ -12,7 +12,7 @@ const QuicktrackingAnalyticsModule = _reactNative.NativeModules.QuicktrackingAna
 class QT {
   /**
    * 页面浏览事件埋点-打开页面
-   * @param pageName 页面名称
+   * @param pageName 页面编码
    */
   static onPageStart(pageName) {
     QuicktrackingAnalyticsModule.onPageStart(pageName);
@@ -20,7 +20,7 @@ class QT {
 
   /**
    * 页面浏览事件埋点-离开页面
-   * @param pageName 页面名称
+   * @param pageName 页面编码
    */
   static onPageEnd(pageName) {
     QuicktrackingAnalyticsModule.onPageEnd(pageName);
@@ -28,14 +28,23 @@ class QT {
 
   /**
    * 自定义事件埋点
-   * @param eventId 当前统计的事件ID
+   * @param eventId 当前统计的事件编码
    * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+   * @param pageName 当前统计事件的页面编码
    */
-  static sendEvent(eventId, params) {
+  static sendEvent(eventId, params, pageName) {
     if (params) {
-      QuicktrackingAnalyticsModule.onEventObject(eventId, params);
+      if (pageName) {
+        QuicktrackingAnalyticsModule.onEventWithParamsAndPageName(eventId, params, pageName);
+      } else {
+        QuicktrackingAnalyticsModule.onEventWithParams(eventId, params);
+      }
     } else {
-      QuicktrackingAnalyticsModule.onEvent(eventId);
+      if (pageName) {
+        QuicktrackingAnalyticsModule.onEventWithPageName(eventId, pageName);
+      } else {
+        QuicktrackingAnalyticsModule.onEvent(eventId);
+      }
     }
   }
 
@@ -78,9 +87,10 @@ class QT {
   /**
    * 注册一个全局事件属性
    * @param property 要注册的全局属性
-   * @description 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
-   * 且这些属性及属性值存入缓存，APP退出后清除。
-   * 在分析数据时，可根据此属性进行查看和筛选。
+   * @description
+   ** 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
+   ** 且这些属性及属性值存入缓存，APP退出后清除。
+   ** 在分析数据时，可根据此属性进行查看和筛选。
    */
   static registerGlobalProperty(gp) {
     if (_reactNative.Platform.OS === 'ios') {
@@ -172,58 +182,16 @@ class QT {
   static profileSignOff() {
     QuicktrackingAnalyticsModule.profileSignOff();
   }
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventLabel 分类标签
-  //  */
-  // static sendEventLabel(eventId: string, eventLabel: string) {
-  //   return QuicktrackingAnalyticsModule.sendEventLabel(eventId, eventLabel);
-  // }
-
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，如：{name:"Jack",gender:"man"}
-  //  */
-  // static sendEventMap(eventId: string, eventData: Object) {
-  //   return QuicktrackingAnalyticsModule.sendEventMap(eventId, eventData);
-  // }
-
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，如：{name:"Jack",gender:"man"}
-  //  * @param eventNum 用户每次触发的数值的分布情况，如事件持续时间、每次付款金额等
-  //  */
-  // static sendEventMapAndCount(
-  //   eventId: string,
-  //   eventData: Object,
-  //   eventNum: number
-  // ) {
-  //   return QuicktrackingAnalyticsModule.sendEventMapAndCount(
-  //     eventId,
-  //     eventData,
-  //     eventNum
-  //   );
-  // }
 
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，值可以是对象
-  //  */
-  // static sendEventObject(eventId: string, eventData: Object) {
-  //   return QuicktrackingAnalyticsModule.sendEventObject(eventId, eventData);
-  // }
-
-  // /**
-  //  * 设置关注事件是否触发
-  //  * @param eventList 事件list
-  //  */
-  // static setFirstLaunchEvent<T>(eventList: Array<T>) {
-  //   return QuicktrackingAnalyticsModule.setFirstLaunchEvent(eventList);
-  // }
+  /**
+   * SDK正式初始化
+   * @param appKey QuickTracking后台提供的唯一key值，请勿泄露给第三方
+   * @param channel 下载渠道
+   * @description 请务必在用户同意隐私政策后，再初始化SDK，务必调用。
+   */
+  static init(appKey, channel) {
+    QuicktrackingAnalyticsModule.initWithAppkey(appKey, channel);
+  }
 }
 exports.QT = QT;
 //# sourceMappingURL=index.js.map

package/lib/module/index.js

@@ -6,7 +6,7 @@ const QuicktrackingAnalyticsModule = NativeModules.QuicktrackingAnalyticsModule;
 export class QT {
   /**
    * 页面浏览事件埋点-打开页面
-   * @param pageName 页面名称
+   * @param pageName 页面编码
    */
   static onPageStart(pageName) {
     QuicktrackingAnalyticsModule.onPageStart(pageName);
@@ -14,7 +14,7 @@ export class QT {
 
   /**
    * 页面浏览事件埋点-离开页面
-   * @param pageName 页面名称
+   * @param pageName 页面编码
    */
   static onPageEnd(pageName) {
     QuicktrackingAnalyticsModule.onPageEnd(pageName);
@@ -22,14 +22,23 @@ export class QT {
 
   /**
    * 自定义事件埋点
-   * @param eventId 当前统计的事件ID
+   * @param eventId 当前统计的事件编码
    * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+   * @param pageName 当前统计事件的页面编码
    */
-  static sendEvent(eventId, params) {
+  static sendEvent(eventId, params, pageName) {
     if (params) {
-      QuicktrackingAnalyticsModule.onEventObject(eventId, params);
+      if (pageName) {
+        QuicktrackingAnalyticsModule.onEventWithParamsAndPageName(eventId, params, pageName);
+      } else {
+        QuicktrackingAnalyticsModule.onEventWithParams(eventId, params);
+      }
     } else {
-      QuicktrackingAnalyticsModule.onEvent(eventId);
+      if (pageName) {
+        QuicktrackingAnalyticsModule.onEventWithPageName(eventId, pageName);
+      } else {
+        QuicktrackingAnalyticsModule.onEvent(eventId);
+      }
     }
   }
 
@@ -72,9 +81,10 @@ export class QT {
   /**
    * 注册一个全局事件属性
    * @param property 要注册的全局属性
-   * @description 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
-   * 且这些属性及属性值存入缓存，APP退出后清除。
-   * 在分析数据时，可根据此属性进行查看和筛选。
+   * @description
+   ** 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
+   ** 且这些属性及属性值存入缓存，APP退出后清除。
+   ** 在分析数据时，可根据此属性进行查看和筛选。
    */
   static registerGlobalProperty(gp) {
     if (Platform.OS === 'ios') {
@@ -166,57 +176,15 @@ export class QT {
   static profileSignOff() {
     QuicktrackingAnalyticsModule.profileSignOff();
   }
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventLabel 分类标签
-  //  */
-  // static sendEventLabel(eventId: string, eventLabel: string) {
-  //   return QuicktrackingAnalyticsModule.sendEventLabel(eventId, eventLabel);
-  // }
-
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，如：{name:"Jack",gender:"man"}
-  //  */
-  // static sendEventMap(eventId: string, eventData: Object) {
-  //   return QuicktrackingAnalyticsModule.sendEventMap(eventId, eventData);
-  // }
-
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，如：{name:"Jack",gender:"man"}
-  //  * @param eventNum 用户每次触发的数值的分布情况，如事件持续时间、每次付款金额等
-  //  */
-  // static sendEventMapAndCount(
-  //   eventId: string,
-  //   eventData: Object,
-  //   eventNum: number
-  // ) {
-  //   return QuicktrackingAnalyticsModule.sendEventMapAndCount(
-  //     eventId,
-  //     eventData,
-  //     eventNum
-  //   );
-  // }
 
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，值可以是对象
-  //  */
-  // static sendEventObject(eventId: string, eventData: Object) {
-  //   return QuicktrackingAnalyticsModule.sendEventObject(eventId, eventData);
-  // }
-
-  // /**
-  //  * 设置关注事件是否触发
-  //  * @param eventList 事件list
-  //  */
-  // static setFirstLaunchEvent<T>(eventList: Array<T>) {
-  //   return QuicktrackingAnalyticsModule.setFirstLaunchEvent(eventList);
-  // }
+  /**
+   * SDK正式初始化
+   * @param appKey QuickTracking后台提供的唯一key值，请勿泄露给第三方
+   * @param channel 下载渠道
+   * @description 请务必在用户同意隐私政策后，再初始化SDK，务必调用。
+   */
+  static init(appKey, channel) {
+    QuicktrackingAnalyticsModule.initWithAppkey(appKey, channel);
+  }
 }
 //# sourceMappingURL=index.js.map

package/lib/typescript/index.d.ts

@@ -6,20 +6,21 @@ declare type EventParams = Record<string, string | number>;
 export declare class QT {
     /**
      * 页面浏览事件埋点-打开页面
-     * @param pageName 页面名称
+     * @param pageName 页面编码
      */
     static onPageStart(pageName: string): void;
     /**
      * 页面浏览事件埋点-离开页面
-     * @param pageName 页面名称
+     * @param pageName 页面编码
      */
     static onPageEnd(pageName: string): void;
     /**
      * 自定义事件埋点
-     * @param eventId 当前统计的事件ID
+     * @param eventId 当前统计的事件编码
      * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+     * @param pageName 当前统计事件的页面编码
      */
-    static sendEvent(eventId: string, params: EventParams): void;
+    static sendEvent(eventId: string, params?: EventParams, pageName?: string): void;
     /**
      * 桥接事件埋点
      * @param data H5转发事件的日志体
@@ -28,9 +29,10 @@ export declare class QT {
     /**
      * 注册一个全局事件属性
      * @param property 要注册的全局属性
-     * @description 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
-     * 且这些属性及属性值存入缓存，APP退出后清除。
-     * 在分析数据时，可根据此属性进行查看和筛选。
+     * @description
+     ** 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
+     ** 且这些属性及属性值存入缓存，APP退出后清除。
+     ** 在分析数据时，可根据此属性进行查看和筛选。
      */
     static registerGlobalProperty(gp: GlobalProperty): void;
     /**
@@ -61,5 +63,12 @@ export declare class QT {
      * 账号登出时需调用此接口，调用之后不再发送账号相关内容。
      */
     static profileSignOff(): void;
+    /**
+     * SDK正式初始化
+     * @param appKey QuickTracking后台提供的唯一key值，请勿泄露给第三方
+     * @param channel 下载渠道
+     * @description 请务必在用户同意隐私政策后，再初始化SDK，务必调用。
+     */
+    static init(appKey: string, channel: string): void;
 }
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-quicktracking-analytics-module",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "QuickTracking ReactNative SDK",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/index.tsx

@@ -10,7 +10,7 @@ type EventParams = Record<string, string | number>;
 export class QT {
   /**
    * 页面浏览事件埋点-打开页面
-   * @param pageName 页面名称
+   * @param pageName 页面编码
    */
   static onPageStart(pageName: string) {
     QuicktrackingAnalyticsModule.onPageStart(pageName);
@@ -18,7 +18,7 @@ export class QT {
 
   /**
    * 页面浏览事件埋点-离开页面
-   * @param pageName 页面名称
+   * @param pageName 页面编码
    */
   static onPageEnd(pageName: string) {
     QuicktrackingAnalyticsModule.onPageEnd(pageName);
@@ -26,14 +26,27 @@ export class QT {
 
   /**
    * 自定义事件埋点
-   * @param eventId 当前统计的事件ID
+   * @param eventId 当前统计的事件编码
    * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+   * @param pageName 当前统计事件的页面编码
    */
-  static sendEvent(eventId: string, params: EventParams) {
+  static sendEvent(eventId: string, params?: EventParams, pageName?: string) {
     if (params) {
-      QuicktrackingAnalyticsModule.onEventObject(eventId, params);
+      if (pageName) {
+        QuicktrackingAnalyticsModule.onEventWithParamsAndPageName(
+          eventId,
+          params,
+          pageName
+        );
+      } else {
+        QuicktrackingAnalyticsModule.onEventWithParams(eventId, params);
+      }
     } else {
-      QuicktrackingAnalyticsModule.onEvent(eventId);
+      if (pageName) {
+        QuicktrackingAnalyticsModule.onEventWithPageName(eventId, pageName);
+      } else {
+        QuicktrackingAnalyticsModule.onEvent(eventId);
+      }
     }
   }
 
@@ -80,9 +93,10 @@ export class QT {
   /**
    * 注册一个全局事件属性
    * @param property 要注册的全局属性
-   * @description 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
-   * 且这些属性及属性值存入缓存，APP退出后清除。
-   * 在分析数据时，可根据此属性进行查看和筛选。
+   * @description
+   ** 注册全局属性后，后续触发的所有事件都将自动包含这些属性；
+   ** 且这些属性及属性值存入缓存，APP退出后清除。
+   ** 在分析数据时，可根据此属性进行查看和筛选。
    */
   static registerGlobalProperty(gp: GlobalProperty) {
     if (Platform.OS === 'ios') {
@@ -174,56 +188,14 @@ export class QT {
   static profileSignOff() {
     QuicktrackingAnalyticsModule.profileSignOff();
   }
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventLabel 分类标签
-  //  */
-  // static sendEventLabel(eventId: string, eventLabel: string) {
-  //   return QuicktrackingAnalyticsModule.sendEventLabel(eventId, eventLabel);
-  // }
-
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，如：{name:"Jack",gender:"man"}
-  //  */
-  // static sendEventMap(eventId: string, eventData: Object) {
-  //   return QuicktrackingAnalyticsModule.sendEventMap(eventId, eventData);
-  // }
-
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，如：{name:"Jack",gender:"man"}
-  //  * @param eventNum 用户每次触发的数值的分布情况，如事件持续时间、每次付款金额等
-  //  */
-  // static sendEventMapAndCount(
-  //   eventId: string,
-  //   eventData: Object,
-  //   eventNum: number
-  // ) {
-  //   return QuicktrackingAnalyticsModule.sendEventMapAndCount(
-  //     eventId,
-  //     eventData,
-  //     eventNum
-  //   );
-  // }
 
-  // /**
-  //  * 自定义事件埋点
-  //  * @param eventId 当前统计的事件ID
-  //  * @param eventData 为当前事件的属性和取值（键值对），不能为空，值可以是对象
-  //  */
-  // static sendEventObject(eventId: string, eventData: Object) {
-  //   return QuicktrackingAnalyticsModule.sendEventObject(eventId, eventData);
-  // }
-
-  // /**
-  //  * 设置关注事件是否触发
-  //  * @param eventList 事件list
-  //  */
-  // static setFirstLaunchEvent<T>(eventList: Array<T>) {
-  //   return QuicktrackingAnalyticsModule.setFirstLaunchEvent(eventList);
-  // }
+  /**
+   * SDK正式初始化
+   * @param appKey QuickTracking后台提供的唯一key值，请勿泄露给第三方
+   * @param channel 下载渠道
+   * @description 请务必在用户同意隐私政策后，再初始化SDK，务必调用。
+   */
+  static init(appKey: string, channel: string) {
+    QuicktrackingAnalyticsModule.initWithAppkey(appKey, channel);
+  }
 }