@nguyenphp/antigravity-marketing 1.0.16 → 1.0.19

package/templates/.agent/skills/ppc-advertising/SKILL.md

@@ -1,551 +1,259 @@
 ---
-name: paid-ads
-description: "When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ad copy,' 'ad creative,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' or 'audience targeting.' This skill covers campaign strategy, ad creation, audience targeting, and optimization."
+name: ppc-advertising
+description: Paid advertising on Google, Meta, LinkedIn with campaign structure and bidding strategies.
+allowed-tools: Read, Glob, Grep
 ---
 
-# Paid Ads
+# PPC Advertising
 
-You are an expert performance marketer with direct access to ad platform accounts. Your goal is to help create, optimize, and scale paid advertising campaigns that drive efficient customer acquisition.
+> Master paid advertising across major platforms.
 
-## Before Starting
+---
 
-Gather this context (ask if not provided):
+## 1. Platform Overview
 
-### 1. Campaign Goals
-- What's the primary objective? (Awareness, traffic, leads, sales, app installs)
-- What's the target CPA or ROAS?
-- What's the monthly/weekly budget?
-- Any constraints? (Brand guidelines, compliance, geographic)
+| Platform | Best For | Avg CPC | Audience |
+|----------|----------|---------|----------|
+| **Google Search** | Intent-based | $1-$50 | Active searchers |
+| **Google Display** | Awareness | $0.50-$5 | Broad reach |
+| **YouTube** | Video, awareness | $0.10-$0.30/view | Video consumers |
+| **Meta (FB/IG)** | Interest-based | $0.50-$5 | Social users |
+| **LinkedIn** | B2B | $2-$15 | Professionals |
+| **TikTok** | Gen Z, viral | $0.50-$3 | Young users |
 
-### 2. Product & Offer
-- What are you promoting? (Product, free trial, lead magnet, demo)
-- What's the landing page URL?
-- What makes this offer compelling?
-- Any promotions or urgency elements?
+---
 
-### 3. Audience
-- Who is the ideal customer?
-- What problem does your product solve for them?
-- What are they searching for or interested in?
-- Do you have existing customer data for lookalikes?
+## 2. Google Ads
 
-### 4. Current State
-- Have you run ads before? What worked/didn't?
-- Do you have existing pixel/conversion data?
-- What's your current funnel conversion rate?
-- Any existing creative assets?
+### Campaign Types
 
----
+| Type | Best For | Targeting |
+|------|----------|-----------|
+| **Search** | Intent, conversions | Keywords |
+| **Display** | Awareness, retargeting | Audiences, placements |
+| **Shopping** | E-commerce | Product feed |
+| **Video** | Branding, YouTube | Audiences, topics |
+| **Performance Max** | Automated, all channels | Goals |
+| **Demand Gen** | Discovery, social-style | Audiences |
 
-## Platform Selection Guide
-
-### Google Ads
-**Best for:** High-intent search traffic, capturing existing demand
-**Use when:**
-- People actively search for your solution
-- You have clear keywords with commercial intent
-- You want bottom-of-funnel conversions
-
-**Campaign types:**
-- Search: Keyword-targeted text ads
-- Performance Max: AI-driven cross-channel
-- Display: Banner ads across Google network
-- YouTube: Video ads
-- Demand Gen: Discovery and Gmail placements
-
-### Meta (Facebook/Instagram)
-**Best for:** Demand generation, visual products, broad targeting
-**Use when:**
-- Your product has visual appeal
-- You're creating demand (not just capturing it)
-- You have strong creative assets
-- You want to build audiences for retargeting
-
-**Campaign types:**
-- Advantage+ Shopping: E-commerce automation
-- Lead Gen: In-platform lead forms
-- Conversions: Website conversion optimization
-- Traffic: Link clicks to site
-- Engagement: Social proof building
-
-### LinkedIn Ads
-**Best for:** B2B targeting, reaching decision-makers
-**Use when:**
-- You're selling to businesses
-- Job title/company targeting matters
-- Higher price points justify higher CPCs
-- You need to reach specific industries
-
-**Campaign types:**
-- Sponsored Content: Feed posts
-- Message Ads: Direct InMail
-- Lead Gen Forms: In-platform capture
-- Document Ads: Gated content
-- Conversation Ads: Interactive messaging
-
-### Twitter/X Ads
-**Best for:** Tech audiences, real-time relevance, thought leadership
-**Use when:**
-- Your audience is active on X
-- You have timely/trending content
-- You want to amplify organic content
-- Lower CPMs matter more than precision targeting
-
-### TikTok Ads
-**Best for:** Younger demographics, viral creative, brand awareness
-**Use when:**
-- Your audience skews younger (18-34)
-- You can create native-feeling video content
-- Brand awareness is a goal
-- You have creative capacity for video
+### Keyword Match Types
 
----
+| Type | Symbol | Matches |
+|------|--------|---------|
+| **Broad** | keyword | Related searches |
+| **Phrase** | "keyword" | Contains phrase |
+| **Exact** | [keyword] | Exact or close variants |
 
-## Campaign Structure Best Practices
+### Ad Structure
 
-### Account Organization
+| Element | Limit | Best Practice |
+|---------|-------|---------------|
+| **Headlines** | 15 (30 chars each) | Include keywords, benefits |
+| **Descriptions** | 4 (90 chars each) | CTA, unique value |
+| **Display URL** | 2 paths (15 chars) | Relevant keywords |
 
-```
-Account
-├── Campaign 1: [Objective] - [Audience/Product]
-│   ├── Ad Set 1: [Targeting variation]
-│   │   ├── Ad 1: [Creative variation A]
-│   │   ├── Ad 2: [Creative variation B]
-│   │   └── Ad 3: [Creative variation C]
-│   └── Ad Set 2: [Targeting variation]
-│       └── Ads...
-└── Campaign 2...
-```
+---
 
-### Naming Conventions
+## 3. Meta Ads (Facebook/Instagram)
 
-Use consistent naming for easy analysis:
+### Campaign Objectives
 
-```
-[Platform]_[Objective]_[Audience]_[Offer]_[Date]
+| Objective | Goal | Optimization |
+|-----------|------|--------------|
+| **Awareness** | Reach | Impressions |
+| **Traffic** | Clicks | Link clicks |
+| **Engagement** | Interaction | Post engagement |
+| **Leads** | Form fills | Leads |
+| **Sales** | Purchases | Conversions |
 
-Examples:
-META_Conv_Lookalike-Customers_FreeTrial_2024Q1
-GOOG_Search_Brand_Demo_Ongoing
-LI_LeadGen_CMOs-SaaS_Whitepaper_Mar24
-```
+### Audience Types
 
-### Budget Allocation Framework
+| Type | Source | Use |
+|------|--------|-----|
+| **Core** | Demographics, interests | Prospecting |
+| **Custom** | Your data (email, pixel) | Retargeting, lookalike base |
+| **Lookalike** | Similar to custom | Expansion |
 
-**Testing phase (first 2-4 weeks):**
-- 70% to proven/safe campaigns
-- 30% to testing new audiences/creative
+### Ad Formats
 
-**Scaling phase:**
-- Consolidate budget into winning combinations
-- Increase budgets 20-30% at a time
-- Wait 3-5 days between increases for algorithm learning
+| Format | Best For | Specs |
+|--------|----------|-------|
+| **Single image** | Simple message | 1080x1080 or 1200x628 |
+| **Carousel** | Multiple products | 2-10 cards |
+| **Video** | Engagement, stories | 15-60 sec optimal |
+| **Collection** | E-commerce | Catalog integration |
 
 ---
 
-## Ad Copy Frameworks
-
-### Primary Text Formulas
+## 4. LinkedIn Ads
 
-**Problem-Agitate-Solve (PAS):**
-```
-[Problem statement]
-[Agitate the pain]
-[Introduce solution]
-[CTA]
-```
+### Campaign Objectives
 
-Example:
-> Spending hours on manual reporting every week?
-> While you're buried in spreadsheets, your competitors are making decisions.
-> [Product] automates your reports in minutes.
-> Start your free trial →
+| Objective | Best For |
+|-----------|----------|
+| **Brand awareness** | Top of funnel |
+| **Website visits** | Traffic |
+| **Engagement** | Content promotion |
+| **Lead gen forms** | B2B leads |
+| **Conversions** | High-value actions |
 
-**Before-After-Bridge (BAB):**
-```
-[Current painful state]
-[Desired future state]
-[Your product as the bridge]
-```
+### Targeting Options
 
-Example:
-> Before: Chasing down approvals across email, Slack, and spreadsheets.
-> After: Every approval tracked, automated, and on time.
-> [Product] connects your tools and keeps projects moving.
+| Type | Examples |
+|------|----------|
+| **Job title** | Marketing Manager |
+| **Job function** | Marketing |
+| **Seniority** | Director+ |
+| **Company size** | 200-500 employees |
+| **Industry** | Technology |
+| **Skills** | Digital Marketing |
 
-**Social Proof Lead:**
-```
-[Impressive stat or testimonial]
-[What you do]
-[CTA]
-```
+### Ad Formats
 
-Example:
-> "We cut our reporting time by 75%." — Sarah K., Marketing Director
-> [Product] automates the reports you hate building.
-> See how it works →
-
-### Headline Formulas
-
-**For Search Ads:**
-- [Keyword] + [Benefit]: "Project Management That Teams Actually Use"
-- [Action] + [Outcome]: "Automate Reports | Save 10 Hours Weekly"
-- [Question]: "Tired of Manual Data Entry?"
-- [Number] + [Benefit]: "500+ Teams Trust [Product] for [Outcome]"
-
-**For Social Ads:**
-- Hook with outcome: "How we 3x'd our conversion rate"
-- Hook with curiosity: "The reporting hack no one talks about"
-- Hook with contrarian: "Why we stopped using [common tool]"
-- Hook with specificity: "The exact template we use for..."
-
-### CTA Variations
-
-**Soft CTAs (awareness/consideration):**
-- Learn More
-- See How It Works
-- Watch Demo
-- Get the Guide
-
-**Hard CTAs (conversion):**
-- Start Free Trial
-- Get Started Free
-- Book a Demo
-- Claim Your Discount
-- Buy Now
-
-**Urgency CTAs (when genuine):**
-- Limited Time: 30% Off
-- Offer Ends [Date]
-- Only X Spots Left
+| Format | Best For |
+|--------|----------|
+| **Single image** | Standard awareness |
+| **Carousel** | Multi-part stories |
+| **Video** | Brand stories |
+| **Message ads** | Direct outreach |
+| **Document ads** | Lead magnets |
 
 ---
 
-## Audience Targeting Strategies
+## 5. Bidding Strategies
 
-### Google Ads Audiences
+### Google Bidding
 
-**Search campaigns:**
-- Keywords (exact, phrase, broad match)
-- Audience layering (observation mode first)
-- Remarketing lists for search ads (RLSA)
+| Strategy | When to Use |
+|----------|-------------|
+| **Manual CPC** | Full control, learning |
+| **Enhanced CPC** | Semi-automated |
+| **Target CPA** | Cost-per-acquisition goal |
+| **Target ROAS** | Revenue goal |
+| **Maximize conversions** | Volume priority |
+| **Maximize clicks** | Traffic priority |
 
-**Display/YouTube:**
-- Custom intent (based on search behavior)
-- In-market audiences
-- Affinity audiences
-- Customer match (upload email lists)
-- Similar/lookalike audiences
+### Meta Bidding
 
-### Meta Audiences
+| Strategy | When to Use |
+|----------|-------------|
+| **Lowest cost** | Maximize volume |
+| **Cost cap** | Control costs |
+| **Bid cap** | Strict cost control |
+| **Minimum ROAS** | Revenue focus |
 
-**Core audiences (interest/demographic):**
-- Layer interests with AND logic for precision
-- Exclude existing customers
-- Start broad, let algorithm optimize
-
-**Custom audiences:**
-- Website visitors (by page, time on site, frequency)
-- Customer list uploads
-- Engagement (video viewers, page engagers)
-- App activity
-
-**Lookalike audiences:**
-- Source: Best customers (by LTV, not just all customers)
-- Size: Start 1%, expand to 1-3% as you scale
-- Layer: Lookalike + interest for early testing
-
-### LinkedIn Audiences
+---
 
-**Job-based targeting:**
-- Job titles (be specific, avoid broad)
-- Job functions + seniority
-- Skills (self-reported)
+## 6. Campaign Structure
 
-**Company-based targeting:**
-- Company size
-- Industry
-- Company names (ABM)
-- Company growth rate
+### Account Structure (Google)
 
-**Combinations that work:**
-- Job function + seniority + company size
-- Industry + job title
-- Company list + decision-maker titles
+```
+Account
+└── Campaign (Budget, Settings)
+    └── Ad Group (Keywords, Audience)
+        └── Ads (Creative)
+```
 
----
+### Recommended Structure
 
-## Creative Best Practices
-
-### Image Ads
-
-**What works:**
-- Clear product screenshots showing UI
-- Before/after comparisons
-- Stats and numbers as focal point
-- Human faces (real, not stock)
-- Bold, readable text overlay (keep under 20%)
-
-**What doesn't:**
-- Generic stock photos
-- Too much text
-- Cluttered visuals
-- Low contrast/hard to read
-
-### Video Ads
-
-**Structure for short-form (15-30 sec):**
-1. Hook (0-3 sec): Pattern interrupt, question, or bold statement
-2. Problem (3-8 sec): Relatable pain point
-3. Solution (8-20 sec): Show product/benefit
-4. CTA (20-30 sec): Clear next step
-
-**Structure for longer-form (60+ sec):**
-1. Hook (0-5 sec)
-2. Problem deep-dive (5-20 sec)
-3. Solution introduction (20-35 sec)
-4. Social proof (35-45 sec)
-5. How it works (45-55 sec)
-6. CTA with offer (55-60 sec)
-
-**Production tips:**
-- Captions always (85% watch without sound)
-- Vertical for Stories/Reels, square for feed
-- Native feel outperforms polished
-- First 3 seconds determine if they watch
-
-### Ad Creative Testing
-
-**Testing hierarchy:**
-1. Concept/angle (biggest impact)
-2. Hook/headline
-3. Visual style
-4. Body copy
-5. CTA
-
-**Testing approach:**
-- Test one variable at a time for clean data
-- Need 100+ conversions per variant for significance
-- Kill losers fast (3-5 days with sufficient spend)
-- Iterate on winners
+| Level | Organization |
+|-------|--------------|
+| **Campaign** | By goal, product line, funnel stage |
+| **Ad Group** | By theme, audience segment |
+| **Ads** | 3-5 variations for testing |
 
 ---
 
-## Campaign Optimization
-
-### Key Metrics by Objective
-
-**Awareness:**
-- CPM (cost per 1,000 impressions)
-- Reach and frequency
-- Video view rate / watch time
-- Brand lift (if available)
-
-**Consideration:**
-- CTR (click-through rate)
-- CPC (cost per click)
-- Landing page views
-- Time on site from ads
-
-**Conversion:**
-- CPA (cost per acquisition)
-- ROAS (return on ad spend)
-- Conversion rate
-- Cost per lead / cost per sale
-
-### Optimization Levers
-
-**If CPA is too high:**
-1. Check landing page (is the problem post-click?)
-2. Tighten audience targeting
-3. Test new creative angles
-4. Improve ad relevance/quality score
-5. Adjust bid strategy
-
-**If CTR is low:**
-- Creative isn't resonating → test new hooks/angles
-- Audience mismatch → refine targeting
-- Ad fatigue → refresh creative
-- Weak offer → improve value proposition
-
-**If CPM is high:**
-- Audience too narrow → expand targeting
-- High competition → try different placements
-- Low relevance score → improve creative fit
-- Bidding too aggressively → adjust bid caps
-
-### Bid Strategies
-
-**Manual/controlled:**
-- Use when: Learning phase, small budgets, need control
-- Manual CPC, bid caps, cost caps
-
-**Automated/smart:**
-- Use when: Sufficient conversion data (50+ per month), scaling
-- Target CPA, target ROAS, maximize conversions
-
-**Progression:**
-1. Start with manual or cost caps
-2. Gather conversion data (50+ conversions)
-3. Switch to automated with targets based on historical data
-4. Monitor and adjust targets based on results
+## 7. Ad Copy Best Practices
 
----
+### Headlines That Convert
 
-## Retargeting Strategies
+| Element | Example |
+|---------|---------|
+| **Keyword inclusion** | "Best CRM Software" |
+| **Benefit** | "Close 30% More Deals" |
+| **Urgency** | "Limited Time Offer" |
+| **Social proof** | "Trusted by 10,000+ Teams" |
+| **Question** | "Tired of Lost Leads?" |
 
-### Funnel-Based Retargeting
+### Description Copy
 
-**Top of funnel (awareness):**
-- Audience: Blog readers, video viewers, social engagers
-- Message: Educational content, social proof
-- Goal: Move to consideration
+| Element | Purpose |
+|---------|---------|
+| **Value prop** | Why choose you |
+| **Features** | What you offer |
+| **CTA** | What to do next |
+| **Trust** | Credibility signals |
 
-**Middle of funnel (consideration):**
-- Audience: Pricing page visitors, feature page visitors
-- Message: Case studies, demos, comparisons
-- Goal: Move to decision
+---
 
-**Bottom of funnel (decision):**
-- Audience: Cart abandoners, trial users, demo no-shows
-- Message: Urgency, objection handling, offers
-- Goal: Convert
+## 8. Landing Page Alignment
 
-### Retargeting Windows
+### Message Match
 
-| Stage | Window | Frequency Cap |
-|-------|--------|---------------|
-| Hot (cart/trial) | 1-7 days | Higher OK |
-| Warm (key pages) | 7-30 days | 3-5x/week |
-| Cold (any visit) | 30-90 days | 1-2x/week |
+| Ad Element | Landing Page |
+|------------|--------------|
+| **Headline** | Hero headline |
+| **Offer** | Above fold CTA |
+| **Keywords** | In content |
+| **Visual** | Consistent imagery |
 
-### Exclusions to Set Up
+### Quality Score Factors (Google)
 
-Always exclude:
-- Existing customers (unless upsell campaign)
-- Recent converters (7-14 day window)
-- Bounced visitors (<10 sec on site)
-- Irrelevant pages (careers, support)
+| Factor | Weight | Improve By |
+|--------|--------|------------|
+| **Expected CTR** | High | Better ad copy |
+| **Ad relevance** | Medium | Keyword-ad alignment |
+| **Landing experience** | High | Page speed, content |
 
 ---
 
-## Reporting & Analysis
-
-### Weekly Review Checklist
-
-- [ ] Spend vs. budget pacing
-- [ ] CPA/ROAS vs. targets
-- [ ] Top and bottom performing ads
-- [ ] Audience performance breakdown
-- [ ] Frequency check (fatigue risk)
-- [ ] Landing page conversion rate
-- [ ] Any disapproved ads or policy issues
+## 9. Key Metrics
 
-### Monthly Analysis
+### Performance Metrics
 
-- [ ] Overall channel performance vs. goals
-- [ ] Creative performance trends
-- [ ] Audience insights and learnings
-- [ ] Budget reallocation recommendations
-- [ ] Test results and next tests
-- [ ] Competitive landscape changes
+| Metric | Formula | Good |
+|--------|---------|------|
+| **CTR** | Clicks / Impressions | >2% search, >0.5% display |
+| **CPC** | Spend / Clicks | Industry varies |
+| **CPA** | Spend / Conversions | Below target |
+| **ROAS** | Revenue / Spend | >3x minimum |
+| **Quality Score** | Google rating 1-10 | >7 |
 
-### Attribution Considerations
+### Efficiency Metrics
 
-- Platform attribution is inflated (they want credit)
-- Use UTM parameters consistently
-- Compare platform data to GA4/analytics
-- Consider incrementality testing for mature accounts
-- Look at blended CAC, not just platform CPA
+| Metric | Indicates |
+|--------|-----------|
+| **Impression share** | Market coverage |
+| **Search lost IS (rank)** | Bid competitiveness |
+| **Search lost IS (budget)** | Budget constraints |
 
 ---
 
-## Platform-Specific Setup Guides
-
-### Google Ads Setup Checklist
-
-- [ ] Conversion tracking installed and tested
-- [ ] Google Analytics 4 linked
-- [ ] Audience lists created (remarketing, customer match)
-- [ ] Negative keyword lists built
-- [ ] Ad extensions set up (sitelinks, callouts, structured snippets)
-- [ ] Brand campaign running (protect branded terms)
-- [ ] Competitor campaign considered
-- [ ] Location and language targeting set
-- [ ] Ad schedule aligned with business hours (if B2B)
-
-### Meta Ads Setup Checklist
-
-- [ ] Pixel installed and events firing
-- [ ] Conversions API set up (server-side tracking)
-- [ ] Custom audiences created
-- [ ] Product catalog connected (if e-commerce)
-- [ ] Domain verified
-- [ ] Business Manager properly configured
-- [ ] Aggregated event measurement prioritized
-- [ ] Creative assets in correct sizes
-- [ ] UTM parameters in all URLs
-
-### LinkedIn Ads Setup Checklist
-
-- [ ] Insight Tag installed
-- [ ] Conversion tracking configured
-- [ ] Matched audiences created
-- [ ] Company page connected
-- [ ] Lead gen form templates created
-- [ ] Document assets uploaded (for Document Ads)
-- [ ] Audience size validated (not too narrow)
-- [ ] Budget realistic for LinkedIn CPCs ($8-15+)
+## 10. Optimization Checklist
 
----
+### Weekly
 
-## Common Mistakes to Avoid
-
-### Strategy Mistakes
-- Launching without conversion tracking
-- Too many campaigns/ad sets (fragmenting budget)
-- Not giving algorithms enough learning time
-- Optimizing for wrong metric (clicks vs. conversions)
-- Ignoring landing page experience
-
-### Targeting Mistakes
-- Audiences too narrow (can't exit learning phase)
-- Audiences too broad (wasting spend)
-- Not excluding existing customers
-- Overlapping audiences competing with each other
-- Ignoring negative keywords (Search)
-
-### Creative Mistakes
-- Only running one ad per ad set
-- Not refreshing creative (ad fatigue)
-- Mismatch between ad and landing page
-- Ignoring mobile experience
-- Too much text in images (Meta)
-
-### Budget Mistakes
-- Spreading budget too thin across campaigns
-- Making big budget changes (disrupts learning)
-- Not accounting for platform minimums
-- Stopping campaigns during learning phase
-- Weekend/off-hours spend without adjustment
+- [ ] Check spend vs budget
+- [ ] Review search terms, add negatives
+- [ ] Pause underperforming ads
+- [ ] Adjust bids on top performers
 
----
+### Monthly
 
-## Questions to Ask
+- [ ] Review campaign structure
+- [ ] Refresh ad creative
+- [ ] Analyze audience performance
+- [ ] Test new targeting
 
-If you need more context:
-1. What platform(s) are you currently running or want to start with?
-2. What's your monthly ad budget?
-3. What does a successful conversion look like (and what's it worth)?
-4. Do you have existing creative assets or need to create them?
-5. What landing page will ads point to?
-6. Do you have pixel/conversion tracking set up?
+### Quarterly
 
----
+- [ ] Full account audit
+- [ ] Competitive analysis
+- [ ] Strategy review
+- [ ] Budget reallocation
 
-## Related Skills
+---
 
-- **copywriting**: For landing page copy that converts ad traffic
-- **analytics-tracking**: For proper conversion tracking setup
-- **ab-test-setup**: For landing page testing to improve ROAS
-- **page-cro**: For optimizing post-click conversion rates
+> **Remember:** PPC success comes from continuous testing and optimization. Start small, learn fast, scale what works.