Manage Apple Ads with an AI coding tool

The ads-manager skill 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. This one carries 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.

What it will not do

The skill 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.

The skill recommends and prepares commands. Reading metrics and dry runs cost nothing, but you stay responsible for approving anything that changes a live ad account.

Install the skill

The ads-manager skill teaches your AI coding tool to operate Apple Ads through the adapty asa commands. It knows the order commands compose in, what to read before writing anything, and which calls spend money.

Supported tools: Claude Code, GitHub Copilot CLI, OpenAI Codex, Gemini CLI.

The skill drives 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.

In a corporate Cowork workspace, an administrator must add both adapty.io and *.adapty.io to the domain allowlist. List both: a wildcard does not cover the apex domain in most allowlist implementations, and the apex is where the documentation the skill reads lives. Until both are allowed, the skill cannot reach Adapty.

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

Claude Code

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

This plugin also contains the SDK integration skill. Both are installed together.

GitHub Copilot CLI

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

Gemini CLI

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

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

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

--all installs both skills into every agent it detects. For this skill on its own, use --skill ads-manager.

Alternatively, clone the repo and copy the directories under skills/ into your tool’s skills directory — or just skills/ads-manager/ if you only want this one.

After installing, run the skill in your project:

/ads-manager

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

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	ads-manager skill
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 skill

Use the AI Agent to ask what is happening in your account. Use the skill 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.