所需条件

SearchAds Manager 通过 API 连接 Apple Ads 账号。你需要具有 API 访问权限的账号，以及 App 要求的凭据。仅有 App Store Connect 凭据并不等于拥有 Apple Ads API 凭据。

准备 API 访问

在 Mac 上打开“设置” → “账户”进行账户设置，并在“签名密钥”中配置密钥对。按照 Apple 的指南注册公钥。

1. 请 Apple Ads 账号管理员授予适当的 API 角色。
2. 按照 Apple 的 OAuth 设置指南准备密钥对和账号标识符，并注册公钥。
3. 在 SearchAds Manager 中输入所需 API 凭据。私钥存储在设备钥匙串中。
4. 选择账号并查看近期报表，确认连接正常。

使用适合你工作的权限。更改广告系列需要具有相应修改权限的账号角色。

报表与管理

输入 Apple Ads API 凭据后，选择你的账户并打开一份近期的广告系列报告。

报表功能免费。你可以查看花费、展示次数、轻点次数、安装次数、每次轻点成本和每次获取成本。

创建或更改广告系列、广告组、广告和关键词需要付费升级。当前提供的订阅和终身购买选项会显示在 App 和 App Store 页面中。

连接 Mac 上的兼容工具

1. 1 Codex

   向本地 MCP 服务器发送请求。

2. 2 SearchAds Manager

   在你的 Mac 上运行服务器并处理请求。

3. 3 Apple Ads

   返回账户数据或执行已获授权的广告系列操作。

保持 SearchAds Manager 在你的 Mac 上运行。它会使用你在应用中配置的 API 访问权限连接到 Apple Ads。

可选的本地 MCP 服务器，让 Mac 上的兼容工具能够使用报表和广告系列操作。请先阅读 MCP 服务器概览和 Codex 连接指南。

如果账号无法连接

请检查你使用的是 Apple Ads API 凭据，公钥已注册，且 API 角色有权访问所选账号。联系支持时，请提供错误消息和平台，但不要在消息中包含私钥和密钥等机密信息。