English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語

使用 AI 编码工具管理 Apple Ads

Apple Ads 插件让 AI 编程工具能够通过 Adapty CLI 操作你的 Apple Ads 账户。用自然语言提问，它会自动判断需要执行哪些命令，先读取账户信息，再将写入操作提交给你确认，任何变更都不会直接发送到 Apple。

技能是 AI 工具按需加载的一组指令。该插件内置三个技能——一个负责运行账户的操作员、一个只读审计员，以及一个策略规划师——另附用于周期性任务的 Playbook（如每周检查、同期群 ROAS 复盘和预算重新分配）、包含品类专属关键词分类体系与初始经济模型的垂直行业指南，以及将最常见操作简化为单行命令的斜杠命令。这些内容共同覆盖了 Ads Manager 中最容易出错的部分：每个标志接受哪种标识符、每个列表使用哪种过滤器、一批关键词最多能放多少个，以及哪些调用会产生费用。

它处理的内容

  • 读取性能：直接选用能回答问题的单次调用，而非逐页翻阅结果。它知道”Top-N”问题只需一次有序调用，统计实体数量根本不需要指标调用。
  • 结构变更：按正确顺序创建和更新广告系列、广告组、广告及关键词，写入子实体前先读取父实体。
  • 关键词操作：批量添加关键词并调整出价，同时将搜索词转化为关键词和否定关键词。
  • 自动化：配置基于规则的自动化任务，并在触达真实出价前进行试运行。
  • 竞品调研：获取竞品应用所投放的关键词。
  • 账户审计：apple-ads-audit 技能在不做任何修改的前提下，检查账户健康状况、投放状态、账户结构及重复关键词。
  • 从零规划：apple-ads-strategy 技能根据您对应用的描述，设计账户结构、关键词分类体系及初始预算——无需 Apple Ads 账户或 CLI。

它不会做什么

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

  • 它会在写入之前先读取数据，而不是猜测 ID 或预算。
  • 在任何涉及花费金钱的命令执行前，它都会先询问确认，并且当你亲自运行命令时，它会保留 CLI 自身的确认提示。
  • 它会为链式写入中的每次操作绑定一个幂等性密钥，这样在结果不明确后重新运行时，不会创建第二个广告系列。
  • 它倾向于小批量操作，这样来自 Apple 的部分拒绝结果也便于阅读。
Note

技能会推荐并准备相关命令。读取数据指标和演练测试不收取任何费用，但对于任何会修改正式广告账户的操作，审批责任由您自行承担。

安装插件

Apple Ads 插件能让你的 AI 编程工具通过 adapty asa 命令操作 Apple Ads。它提供三项技能：

  • apple-ads：操作员。可读取效果数据、调整出价和预算、添加关键词及否定关键词、挖掘搜索词，以及启动和暂停广告系列——在任何花钱的操作前都会请求确认。
  • apple-ads-audit：只读审计员。检查账户健康状况、投放状态、账户结构、流量归属及重复精确匹配关键词，不执行任何写入操作。
  • apple-ads-strategy：无需账户、CLI 或订阅的规划工具。只需输入应用描述，即可生成账户结构、关键词分类体系、初始预算和否定关键词列表。

支持的工具：Claude Code、Claude Cowork、GitHub Copilot CLI、OpenAI Codex、Gemini CLI，以及其他所有支持技能的工具。

操作员和审计员依赖 Adapty CLI 运行，请先安装并完成 CLI 认证——参见快速入门指南。adapty asa 命令在 Adapty CLI 0.4.0 及以上版本中提供；旧版本中这些命令不存在。可通过 adapty asa whoami 检查版本，该命令同时会告知是否已连接 Apple Ads 账户，以及公司是否拥有有效的 Ads Manager 订阅。策略技能无需以上任何条件即可使用。

Claude Cowork 在沙盒中运行 CLI，该沙盒会屏蔽白名单以外的所有域名。在该环境中安装插件前，请先放行 Adapty 域名——参见在 Cowork 中运行 CLI。Cowork 任务每次都在全新机器上启动，因此 CLI 及其登录状态不会在会话间保留——插件的 adapty-cli-setup 技能会在每次会话开始时重新安装并认证 CLI。

根据你使用的工具选择对应的安装方式。完整列表请参见插件 README。

Claude Code

claude plugin marketplace add adaptyteam/apple-ads-cli
claude plugin install apple-ads@adapty

除技能外，Claude Code 插件还会安装 /asa-* 斜杠命令——这些是常用任务的预设提示词，例如用于每周复盘的 /asa-review，以及将搜索词转化为关键词和否定关键词的 /asa-harvest。

其他工具 — 使用 skills CLI（注意通过此方式安装的技能不会自动更新）：

npx skills add adaptyteam/apple-ads-cli --all

--all 会将全部三项技能安装到它检测到的每个 Agent 中。如需单独安装某项技能，使用 --skill，例如 --skill apple-ads-strategy。

安装完成后，在项目中运行技能——可直接运行，也可通过斜杠命令：

/apple-ads

读取数据指标和演习运行不产生任何费用。其他所有命令都会在数秒内触达 Apple，花费真实资金，且无法撤销——技能在每次操作前都会询问确认，你也应该如此。

Benchmarks 插件

同一市场中还提供一个可选的配套插件 apple-ads-benchmarks——这是 Adapty 发布的订阅类应用 Apple Ads 基准数据，以本地数据包的形式提供，供 AI 工具直接查询：涵盖 90 个国家、22 个 App Store 类别和 59 个细分赛道的点击率、转化率、CPT 和 CPA，以及订阅者经济指标（如第一年 LTV）。该插件完全离线运行，无需 Apple Ads 账户、无需 CLI，也无需 Adapty 订阅。

在深入研究账户之前，先用它判断某个数字是否有问题：“德国健身应用的 CPT 4 美元高吗？“——这首先是一个基准对比的问题。

Claude Code

claude plugin marketplace add adaptyteam/apple-ads-cli
claude plugin install apple-ads-benchmarks@adapty

Any other tool

npx skills add adaptyteam/apple-ads-benchmarks --all
Note

基准 CPA 是每次下载的费用，而非每次安装的费用；CR 是点击到下载的转化率，而非试用到付费的转化率。对比时请确保使用相同的定义。

斜杠命令

在 Claude Code 中，该插件还新增了九个 /asa-* 命令。每个命令都是一个现成的提示词，会自动匹配适合该任务的技能和操作手册，因此你只需输入命令，无需自己编写提示词：

命令功能说明
/asa-review每周例行检查——方向、安装量对比、异常数据及下一步行动
/asa-audit只读账户健康状态或实时结构审计
/asa-bids按同期群 ROAS 审查并调整出价
/asa-budget跨广告系列重新分配预算
/asa-harvest将搜索词归集为精确匹配关键词和否定关键词
/asa-negatives从搜索词中挖掘范围最窄的安全否定关键词
/asa-opportunities从市场情报中发现竞品关键词机会
/asa-cpp将关键词意图路由至现有自定义产品页及广告
/asa-launch规划并启动新的 Apple Search Ads 广告系列

Slash commands install with the Claude Code plugin. In other tools, ask for the same jobs in plain language — the skills carry the same playbooks.

示例提示词

这些技能本身已经包含了相关命令、执行顺序以及哪些操作会产生费用，因此提示词无需逐一说明这些内容。只需告诉技能它无法自行判断的部分：你用来衡量广告系列的数据指标与时间窗口、用于对比的基准值，以及你期望的答案形式。

审查已运行的账户

当广告活动已上线、你想了解资金流向时使用此功能。所有操作均为只读命令，不会对账户做任何更改。

Audit my Apple Search Ads account and tell me what needs my attention. This is
read-only — don't change anything.

Judge campaigns on cohort net ROAS over the last 30 days against a 3:1
benchmark, since Adapty attributes real subscription revenue back to the
campaign that drove it. Cover campaigns, keywords, the search terms I'm
matching on, and what my active automations do.

Serving status and the reasons a campaign isn't serving come back on the
metrics rows, not from campaigns list.

Then report back in plain language:
- what's blocked and how to unblock it
- net ROAS per campaign against the benchmark
- the top 3 places I'm wasting money
- the top 3 growth opportunities
- the changes you'd make, each as the exact command with its current and new
  value, for me to approve one at a time

I'm not an Apple Ads expert. Assume I'm smart but busy.

启动您的第一批广告系列

当 Apple Ads 帐户为空时使用此功能。该操作符技能会默认创建暂停状态的广告系列，在您阅读计划之前，此提示会保持该状态。

I want to launch Apple Search Ads for my app from scratch. I'm not an Apple
Ads expert — guide me and build it for me. Create everything paused.

Interview me first, briefly: what my app does and who it's for, which
countries to start in, my monthly test budget, and my target cost per
subscriber. If I don't know that last one, work it back from my price and
expected trial conversion.

Then propose a starter structure as a table before you create anything: a
brand campaign, a generic campaign, a competitor campaign if I name
competitors, and a small discovery campaign to mine search terms. For each
one give me a one-line reason it exists, its share of the budget, its ad
groups, a starter keyword list with match types and bids, and the negative
keywords to share across all of them.

Build it once I approve, then show me what was created.

Finish with a launch checklist: what I still have to fix in the Apple Search
Ads console before anything can serve, such as a payment method or a pending
tax verification; how to switch the campaigns on when I'm ready; and one
automation rule worth adding after a week of data. Then tell me to come back
in 7 days for a performance review.

与 AI Agent 的区别

Adapty Ads Manager 在看板中还内置了一个 AI Agent。两者满足不同的需求：

AI AgentApple Ads 插件
运行位置Adapty 看板你的终端，在 AI 编程工具中
功能分析并提供建议分析、提供建议并执行命令
配置无需配置需安装 Adapty CLI 及插件

如果你只是想了解账户的情况，使用 AI Agent；如果你还想让变更自动执行，使用插件。

下一步