更新记录

1.0.0（2026-10-22）

1.0.0（2026-10-22）

• 首次发布
• 支持 iOS 14.3+ 获取 ASA 归因 Token（基于 AdServices 框架）
• 非 iOS 平台及低版本系统统一返回空字符串

平台兼容性

uni-app

ios-attribution-token（iOS ASA 归因 Token）

基于 UTS 的 uni-app 插件，用于获取 Apple Search Ads（ASA）归因 Token，通过 iOS 系统 AdServices 框架调用 AAAttribution.attributionToken() 获取，可用于向 Apple 官方归因接口换取广告归因数据。

平台支持

• iOS 14.3+：返回归因 Token

• iOS 14.3 以下 / Android / Web / 小程序：返回空字符串 ""

使用方法

import { getAttributionToken } from '@/uni_modules/ios-attribution-token' const token = getAttributionToken() if (token) { // 上报给业务后端，由后端请求 https://api-adservices.apple.com/api/v1/ 换取归因数据 }

API

getAttributionToken(): string —— iOS 14.3+ 成功返回 token；版本过低、调用失败或非 iOS 平台返回 ""

注意事项

• 需真机 + 自定义基座/正式包运行，标准基座不包含本插件

• 需在 App Store Connect 配置 Apple Search Ads 广告系列

• 插件不采集 IDFA，不受 ATT 授权弹窗影响

• Token 建议由后端处理，并在 24 小时内使用