apple-search-ads
eronred/aso-skills
Set up, optimize, and scale Apple Search Ads campaigns with keyword bidding, match types, and ROAS targeting.
What is apple-search-ads?
Apple Search Ads (ASA) is the App Store's native ad platform for reaching users with high purchase intent through keyword-based search. Use this skill to structure campaigns, manage bids, configure Creative Product Sets, and optimize for install volume and profitability.
- Design account structure with separate campaigns for Brand, Competitor, Category, and Discovery intent
- Configure exact, broad, and Search Match keyword strategies with weekly optimization workflows
- Set starting bids and automated bidding rules based on campaign type and performance signals
- Link Custom Product Pages (CPPs) to ad groups for keyword-specific creative routing
- Monitor TTR, CVR, CPI, and ROAS metrics with weekly optimization and scaling checklists
- Audit campaign performance and identify high-impact fixes
How to install apple-search-ads
npx skills add https://github.com/eronred/aso-skills --skill apple-search-adsHow to use apple-search-ads
- 1.Set up account structure with separate campaigns for Brand, Competitor, Category, and Discovery (Search Results placement first)
- 2.Build keyword seed lists per campaign type using Appeeky or similar tools to validate volume and difficulty
- 3.Set starting bids: Brand $2–5, Competitor $1–2, Category $0.80–1.50, Discovery $0.50–0.80
- 4.Create Custom Product Pages for keyword-specific creatives and link them to ad groups
- 5.Execute weekly optimization: review search terms, add negatives, adjust bids for impression share, pause zero-install keywords, test new CPP variants
- 6.Monitor TTR (>5%), CVR (>30%), and CPI metrics; scale budget only after validating stability and profitability
Use cases
- Launch a new ASA campaign with proper structure and initial keyword seed lists
- Optimize underperforming ad groups by adjusting bids, creatives, and negative keywords
- Scale budget safely by validating CVR thresholds and bid stability before increasing spend
- Route keyword-specific creatives using Custom Product Pages to improve tap-through and conversion rates
- Mine search terms reports weekly to promote high-performing broad/Search Match terms to exact match campaigns
- Mobile app marketers managing user acquisition budgets
- App growth teams optimizing for install volume and ROAS
- Product managers evaluating App Store paid channels
- ASA campaign managers scaling campaigns profitably
apple-search-ads FAQ
Start with manual bidding to establish a baseline. Switch to automated bidding (target CPA or ROAS) only after a campaign has 50+ conversions per ad group per week and manual bidding has proven stable.
Search Results (below organic results) has the highest intent and is most measurable—start here. Search Tab (top of search before typing) is for brand awareness. Today Tab (home page) is for high-visibility brand moments. Product Pages target competitors and related apps.
Low TTR (<3%) suggests creative mismatch. Test new Custom Product Pages with keyword-specific screenshots, or review if your keyword intent aligns with your app positioning.
Add competitor names you're not targeting, irrelevant terms from Search Match (review weekly), and high-impression zero-tap keywords to prevent wasted spend.
Scale only when CVR >30%, CPI <3× your target, bid strategy is stable and manual, negative keywords are maintained, and you've tested at least 2 Custom Product Page variants.
Full instructions (SKILL.md)
Source of truth, from eronred/aso-skills.
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:
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 ASAscreenshot-optimization— Build CPPs for keyword-specific creativesab-test-store-listing— Test product page CVR before scaling spend
Related skills
More from eronred/aso-skills and the wider catalog.

asc-metrics
When the user wants to analyze their own app's actual performance data from App Store Connect — real downloads, revenue, IAP, subscriptions, trials, or country breakdowns synced via Appeeky Connect. Use when the user asks about "my downloads", "my revenue", "how is my app performing", "ASC data", "sales and trends", "my subscription numbers", "App Store Connect metrics", or wants to compare periods or top markets. For third-party app estimates, see app-analytics. For subscription analytics depth, see monetization-strategy.

aso-audit
Comprehensive App Store Optimization health audit with scoring framework and prioritized action plan.

attribution-setup
When the user wants to set up, debug, or interpret app install attribution — including SKAdNetwork (SKAN), Apple's AdAttributionKit, Google Play Install Referrer, MMPs (AppsFlyer, Adjust, Singular, Branch, Kochava), deep links, deferred deep links, conversion values, postback windows, or privacy thresholds. Use when the user mentions "SKAdNetwork", "SKAN", "SKAN 4", "AdAttributionKit", "AAK", "MMP", "AppsFlyer", "Adjust", "Singular", "Branch", "attribution", "conversion value", "postback", "Install Referrer", "deferred deep link", "iOS 14.5", "ATT", "App Tracking Transparency", "IDFA", or "I can't measure my ad campaigns". For paid campaign strategy, see ua-campaign and apple-search-ads. For analytics events, see app-analytics.

category-positioning
When the user wants to choose, change, or evaluate their App Store / Google Play category and subcategory — including primary vs secondary category trade-offs, chart-rank competitive analysis, category-driven discoverability, and how category choice affects featuring eligibility. Use when the user mentions "which category", "App Store category", "primary category", "secondary category", "change my category", "Health & Fitness vs Lifestyle", "Productivity vs Utilities", "rank higher in a smaller category", "category chart", "subcategory", "Play Store category", or "should I switch categories". For full ASO health beyond category, see aso-audit. For competitor analysis within the chosen category, see competitor-analysis. For chart movements within categories, see market-movers.

competitor-analysis
Analyze competitors' App Store strategy, identify keyword gaps, and find positioning opportunities.

competitor-tracking
When the user wants to monitor competitor apps on an ongoing basis — tracking metadata changes, keyword shifts, screenshot updates, rating trends, or new features. Use when the user mentions "competitor monitoring", "track competitors", "competitor alert", "competitor changed their title", "watch a competitor app", "competitor weekly report", "competitive intelligence", or "what changed in competitor's listing". For a one-time deep competitive analysis, see competitor-analysis. For market-wide chart movements, see market-movers.