ua-campaign
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.
Best use case
ua-campaign is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
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.
Teams using ua-campaign should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/ua-campaign/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How ua-campaign Compares
| Feature / Agent | ua-campaign | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
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.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
Best AI Agents for Marketing
A curated list of the best AI agents and skills for marketing teams focused on SEO, content systems, outreach, and campaign execution.
SKILL.md Source
# 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)Related Skills
subscription-lifecycle
When the user wants to optimize their subscription business end-to-end — from trial start through renewal, cancellation, and win-back. Use when the user mentions "subscription lifecycle", "trial conversion", "churn", "cancellation", "win-back", "lapsed subscribers", "dunning", "billing retry", "grace period", "renewal rate", "subscriber LTV", or "resubscribe". For paywall design and pricing strategy, see monetization-strategy. For subscription analytics dashboards, see app-analytics.
seasonal-aso
When the user wants to optimize their App Store listing for seasonal events, holidays, or trending moments — including keyword opportunities, metadata updates, screenshot theming, and timing strategy. Use when the user mentions "seasonal", "holiday", "Christmas", "New Year", "Valentine's Day", "summer", "back to school", "seasonal keywords", "trending now", "limited time", or wants to capitalize on a calendar event. For general keyword research, see keyword-research. For full metadata rewrites, see metadata-optimization.
screenshot-optimization
When the user wants to design, optimize, or evaluate App Store screenshots and preview videos. Also use when the user mentions "screenshots", "app preview", "product page design", "screenshot design", "creative assets", or "what should my screenshots show". For A/B testing screenshots, see ab-test-store-listing. For full ASO audit, see aso-audit.
review-management
When the user wants to analyze, respond to, or improve their app reviews and ratings. Also use when the user mentions "reviews", "ratings", "negative reviews", "how to get more reviews", "review response", or "my rating is dropping". For broader ASO audit, see aso-audit. For retention issues causing bad reviews, see retention-optimization.
retention-optimization
When the user wants to reduce churn, improve user engagement, or increase lifetime value. Also use when the user mentions "retention", "churn", "users leaving", "engagement", "DAU/MAU", "user activation", or "why are users uninstalling". For onboarding-specific issues, see app-launch. For monetization, see monetization-strategy.
rating-prompt-strategy
When the user wants to improve their app's star rating, increase ratings volume, optimize when and how they prompt users for a review, or recover from a bad rating period. Use when the user mentions "app rating", "star rating", "review prompt", "SKStoreReviewRequest", "In-App Review API", "ask for review", "low rating", "rating drop", "get more reviews", or "recover from 1-star". For responding to reviews, see review-management. For overall ASO health, see aso-audit.
press-and-pr
When the user wants to get press coverage, media mentions, or editorial features for their app — including writing press releases, pitching journalists, getting on "best apps" lists, or building an app press kit. Use when the user mentions "press", "PR", "media coverage", "TechCrunch", "journalist", "press release", "app press kit", "get featured in media", "editorial coverage", "review from a blogger", or "app launch announcement". For Apple editorial featuring, see app-store-featured. For launch strategy, see app-launch.
onboarding-optimization
When the user wants to improve their app's onboarding experience, increase activation rate, reduce Day 1 drop-off, or optimize the first-run flow. Use when the user mentions "onboarding", "first-run", "activation", "tutorial", "day 1 retention", "new user flow", "permission prompts", "sign-up conversion", "onboarding funnel", or "users dropping off early". For overall retention strategy, see retention-optimization. For paywall placement, see monetization-strategy.
monetization-strategy
When the user wants to design or optimize their app's monetization — pricing, paywalls, subscriptions, or in-app purchases. Also use when the user mentions "pricing", "paywall", "subscription", "IAP", "how to monetize", "revenue optimization", "free trial", or "conversion to paid". For retention impact, see retention-optimization. For competitive pricing, see competitor-analysis.
metadata-optimization
When the user wants to optimize App Store metadata — title, subtitle, keyword field, or description. Also use when the user mentions "optimize my title", "ASO metadata", "keyword field", "character limits", "app description", or "write my subtitle". For keyword discovery, see keyword-research. For full ASO audits, see aso-audit.
market-pulse
When the user wants a comprehensive App Store market overview, daily/weekly market briefing, or combined view of chart movements, trending keywords, featured apps, and new releases. Also use when the user mentions "market overview", "what's happening on the App Store", "market briefing", "weekly report", "market trends", or "state of the market". For chart-specific rank changes only, see market-movers. For keyword trends only, see keyword-research.
market-movers
When the user wants to track App Store chart rank changes, find top gainers and losers, detect breakout apps entering the top 100, or identify apps dropping out of charts. Also use when the user mentions "chart movers", "rank changes", "who's rising", "who's falling", "new chart entries", "top gainers", or "market shifts". For broader market overview, see market-pulse. For competitive keyword analysis, see competitor-analysis.