更新记录

1.0.1（2025-08-04）

代码整理，修复 bug

1.0.0（2025-08-01）

集成 adjust 事件功能与归因监听

平台兼容性

uni-app x

native-adjust

UniApp UTS Adjust SDK 移动分析插件

使用方法

import { 
  initAdjust, event, getAttribution, getAdId, setEnabled, sdkVersion,
  // Android 特有
  getGoogleAdId, getAmazonId,
  // iOS 特有  
  getIDFA, getIDFV
} from '@/uni_modules/native-adjust'

// 初始化 SDK
initAdjust({
  appToken: "your_app_token_here",
  sessionBack: true,  // 启用会话回调
  eventBack: true     // 启用事件回调
}, (result) => {
  console.log('Adjust 回调:', result)
})

// 跟踪简单事件
event({ token: "abc123" }, (success) => {
  console.log('事件跟踪:', success)
})

// 跟踪收入事件
event({
  token: "xyz456",
  money: 9.99,
  moneyUnit: "USD",
  orderId: "order_123",
  callbackId: "cb_001"
}, (success) => {
  console.log('收入事件:', success)
})

// 跟踪带参数的事件
event({
  token: "def789",
  callbackParams: {
    "user_id": "12345",
    "product": "premium"
  },
  partnerParams: {
    "campaign": "summer_sale"
  }
}, (success) => {
  console.log('参数事件:', success)
})

// 获取归因信息
getAttribution((attribution) => {
  console.log('归因数据:', attribution)
})

// 获取广告ID（通用）
getAdId((adId) => {
  console.log('广告ID:', adId)
})

// Android 特有方法
getGoogleAdId((googleAdId) => {
  console.log('Google广告ID:', googleAdId)
})

getAmazonId((amazonId) => {
  console.log('Amazon广告ID:', amazonId)
})

// iOS 特有方法
getIDFA((idfa) => {
  console.log('IDFA:', idfa)
})

getIDFV((idfv) => {
  console.log('IDFV:', idfv)
})

// SDK控制
setEnabled(true)   // 启用SDK
setEnabled(false)  // 禁用SDK

// 获取SDK版本
sdkVersion((version) => {
  console.log('SDK版本:', version)
})

主要功能

• 移动应用分析和归因跟踪
• 会话跟踪和事件跟踪
• 收入跟踪和转化分析
• 自定义回调参数和合作伙伴参数
• 跨平台广告ID获取和归因数据
• 平台特有标识符支持
  • Android: Google AdID, Amazon AdID
  • iOS: IDFA, IDFV
• SDK启用/禁用控制

平台支持

• Android: 完整支持 (最低 SDK 21)
• iOS: 完整支持 (最低 iOS 12.0)

技术规格

• 开发框架: UTS (TypeScript for UniApp)
• 插件类型: 原生API插件
• 依赖库:
  • Android: Adjust Android SDK 4.30.1
  • iOS: Adjust iOS SDK (通过框架集成)
• 权限要求:
  • Android: 网络访问、广告ID读取
  • iOS: 网络访问、广告ID读取、应用跟踪透明度 (iOS 14.5+)

版本历史

• v1.1.0: 新增iOS平台完整支持，跨平台功能一致
• v1.0.0: 基础Adjust功能，Android平台支持