SkillAgentSearch skills...

apple-search-ads

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

Install / Use

npx skills add appeeky/aso-skills --skill apple-search-ads

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

93/100

Category

Marketing

Supported Platforms

Universal

Tags

Our assessment of apple-search-ads

apple-search-ads scores 93/100 on our quality scale, 143rd of 642 Marketing skills we index (top 23%).

Its SKILL.md is 7.2 KB long, well organised into 20 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.

With 2,095 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
14/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 3 months ago, so apple-search-ads is actively maintained.
  • Our last check on 2026-10-26 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

apple-search-ads compared with similar skills

All 4 of these similar skills score higher than apple-search-ads; compare them before choosing.

SkillScoreStarsUpdatedFormat
apple-search-ads (this skill)by appeeky932.1k3mo agoSKILL.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md
designby nextlevelbuilder100149.0k6d agoSKILL.md

Frequently asked questions

How do I install apple-search-ads?
Run npx skills add appeeky/aso-skills --skill apple-search-ads. The install tabs above show the steps for each supported agent.
Which AI agents does apple-search-ads work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is apple-search-ads safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is apple-search-ads still maintained?
The repository was last updated about 3 months ago, so apple-search-ads is actively maintained.

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 ASA
  • screenshot-optimization — Build CPPs for keyword-specific creatives
  • ab-test-store-listing — Test product page CVR before scaling spend

Related Skills

View on GitHub
GitHub Stars2.1k
CategoryMarketing
Updated2mo ago
Forks126

Languages

MDX

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions