rocket_launch ASAPilot
开始使用

术语

Ad Services API

Apple 一方的 Apple Search Ads 专属归因 API。确认哪些 App 安装来自 ASA campaign，返回 campaign、广告组、关键词 ID — 不带任何用户标识。

别名：AdServices framework, AdAttributionKit（相关）

什么是 Ad Services API？

Ad Services API（iOS 14.3 引入，取代旧 iAd 框架）是 Apple 一方的 Apple Search Ads 安装 专用归因 API。

当用户点击 ASA 广告然后安装你的 App，Apple 因为广告版位和 App Store 都由它运营，能确定性地知道 这一关联。Ad Services API 让你的 App 在不暴露 IDFA 或任何用户级标识的情况下请求这一归因数据。

工作流程

  1. 用户通过 ASA 广告点击安装你的 App。
  2. App 在首次会话内调用 AdServices.attributionToken()。
  3. App 把 token 发送到 Apple 归因端点：POST https://api-adservices.apple.com/api/v1/
  4. Apple 返回带归因细节的 JSON payload： 
    {
  "attribution": true,
  "campaignId": 12345678,
  "adGroupId": 87654321,
  "keywordId": 11223344,
  "creativeSetId": null,
  "orgId": 99887766,
  "countryOrRegion": "US",
  "clickDate": "2026-05-20T14:23:11Z",
  "conversionDate": "2026-05-20T14:24:42Z",
  "iad-purchase-date": "2026-05-20T14:24:42Z"
}
  5. 你的后端把这些与用户级数据合并计算归因收入、LTV 等。

如果 "attribution": false，安装不来自 ASA — 可能是自然、其他付费渠道，或来自不匹配任何 campaign 的搜索查询。

响应告诉你什么

字段含义
campaignIdASA campaign ID — 合并到你的 campaign 列表
adGroupIdASA 广告组 ID — 合并到你的广告组列表
keywordId触发点击的关键词（Search Match 为 null）
creativeSetId创意变体（CPP 取代 creative set 后很少使用）
orgId你的 Apple Search Ads org ID
countryOrRegion安装发生的店面
clickDate点击发生时间
conversionDate安装发生时间

与 SKAdNetwork 对比

方面Ad Services APISKAdNetwork
范围仅 ASA所有广告网络
延迟几分钟几小时到几天（SKAN 4.0 三个回传窗口）
粒度Campaign + 广告组 + 关键词Campaign 级 + conversion value
确定性确定性聚合、隐私保护
用户标识无无（有意）
人群匿名等级无有（抑制低量数据）
最佳用途ASA-only 优化通过 MMP 做跨网络归因

ASAPilot 如何使用 Ad Services API

ASAPilot 通过 Apple Search Ads API 读取 ASA campaign 表现（campaign 和支出数据），并与你后端的 归因数据（来自 Ad Services API）合并。

你在 App 中设置 Ad Services API 集成（一次性后端工作）。ASAPilot 然后把归因事件与 ASA 支出合并 计算每个 campaign / 广告组 / 关键词的 CPI、CPA、ROAS — 不需要 MMP。

常见实现陷阱

  • Token 必须在首次会话中获取。如果 App 在 token 请求前崩溃或被卸载，会丢失归因。
  • Token 有效期短。Token 很快过期；及时与 Apple 端点交换。
  • pre-iOS 14.3 回退。如果支持更旧 iOS，需要传统 iAd 框架与 Ad Services 并存。多数 App 在 2026 已经放弃 iOS <15。
  • attribution: false 不总是”自然”。一些非 ASA 安装来自 Today Tab 曝光、搜索推荐或 token 未 生成的旧创意。

相关术语