用途:在 iOS 17.4+ 上以隐私保护方式衡量广告带来的应用安装与再互动。参与角色有三类:广告网络用 JWS 签名展示并接收校验后的回传;发布者 App 用 UIEventAttributionView 或 StoreKit 叠加层承载广告;被推广 App 注册转化、更新转化值并接收回传副本。
隐私与仲裁:系统按人群量级(0-3 级)限制回传粒度,低层级返回粗略转化值和较短来源 ID,Tier 3 返回完整 4 位来源 ID 与精细值。回传随机延迟下发(首个转化窗口 24-48 小时,第二、三个窗口 24-144 小时)。AdAttributionKit 与 SKAdNetwork 展示会一起评估,只有一条胜出:点击优先于浏览,同类交互中最近展示胜出。
必要用法:发布者 App 在 Info.plist 以小写标识符声明支持的网络(AdNetworkIdentifiers);自定义点击广告需在可点击区域上方叠加 UIEventAttributionView。广告主 App 配置 AdAttributionKit 字典,含 HTTPS 的 AttributionCopyEndpoint 及可选 OptInForReengagementPostbackCopies,系统发往 /.well-known/appattribution/report-attribution/。注册展示可用 AppImpression(compactJWS:),调用 handleView() 或 handleTap()(须在创建后 15 分钟内);也可用 SKOverlay.AppConfiguration 的 appImpression 自动跟踪。转化值通过 Postback.updateConversionValue 在启动与关键里程碑更新,可传入 coarseConversionValue 并用 lockPostback 提前锁定窗口。
常见错误:标识符误用大写、自定义点击广告缺少 UIEventAttributionView、首次启动未及时调用更新转化值、超过 15 分钟点击窗口、混淆归因资格窗口与回传转化窗口。
限制:需 iOS 17.4+,仅支持具备相应能力的设备;回传经延迟与人群量级限制,服务端需校验 JWS 签名。测试、服务端处理与 SKAdNetwork 迁移细节暂未提供。