用途:AdAttributionKit 用于 iOS 17.4+ / Swift 6.3 的隐私保护广告归因,让广告网络衡量转化(安装与再互动)而不暴露用户级数据,支持 App Store 与替代市场,并与 SKAdNetwork 互操作。归因流程涉及广告网络(签名展示、接收回传)、发布者应用(展示广告)和被推广应用三方。
隐私机制:通过人群匿名层级(Tier 0 至 Tier 3)限制回传数据粒度;回传延迟发送(第一窗口 24-48 小时,第二/三窗口 24-144 小时);不含用户级标识符;使用 2、3 或 4 位分层来源标识符。系统同时评估 AdAttributionKit 与 SKAdNetwork 的展示,每次转化仅一个展示胜出,点击优先于浏览,同组内以时间新近为决胜。
发布者应用:在 Info.plist 的 AdNetworkIdentifiers 数组中加入各广告网络 ID(须小写,也接受 .skadnetwork 结尾的 ID)。点击式自定义广告需叠加 UIEventAttributionView,用户点击后 handleTap() 才能成功。
广告主应用:须至少调用一次转化值更新以启动回传窗口;可在 Info.plist 配置 AttributionCopyEndpoint 接收胜出回传副本,系统生成 well-known 路径 https://example.com/.well-known/appattribution/report-attribution/,服务器需支持 HTTPS POST 且证书有效;再互动副本需加 OptInForReengagementPostbackCopies。
展示与回传:广告网络用 JWS 创建签名展示,发布者用 AppImpression 注册;可用 AppImpression.isSupported 检查支持;浏览展示用 handleView() 或 beginView()/endView(),点击用 handleTap()。StoreKit 渲染广告可传 appImpression,展示 2 秒后自动记录浏览、点击时记录点击。回传分三个转化窗口(第 0-2 天、3-7 天、8-35 天),Tier 0 仅产生首个回传,非胜出归因仅一个回传。转化值细粒度 0-63(仅首回传且 Tier 2+),粗粒度 .low/.medium/.high;iOS 18+ 可按 install/reengagement 类型分别更新,iOS 18.4+ 支持 conversion tag。
再互动:JWS 中标记 eligible-for-re-engagement,handleTap(reengagementURL:) 传通用链接,系统附加 AdAttributionKitReengagementOpen 查询参数;仅点击产生再互动回传,设备有月度/年度限制。
限制与常见错误:忘记首次启动更新转化值、广告网络 ID 大写、未叠加 UIEventAttributionView 就调用 handleTap、忽略 handleTap 错误、服务器未及时返回 200(设备最多重试 9 次/9 天)等。资料未提供收费、价格或平台支持范围之外的信息。