【uni-app 统计去重:App 端设备标识怎么取】
做活动曝光、安装量、首次打开这类统计时,小程序端通常按登录用户 ID(或宿主侧用户标识)去重就够了。同一套 uni-app 代码出 Android App 后,产品常会多问一句:没登录的用户,能不能按「设备」去重,避免同一台手机被记成很多次新用户。
小程序里没有稳定的开发者可读设备标识,这是宿主限制,不必硬找替代。App 端可以在用户同意隐私政策之后,读取设备标识,并把来源一起上报,让统计服务按来源决定权重。
【两端怎么分工】
抖音小程序:去重键用用户 ID,clientKey 传空串。
Android App:去重键用设备标识加 source;隐私同意后再读;无同意则只报用户 ID。
【条件编译封装】
—— 代码 ——
// utils/stat-id.js
export function getStatIdentity () {
return new Promise((resolve) => {
// #ifdef MP-TOUTIAO
resolve({ platform: 'mp-toutiao', clientKey: '', source: 'none' })
// #endif
// #ifdef APP-ANDROID || APP-PLUS
readAppDeviceId().then(resolve)
// #endif
})
}
—— 代码结束 ——
—— 代码 ——
// #ifdef APP-ANDROID || APP-PLUS
import * as DeviceId from '@/uni_modules/aiko-device-id'
function readAppDeviceId () {
return new Promise((resolve) => {
if (!uni.getStorageSync('privacyAgreed')) {
resolve({ platform: 'app-android', clientKey: '', source: 'none' })
return
}
DeviceId.initSdk({
success () {
const uid = DeviceId.getDeviceUniqueId()
DeviceId.getOAID({
success (res) {
const data = res['data']
resolve({ platform: 'app-android', clientKey: uid, source: 'oaid', hint: data })
},
fail (err) {
resolve({
platform: 'app-android',
clientKey: uid,
source: err['code'] === 9026003 ? 'fallback' : 'error',
code: err['code']
})
}
})
},
fail (err) {
resolve({ platform: 'app-android', clientKey: '', source: 'error', code: err['code'] })
}
})
})
}
// #endif
—— 代码结束 ——
getDeviceUniqueId() 内部顺序:OAID → ANDROID_ID → 插件持久化 UUID。9026003(OAID 不可用)时不要重试,直接用聚合结果。同步 getDeviceId() 可单独拿 ANDROID_ID。需要看能力与回退来源时用 getIdentifierDiagnostics。
APP-PLUS 会编进 iOS。插件目前只支持 Android,其它平台返回 9026001;统计上把这些端当成「无设备键」即可。
【上报时带 source】
—— 代码 ——
export async function trackFirstOpen (userId) {
const id = await getStatIdentity()
uni.request({
url: '/api/stat/first-open',
method: 'POST',
data: {
userId: userId || null,
platform: id.platform,
clientKey: id.clientKey,
source: id.source,
code: id.code || null
}
})
}
—— 代码结束 ——
服务端建议:
source 为 none 或 clientKey 为空时,只按用户 ID(或匿名会话)去重。
oaid / android_id / fallback 可参与设备去重;uuid 回退卸载重装会变,权重放低或仅作弱去重。
不要把「设备去重」写成识别他人;用途写在隐私政策里,且必须在同意之后采集。
【错误码速查】
9026001 平台不支持 → 当无设备键
9026002 原生上下文不可用 → 记日志,当无设备键
9026003 OAID 不可用 → 用聚合 ID,source=fallback
9026004 SDK 未初始化(保留) → 先 initSdk
9026006 系统错误 → 记日志,降级
【插件信息】
以上 Android 代码对应 Aiko 设备唯一标识(aiko-device-id,市场 ID 29573,作者 Awak3n1ng,版本 1.0.0,约 952.8KB,普通授权 9.9 元)。介绍页:https://ext.dcloud.net.cn/plugin?id=29573
兼容表只勾 Android;文档未写起始版本,以真机试用为准。隐私要点:不读 IMEI、电话、MAC;不上传第三方;本地计算;无敏感电话权限。
详情页:
https://ext.dcloud.net.cn/plugin?id=29573
也可在 DCloud 插件市场搜「Aiko 设备唯一标识」。
