术语
adam ID(adam 标识)
Apple 内部对每个 App Store 项目的数字标识 — App、内购、内容包。在 Apple Search Ads API 中用于引用特定 App。
别名:Apple ID(App Store 上下文), App Store ID, iTunes adam ID
什么是 adam ID?
adam ID 是 Apple 对每个 App Store 项目的内部数字标识。它是唯一的、稳定的,并在整个 Apple API 中使用 — 包括 Apple Search Ads。
“adam” 据报告是 Apple 内部缩写(不同说法包括 “Apple Digital Asset Manager”),Apple 未官方解释 词源。
adam ID 在哪里出现
- App Store URL:
https://apps.apple.com/cn/app/example/id1234567890—1234567890是 adam ID。 - App Store Connect — 在 App Information 下显示为 App 的 “Apple ID”。
- Apple Search Ads API — 在
campaigns.app.adamId引用被广告的 App。 - Ad Services API 归因 payload — 包含在归因响应中。
- iTunes Search API —
trackId字段。
adam ID vs 其他标识
iOS App 有三个不同标识,操作者经常混淆:
| 标识 | 格式 | 设置位置 | 使用位置 |
|---|---|---|---|
| adam ID | 9-10 位数字(如 1234567890) | 创建 App 时 Apple 自动分配 | Apple Search Ads、App Store URL、归因 API |
| Bundle ID | 反向 DNS(com.example.app) | 开发者在 Xcode / App Store Connect 中设置 | App 构建、签名、深度链接 |
| App Store Connect SKU | 自由文本(如 EXAMPLE_2026) | 开发者在 App Store Connect 中设置 | 仅内部核算 |
最常见的混淆是 adam ID 和 Bundle ID。总是把 adam ID 传给 ASA API — Bundle ID 用于构建/运行时 问题。
如何找你的 adam ID
三种方法:
- 从 App Store URL。打开
apps.apple.com/<storefront>/app/<slug>/id<NUMBER>。id前缀后跟的是 adam ID。 - 从 App Store Connect。登入 → My Apps → 选择你的 App → App Information → “Apple ID” 字段。
- 从 iTunes Search API。查询
https://itunes.apple.com/search?term=<App名>&entity=software— 响应的trackId是 adam ID。
adam ID 与 storefront
单个 App 在所有 storefront 有一个 adam ID。同一个 1234567890 是美国 App Store、英国 App
Store、日本 App Store 中你的 App。
这对 Apple Search Ads 重要因为 campaign 是 per-storefront 但通过单一 adam ID 引用 App。 storefront 决定语言和货币;adam ID 标识要广告哪个 App。
ASAPilot 如何使用 adam ID
ASAPilot 初始化流程要求 App Store URL(自动提取 adam ID)或直接 adam ID。内部每个 campaign、 广告组、归因事件引用 adam ID。
Campaign Launch Pipeline 接受 App Store URL 作为输入,在 onboarding 阶段解析出 adam ID。
相关术语
- Apple Search Ads — 引用 adam ID 的平台
- Apple Search Ads API — 每次 campaign 变更都用 adam ID
- Custom Product Page — 除了 adam ID 还有自己的 UUID