更新记录

1.0.0（2026-08-10）

首次发布：腾讯 DataNexus（广点通 GDT 转化）数据上报 UTS 插件，支持微信小程序 / Android / iOS。

功能

• init / isReady / setUserId / track / trackPay / syncCache / clearCache / destroy 等 API。
• 一套 API 适配三端，基于 SDK 真实回执判定上报成败，失败自动写入离线缓存（7 天过期、500 条上限），联网后自动补发，不重复上报。
• 微信端自动提取启动链接 click_id 实现广告归因，并持久化、onShow 场景切换自动更新。
• iOS 端强制适配 ATT 授权：未授权禁止上报并自动入缓存，授权后自动补发；iOS < 14 无需授权可直接上报。
• autoTrack 自动采集：拦截页面导航自动上报 view 事件，回到前台自动补报当前页面。
• 未初始化 / 端不支持 / 上报失败等场景输出 DnError 错误码日志，便于排查。

合规

• 仅封装腾讯官方 SDK，不采集手机号、身份证等敏感隐私；
• 仅做客户端行为上报，不做数据中转；
• 不新增 Android 敏感权限；iOS 需声明 NSUserTrackingUsageDescription。

平台兼容性

uni-app(3.8.1)

uni-app x(3.8.1)

# qtencent-datanexus 腾讯 DataNexus 转化数据上报

腾讯 DataNexus（广点通 GDT 转化）数据上报 UTS 插件。一套 API 适配 微信小程序、Android、iOS 三端。

• 自动提取微信广告归因 click_id
• 离线断网缓存补发，防数据丢失
• 内置支付、预约、核销等快捷上报
• 轻量化、无打包冲突、无新增敏感权限
• 支持 uni-app 与 uni-app x

快速接入

1. 安装

将 qtencent-datanexus 目录复制到项目 uni_modules/ 下：

你的项目/uni_modules/qtencent-datanexus/

2. 各端补齐官方 SDK

3. 初始化与上报

import { init, setUserId, trackPay, track, syncCache, DnEvent } from '@/uni_modules/qtencent-datanexus'

init({
    userActionSetId: "你的数据源ID",
    secretKey: "密钥",
    appId: "wxxxxxxx",
    autoTrack: true, // 可选：自动采集页面浏览
    debug: false
})

setUserId("openid_xxxx")

trackPay({
    orderNo: "ORD20260810001",
    totalFee: 88800, // 单位：分
    goodsName: "民宿包月套餐"
})

track(DnEvent.VIEW, { page: "detail", goodsName: "民宿包月套餐" })

await syncCache() // 联网后补发离线缓存

对外 API

预设事件枚举 DnEvent：VIEW(view) / BOOK(book) / PAY(pay) / VERIFY(verify) / REFUND(refund)。

缓存机制

• 上报失败自动写入本地持久化缓存，联网后自动补发；
• 缓存 7 天 过期清理，上限 500 条，防存储溢出；
• 补发成功自动删除对应条目，不重复上报；
• syncCache() 内置并发锁，避免重复补发。

合规说明

• 仅封装腾讯官方 SDK，不采集手机号、身份证等敏感隐私；
• 仅做客户端行为上报，不做数据中转；
• 所有用户数据上报前提为业务层已获取用户隐私授权。

详细文档

见插件内 docs/use.md。