@uxda/appkit 4.2.93 → 4.2.94

package/src/shared/tracking/useAutoTracking.ts

@@ -0,0 +1,108 @@
+/**
+ * 自动埋点组合式函数 - 精简版
+ */
+
+import { onUnmounted, ref } from 'vue'
+import { useDidShow } from '@tarojs/taro'
+import { trackingSDK, TrackingEventType } from './tracking-sdk'
+
+// 自动埋点配置
+interface AutoTrackingConfig {
+  trackPageView?: boolean // 是否自动跟踪页面访问
+  trackClicks?: boolean // 是否自动跟踪点击事件
+  trackStay?: boolean // 是否自动跟踪停留时间
+  pageTitle?: string // 页面标题
+  customData?: Record<string, unknown> // 自定义数据
+}
+
+/**
+ * 自动埋点组合式函数
+ * @param config 自动埋点配置
+ */
+export function useAutoTracking(config: AutoTrackingConfig = {}) {
+  const { trackPageView = true, trackClicks = true, pageTitle, customData = {} } = config
+
+  const pageStartTime = ref<number>(0)
+  const isPageVisible = ref<boolean>(true)
+
+  /**
+   * 处理页面显示
+   */
+  const handlePageShow = () => {
+    isPageVisible.value = true
+    pageStartTime.value = Date.now()
+
+    if (trackPageView) {
+      trackingSDK.trackPageView(pageTitle)
+    }
+  }
+
+  /**
+   * 处理页面隐藏
+   */
+  const handlePageHide = () => {
+    isPageVisible.value = false
+  }
+
+  /**
+   * 处理点击事件
+   */
+  const handleClick = (event: any) => {
+    if (!trackClicks || !isPageVisible.value) return
+
+    const target = event.target || event.currentTarget
+    const elementId = target?.id
+    const elementClass = target?.className
+    const elementText = target?.textContent || target?.innerText
+
+    trackingSDK.trackClick(elementId || elementClass, elementText)
+  }
+
+  /**
+   * 手动埋点方法
+   */
+  const trackEvent = (eventName: string, data?: Record<string, unknown>) => {
+    trackingSDK.trackCustom(eventName, { ...customData, ...data })
+  }
+
+  /**
+   * 埋点业务事件
+   */
+  const trackBusinessEvent = (event: TrackingEventType, businessData?: Record<string, unknown>) => {
+    trackingSDK.trackBusiness(event, businessData)
+  }
+
+  // 组件挂载时设置自动埋点
+  useDidShow(() => {
+    handlePageShow()
+  })
+
+  // 组件卸载时记录停留时间
+  onUnmounted(() => {
+    handlePageHide()
+  })
+
+  return {
+    // 状态
+    isPageVisible,
+    pageStartTime,
+
+    // 事件处理函数
+    handleClick,
+
+    // 手动埋点方法
+    trackEvent,
+    trackBusinessEvent,
+
+    // 页面生命周期
+    handlePageShow,
+    handlePageHide,
+  }
+}
+
+/**
+ * 页面级自动埋点组合式函数
+ */
+export function usePageTracking(config: AutoTrackingConfig = {}) {
+  return useAutoTracking(config)
+}