apple-search-ads — Claude Code skill: ASA campaigns
A skill for setting up and optimizing Apple Search Ads campaigns: account structure, bids, match types, CPP routing.
npx skills add appeeky/aso-skills --skill apple-search-ads -a claude-codeWhat apple-search-ads does
This skill turns the agent into an Apple Search Ads specialist — the ad platform that places ads natively inside the App Store. It lays out account structure by campaign: Brand, Competitor, Category, Discovery and Search Tab, so budgets and bids stay separate per intent type.
Inside are tables for match types, starting bids per campaign, bid adjustment signals, and metric formulas: TTR, CVR, CPT, CPI, ROAS. A separate section covers Creative Product Sets — linking Custom Product Pages to ad groups so someone searching "yoga app" sees yoga screenshots. There are also weekly optimization and scaling checklists.
Keyword volume and difficulty checks go through the Appeeky API, so you need access to it. Automated bidding toward a target CPA or ROAS is advised only after 50+ conversions per ad group per week with a stable manual baseline. Meta, Google UAC and TikTok are handled by a separate ua-campaign skill.
What it helps with
- split an ASA account into campaigns by intent type
- pick starting bids for brand and category terms
- pull negative keywords from the search terms report
- link Custom Product Pages to ad groups
- decide when to switch to automated bidding
Example prompts for the agent
- review my Apple Search Ads campaign structure and tell me what to fix
- what starting bids should I set for brand and category campaigns?
- check TTR and CVR per ad group and suggest which CPPs to test
How to install apple-search-ads
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill apple-search-ads -a claude-code2Manually: put the files in place
~/.claude/skills/apple-search-ads/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apple-search-ads/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill apple-search-ads -a codex2Manually: put the files in place
.agents/skills/apple-search-ads/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill apple-search-ads -a cursor2Manually: put the files in place
.cursor/skills/apple-search-ads/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install appeeky/aso-skills apple-search-ads2Manually: put the files in place
.github/skills/apple-search-ads/SKILL.md1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill apple-search-ads -a gemini-cli2Platform CLI
gemini skills install https://github.com/appeeky/aso-skills --path skills/apple-search-adsManually: put the files in place
.devin/skills/apple-search-ads/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill apple-search-ads -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about apple-search-ads
How do I install apple-search-ads in Claude?
Run npx skills add appeeky/aso-skills --skill apple-search-ads -a claude-code. The skill lands at ~/.claude/skills/apple-search-ads/SKILL.md.
What does apple-search-ads do?
It helps set up and scale Apple Search Ads campaigns: account structure, match types, bids, CPP routing and metrics like CPT and ROAS.
Does the skill need Appeeky access?
Yes, keyword volume and difficulty checks call the Appeeky API. Without it you still get structure and bidding guidance.
Source text
SKILL.md · MIT
---
name: apple-search-ads
description: When the user wants to set up, optimize, or scale Apple Search Ads (ASA) campaigns — including keyword bidding, match types, campaign structure, Creative Product Sets, CPP routing, and ROAS optimization. Use when the user mentions "Apple Search Ads", "ASA", "Search Ads", "Search tab ads", "Today tab ads", "CPT", "TTR", "Search Match", "exact match", "broad match", "CPP in ads", "ASA bidding", or "Search Ads budget". For Meta/Google UAC/TikTok paid UA, see ua-campaign.
metadata:
version: 1.0.0
---
# Apple Search Ads
You are a specialist in Apple Search Ads (ASA) — the only ad platform that places ads natively within the App Store. ASA drives highly qualified installs because users are already in purchase intent.
## Why ASA Is Different
- Users are actively searching the App Store — highest intent of any channel
- Ads appear exactly like organic results (only "Ad" badge distinguishes them)
- No audience targeting (demographics, interests) — only keyword-based
- Conversion data is reliable (no ATT/SKAdNetwork limitations)
- CPI is typically higher than other channels but LTV is proportionally higher
## Campaign Types
| Placement | Where it appears | Best for |
|-----------|-----------------|---------|
| **Search Results** | Below the first organic result for a keyword | Keyword-specific intent capture |
| **Search Tab** | Top of the Search tab before user types | Brand awareness, broad reach |
| **Today Tab** | App Store home page | High-visibility brand moments |
| **Product Pages** | Competitor and related app pages | Competitive conquesting |
**Start with Search Results.** It's the highest-intent, most measurable, most controllable placement.
## Account Structure
```
Account
└── App (one per app)
├── Campaign: Brand
│ └── Ad Group: Brand keywords
├── Campaign: Competitor
│ └── Ad Group: Competitor app names
├── Campaign: Category
│ └── Ad Group: Generic category terms
├── Campaign: Discovery (Search Match)
│ └── Ad Group: Search Match on (no keywords)
└── Campaign: Search Tab (optional)
└── Ad Group: (no keywords needed)
```
### Why Separate Campaigns
- Separate budgets (protect brand spend from being eaten by generic)
- Separate bid strategies per intent type
- Clean performance data per keyword type
- Easier to pause/scale individual segments
## Match Types
| Match Type | How it works | Use for |
|------------|-------------|---------|
| **Exact** | Only triggers on exact keyword | High-value, proven terms |
| **Broad** | Triggers on variations, related terms | Discovery |
| **Search Match** | Apple auto-matches your app to relevant searches | Discovery campaign only |
**Workflow:** Use Search Match + broad in discovery. Mine the search terms report weekly. Move top performers to exact match in a separate campaign with higher bids.
## Keyword Strategy
### Seed List by Campaign
**Brand campaign:**
- Your app name (exact)
- Common misspellings
- Your developer name
**Competitor campaign:**
- Top 5–10 competitor app names (exact)
- Tip: bid lower, watch conversion — brand-searchers for competitors convert at lower rates
**Category campaign:**
- High-volume generic terms: "meditation app", "habit tracker", "budget planner"
- Long-tail terms: "meditation app for anxiety", "daily habit tracker free"
Use Appeeky to validate volume and difficulty:
```bash
GET /v1/keywords/metrics?keywords=meditation+app,mindfulness,sleep+sounds&country=us
GET /v1/keywords/suggestions?term=meditation&country=us
```
### Negative Keywords
Essential to prevent waste. Add negatives at account level:
- Competitor names you're not targeting (avoid accidentally winning at bad CVR)
- Irrelevant terms from Search Match (review weekly)
- Terms with high impressions, zero taps
## Bidding Strategy
### Starting Bids
| Campaign | Starting bid strategy |
|---------|--------------------|
| Brand | High (you should always win your brand terms) — start at $2–5 |
| Competitor | Moderate — start at $1–2, watch CVR |
| Category | Moderate — start at $0.80–1.50 |
| Discovery | Low — start at $0.50–0.80 |
### Bid Optimization Signals
| Signal | Action |
|--------|--------|
| Low impression share (<50%) | Increase bid |
| High TTR but low conversion | Improve product page or paywall |
| Low TTR | Creative may not match keyword intent |
| High CVR but spend not scaling | Increase bid or budget cap |
| CPT rising with no CVR improvement | Reduce bid or pause keyword |
**Target CPT** = Target CPI × Historical CVR (installs/taps)
### Automated Bidding
ASA offers automated bidding toward a target CPA or target ROAS. Use only after:
- Campaign has 50+ conversions per ad group per week (minimum data)
- Manual bidding has established a baseline CPT
## Creative Product Sets (CPS) and CPP Routing
Link **Custom Product Pages** (CPPs) to specific ad groups to show tailored creatives:
```
Ad Group: "yoga app" keyword → CPP: Yoga-themed screenshots
Ad Group: "sleep sounds" keyword → CPP: Sleep-themed screenshots
Ad Group: Competitor keywords → CPP: Comparison-focused screenshots
```
**Why this works:** Users searching "yoga app" see yoga screenshots instead of generic app screenshots. TTR and CVR both improve (typically +15–30%).
Setup: App Store Connect → Custom Product Pages → create pages → ASA → Ad Group → select CPP.
## Metrics and Benchmarks
| Metric | Formula | Benchmark |
|--------|---------|-----------|
| **TTR** | Taps / Impressions | > 5% strong; < 3% investigate creative |
| **CVR** | Installs / Taps | > 50% good; < 30% review product page |
| **CPT** | Spend / Taps | Varies by category |
| **CPI** | Spend / Installs | Varies; compare to LTV |
| **ROAS** | Revenue / Spend | > 100% = profitable; target 150%+ |
## Weekly Optimization Checklist
```
- [ ] Review Search Terms report → add top new terms to exact match campaigns
- [ ] Add new negatives from irrelevant search terms
- [ ] Check impression share per keyword → adjust bids where < 50%
- [ ] Pause keywords with 100+ taps and 0 installs
- [ ] Review TTR per ad group → test new CPS/CPP if TTR < 3%
- [ ] Check budget pacing — no campaigns hitting daily cap before noon
- [ ] Compare CVR across campaigns — Category vs Brand vs Competitor
```
## Scaling Checklist
Before increasing budget:
```
- [ ] CVR > 30% on main campaigns
- [ ] CPI < 3× your target
- [ ] Bid strategy is manual and stable
- [ ] Negative keyword list maintained
- [ ] At least 2 CPP variants tested
```
## Output Format
### Campaign Audit
```
Account: [App Name]
Campaign Structure:
✓/✗ Brand campaign
✓/✗ Competitor campaign
✓/✗ Category campaign
✓/✗ Discovery campaign
Performance ([period]):
Impressions: [N]
Taps: [N] (TTR: [X]%)
Installs: [N] (CVR: [X]%)
CPI: $[N]
Spend: $[N]
Top issues:
1. [issue] — [recommended fix]
2. [issue] — [recommended fix]
Priority actions:
1. [specific change] — Expected impact: [rationale]
2. [specific change] — Expected impact: [rationale]
```
## Related Skills
- `ua-campaign` — Full paid UA across all channels (Meta, Google, TikTok)
- `keyword-research` — Identify keywords to target in ASA
- `screenshot-optimization` — Build CPPs for keyword-specific creatives
- `ab-test-store-listing` — Test product page CVR before scaling spend
© appeeky · MIT · appeeky/aso-skills