Agent skill

Apple Search Ads

by appeeky in appeeky/aso-skills

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…

MITAuto-check passedMarketing & SEO

Install Apple Search Ads

skills CLI
$ npx skills add appeeky/aso-skills --skill apple-search-ads -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install appeeky/aso-skills apple-search-ads --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/appeeky/aso-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/apple-search-ads .claude/skills/apple-search-ads && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apple-search-ads
GitHub stars
2.2k
Token cost
~1.8k tokens
SKILL.md length
622 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Wants to set up
  • SKILL.md covers Why ASA Is Different, Campaign Types, Account Structure and Match Types, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Scale Apple Search Ads (ASA) campaigns — including keyword bidding

What it does

Apple Search Ads is an agent skill from appeeky/aso-skills. 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.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering App store release and Paid advertising. It works with C++ and TikTok. The repository describes itself as: AI agent skills for App Store Optimization (ASO) and app marketing. Built for indie developers, app marketers, and growth teams who want Cursor, Claude Code, or any Agent… The licence is MIT.

When your agent uses it

  • Wants to set up
  • Scale Apple Search Ads (ASA) campaigns — including keyword bidding
  • Campaign structure
  • Creative Product Sets

Example prompts

  • “Apple Search Ads”
  • “Search Ads”
  • “Search tab ads”
  • “/apple-search-ads”

What it can do on your machine

Read from SKILL.md and the folder at commit 3919d7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Apple Search Ads loads about 1.8k tokens when it runs. Until then it costs about 122 tokens; SKILL.md has 622 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~122
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from appeeky/aso-skills at commit 3919d7c, republished under its MIT licence (© appeeky). 622 words, ~1,837 tokens.

Download SKILL.mdSave it as .claude/skills/apple-search-ads/SKILL.md (or your agent's skills folder).
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

PlacementWhere it appearsBest for
Search ResultsBelow the first organic result for a keywordKeyword-specific intent capture
Search TabTop of the Search tab before user typesBrand awareness, broad reach
Today TabApp Store home pageHigh-visibility brand moments
Product PagesCompetitor and related app pagesCompetitive 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 TypeHow it worksUse for
ExactOnly triggers on exact keywordHigh-value, proven terms
BroadTriggers on variations, related termsDiscovery
Search MatchApple auto-matches your app to relevant searchesDiscovery 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
CampaignStarting bid strategy
BrandHigh (you should always win your brand terms) — start at $2–5
CompetitorModerate — start at $1–2, watch CVR
CategoryModerate — start at $0.80–1.50
DiscoveryLow — start at $0.50–0.80
Show full SKILL.md (236 more words)Show less
Bid Optimization Signals
SignalAction
Low impression share (<50%)Increase bid
High TTR but low conversionImprove product page or paywall
Low TTRCreative may not match keyword intent
High CVR but spend not scalingIncrease bid or budget cap
CPT rising with no CVR improvementReduce 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

MetricFormulaBenchmark
TTRTaps / Impressions> 5% strong; < 3% investigate creative
CVRInstalls / Taps> 50% good; < 30% review product page
CPTSpend / TapsVaries by category
CPISpend / InstallsVaries; compare to LTV
ROASRevenue / 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]
  • 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. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/apple-search-ads of appeeky/aso-skills.

Open the folder on GitHubat commit 3919d7c

Compare with similar skills

Apple Search Ads next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apple Search Ads compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Search Ads this skillappeeky/aso-skills2.2k—~1.8kAutomated safety check: PassMIT
Custom Product Pagesgustavscirulis/snapgrid1161 repos~2.2kAutomated safety check: PassCustom licence
Gingiris Aso GrowthGingiris-1031/Competitor-analysis-tool110—~1.3kAutomated safety check: PassNone
Paid Ads AuditAgriciDaniel/claude-ads9.9k—~1.5kAutomated safety check: PassMIT
Marketing OsYuzzyuk/marketing-os540—~2.5kAutomated safety check: PassMIT
Ad Spend Allocatoririnabuht12-oss/marketing-skills4.1k—~1.3kAutomated safety check: PassNone

Similar skills

  • Custom Product Pages

    gustavscirulis/snapgrid

    Generates Custom Product Page metadata templates with screenshot strategies, keyword targeting, and audience-specific messaging for up to 35 page variants.

    116 GitHub starsUsed in 1 repo~2.2k tokens
    Marketing & SEOAuto-check passed
  • Gingiris Aso Growth

    Gingiris-1031/Competitor-analysis-tool

    🇺🇸 ASO & Mobile App Growth Playbook 2026 — Complete App Store Optimization guide.

    110 GitHub stars~1.3k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Paid Ads Audit

    AgriciDaniel/claude-ads

    Runs a source-grounded paid advertising audit across up to 12 ad platforms, with parallel platform workers, deterministic scoring and a versioned JSON bundle.

    9.9k GitHub stars~1.5k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Marketing Os

    Yuzzyuk/marketing-os

    A complete marketing department in one skill. An agent skill from Yuzzyuk/marketing-os.

    540 GitHub stars~2.5k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Ad Spend Allocator

    irinabuht12-oss/marketing-skills

    Multi-channel budget optimization using MER, marginal ROAS, and diminishing returns analysis.

    4.1k GitHub stars~1.3k tokensUpdated 16 days ago
    Marketing & SEOAuto-check passed
  • Ad Creative

    coreyhaines31/marketingskills

    When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform.

    54k GitHub stars~6.3k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from appeeky/aso-skills

All 39 skills in this repo
  • Ab Test Store Listing

    appeeky/aso-skills

    When the user wants to A/B test App Store product page elements to improve conversion rate.

    2.2k GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • Android Aso

    appeeky/aso-skills

    When the user wants to optimize their Google Play Store listing — title, short description, full description, keywords, ratings, or Play Store-specific features.

    2.2k GitHub stars~1.7k tokensUpdated 4 days ago
    Auto-check passed
  • App Analytics

    appeeky/aso-skills

    When the user wants to set up, interpret, or improve their app analytics and tracking.

    2.2k GitHub stars~1.6k tokensUpdated 4 days ago
    Auto-check passed
  • App Clips

    appeeky/aso-skills

    When the user wants to implement, optimize, or use App Clips for app discovery and conversion.

    2.2k GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed
  • App Icon Optimization

    appeeky/aso-skills

    When the user wants to design, test, or improve their app icon to increase tap-through rate and conversions in App Store search and browse.

    2.2k GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check passed
  • App Marketing Context

    appeeky/aso-skills

    When the user wants to create or update their app marketing context document.

    2.2k GitHub stars~910 tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Apple Search Ads

What does Apple Search Ads do?

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…. Apple Search Ads is an agent skill from appeeky/aso-skills. 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.

When should I use Apple Search Ads?

Apple Search Ads fits situations like: wants to set up; scale Apple Search Ads (ASA) campaigns — including keyword bidding; campaign structure; creative Product Sets.

How do I install Apple Search Ads in Claude Code?

Run `npx skills add appeeky/aso-skills --skill apple-search-ads -a claude-code`. Or copy the skill folder (skills/apple-search-ads in appeeky/aso-skills) into .claude/skills/apple-search-ads in your project. Claude Code loads it when a task matches its description.

How do I install Apple Search Ads in Codex?

Run `npx skills add appeeky/aso-skills --skill apple-search-ads -a codex`. Or copy the skill folder (skills/apple-search-ads in appeeky/aso-skills) into .agents/skills/apple-search-ads in your project. Codex loads it when a task matches its description.

Can I use Apple Search Ads in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add appeeky/aso-skills --skill apple-search-ads -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apple-search-ads, .gemini/skills/apple-search-ads, .github/skills/apple-search-ads and .opencode/skills/apple-search-ads in your project.

What does Apple Search Ads need to run?

SKILL.md names no scripts, command-line tools or credentials: Apple Search Ads is instructions for the agent only.

Does Apple Search Ads access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Apple Search Ads safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Apple Search Ads use?

Apple Search Ads is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apple Search Ads use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Apple Search Ads?

Skills that share tags, products or a category with Apple Search Ads: Custom Product Pages (gustavscirulis/snapgrid, 116 stars), Gingiris Aso Growth (Gingiris-1031/Competitor-analysis-tool, 110 stars), Paid Ads Audit (AgriciDaniel/claude-ads, 9.9k stars) and Marketing Os (Yuzzyuk/marketing-os, 540 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Search Ads?

appeeky (a GitHub organization) maintains it in appeeky/aso-skills, which has 2,163 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 6, 2026.

Source: appeeky/aso-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.