The Apple Ads plugin lets an AI coding tool operate your Apple Ads account through the Adapty CLI. Ask it a question in plain language, and it works out which commands answer it, reads the account first, and proposes the write before anything reaches Apple.

A skill is a set of instructions your AI tool loads on demand. The plugin ships three of them — an operator that runs your account, a read-only auditor, and a strategy planner — plus playbooks for recurring jobs like weekly check-ins, cohort ROAS reviews, and budget reallocation, vertical guides with category-specific keyword taxonomies and starting economics, and slash commands that turn the most common jobs into one-liners. Together they carry the parts of the Ads Manager surface that are easy to get wrong: which identifier each flag accepts, which filter each list takes, how many keywords fit in a batch, and which calls cost money.

What it handles

• Reading performance: Picks the single call that answers a question instead of paging through results. It knows that a top-N question is one ordered call, and that counting entities needs no metrics call at all.
• Structural changes: Creates and updates campaigns, ad groups, ads, and keywords in the right order, reading the parent entity before writing the child.
• Keyword work: Adds and re-bids keywords in batches, and harvests search terms into keywords and negative keywords.
• Automations: Sets up rule-based automations and dry-runs them before they touch live bids.
• Competitor research: Pulls the keywords competing apps bid on.
• Account audits: The apple-ads-audit skill checks account health, serving status, structure, and duplicate keywords without changing anything.
• Planning from scratch: The apple-ads-strategy skill designs an account structure, keyword taxonomy, and starting budgets from a description of your app — no Apple Ads account or CLI required.

What it will not do

The plugin treats every write as irreversible, because it is — the CLI has no delete, and changes reach Apple within seconds.

• It reads before it writes, rather than guessing an ID or a budget.
• It asks before any command that spends money, and it leaves the CLI’s own confirmation prompt in place when you are the one running the command.
• It pins an idempotency key on each write in a chain, so a re-run after an unclear result does not create a second campaign.
• It prefers small batches, so a partial rejection from Apple stays easy to read.

Install the plugin

The Apple Ads plugin teaches your AI coding tool to operate Apple Ads through the adapty asa commands. It ships three skills:

• apple-ads: The operator. It reads performance, changes bids and budgets, adds keywords and negatives, harvests search terms, and launches and pauses campaigns — with confirmation before anything spends money.
• apple-ads-audit: A read-only auditor. It checks account health, serving status, structure, traffic ownership, and duplicate exact-match keywords, and never writes.
• apple-ads-strategy: A planner that needs no account, CLI, or subscription. It turns a description of your app into an account structure, a keyword taxonomy, starting budgets, and a negative keyword list.

Supported tools: Claude Code, Claude Cowork, GitHub Copilot CLI, OpenAI Codex, Gemini CLI, and any other tool that supports skills.

The operator and auditor drive the Adapty CLI, so install and authenticate the CLI first — see the quickstart guide. The adapty asa commands ship in Adapty CLI 0.4.0 and newer; on an older version they do not exist at all. Check with adapty asa whoami, which also tells you whether an Apple Ads account is connected and whether the company has an active Ads Manager subscription. The strategy skill works without any of this.

Claude Cowork runs the CLI in a sandbox that blocks every domain outside its allowlist. Allow the Adapty domains before you install the plugin there — see Set up the Adapty CLI in Claude Cowork. A Cowork task also starts on a clean machine, so the CLI and its login don’t carry over between sessions — the plugin’s adapty-cli-setup skill installs and authenticates the CLI again at the start of each one.

To install, pick the form for your tool. The full list is in the plugin README.

Claude Code

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

Besides the skills, the Claude Code plugin installs /asa-* slash commands — ready-made prompts for common jobs, like /asa-review for the weekly check-in and /asa-harvest for turning search terms into keywords and negatives.

Any other tool — use the skills CLI (note that skills installed this way don’t update automatically):

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

--all installs all three skills into every agent it detects. For one skill on its own, use --skill, for example --skill apple-ads-strategy.

After installing, run a skill in your project — either directly or through one of the slash commands:

/apple-ads

Reading metrics and dry runs cost nothing. Every other command reaches Apple within seconds, spends real money, and cannot be undone — the skills ask before each one, and so should you.

Benchmarks plugin

The same marketplace carries an optional companion, apple-ads-benchmarks — Adapty’s published Apple Ads baselines for subscription apps, packaged as local data your AI tool can query: tap-through rate, conversion rate, CPT, and CPA across 90 countries, 22 App Store genres, and 59 niches, plus subscriber economics like year-one LTV. It works entirely offline, so it needs no Apple Ads account, no CLI, and no Adapty subscription.

Use it to judge whether a number is a problem before digging into the account: “Is a $4 CPT high for a fitness app in Germany?” is a benchmarks question first.

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

Slash commands

In Claude Code, the plugin also adds nine /asa-* commands. Each one is a ready-made prompt that picks the right skill and playbook for a common job, so you type the command instead of writing the prompt yourself:

Command	What it does
/asa-review	Weekly check-in — direction, install comparison, outliers, and one action
/asa-audit	Read-only account health or live structure audit
/asa-bids	Review and adjust bids by cohort ROAS
/asa-budget	Reallocate budget across campaigns
/asa-harvest	Harvest search terms into exact keywords and negative keywords
/asa-negatives	Mine search terms for the narrowest safe negative keywords
/asa-opportunities	Find competitor keyword opportunities from Market Intelligence
/asa-cpp	Route a keyword intent to an existing Custom Product Page and ad
/asa-launch	Plan and launch a new Apple Search Ads campaign

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.

Example prompts

The skills already carry the commands, the order they compose in, and which ones spend money, so a prompt doesn’t have to spell any of that out. Write the prompt for what a skill can’t work out on its own: the metric and window you judge campaigns by, the benchmark you compare them against, and the shape of the answer you want back.

Audit an account you already run

Use this when campaigns are live and you want to know where the money goes. Every command it needs is a read, so nothing in your account changes.

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.

Launch your first campaigns

Use this when the Apple Ads account is empty. The operator skill creates campaigns paused by default, and this prompt holds it to that until you’ve read the plan.

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.

How it differs from the AI Agent

Adapty Ads Manager also has a built-in AI Agent in the dashboard. The two answer different needs:

	AI Agent	Apple Ads plugin
Where it runs	The Adapty dashboard	Your terminal, in your AI coding tool
What it does	Analyzes and recommends	Analyzes, recommends, and runs the commands
Setup	None	Adapty CLI plus the plugin

Use the AI Agent to ask what is happening in your account. Use the plugin when you want the change carried out as well.

What’s next

• Manage Ads Manager from the CLI — the same tasks by hand, without an AI tool.
• Ads Manager commands — every command with its arguments, flags, and accepted values.