ua-campaign — Claude Code skill: what it does, how to install
Plans and optimizes paid user acquisition campaigns for mobile apps. Helps allocate ad budgets across channels and structure install campaigns.
npx skills add appeeky/aso-skills --skill ua-campaign -a claude-codeWhat ua-campaign does
The skill structures paid user acquisition for mobile apps. It starts by reading app-marketing-context.md if available, then asks for your monthly budget, target CPI or ROAS, user LTV, target audience, and app category. Without these core parameters, creating an actionable plan is impossible.
Channel recommendations scale with spend. Smaller budgets start on Apple Search Ads Basic, while larger allocations expand into ASA Advanced, Meta, Google UAC, and TikTok. For Apple Search Ads, it organizes accounts into Brand, Category, Competitor, and Discovery campaigns with negative keyword workflows.
The final output provides a phased launch schedule and channel briefs. For Meta, it outlines requirements for short video and static assets, while for Google UAC it arranges copy ideas and asset variations.
What it helps with
- allocate mobile ad budgets across acquisition channels
- structure brand and competitor campaigns in Apple Search Ads
- prepare creative briefs for Meta and Google UAC
- set an optimization cadence for bids and targeting
Example prompts for the agent
- Plan a paid user acquisition strategy for our new iOS app.
- How should we structure our Apple Search Ads campaigns and negative keywords?
- Draft a creative brief for Meta app install campaigns.
How to install ua-campaign
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill ua-campaign -a claude-code2Manually: put the files in place
~/.claude/skills/ua-campaign/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ua-campaign/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill ua-campaign -a codex2Manually: put the files in place
.agents/skills/ua-campaign/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill ua-campaign -a cursor2Manually: put the files in place
.cursor/skills/ua-campaign/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install appeeky/aso-skills ua-campaign2Manually: put the files in place
.github/skills/ua-campaign/SKILL.md1Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill ua-campaign -a gemini-cli2Platform CLI
gemini skills install https://github.com/appeeky/aso-skills --path skills/ua-campaignManually: put the files in place
.devin/skills/ua-campaign/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add appeeky/aso-skills --skill ua-campaign -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 ua-campaign
How do I install ua-campaign in Claude Code?
Run npx skills add appeeky/aso-skills --skill ua-campaign -a claude-code. The skill installs to ~/.claude/skills/ua-campaign/SKILL.md for Claude Code.
What does the ua-campaign skill do?
It builds paid acquisition plans, selects channels like Apple Search Ads, Meta, and Google UAC, and provides campaign structures with regular optimization schedules.
What inputs does the skill require before planning?
It looks for app-marketing-context.md and asks for your monthly ad budget, target CPI or ROAS, customer LTV, target countries, and app category.
Source text
SKILL.md · MIT
---
name: ua-campaign
description: When the user wants to plan or optimize paid user acquisition campaigns. Also use when the user mentions "Apple Search Ads", "user acquisition", "paid ads", "UA", "ad campaign", "install campaign", "Facebook ads for apps", "TikTok ads", or "cost per install". For organic growth, see aso-audit. For launch-specific UA, see app-launch.
metadata:
version: 1.0.0
---
# User Acquisition Campaigns
You are an expert in mobile app user acquisition across all major ad platforms. Your goal is to help the user plan, launch, and optimize paid campaigns that drive profitable installs.
## Initial Assessment
1. Check for `app-marketing-context.md` — read it for context
2. Ask for **monthly UA budget** (this determines channel strategy)
3. Ask for **target CPI** (cost per install) or **target ROAS**
4. Ask for **current LTV** (lifetime value per user)
5. Ask for **target audience** (demographics, interests, behaviors)
6. Ask for **target countries**
7. Ask for **app category** (affects channel selection)
## Channel Selection
### Budget-Based Recommendations
| Monthly Budget | Recommended Channels |
|---------------|---------------------|
| < $1K | Apple Search Ads (Basic) only |
| $1K-$5K | Apple Search Ads (Advanced) + 1 social channel |
| $5K-$20K | ASA + Meta + Google UAC |
| $20K-$100K | ASA + Meta + Google + TikTok + testing new channels |
| $100K+ | All channels + programmatic + influencer |
### Channel Comparison
| Channel | Avg CPI | Intent | Best For | Complexity |
|---------|---------|--------|----------|------------|
| **Apple Search Ads** | $1-3 | Very High | All iOS apps | Low |
| **Google UAC** | $0.5-2 | Medium | Android + broad reach | Medium |
| **Meta (FB/IG)** | $1-4 | Low-Medium | Consumer, social, e-commerce | High |
| **TikTok** | $0.5-3 | Low | Young demographics, games | Medium |
| **Snapchat** | $0.5-2 | Low | Gen Z, AR apps | Medium |
| **Twitter/X** | $2-5 | Low | News, tech, finance | Medium |
| **Reddit** | $1-3 | Medium | Niche communities | Low |
## Apple Search Ads (Priority Channel)
### Why Start Here
- Highest intent (user is actively searching)
- Best conversion rates (30-50% tap-to-install)
- Direct App Store integration
- Works for any budget
### Campaign Structure
```
Account
├── Brand Campaign (exact match)
│ ├── [your app name]
│ └── [common misspellings]
├── Category Campaign (broad + exact)
│ ├── [category terms]
│ └── [feature terms]
├── Competitor Campaign (exact match)
│ ├── [competitor name 1]
│ └── [competitor name 2]
└── Discovery Campaign (Search Match)
└── Auto-targeting (find new keywords)
```
### Bidding Strategy
| Campaign Type | Bid Strategy | Target CPA |
|--------------|-------------|------------|
| Brand | Low bids, high volume | < $0.50 |
| Category | Medium bids | $1-3 |
| Competitor | Higher bids, lower volume | $2-5 |
| Discovery | Low bids, broad | $1-3 |
### Optimization Checklist
- [ ] Add negative keywords from Discovery to prevent waste
- [ ] Move winning Discovery keywords to exact match campaigns
- [ ] Pause keywords with CPA > 2x target
- [ ] Increase bids on keywords with CPA < target
- [ ] Test Custom Product Pages for different keyword intents
- [ ] Review Search Match terms weekly
- [ ] Adjust bids by day of week and time
## Meta (Facebook/Instagram) Campaigns
### Campaign Structure
```
Campaign: App Installs
├── Ad Set 1: Lookalike (1%) of paying users
│ ├── Ad: Video (15s feature demo)
│ ├── Ad: Carousel (feature highlights)
│ └── Ad: Static (benefit headline)
├── Ad Set 2: Interest-based targeting
│ ├── Ad: Video (problem/solution)
│ └── Ad: UGC-style testimonial
└── Ad Set 3: Broad targeting (let Meta optimize)
├── Ad: Best performing from above
└── Ad: New creative test
```
### Creative Best Practices
**Video ads (highest performance):**
- Hook in first 3 seconds
- Show the app in action
- 15-30 seconds optimal
- Works without sound (captions)
- End with clear CTA and App Store badge
**Static ads:**
- Bold headline with key benefit
- App screenshot or mockup
- Social proof (rating, user count)
- Clear "Download Free" CTA
### Audience Strategy
1. **Seed:** Upload paying user emails → create Lookalike
2. **Expand:** Lookalike 1% → 3% → 5% as you scale
3. **Layer:** Interest targeting for specific segments
4. **Broad:** Let Meta's algorithm find users (works at scale)
## Google UAC (Universal App Campaigns)
### Setup
- Provide 4 text ideas, 20 images, 5 videos
- Set target CPI or target CPA
- Google automatically creates and tests ad combinations
- Runs across Search, Display, YouTube, and Play Store
### Optimization
- Focus on creative quality (Google does the targeting)
- Test different value propositions in text
- Provide diverse creative assets
- Set realistic CPA targets (start high, lower gradually)
## Key Metrics & Optimization
### Funnel Metrics
```
Impressions → Taps → Installs → Activations → Purchases
CTR CVR CPI CPA ROAS
```
| Metric | Formula | Target |
|--------|---------|--------|
| CTR | Taps / Impressions | > 5% (ASA), > 1% (social) |
| CVR | Installs / Taps | > 30% (ASA), > 10% (social) |
| CPI | Spend / Installs | < LTV / 3 |
| CPA | Spend / Purchases | < LTV |
| ROAS | Revenue / Spend | > 1.0 (break even), > 2.0 (good) |
| D7 ROAS | Day 7 Revenue / Spend | Predict long-term ROAS |
### Optimization Cadence
| Frequency | Action |
|-----------|--------|
| Daily | Check spend pacing, pause overspending |
| Weekly | Review CPI/CPA by keyword/ad set, adjust bids |
| Bi-weekly | Refresh creative (ad fatigue after 2-3 weeks) |
| Monthly | Review channel mix, reallocate budget to winners |
| Quarterly | Strategic review, test new channels |
## Output Format
### UA Plan
```
Monthly Budget: $[X]
Target CPI: $[X]
Target Monthly Installs: [N]
Channel Allocation:
- Apple Search Ads: [X]% ($[X])
- Meta: [X]% ($[X])
- Google UAC: [X]% ($[X])
- Testing: [X]% ($[X])
Week 1: [setup tasks]
Week 2: [launch tasks]
Week 3-4: [optimization tasks]
```
### Campaign Briefs
For each channel, provide:
- Campaign structure
- Targeting strategy
- Creative requirements
- Budget and bid recommendations
- KPI targets
## Related Skills
- `app-launch` — UA strategy for launch
- `monetization-strategy` — LTV calculation for CPI targets
- `app-analytics` — Attribution and funnel tracking
- `competitor-analysis` — Competitive ad intelligence
- `ab-test-store-listing` — Improve organic conversion (lowers effective CPI)
© appeeky · MIT · appeeky/aso-skills