@uxda/appkit 4.2.93 → 4.2.95

package/src/shared/tracking/tracking-init.ts

@@ -0,0 +1,214 @@
+/**
+ * 埋点初始化 - 精简版
+ */
+
+import { App } from 'vue'
+import { onAppShow, onAppHide, onNetworkStatusChange } from '@tarojs/taro'
+import { trackingSDK, TrackingUserInfo } from './tracking-sdk'
+import { installTrackingDirectives } from './directives'
+
+// 导出用户信息接口，供外部使用
+export type { TrackingUserInfo }
+
+// 埋点初始化配置
+interface TrackingInitConfig {
+  enabled?: boolean
+  debug?: boolean
+  apiEndpoint?: string
+  batchSize?: number
+  flushInterval?: number
+  userInfo?: TrackingUserInfo // 用户信息
+}
+
+/**
+ * 初始化埋点系统
+ */
+export async function initTracking(config: TrackingInitConfig = {}): Promise<void> {
+  try {
+    console.log('[TrackingInit] 开始初始化埋点系统...')
+
+    // 1. 更新SDK配置
+    const sdkConfig = {
+      enabled: config.enabled,
+      debug: config.debug,
+      apiEndpoint: config.apiEndpoint,
+      batchSize: config.batchSize,
+      flushInterval: config.flushInterval,
+      userInfo: config.userInfo, // 传递用户信息
+    }
+
+    trackingSDK.updateConfig(sdkConfig)
+
+    // 2. 设置全局错误处理
+    setupGlobalErrorHandling()
+
+    // 3. 设置页面生命周期监听
+    setupPageLifecycleTracking()
+
+    // 4. 设置全局属性
+    setupGlobalProperties()
+
+    // 5. 设置页面历史记录
+    trackingSDK.clearPageHistory()
+
+    console.log('[TrackingInit] 埋点系统初始化完成')
+
+    // 发送初始化完成埋点
+    await trackingSDK.trackCustom('tracking_init_complete', {
+      logTime: Date.now(),
+    })
+  } catch (error) {
+    console.error('[TrackingInit] 埋点系统初始化失败:', error)
+  }
+}
+
+/**
+ * 设置全局错误处理
+ */
+function setupGlobalErrorHandling(): void {
+  // 监听未捕获的错误
+  window.addEventListener('error', () => {
+    // trackingSDK.trackCustom('global_error', {
+    //   message: event.message,
+    //   filename: event.filename,
+    //   lineno: event.lineno,
+    //   colno: event.colno,
+    //   error: event.error?.stack,
+    //   logTime: Date.now(),
+    // })
+  })
+
+  // 监听未处理的Promise拒绝
+  window.addEventListener('unhandledrejection', (event) => {
+    // trackingSDK
+    //   .trackCustom('unhandled_promise_rejection', {
+    //     reason: event.reason?.toString(),
+    //     promise: event.promise,
+    //     logTime: Date.now(),
+    //   })
+    //   .catch(console.error)
+  })
+}
+
+/**
+ * 设置页面生命周期监听
+ */
+function setupPageLifecycleTracking(): void {
+  // 监听应用显示
+  onAppShow(() => {
+    trackingSDK
+      .trackCustom('app_show', {
+        logTime: Date.now(),
+      })
+      .catch(console.error)
+  })
+
+  // 监听应用隐藏
+  onAppHide(() => {
+    trackingSDK
+      .trackCustom('app_hide', {
+        logTime: Date.now(),
+      })
+      .catch(console.error)
+  })
+
+  // 监听网络状态变化
+  onNetworkStatusChange((res) => {
+    trackingSDK
+      .trackCustom('network_status_change', {
+        isConnected: res.isConnected,
+        networkType: res.networkType,
+        logTime: Date.now(),
+      })
+      .catch(console.error)
+  })
+}
+
+/**
+ * 设置全局属性
+ */
+function setupGlobalProperties(): void {
+  // 设置全局埋点SDK引用
+  if (typeof window !== 'undefined') {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ;(window as any).__trackingSDK = trackingSDK
+  }
+
+  // 设置全局埋点方法
+  if (typeof globalThis !== 'undefined') {
+    globalThis.track = trackingSDK.trackCustom.bind(trackingSDK)
+    globalThis.trackPage = trackingSDK.trackPageView.bind(trackingSDK)
+    globalThis.trackClick = trackingSDK.trackClick.bind(trackingSDK)
+  }
+}
+
+/**
+ * Vue应用插件安装
+ */
+export function installTrackingPlugin(app: App): void {
+  // 安装埋点指令
+  installTrackingDirectives(app)
+
+  // 添加全局属性
+  app.config.globalProperties.$track = async (event: string, data?: Record<string, unknown>) => {
+    await trackingSDK.trackCustom(event, data)
+  }
+
+  app.config.globalProperties.$trackPage = async (
+    pageTitle?: string,
+    customData?: Record<string, unknown>
+  ) => {
+    await trackingSDK.trackPageView(pageTitle)
+    if (customData) {
+      await trackingSDK.trackCustom('page_custom', customData)
+    }
+  }
+
+  app.config.globalProperties.$trackClick = async (elementId?: string, elementText?: string) => {
+    await trackingSDK.trackClick(elementId, elementText)
+  }
+
+  // 添加全局错误处理
+  // app.config.errorHandler = (err: any, _instance: any, info: string) => {
+  //   trackingSDK.trackCustom('vue_error', {
+  //     error: err?.message || 'Unknown error',
+  //     stack: err?.stack,
+  //     componentInfo: info,
+  //     logTime: Date.now(),
+  //   })
+  // }
+
+  console.log('[TrackingInit] Vue埋点插件安装完成')
+}
+
+/**
+ * 销毁埋点系统
+ */
+export function destroyTracking(): void {
+  try {
+    // 销毁SDK
+    trackingSDK.destroy()
+
+    // 清理全局属性
+    if (typeof window !== 'undefined') {
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      delete (window as any).__trackingSDK
+    }
+
+    if (typeof globalThis !== 'undefined') {
+      delete globalThis.track
+      delete globalThis.trackPage
+      delete globalThis.trackClick
+    }
+
+    console.log('[TrackingInit] 埋点系统已销毁')
+  } catch (error) {
+    console.error('[TrackingInit] 埋点系统销毁失败:', error)
+  }
+}
+
+export default {
+  init: initTracking,
+  install: installTrackingPlugin,
+  destroy: destroyTracking,
+}