---
title: "使用 AI 编码工具管理 Apple Ads"
description: "安装 ads-manager 技能，让 Claude Code、Copilot CLI、Codex 或 Gemini CLI 通过 Adapty CLI 运行您的 Apple Ads 广告活动。"
---

`ads-manager` 技能让 AI 编程工具能够通过 [Adapty CLI](developer-cli-ads-manager) 操作你的 Apple Ads 账户。用自然语言提问，它会自行判断需要执行哪些命令，先读取账户数据，再将写入操作提交给你确认，然后才实际发送到 Apple。

技能是 AI 工具按需加载的一组指令。这个技能涵盖了 Ads Manager 中最容易出错的部分：每个标识符对应哪个参数，每个列表支持哪些过滤条件，一次批量操作最多可以提交多少关键词，以及哪些调用会产生费用。

## 它处理的内容 \{#what-it-handles\}

- **读取性能**：针对每个问题选择最合适的单次调用，而非逐页翻查结果。它知道"前 N 名"类问题只需一次有序调用，统计实体数量也根本不需要调用指标接口。
- **结构变更**：按正确顺序创建和更新广告系列、广告组、广告及关键词，写入子实体前先读取父实体。
- **关键词管理**：批量添加关键词并调整出价，同时将搜索词转化为关键词和否定关键词。
- **自动化规则**：设置基于规则的自动化，并在影响实际出价前先进行模拟运行。
- **竞品调研**：获取竞品应用所竞价的关键词。

## 它不会做什么 \{#what-it-will-not-do\}

该技能将每次写入都视为不可逆操作，因为确实如此——CLI 没有删除功能，且更改会在几秒内同步到 Apple。

- 在写入之前先读取，而不是猜测 ID 或预算。
- 在任何涉及花费的命令执行前都会先询问确认，并且当您亲自运行命令时，保留 CLI 自身的确认提示。
- 在链式写入的每次操作上固定一个幂等键，这样在结果不明确后重新运行时不会创建第二个广告系列。
- 优先采用小批量方式，以便 Apple 返回部分拒绝时仍易于查看。

:::note
该功能仅提供建议并准备待执行命令。读取数据指标和模拟运行不产生任何费用，但对线上广告账户的任何变更操作，均由您自行审核批准后方可执行。
:::

## 安装技能 \{#install-the-skill\}

[ads-manager skill](https://github.com/adaptyteam/adapty-sdk-integration-skill) 可以教你的 AI 编码工具通过 `adapty asa` 命令操作 Apple Ads。它了解命令的组合顺序、在执行写入操作前应读取哪些内容，以及哪些调用会产生费用。

**支持的工具**：Claude Code、GitHub Copilot CLI、OpenAI Codex、Gemini CLI。

该 skill 驱动 Adapty CLI，因此请先安装并完成 CLI 的身份验证——参阅[快速入门指南](developer-cli-quickstart)。`adapty asa` 命令在 **Adapty CLI 0.4.0 及更高版本**中提供；旧版本中该命令根本不存在。运行 `adapty asa whoami` 进行检查，该命令同时会告知你是否已连接 Apple Ads 账户，以及公司是否拥有有效的 Ads Manager 订阅。

在企业 Cowork 工作区中，管理员必须将 `adapty.io` 和 `*.adapty.io` 都添加到域名白名单。两者须同时添加：在大多数白名单实现中，通配符不覆盖根域名，而根域名正是该 skill 读取文档的地址。在两者都被允许之前，该 skill 无法访问 Adapty。

安装时，请根据你使用的工具选择对应的方式。完整列表请参阅 [skill README](https://github.com/adaptyteam/adapty-sdk-integration-skill)。

**Claude Code**

```bash
claude plugin marketplace add adaptyteam/adapty-sdk-integration-skill
claude plugin install adapty-sdk-integration@adapty
```

此插件同时包含 SDK 集成 skill，两者会一并安装。

**GitHub Copilot CLI**

```bash
git clone https://github.com/adaptyteam/adapty-sdk-integration-skill.git
cp -r adapty-sdk-integration-skill/skills/* ~/.copilot/skills/
```

**Gemini CLI**

```bash
gemini skills install https://github.com/adaptyteam/adapty-sdk-integration-skill
```

**OpenAI Codex 或其他工具** —— 使用 [skills CLI](https://skills.sh)（注意以此方式安装的 skill 不会自动更新）：

```bash
npx skills add adaptyteam/adapty-sdk-integration-skill --all
```

`--all` 会将两个 skill 安装到检测到的所有 agent 中。如果只需安装本 skill，请使用 `--skill ads-manager`。

你也可以克隆仓库，将 `skills/` 下的目录复制到你的工具的 skills 目录中——如果只需要这一个 skill，复制 `skills/ads-manager/` 即可。

安装完成后，在你的项目中运行该 skill：

```bash
/ads-manager
```

读取数据指标和演练运行不产生任何费用。其他所有命令都会在数秒内触达 Apple，花费真实资金，且操作无法撤销——该 skill 在每次执行前都会向你确认，你自己也应该做到同样的谨慎。

## 与 AI Agent 的区别 \{#how-it-differs-from-the-ai-agent\}

Adapty Ads Manager 在看板中还内置了一个 [AI Agent](ads-manager-ai-agent)。两者面向不同的使用需求：

| | AI Agent | ads-manager skill |
|---|---|---|
| 运行位置 | Adapty 看板 | 你的终端，在 AI 编码工具中 |
| 功能 | 分析并给出建议 | 分析、给出建议，并执行命令 |
| 配置 | 无需配置 | 需要 Adapty CLI 和该 skill |

如果你想了解账户中正在发生什么，使用 AI Agent；如果你还希望直接执行变更，则使用 skill。

## 下一步 \{#whats-next\}

- [通过 CLI 管理 Ads Manager](developer-cli-ads-manager) — 不借助 AI 工具，手动完成相同操作。
- [Ads Manager 命令](developer-cli-ads-manager-reference) — 包含所有命令及其参数、标志和可接受值的完整参考。