rocket_launch ASAPilot
开始使用

术语

Apple Search Ads API

Apple 官方的 REST API，用于 Apple Search Ads 的程序化管理 — campaign CRUD、报告、关键词管理、出价变更。使用 OAuth 2.0 + ES256 JWT 认证。

别名：ASA API, Apple Search Ads Campaign Management API

什么是 Apple Search Ads API？

Apple Search Ads API 是 Apple 官方的 REST API，用于 Apple Search Ads 的程序化管理。它是所有 合法第三方 ASA 工具的集成接口 —— 包括 ASAPilot。

能力：

  • Campaign 管理 — 创建、更新、暂停、归档
  • 广告组管理 — 关键词、广告、出价、受众细化
  • 关键词操作 — 添加、修改匹配类型、设出价、添加 negatives
  • 报告 — 每个关键词/广告组/campaign 的支出、点击、安装、转化率
  • 搜索词报告 — 查看实际触发点击的用户查询
  • Custom Product Page 分配 — 给广告组分配 CPP

认证如何工作

Apple Search Ads API 使用 OAuth 2.0 + ES256 JWT：

  1. 在 Apple Search Ads 账户设置生成 EC（椭圆曲线）私钥。
  2. 安全存储私钥（这是你的密钥）。
  3. 做 API 调用时，构造私钥签名的 JWT。JWT 包含 client ID、team ID、key ID 和短过期（通常 5-20 分）。
  4. POST JWT 到 Apple OAuth 端点换取短期访问 token。
  5. 在后续 API 调用的 Authorization: Bearer <token> 头里用 token。

这个流程比简单 API key 更重。ASAPilot 和其他第三方工具内部处理 JWT 生成 — 你只在初始化时提供 key。

速率限制

Apple 未公布严格速率限制数。观察行为（2026）：

  • 软节流 在持续 >5 req/s
  • 突发容差 在短窗口内 ~20-30 req/s
  • 报告端点 比变更端点更宽松

达到限制时 Apple 返回 429 Too Many Requests + Retry-After 提示。生产集成应实现指数退避。

为什么第三方工具用 API

Apple Search Ads 仪表盘适合单账户低频任务。API 在这些情况变得必要：

  • 一次管理 5+ 账户（手动登录操作不可行）
  • 运行自动化（日报、异常告警、循环审计）
  • 构建自定义仪表盘（收入合并、LTV 分析、cohort 拆分）
  • 批量操作（一批添加 200 个 negative keywords）

常见集成模式

模式如何用 API
日报告工具夜间拉报告、计算 KPI、邮件总结
异常检测器每 5-15 分轮询指标、阈值突破告警
出价优化器读取表现、计算新出价、写回（安全工具如 ASAPilot 需人工审批）
审计仪表盘只读拉取完整账户状态、曝光结构问题
MMP 集成把 ASA 支出与 AppsFlyer/Adjust/Kochava 跨渠道归因合并

ASAPilot 如何使用 API

ASAPilot 在初始化时通过 OAuth 2.0 + ES256 JWT 接入你的 Apple Search Ads 账户（中位耗时 <2 分）。 接入后：

  • 每 5-15 分轮询报告端点做支出节奏和异常检测
  • 为账户审计读取 campaign / 广告组 / 关键词状态
  • 默认不写入你的账户 — 只读是默认模式；写入需对每条建议显式人工审批

查看 docs/connect-apple-search-ads 了解完整接入流程。

相关术语