更新记录

1.0.1（2026-04-16）

  • 记录广告收入信息
  • 获取归因信息
  • 发送回传信息
  • 发送事件信息
  • 收起会话延迟
  • 深度链接
  • 发送安装应用获取
  • 设置隐私功能
  • 收入验证
  • 配置回传参数
  • 发送订阅信息

1.0.0（2026-04-16）

  1. Adjust归因

平台兼容性

uni-app(3.7.6)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ - √ √ √ 6.0 √ -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
- - - - - - - - - - - -

uni-app x(3.7.7)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - 6.0 √ - -

其他

多语言 暗黑模式 宽屏模式
√ √ √

ADJUST移动归因

功能

  • 记录广告收入信息
  • 获取归因信息
  • 发送回传信息
  • 发送事件信息
  • 收起会话延迟
  • 深度链接
  • 发送安装应用获取
  • 设置隐私功能
  • 收入验证
  • 配置回传参数
  • 发送订阅信息
  • .....

集成步骤

  1. 拷贝demo里的AndroidManifest.xml文件到项目根目录
  2. 点击右上角"试用"按钮绑定项目appId，然后导入插件到项目，然后删除本地基座和手机上现有的app，重新自定义基座运行
  3. 如需定制或增加功能请点击插件标题下方的"进入交流群"私聊作者

接口


import {UTSAdjust} from "@/uni_modules/wrs-uts-adjust"

配置模块

  • 设置回调

// 设置回调
UTSAdjust.onCallback((resp) => {
    let opt = resp.opt
    switch (opt) {
        case "onAttributionChanged":

            break;
            // 发送回传信息，会话回传，success回传
        case "onSessionTrackingSucceeded":

            break;
            // 发送回传信息，会话回传，failure回传
        case "onSessionTrackingFailed":

            break;
            // 发送回传信息，事件回传，success回传
        case "onEventTrackingSucceeded":

            break;
                // 发送回传信息，事件回传，failure回传
        case "onEventTrackingFailed":

            break;
            // 延迟深度链接回传
        case "launchReceivedDeeplink":

            break;
        default:
            break;
    }
})
  • 初始化SDK
let params = {}
params.environment = "production" // 环境 production、sandbox
params.logLevel = "debug" // 日志等级 verbose、debug、info、warn、error、assert、suppress
// params.urlStrategy = { // 隐私功能模块里，设置 URL 策略
//  domains: ["xxx"], // 接收您所发送 SDK 流量的数据驻留国家/地区或终端
//  useSubdomains: true, // 来源是否为子域名作为前缀
//  isDataResidency: true //域名是否用于数据驻留
// }
// params.fbAppId = "xxx" // 设置Meta Install Referrer的应用ID,仅支持Android
// params.eventDeduplicationIdsMaxSize = 20 // 设置去重 ID 限制
// params.externalDeviceId = "xxx" // 设置外部设备标识符
// params.defaultTracker = "" // 设置默认链接识别码
// params.enableCostDataInAttribution = true // 启用成本数据发送
// params.disableAppSetIdReading = true // 禁用 app set ID 读取, 不支持ios
// params.enableSendingInBackground = true // 启用后台记录
// params.enablePreinstallTracking = true // 发送预安装应用活动,启用预安装监测，不支持iOS
// params.enableFirstSessionDelay = true // 启用首次会话延迟，不支持iOS
// params.enableCoppaCompliance = true // COPPA 合规
// params.enablePlayStoreKidsCompliance = true // 将应用标记为 Play 商店儿童应用，不支持iOS
// params.storeInfo = { // 配置商店类型
//  storeName: "xxx",
//  storeAppId: "xxx"
// }
// params.disableSkanAttribution = false // 关闭 SKAdNetwork 通讯,不支持android
// params.processName = "xxx" // 设置主进程名称,一般不需要设置，不支持iOS
// params.preinstallFilePath = "/xxxx/xxxx" // 全局可读目录，不支持iOS
// params.disableIdfvReading = true // // 禁用 IDFV 读取,仅支持iOS
UTSAdjust.sdkInit(params)
  • 激活离线模式

UTSAdjust.switchToOfflineMode()
  • 禁用离线模式

UTSAdjust.switchToOfflineMode()
  • 设置推送标签

UTSAdjust.setPushToken({
    token: "xxx"
})
  • 禁用SDK

UTSAdjust.disable()
  • 启用SDK

UTSAdjust.enable()
  • 查看SDK启用状态

UTSAdjust.isEnabled((resp)=>{
    let isEnabled = resp.isEnabled
    if(isEnabled) {

    } else {

    }
})

发送广告收入信息

  • 发送广告收入信息

let params = {}
params.source = "applovin_max_sdk" // 广告收入来源
params.revenue = 1.25 // 记录广告收入额-收入额
params.currency = "EUR" // 记录广告收入额-币种
params.adImpressionsCount = 2 // 广告展示量记录
params.adRevenueNetwork = "network1" // 广告收入渠道
params.adRevenueUnit = "unit1" // 广告收入单位
params.adRevenuePlacement = "banner" // 广告收入位置
params.callbackParameter = [ // 添加回传参数
    {
        key: "age",
        value: "12"
    }
]
params.partnerParameter = [ // 添加合作伙伴参数
    {
        key: "xx",
        value: "1xx2"
    }
]
UTSAdjust.trackAdRevenue(params)
  • 获取归因信息

UTSAdjust.getAttribution((resp)=>{

})
  • 获取带有超时值的当前归因信息

UTSAdjust.getAttributionWithTimeout({
    timeoutInMilliSec: 2000 // 毫秒
},(resp)=>{

})
  • 访问深度链接信息，获取深度链接信息,仅支持Android

let deepLink = UTSAdjust.getData()
if(deepLink) {

}
  • 通过深度链接进行再归因

let params = {}
params.uri = "http://www.xxxx/xxx/xxx"
// params.referrer = true // 是否处理带有 referrer 的深度链接
UTSAdjust.processDeeplink(params)
  • 获取最近的深度链接

UTSAdjust.getLastDeeplink((resp)=>{
    let deeplink = resp.deeplink
})
  • 链接解析，仅支持Android

let params = {}
params.url = "http://wwww.xxxx"
params.resolveUrlSuffixArray = ["xxxx"]
UTSAdjust.resolveLink(params, (resp)=>{
    let resolvedLink = resp.resolvedLink
})
  • 获取设备标识符adid

UTSAdjust.getAdid((resp)=>{
    let adid = resp.adid
})
  • 获取带有超时值的 Adjust 设备标识符

UTSAdjust.getAdidWithTimeout({
    timeoutInMilliSec: 200000
}, (resp)=>{
    let adid = resp.adid
})
  • 获取Google Play 服务广告 ID

UTSAdjust.getGoogleAdId((resp)=>{
    let googleAdId = resp.googleAdId
})
  • 获取Amazon 广告主 ID

UTSAdjust.getAmazonAdId((resp)=>{ let amazonAdId = resp.amazonAdId })


- 获取Adjust SDK 版本

UTSAdjust.getSdkVersion((resp)=>{ let sdkVersion = resp.sdkVersion })


- 发送事件信息

let params = {} params.eventToken = "xxx" // 事件识别码 params.revenue = { // 记录事件收入 revenue: 1.2, currency: "EUR" } params.productId = "xxx" // 已购买产品的 ID params.purchaseToken = "xx" // 与购买关联的购买识别码 params.deduplicationId = "xx" // 可选的标识符，用于事件去重 params.callbackId = "xx" // 添加回传标识符 params.callbackParameter = [ // 添加回传参数 { key: "xxx", value: "sss" } ] params.partnerParameter = [// 添加合作伙伴参数 { { key: "xxx", value: "sss" } } ] UTSAdjust.trackEvent(params)


- 禁止首次会话延迟

UTSAdjust.endFirstSessionDelay()


- COPPA 合规启用

UTSAdjust.enableCoppaComplianceInDelay()


- COPPA 合规禁用

UTSAdjust.disableCoppaComplianceInDelay()


- Play 商店儿童合规启用方法，仅支持Android

UTSAdjust.enablePlayStoreKidsComplianceInDelay()


- Play 商店儿童合规禁用方法，仅支持Android

UTSAdjust.disablePlayStoreKidsComplianceInDelay()


- 设置外部设备 ID

UTSAdjust.setExternalDeviceIdInDelay({ externalDeviceId: "xxx" })


## 隐私功能

- 发送删除请求

UTSAdjust.gdprForgetMe()


- 第三方数据分享是否启用

let params = {} params.isEnabled = true // 第三方数据分享是否启用。传送 true 可启用第三方分享；传送 false 可禁用第三方分享。 params.granularOption = [ // 发送精细信息 { partnerName: "xxx", key: "", value: "" } ] params.partnerSharingSetting = [ // 更新合作伙伴分享设置 { partnerName: "xxx", key: "", value: true } ] UTSAdjust.trackThirdPartySharing(params)


- 针对特定用户的许可监测,许可监测是 (true) 否 (false) 启用

UTSAdjust.trackMeasurementConsent({ consentMeasurement: true })


- 记录事件并验证购买

let params = {} params.eventToken = "xxx" // 事件识别码 params.revenue = { // 记录事件收入 revenue: 1.2, currency: "EUR" } params.productId = "xxx" // 已购买产品的 ID params.purchaseToken = "xx" // 与购买关联的购买识别码 params.deduplicationId = "xx" // 可选的标识符，用于事件去重 params.callbackId = "xx" // 添加回传标识符 params.callbackParameter = [ // 添加回传参数 { key: "xxx", value: "sss" } ] params.partnerParameter = [// 添加合作伙伴参数 { { key: "xxx", value: "sss" } } ] UTSAdjust.verifyAndTrackPlayStorePurchase(params, (resp)=>{

})


- 仅验证购买

UTSAdjust.verifyPlayStorePurchase({ productId: "", // 已购买产品的 ID purchaseToken: "" // 与购买关联的购买识别码 }, (resp)=>{

})


## 配置回传参数

- 统一回传参数

UTSAdjust.addGlobalCallbackParameter({ key: "", value: "" })


- 移除统一回传参数

UTSAdjust.removeGlobalCallbackParameter({ key: "" })


- 移除所有统一回传参数

UTSAdjust.removeGlobalCallbackParameters()


- 统一合作伙伴参数

UTSAdjust.addGlobalPartnerParameter({ key: "", value: "" })


- 移除统一合作伙伴参数

UTSAdjust.removeGlobalPartnerParameter({ key: "" })


- 重置统一合作伙伴参数

UTSAdjust.removeGlobalPartnerParameters()


## 解析品牌化短链接

- 设置Adjust SDK来解析短链接

UTSAdjust.processAndResolveDeeplink({ url: "https://www.xxx/xx", referrer: false // 处理带有 referrer 的深度链接 }, (resp)=>{ let resolvedLink = resp.resolvedLink })


## 发送订阅信息

- 发送订阅信息

let params = {} params.price = 12.00 // 订阅价格 params.currency = "" // 订阅使用的币种 params.sku = "" // 产品 ID params.orderId = "" // 您的交易 ID params.signature = "" // 购买数据的签名 params.purchaseToken = "" // 交易唯一识别码 params.purchaseTime = 24131 // 用户购买订阅的日期 params.callbackParameter = [ // 添加回传参数 { key: "", value: "" } ] params.partnerParameter = [ // 添加合作伙伴参数 { key: "", value: "" } ] UTSAdjust.trackPlayStoreSubscription(params)


## 插件
- 访问 Huawei Ads Install Referrer，仅支持Android

UTSAdjust.getHuaweiAdsInstallReferrer((resp)=>{ let opt = resp.opt switch(opt) { case "onInstallReferrerDetailsRead":

    break;
    case "onFail":

    break;
}

})


- 访问 Huawei AppGallery Install Referrer ，仅支持Android

UTSAdjust.getHuaweiAppGalleryInstallReferrer((resp)=>{ let opt = resp.opt switch(opt) { case "onInstallReferrerDetailsRead":

    break;
    case "onFail":

    break;
}

})


- IMEI,收集设备的 IMEI 和 MEID ，仅支持Android

在UTSAdjust.sdkInit(params)前调用

UTSAdjust.readImei()


- IMEI,阻止 SDK 读取 IMEI 和 MEID，仅支持Android

在UTSAdjust.sdkInit(params)前调用

UTSAdjust.doNotReadImei()


- OAID,收集设备的OAID ，仅支持Android

在UTSAdjust.sdkInit(params)前调用

UTSAdjust.readOaid()


- OAID,阻止 SDK 读取 OAID，仅支持Android

在UTSAdjust.sdkInit(params)前调用

UTSAdjust.doNotReadOaid()


- Samsung install referrer,启用 install referrer 读取，仅支持Android
在UTSAdjust.sdkInit(params)前调用

UTSAdjust.readSamsungReferrer()


- Samsung install referrer,禁用 install referrer 读取，仅支持Android

在UTSAdjust.sdkInit(params)前调用

UTSAdjust.doNotReadSamsungReferrer()


- Vivo referrer,启用 install referrer 读取，仅支持Android
在UTSAdjust.sdkInit(params)前调用

UTSAdjust.readVivoReferrer()


- Vivo referrer,禁用 install referrer 读取，仅支持Android

在UTSAdjust.sdkInit(params)前调用

UTSAdjust.doNotReadVivoReferrer()


- 小米 referrer,启用 install referrer 读取，仅支持Android
在UTSAdjust.sdkInit(params)前调用

UTSAdjust.readXiaomiReferrer()


- 小米 referrer,禁用 install referrer 读取，仅支持Android

在UTSAdjust.sdkInit(params)前调用

UTSAdjust.doNotReadXiaomiReferrer()


- 获取IDFA (广告主 ID),Apple 设备的独特标识符，仅支持ios

UTSAdjust.getIdfa((resp)=>{ let idfa = resp.idfa })


- 获取IDFV,(供应商 ID) 是一种唯一标识符，用于识别同一设备上来自同一发行商/供应商的所有应用，仅支持ios

UTSAdjust.getIdfv((resp)=>{ let idfv = resp.idfv })


- requestAppTrackingAuthorization，仅支持ios

UTSAdjust.requestAppTrackingAuthorization((resp)=>{ let status = resp.status })


- appTrackingAuthorizationStatus，仅支持ios

let status = UTSAdjust.appTrackingAuthorizationStatus()

隐私、权限声明

1. 本插件需要申请的系统权限列表：

<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/> <!-- 默认包含 com.google.android.gms.AD_ID 权限。如果您要让应用符合 COPPA (儿童在线隐私保护法) 规定，或者应用并不面向 Google Play 商店，请务必使用 remove 命令移除权限 --> <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件使用的 ADJUST SDK会采集数据，详情可参考：https://dev.adjust.com/zh/sdk

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

评论列表 撰写评论 向官方投诉
加载更多...