uni-app 统计去重:App 端设备标识怎么取
130 浏览2026年10月23日作者:User7699303358720606218

【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 设备唯一标识」。

最后一次编辑于 2026 年 10 月 23 日
共 0 条评论

相关文章

专题推荐

热门文章

热门问答