@rk911/tracker-sdk 1.6.4

package/plugins/page-view.js

@@ -0,0 +1,172 @@
+export class PageViewPlugin {
+  constructor() {
+    this.name = 'page-view'
+    this.tracker = null
+    this._lastPage = ''
+    this._pendingTimer = null
+    this._lastFiredRoute = ''
+    this._lastFiredTime = 0
+  }
+
+  install(tracker) {
+    this.tracker = tracker
+    var adapter = tracker.getAdapter()
+    var platform = adapter.getPlatformName()
+    var self = this
+
+    if (platform === 'web' || platform === 'app') {
+      adapter.onRouteChange(function () {
+        // 取消上一次未完成的检测（防止 pushState+hashchange 双触发）
+        if (self._pendingTimer) {
+          clearTimeout(self._pendingTimer)
+          self._pendingTimer = null
+        }
+        self._waitForNewRoute(function () {
+          self._reportPageView()
+        })
+      })
+      // 首次 PV
+      self._waitForRoute(function () {
+        self._reportPageView()
+      })
+
+      // 会话过期重建时补报当前页 page_view（保证每个 session 都有入口页）
+      tracker.getSession().onRenew(function () {
+        var currentPage = adapter.getCurrentPagePath()
+        if (currentPage && currentPage !== '/') {
+          self._lastPage = ''
+          self._reportPageView()
+        }
+      })
+    }
+  }
+
+  // 首次加载：等路径有效即可
+  _waitForRoute(callback) {
+    var adapter = this.tracker.getAdapter()
+    var attempts = 0
+    var maxAttempts = 10
+
+    function check() {
+      var path = adapter.getCurrentPagePath()
+      if (path && path !== '/') {
+        callback()
+      } else if (attempts < maxAttempts) {
+        attempts++
+        setTimeout(check, 20)
+      } else {
+        callback()
+      }
+    }
+    check()
+  }
+
+  // 后续导航：等路径真正变化后再上报 page_view
+  _waitForNewRoute(callback) {
+    var adapter = this.tracker.getAdapter()
+    var self = this
+    var attempts = 0
+    var maxAttempts = 25
+
+    function check() {
+      var path = adapter.getCurrentPagePath()
+      if (path && path !== '/' && path !== self._lastPage) {
+        self._pendingTimer = null
+        callback()
+      } else if (attempts < maxAttempts) {
+        attempts++
+        self._pendingTimer = setTimeout(check, 20)
+      } else {
+        self._pendingTimer = null
+      }
+    }
+    check()
+  }
+
+  _reportPageView() {
+    var adapter = this.tracker.getAdapter()
+    var currentPage = adapter.getCurrentPagePath()
+
+    // 去重：同一个页面不重复上报
+    if (currentPage === this._lastPage) return
+
+    // 防抖：同路由 500ms 内不重复上报（防框架路由重入导致的竞态）
+    var now = Date.now()
+    if (this._lastFiredRoute === currentPage && now - this._lastFiredTime < 500) return
+
+    this._lastPage = currentPage
+    this._lastFiredRoute = currentPage
+    this._lastFiredTime = now
+    this.tracker.updatePageRoute(currentPage)
+
+    var self = this
+    // 代次令牌：每次进入生成新代次，旧的 title 重试链检测到代次变化即中止
+    // 防止导航交叠时，未完成的重试链把过期路由的 page_view 发出去
+    var myGen = (this._pvGen = (this._pvGen || 0) + 1)
+    var titleAttempts = 0
+    var prevTitle = ''
+    function reportWithTitle() {
+      if (myGen !== self._pvGen) return
+      var title = typeof document !== 'undefined' ? document.title : ''
+      // 第一轮：无论 title 有无值，都等一个 tick 让框架有机会更新
+      if (titleAttempts === 0) {
+        prevTitle = title
+        titleAttempts++
+        setTimeout(reportWithTitle, 50)
+        return
+      }
+      // title 为空：继续等
+      if (!title && titleAttempts < 10) {
+        titleAttempts++
+        setTimeout(reportWithTitle, 50)
+        return
+      }
+      // title 在两次检查间发生变化：说明框架刚更新了，再等一轮确认稳定
+      if (title !== prevTitle && titleAttempts < 10) {
+        prevTitle = title
+        titleAttempts++
+        setTimeout(reportWithTitle, 50)
+        return
+      }
+      // 兜底：如果 title 在所有重试后仍未变化（框架未更新 document.title），
+      // 尝试从 uni-app 页面栈读取 navigationBarTitle
+      if (titleAttempts >= 10 && title === prevTitle) {
+        try {
+          var pages = getCurrentPages()
+          var cur = pages[pages.length - 1]
+          var stackTitle = (cur && cur.$page && cur.$page.meta && cur.$page.meta.navigationBar
+            ? cur.$page.meta.navigationBar.titleText : '') || ''
+          if (stackTitle) title = stackTitle
+        } catch (e) {}
+      }
+      self._lastTitle = title
+      self.tracker.track('page_view', {
+        pageRoute: currentPage,
+        page: currentPage,
+        pageTitle: title,
+      })
+    }
+    reportWithTitle()
+  }
+
+  // 供 mixin 调用（小程序端）
+  trackPageShow() {
+    var adapter = this.tracker.getAdapter()
+    var currentPage = adapter.getCurrentPagePath()
+    this._lastPage = currentPage
+    this.tracker.updatePageRoute(currentPage)
+
+    this.tracker.track('page_view', {
+      pageRoute: currentPage,
+      page: currentPage,
+    })
+  }
+
+  destroy() {
+    if (this._pendingTimer) {
+      clearTimeout(this._pendingTimer)
+      this._pendingTimer = null
+    }
+    this.tracker = null
+  }
+}

package/plugins/performance.js

@@ -0,0 +1,157 @@
+/**
+ * 页面性能监控插件
+ *
+ * 采集指标：
+ *   dns       — DNS 解析耗时
+ *   tcp       — TCP 连接耗时
+ *   ttfb      — 首字节时间（Time To First Byte）
+ *   domReady  — DOM 加载完成时间
+ *   load      — 页面完全加载时间
+ *   fcp       — 首次内容绘制（First Contentful Paint）
+ *   lcp       — 最大内容绘制（Largest Contentful Paint）
+ *
+ * 兼容策略：
+ *   优先使用 PerformanceObserver（现代浏览器）
+ *   降级使用 performance.timing（旧浏览器，已弃用但兼容性好）
+ *
+ * 移植自 smart-tracker 的 _initPerformanceMonitor，并增加了现代 API 支持
+ */
+export class PerformancePlugin {
+  constructor() {
+    this.name = 'performance'
+    this.tracker = null
+    this._reported = false
+  }
+
+  install(tracker) {
+    this.tracker = tracker
+    var adapter = tracker.getAdapter()
+
+    // 仅 Web 和 APP(WebView) 环境支持
+    if (adapter.getPlatformName() === 'weapp') return
+    if (typeof window === 'undefined' || typeof performance === 'undefined') return
+
+    this._collectMetrics()
+  }
+
+  _collectMetrics() {
+    var self = this
+
+    // 等待页面加载完成后采集
+    if (document.readyState === 'complete') {
+      setTimeout(function () {
+        self._report()
+      }, 0)
+    } else {
+      window.addEventListener('load', function () {
+        // 延迟一点确保 timing 数据完整
+        setTimeout(function () {
+          self._report()
+        }, 100)
+      })
+    }
+
+    // 使用 PerformanceObserver 采集 FCP 和 LCP
+    this._observePaintMetrics()
+  }
+
+  _report() {
+    if (this._reported) return
+    this._reported = true
+
+    var data = {}
+
+    // 优先用 Navigation Timing Level 2
+    if (performance.getEntriesByType) {
+      var navEntries = performance.getEntriesByType('navigation')
+      if (navEntries && navEntries.length > 0) {
+        var nav = navEntries[0]
+        data.dns = Math.round(nav.domainLookupEnd - nav.domainLookupStart)
+        data.tcp = Math.round(nav.connectEnd - nav.connectStart)
+        data.ttfb = Math.round(nav.responseStart - nav.requestStart)
+        data.domReady = Math.round(nav.domContentLoadedEventEnd - nav.startTime)
+        data.load = Math.round(nav.loadEventEnd - nav.startTime)
+        data.redirect = Math.round(nav.redirectEnd - nav.redirectStart)
+        data.domParse = Math.round(nav.domInteractive - nav.responseEnd)
+      }
+    }
+
+    // 降级到 performance.timing（旧浏览器）
+    if (!data.dns && performance.timing) {
+      var timing = performance.timing
+      data.dns = timing.domainLookupEnd - timing.domainLookupStart
+      data.tcp = timing.connectEnd - timing.connectStart
+      data.ttfb = timing.responseStart - timing.requestStart
+      data.domReady = timing.domContentLoadedEventEnd - timing.navigationStart
+      data.load = timing.loadEventEnd - timing.navigationStart
+      data.redirect = timing.redirectEnd - timing.redirectStart
+      data.domParse = timing.domInteractive - timing.responseEnd
+    }
+
+    // FCP（如果 PerformanceObserver 已采集到）
+    if (this._fcp) data.fcp = this._fcp
+    if (this._lcp) data.lcp = this._lcp
+
+    // 过滤无效值（0 或负数）
+    for (var key in data) {
+      if (data[key] <= 0) delete data[key]
+    }
+
+    if (Object.keys(data).length > 0) {
+      this.tracker.track('performance', data)
+    }
+  }
+
+  _observePaintMetrics() {
+    if (typeof PerformanceObserver === 'undefined') return
+
+    var self = this
+
+    // FCP
+    try {
+      var fcpObserver = new PerformanceObserver(function (list) {
+        var entries = list.getEntries()
+        for (var i = 0; i < entries.length; i++) {
+          if (entries[i].name === 'first-contentful-paint') {
+            self._fcp = Math.round(entries[i].startTime)
+            fcpObserver.disconnect()
+            break
+          }
+        }
+      })
+      fcpObserver.observe({ type: 'paint', buffered: true })
+    } catch (e) {}
+
+    // LCP
+    try {
+      var lcpObserver = new PerformanceObserver(function (list) {
+        var entries = list.getEntries()
+        if (entries.length > 0) {
+          self._lcp = Math.round(entries[entries.length - 1].startTime)
+        }
+      })
+      lcpObserver.observe({ type: 'largest-contentful-paint', buffered: true })
+
+      // LCP 在用户交互后不再更新，页面可见性变化时停止观察
+      if (typeof document !== 'undefined') {
+        document.addEventListener(
+          'visibilitychange',
+          function () {
+            if (document.visibilityState === 'hidden') {
+              lcpObserver.disconnect()
+              // 如果此时已有 LCP 数据但还没上报过主性能数据
+              if (self._lcp && !self._reported) {
+                self._report()
+              }
+            }
+          },
+          { once: true }
+        )
+      }
+    } catch (e) {}
+  }
+
+  destroy() {
+    this.tracker = null
+  }
+}

package/plugins/scroll-depth.js

@@ -0,0 +1,256 @@
+/**
+ * 页面滚动深度插件
+ *
+ * scrollDepth 字段上报实际滚动距离（像素值）
+ * 每滚动一屏距离上报一次 scroll_depth 事件
+ */
+export class ScrollDepthPlugin {
+  constructor() {
+    this.name = 'scroll-depth'
+    this.tracker = null
+    this._maxScrollTop = 0
+    this._lastReportedDistance = 0
+    this._config = null
+    this._cachedContainers = null
+    this._rafId = null
+    this._debounceTimer = null
+    this._touchEndHandler = null
+    this._touchMoveHandler = null
+    this._wheelHandler = null
+    this._unloadHandler = null
+    this._hideHandler = null
+    this._isScrolling = false
+    this._screenHeight = 0
+    this._trackingPage = null
+  }
+
+  install(tracker) {
+    this.tracker = tracker
+    var adapter = tracker.getAdapter()
+
+    if (!adapter.supportsDOM()) return
+    if (typeof window === 'undefined') return
+
+    this._screenHeight = window.innerHeight || 800
+
+    var trackerConfig = tracker.getConfig()
+    this._config = {
+      throttle: 2000,
+      ...(trackerConfig.scrollDepth || {}),
+    }
+
+    this._trackingPage = tracker._currentPage || (adapter.getCurrentPagePath ? adapter.getCurrentPagePath() : null)
+
+    this._initTracking()
+    this._setupFinalOnHide()
+
+    this._unloadHandler = function () {
+      if (tracker._destroyed) return
+    }
+    window.addEventListener('beforeunload', this._unloadHandler)
+
+    var self = this
+    adapter.onRouteChange(function () {
+      if (self._maxScrollTop > 0) {
+        self._reportDepth(self._maxScrollTop, true, self._trackingPage)
+      }
+      self._maxScrollTop = 0
+      self._lastReportedDistance = 0
+      self._cachedContainers = null
+      if (self.tracker) {
+        self.tracker._currentScrollDepth = null
+      }
+      self._trackingPage = self.tracker ? self.tracker._currentPage : null
+    })
+  }
+
+  getMaxDepth() {
+    return this._maxScrollTop
+  }
+
+  _setupFinalOnHide() {
+    if (typeof document === 'undefined') return
+    var self = this
+    this._hideHandler = function () {
+      if (document.visibilityState === 'hidden') {
+        if (self._maxScrollTop > self._lastReportedDistance) {
+          self._reportDepth(self._maxScrollTop, true)
+        }
+      }
+    }
+    document.addEventListener('visibilitychange', this._hideHandler)
+  }
+
+  _initTracking() {
+    var self = this
+
+    this._touchEndHandler = function () {
+      self._scheduleCheck()
+    }
+
+    this._touchMoveHandler = function () {
+      // 立即更新 _currentScrollDepth（不触发上报），确保其他事件能实时拿到值
+      self._quickUpdate()
+      if (self._isScrolling) return
+      self._isScrolling = true
+      clearTimeout(self._debounceTimer)
+      self._debounceTimer = setTimeout(function () {
+        self._isScrolling = false
+        self._doCheck()
+      }, self._config.throttle)
+    }
+
+    this._wheelHandler = function () {
+      self._quickUpdate()
+      self._scheduleCheck()
+    }
+
+    document.addEventListener('touchend', this._touchEndHandler, { capture: true, passive: true })
+    document.addEventListener('touchmove', this._touchMoveHandler, { capture: true, passive: true })
+    document.addEventListener('wheel', this._wheelHandler, { capture: true, passive: true })
+  }
+
+  _scheduleCheck() {
+    var self = this
+    clearTimeout(this._debounceTimer)
+    this._debounceTimer = setTimeout(function () {
+      self._isScrolling = false
+      if (self._rafId) return
+      self._rafId = requestAnimationFrame(function () {
+        self._rafId = null
+        self._doCheck()
+      })
+    }, 300)
+  }
+
+  _quickUpdate() {
+    var containers = this._getContainers()
+    var maxSt = 0
+    for (var i = 0; i < containers.length; i++) {
+      var c = containers[i]
+      var st = 0
+      if (c.type === 'window') {
+        st = window.pageYOffset || document.documentElement.scrollTop || 0
+      } else {
+        st = c.el.scrollTop || 0
+      }
+      if (st > maxSt) maxSt = st
+    }
+    if (maxSt > this._maxScrollTop) {
+      this._maxScrollTop = maxSt
+      if (this.tracker) {
+        this.tracker._currentScrollDepth = maxSt
+      }
+    }
+  }
+
+  _doCheck() {
+    var containers = this._getContainers()
+    var maxSt = 0
+
+    for (var i = 0; i < containers.length; i++) {
+      var c = containers[i]
+      var st = 0
+      if (c.type === 'window') {
+        st = window.pageYOffset || document.documentElement.scrollTop || 0
+      } else {
+        st = c.el.scrollTop || 0
+      }
+      if (st > maxSt) maxSt = st
+    }
+
+    if (maxSt <= 0) return
+
+    if (maxSt > this._maxScrollTop) {
+      this._maxScrollTop = maxSt
+      if (this.tracker) {
+        this.tracker._currentScrollDepth = maxSt
+      }
+      // 每滚动一屏上报一次
+      var nextMilestone = this._lastReportedDistance + this._screenHeight
+      if (maxSt >= nextMilestone) {
+        this._reportDepth(maxSt, false)
+      }
+    }
+  }
+
+  _getContainers() {
+    if (this._cachedContainers) return this._cachedContainers
+
+    var containers = [{ type: 'window' }]
+
+    var scrollViews = document.querySelectorAll('uni-scroll-view')
+    for (var i = 0; i < scrollViews.length; i++) {
+      var found = this._findScrollEl(scrollViews[i])
+      if (found) {
+        containers.push({ type: 'element', el: found })
+      }
+    }
+
+    var overflowEls = document.querySelectorAll('.uni-scroll-view')
+    for (var i = 0; i < overflowEls.length; i++) {
+      var el = overflowEls[i]
+      if (el.scrollHeight > el.clientHeight && el.clientHeight >= 200) {
+        containers.push({ type: 'element', el: el })
+      }
+    }
+
+    if (containers.length > 1) {
+      this._cachedContainers = containers
+    }
+
+    return containers
+  }
+
+  _findScrollEl(el) {
+    if (this._isScrollContainer(el)) return el
+    var children = el.children
+    for (var i = 0; i < children.length; i++) {
+      if (this._isScrollContainer(children[i])) return children[i]
+      var grandchildren = children[i].children
+      for (var j = 0; j < grandchildren.length; j++) {
+        if (this._isScrollContainer(grandchildren[j])) return grandchildren[j]
+        var great = grandchildren[j].children
+        for (var k = 0; k < great.length; k++) {
+          if (this._isScrollContainer(great[k])) return great[k]
+        }
+      }
+    }
+    return null
+  }
+
+  _isScrollContainer(el) {
+    return el && el.clientHeight >= 200 && el.scrollHeight > el.clientHeight + 10
+  }
+
+  _reportDepth(distance, isFinal, pageRoute) {
+    this._lastReportedDistance = distance
+
+    var data = {
+      scrollDepth: distance,
+      extraData: {
+        isFinal: isFinal,
+      },
+    }
+    if (pageRoute) {
+      data.pageRoute = pageRoute
+    }
+    this.tracker.track('scroll_depth', data)
+  }
+
+  destroy() {
+    if (typeof document !== 'undefined') {
+      if (this._touchEndHandler) document.removeEventListener('touchend', this._touchEndHandler, { capture: true })
+      if (this._touchMoveHandler) document.removeEventListener('touchmove', this._touchMoveHandler, { capture: true })
+      if (this._wheelHandler) document.removeEventListener('wheel', this._wheelHandler, { capture: true })
+      if (this._hideHandler) document.removeEventListener('visibilitychange', this._hideHandler)
+    }
+    if (typeof window !== 'undefined' && this._unloadHandler) {
+      window.removeEventListener('beforeunload', this._unloadHandler)
+    }
+    if (this._rafId) cancelAnimationFrame(this._rafId)
+    if (this._debounceTimer) clearTimeout(this._debounceTimer)
+    this._cachedContainers = null
+    this.tracker = null
+  }
+}