apple-ads

Operate Apple Search Ads campaigns through the Adapty CLI with cohort revenue metrics.

Updated Aug 16, 2026
One-click install
npx skills add https://github.com/adaptyteam/apple-ads-cli --skill apple-ads-adaptyteam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: apple-ads
Source: https://github.com/adaptyteam/apple-ads-cli/tree/main/skills/apple-ads
Command: npx skills add https://github.com/adaptyteam/apple-ads-cli --skill apple-ads-adaptyteam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Apple's own ads tooling reports spend, taps, and installs but cannot show what an install was worth weeks later. This Skill connects Apple Search Ads performance to Adapty subscription revenue so an agent can answer which keywords actually pay back by cohort ROAS, and then safely act on that answer. ## Core Features & Use Cases - Cohort profitability analysis: Rank keywords and campaigns by net ROAS at day-7, day-30, or day-90 windows using --by-days cohort metrics, not install counts. - Full account operation: Review performance, adjust bids and budgets, harvest search terms into Exact keywords, mine negative keywords, route intents to custom product pages, launch campaigns, and configure rule automations — all with mandatory confirmation before any spend. - Competitor keyword discovery: Pull per-app, per-country Market Intelligence terms and share of voice for up to five competitor App Store ids, then compare against live inventory. - Use Case: Ask which keywords are profitable at day 30; the Skill runs one server-side metrics call ranked by net_roas, separates payers from losers from insufficient-data rows, and proposes bid changes only after you confirm the exact targets. ## Quick Start Ask the agent to run a weekly review of your Apple Ads account and show which keywords pay back at day 30 by net ROAS.

Frequently Asked Questions about apple-ads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find which Apple Search Ads keywords are actually profitable?▼

Run a cohort ROAS query with adapty asa metrics using --metric roas, --by-days windows like 7, 30, and 90, and rank with --order-by net_roas. This ranks keywords by subscription revenue observed at each renewal window, not by install count.

How do I change keyword bids in Apple Search Ads from the CLI?▼

Use adapty asa keywords update with the keyword ids from a scoped keywords list, after agreeing on a success metric and target. Group only keywords receiving the identical change, use a fresh idempotency key per write, and read the keywords back to verify.

Does this Skill require an Adapty subscription?▼

Yes, operating the account requires the adapty CLI, an authenticated Adapty account, and an Ads Manager subscription; without one the API returns 402 ads_manager_subscription_required. For planning without an account, use the apple-ads-strategy skill instead.

Why does my Apple Ads command return 429 errors?▼

A 429 means the per-company rate budget is exhausted: cli_analytics_busy indicates the shared analytics pool is occupied, cli_rate_limit_exceeded a full per-minute window, and cli_cooldown_active an escalating 5m to 3h lockout. The CLI already retried once, so reduce calls instead of looping.

Can I delete or undo a campaign created through the CLI?▼

No. The asa surface has no delete command and no undo; the only stop is setting --status PAUSED. That is why every write requires a named proposal, explicit confirmation, and an idempotency key before execution.

What is the difference between apple-ads and apple-ads-audit?▼

apple-ads is the operator: it reads performance and makes confirmed writes such as bids, budgets, and keywords. apple-ads-audit is read-only and handles account health checks, live structure diagnostics, and duplicate Exact keyword detection without ever writing.