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

package/HISTORY.md

@@ -0,0 +1,17 @@
+### v1.0.4
+  * fix: 修复iOS不能设置页面属性的问题
+
+### v1.0.3
+    * feat: 添加了页面属性上传的埋点API uploadPageProperties
+    * chore: Android底层SDK版本升级至 => 1.4.0.PX
+    * chore: iOS底层SDK版本升级至 => 1.3.9.PX
+
+### v1.0.2
+    * fix: 初始化接口中隐藏了preInit
+    * feat: 自定义事件支持传入事件编码
+
+### v1.0.1
+    * feat: 支持初始化接口
+
+### v1.0.0
+    * feat: 基于Android、iOS封装了常见埋点API，利用React Native的native module能力

package/README.md

@@ -56,7 +56,7 @@ allprojects {
 dependencies {
   implementation fileTree(include:['*.jar'], dir:'libs')
 
-  implementation "com.umeng.umsdk:qt-px-common:1.3.9.PX"
+  implementation "com.umeng.umsdk:qt-px-common:1.4.0.PX"
 }
 ```
 
@@ -375,6 +375,24 @@ QT.onPageEnd('MainPage');
 注意：
 onPageStart 和 onPageEnd 必须成对调用。
 
+## 页面属性上传
+给当前页面附加自定义属性
+```typescript
+function uploadPageProperties(pageName: string, params: any): void
+```
+| 参数 | 含义 |
+| --- | --- |
+| pageName | 页面编码 |
+| params | 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对 |
+
+示例：
+```typescript
+QT.uploadPageProperties('detail_page', { test: 1 })
+```
+注意：
+该接口必须在onPageStart和onPageEnd之间调用
+
+
 ## 自定义事件埋点
 自定义事件可以用于追踪用户行为，记录行为发生的具体细节。
 使用 **sendEvent **接口进行事件的统计，接口如下：
@@ -512,9 +530,6 @@ export default function WebPage() {
 }
 ```
 # FAQ
-## 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项目需求。

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.9.PX"
+  implementation "com.umeng.umsdk:qt-px-common:1.4.0.PX"
 }
 
 if (isNewArchitectureEnabled()) {

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

@@ -55,6 +55,27 @@ public class QuicktrackingAnalyticsModuleModule extends ReactContextBaseJavaModu
       QtTrackAgent.onPageEnd(pageName);
     }
 
+    @ReactMethod
+    public void uploadPageProperties(String pageName, ReadableMap property) {
+      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.setPageProperty(context, pageName, map);
+    }
+
     @ReactMethod
     public void onEvent(String eventID) {
       QtTrackAgent.onEvent(context, eventID);

package/ios/QuicktrackingAnalyticsModule.m

@@ -1,6 +1,7 @@
 //#if __has_include(<QTCommon/MobClick.h>)
 #import <QTCommon/MobClick.h>
 #import <QTCommon/UMConfigure.h>
+#import <QTCommon/UMSpm.h>
 
 //#else
 //#import "MobClick.h"
@@ -34,6 +35,18 @@ RCT_EXPORT_METHOD(onPageEnd:(NSString *)pageName)
     [QTMobClick endLogPageView:pageName];
 }
 
+// 上传页面属性
+RCT_EXPORT_METHOD(uploadPageProperties:(NSString *)pageName params:(NSDictionary*)parameters)
+{
+    if (pageName == nil || [pageName isKindOfClass:[NSNull class]]) {
+        return;
+    }
+    if (parameters == nil && [parameters isKindOfClass:[NSNull class]]) {
+        parameters = nil;
+    }
+    [UMSpm updatePageProperties:pageName properties: parameters];
+}
+
 //======================================自定义事件相关===========================================//
 /**
  * @description QtAnalytics.onEventObject(String eventId, Object params)

package/lib/commonjs/index.js

@@ -26,6 +26,15 @@ class QT {
     QuicktrackingAnalyticsModule.onPageEnd(pageName);
   }
 
+  /**
+   * 上传页面属性
+   * @param pageName 页面编码
+   * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+   */
+  static uploadPageProperties(pageName, params) {
+    QuicktrackingAnalyticsModule.uploadPageProperties(pageName, params);
+  }
+
   /**
    * 自定义事件埋点
    * @param eventId 当前统计的事件编码

package/lib/module/index.js

@@ -20,6 +20,15 @@ export class QT {
     QuicktrackingAnalyticsModule.onPageEnd(pageName);
   }
 
+  /**
+   * 上传页面属性
+   * @param pageName 页面编码
+   * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+   */
+  static uploadPageProperties(pageName, params) {
+    QuicktrackingAnalyticsModule.uploadPageProperties(pageName, params);
+  }
+
   /**
    * 自定义事件埋点
    * @param eventId 当前统计的事件编码

package/lib/typescript/index.d.ts

@@ -14,6 +14,12 @@ export declare class QT {
      * @param pageName 页面编码
      */
     static onPageEnd(pageName: string): void;
+    /**
+     * 上传页面属性
+     * @param pageName 页面编码
+     * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+     */
+    static uploadPageProperties(pageName: string, params: EventParams): void;
     /**
      * 自定义事件埋点
      * @param eventId 当前统计的事件编码

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-quicktracking-analytics-module",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "QuickTracking ReactNative SDK",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -28,7 +28,9 @@
     "typescript": "tsc --noEmit",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "prepare": "bob build",
-    "release": "release-it"
+    "release": "release-it",
+    "example": "yarn --cwd example",
+    "bootstrap": "yarn example && yarn && yarn example pods"
   },
   "keywords": [
     "quicktracking",

package/react-native-quicktracking-analytics-module.podspec

@@ -17,8 +17,8 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm}"
 
   s.dependency "React-Core"
-  s.dependency "QTCommon", "~> 1.3.8.PX"
-  
+  s.dependency "QTCommon", "~> 1.3.9.PX"
+
   # Don't install the dependencies when we run `pod install` in the old architecture.
   if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
     s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
@@ -32,6 +32,6 @@ Pod::Spec.new do |s|
     s.dependency "RCTRequired"
     s.dependency "RCTTypeSafety"
     s.dependency "ReactCommon/turbomodule/core"
-    
+
   end
 end

package/src/index.tsx

@@ -24,6 +24,15 @@ export class QT {
     QuicktrackingAnalyticsModule.onPageEnd(pageName);
   }
 
+  /**
+   * 上传页面属性
+   * @param pageName 页面编码
+   * @param params 对当前事件的参数描述，定义为“参数名:参数值”的“<键-值>”对
+   */
+  static uploadPageProperties(pageName: string, params: EventParams) {
+    QuicktrackingAnalyticsModule.uploadPageProperties(pageName, params);
+  }
+
   /**
    * 自定义事件埋点
    * @param eventId 当前统计的事件编码