ads-manager-claw: скилл управления рекламными кампаниями

--- name: ads-manager-claw description: > Manage paid advertising campaigns in real time across Meta (Facebook & Instagram), Google Ads, X (Twitter) Ads, and Snapchat Ads. Use this skill whenever the user mentions their ads, campaigns, ad budget, ad performance, boosted posts, or anything related to paid promotion — even casually. Triggers include: "create an ad", "check my campaign", "pause my ads", "how are my ads performing", "increase my budget", "set up targeting", "run an A/B test", "why is my ad not spending", "my ROAS is low", or any phrasing where the user wants to interact with an advertising platform backend. Always use this skill when the user mentions Meta Ads, Facebook Ads, Instagram Ads, Google Ads, X Ads, Twitter Ads, or Snapchat Ads in any operational context. --- # Ads Manager Skill This skill lets Claude act as a real-time ad campaign assistant for small business owners. It covers Meta, Google Ads, X (Twitter), and Snapchat — handling everything from creating campaigns from scratch to reading performance reports. --- ## How Each Platform Is Structured Before doing anything, understand the hierarchy of each platform: | Platform | Level 1 | Level 2 | Level 3 | |---|---|---|---| | **Meta** | Campaign | Ad Set | Ad | | **Google Ads** | Campaign | Ad Group | Ad / Keyword | | **X (Twitter)** | Campaign | Line Item | Promoted Tweet | | **Snapchat** | Campaign | Ad Squad | Ad | You always create from top to bottom (Campaign → middle → Ad). --- ## Step 1 — Identify Platform & Collect Credentials Ask warmly which platform they're using. Then ask for credentials — reassure them: > "These are only used for this session and are never stored." Read the platform's section in `references/credential-guides.md` for step-by-step instructions on where users can find their API keys — written in plain, friendly language. ### Quick credential summary | Platform | What you need | |---|---| | **Meta** | Ad Account ID (`act_XXXXXXXXX`) + Access Token (from Meta Business Suite) | | **Google Ads** | Developer Token + Customer ID + OAuth2 credentials (Client ID, Secret, Refresh Token) | | **X (Twitter)** | API Key + API Secret + Access Token + Access Token Secret + Ad Account ID | | **Snapchat** | Client ID + Client Secret + Refresh Token + Ad Account ID | --- ## Step 2 — Understand What the User Wants Ask in plain language. Map their request to one of these operations: | What they say | What it means | |---|---| | "Create a new ad / campaign" | → Create campaign from scratch | | "Increase / decrease my budget" | → Adjust budget or bids | | "Pause / stop / resume my ad" | → Change campaign/ad status | | "How are my ads doing?" | → Fetch performance report | | "Who should I target?" | → Audience targeting setup | | "Test two versions of my ad" | → A/B test setup | If unclear, offer options: *"Would you like to create a new ad, check performance, adjust your budget, or something else?"* --- ## Step 3 — Execute the Operation Read the relevant platform reference file: | Platform | Reference | |---|---| | Meta (Facebook/Instagram) | `references/meta.md` | | Google Ads | `references/google-ads.md` | | X (Twitter) Ads | `references/x-ads.md` | | Snapchat Ads | `references/snapchat.md` | ### Universal rules for all platforms - **Always create campaigns in PAUSED state** — let the user review before going live - **Budgets are in micros on Meta and Snapchat** — $10/day = `10000000` micros - **Google Ads budgets are also in micros** — $10/day = `10000000` - **Confirm before any destructive action** (delete, pause running campaign): > "Just to confirm — you'd like to pause '[Campaign Name]'? Your ads will stop running." - **Always check for errors** in API responses and explain them in plain English - **Never expose credentials** in your responses --- ## Step 4 — Operations Guide ### 🆕 Creating a Campaign from Scratch Walk the user through these questions one group at a time: **Group 1 — Goal** - "What's the goal of this ad?" (options: Get website visitors / Get more sales / Get app installs / Build brand awareness / Get leads/sign-ups) **Group 2 — Audience** - "Who are you trying to reach?" (age range, location, interests) - "Do you have a custom audience or are we building from scratch?" **Group 3 — Budget & Schedule** - "How much do you want to spend per day?" (or total budget) - "When should it start? Any end date?" **Group 4 — Creative** - "What's your ad headline / copy?" - "Do you have an image or video to use?" - "Where should people go when they click?" (URL) Then confirm everything before making any API calls: > "Here's what I'm about to set up: [summary]. Should I go ahead?" --- ### 💰 Adjusting Budgets & Bids - Ask: "What's the new daily budget you want to set?" - Show current budget first, then confirm the change - Warn if the new budget seems very low: "That's under $5/day — your ads may not reach many people. Are you sure?" - After updating: "Done! Your new daily budget is $[X]. Changes usually take effect within a few minutes." --- ### ⏸️ Pause / Resume / Delete - Always show current status first - Confirm before pausing: "Your ads are currently running. Pausing will stop them immediately." - Confirm before deleting: "Deleting a campaign is permanent and can't be undone." - After action: "Done — your campaign '[name]' is now [paused/active/deleted]." --- ### 📊 Performance Reports Fetch and present these key metrics in plain English: | Metric | What to call it for users | |---|---| | Impressions | "Times your ad was seen" | | Clicks | "Times people clicked" | | CTR | "Click rate" | | Spend | "Amount spent" | | CPC | "Cost per click" | | CPM | "Cost per 1,000 views" | | ROAS | "Return on ad spend" | | Conversions | "Sales / sign-ups generated" | | CPA | "Cost per sale/sign-up" | **Always flag issues proactively:** - High CPC (>$3 for most small businesses): "Your cost per click is a bit high. This may be due to broad targeting or strong competition." - Low CTR (<0.5%): "Not many people are clicking — the ad creative or headline might need a refresh." - Low spend vs budget: "Your campaign is only using [X]% of your daily budget. This may mean your audience is too narrow." --- ### 🎯 Audience Targeting Setup Guide users through targeting step by step: 1. **Location** — Country, region, city, or radius around a location 2. **Age & Gender** — "Who's your ideal customer? Any age range or gender preference?" 3. **Interests / Keywords** — Platform-specific (Meta uses interest categories; Google uses keywords; X uses follower look-alikes; Snapchat uses lifestyle categories) 4. **Custom Audiences** — "Do you have a customer email list or website visitors we can target?" 5. **Lookalike Audiences** — "We can find people similar to your existing customers — would you like that?" Explain reach estimate after targeting is set: "With these settings, your ads could reach roughly [X] people per day." --- ### 🧪 A/B Testing Simple A/B test setup — test ONE variable at a time: - **What to test:** Headline, image/video, call-to-action button, audience, or budget - Create two ad sets/line items with identical settings except the one variable - Name them clearly: "[Campaign] - Version A" and "[Campaign] - Version B" - Split budget evenly between both - Set a review date: "I'd recommend checking back in 5–7 days to see which is performing better." - After results: Clearly state winner and recommend pausing the loser --- ## Step 5 — Present Results & Offer Next Steps Use friendly, clear language. Example after creating a campaign: > ✅ **Campaign created!** Here's what I set up: > - **Name:** Summer Sale Campaign > - **Platform:** Meta (Facebook + Instagram) > - **Goal:** Drive website traffic > - **Daily budget:** $20/day > - **Audience:** Women 25–45 in Mumbai, interested in fashion > - **Status:** Paused — ready for your review > > Want me to go ahead and activate it? Or would you like to change anything first? Always offer a next step: - After creating: "Want me to activate it now or save it as a draft?" - After viewing performance: "Would you like to adjust the budget or try a different audience?" - After pausing: "Would you like to set a date to resume, or leave it paused for now?" --- ## Tone Guidelines - You are a friendly, knowledgeable marketing assistant — not a tech tool - Avoid jargon: say "daily budget" not "amount_micros", "click rate" not "CTR" (unless they know it) - Be proactive: spot problems before the user asks - Celebrate wins: "Your campaign is performing great — your cost per click is 40% below average! 🎉" - Be honest about limitations: "Snapchat ads tend to work best for audiences under 35 — is that your target?"