# AdAdvisor Docs

> AdAdvisor docs: step-by-step user guides and a complete reference for Meta and Facebook advertising metrics, strategies, and terminology.

## Docs

- [Available Tools and Capabilities](https://adadvisor.ai/docs/ai/available-tools.md): Complete reference for every tool your AI assistant can use through AdAdvisor for reading, creating, and managing your Meta ad campaigns.
- [Getting Started with the AdAdvisor MCP Server](https://adadvisor.ai/docs/ai/getting-started-with-mcp.md): New to AdAdvisor? Here's how to get set up and start querying your Meta ad data from any AI assistant.
- [Setting Up Your MCP Client](https://adadvisor.ai/docs/ai/setting-up-your-mcp-client.md): Step-by-step setup instructions for connecting Claude Code, Claude Desktop, ChatGPT, and other MCP-compatible AI clients to AdAdvisor's MCP server.
- [Give Your AI Assistant Access to Your Meta Ad Account](https://adadvisor.ai/docs/ai/welcome.md): Connect your favorite AI tool to your Meta ad account through AdAdvisor. Create campaigns, analyze performance, and manage your ads by just asking.
- [What is the MCP Server?](https://adadvisor.ai/docs/ai/what-is-mcp-server.md): Learn how AdAdvisor's MCP server lets AI assistants access your ad data.
- [What is A/B Testing? Split Testing Your Meta Ads](https://adadvisor.ai/docs/learn/ab-testing.md): A/B testing (split testing) compares two ad variations to find which performs better. Learn how to run A/B tests on Meta and read results.
- [What is Ad Creative? Meta Ads Creative Guide](https://adadvisor.ai/docs/learn/ad-creative.md): Ad creative is the visual and text content in your Meta ad. Learn best practices, common formats, and how to test creatives effectively.
- [What is Ad Fatigue? Signs, Causes & How to Fix It](https://adadvisor.ai/docs/learn/ad-fatigue.md): Ad fatigue happens when your audience sees the same ad too many times and stops engaging. Learn how to spot it and refresh your ads.
- [What Are Meta Ads Placements? Where Your Ads Appear](https://adadvisor.ai/docs/learn/ad-placements.md): Ad placements determine where your ads show across Facebook, Instagram, Messenger, and Audience Network. Learn how to optimize.
- [What Are Ad Sets? Meta Ads Ad Set Guide](https://adadvisor.ai/docs/learn/ad-sets.md): An ad set is the middle level of Meta's campaign structure, controlling targeting, budget, schedule, and placements. Learn how to organize them.
- [What is Advantage+? Meta's AI-Powered Ad Automation](https://adadvisor.ai/docs/learn/advantage-plus.md): Advantage+ is Meta's suite of AI-powered campaign features that automate targeting, placements, and creative. Learn what each feature does.
- [What Are Advantage+ Shopping Campaigns? Meta's Automated E-Commerce Ads](https://adadvisor.ai/docs/learn/advantage-plus-shopping.md): Advantage+ Shopping Campaigns (ASC) use Meta's AI to automate targeting, placements, and creative for e-commerce. Learn how ASC works.
- [What is AOV? Average Order Value Explained](https://adadvisor.ai/docs/learn/aov.md): AOV (Average Order Value) is the average revenue per order. Learn the formula, see benchmarks, and how increasing AOV boosts ad profitability.
- [What Are Attribution Models? How Meta Credits Conversions](https://adadvisor.ai/docs/learn/attribution-models.md): Attribution models determine which ad touchpoint gets credit for a conversion. Learn about last-click, first-click, and data-driven models.
- [What is an Attribution Window? Meta Ads Attribution Settings](https://adadvisor.ai/docs/learn/attribution-window.md): An attribution window is the time period after an ad click or view during which a conversion is credited. Learn Meta's default windows.
- [What Are Meta Ads Bid Strategies? Lowest Cost, Cost Cap & More](https://adadvisor.ai/docs/learn/bid-strategies.md): Bid strategies control how Meta spends your budget in the ad auction. Learn about Lowest Cost, Cost Cap, Bid Cap, and Minimum ROAS.
- [What is Blended ROAS? Total Marketing ROAS Explained](https://adadvisor.ai/docs/learn/blended-roas.md): Blended ROAS measures total revenue across all channels divided by total marketing spend. Learn why it gives a truer picture than channel ROAS.
- [What is Break-Even ROAS? Find Your Minimum Target](https://adadvisor.ai/docs/learn/break-even-roas.md): Break-even ROAS is the minimum return on ad spend needed to cover your costs. Learn the formula, calculate yours, and set the right target.
- [What is Broad Targeting? When to Let Meta Find Your Audience](https://adadvisor.ai/docs/learn/broad-targeting.md): Broad targeting removes interest and demographic restrictions, letting Meta's algorithm find buyers. Learn when it works and when it doesn't.
- [What is CAC? Customer Acquisition Cost Explained](https://adadvisor.ai/docs/learn/cac.md): CAC (Customer Acquisition Cost) is the total cost to acquire one new customer, including ad spend, salaries, and tools. Learn the formula and benchmarks.
- [What Are Meta Ads Campaign Objectives? Choosing the Right One](https://adadvisor.ai/docs/learn/campaign-objectives.md): Campaign objectives tell Meta what result to optimize for. Learn about all six objectives and when to use each.
- [What is Meta Ads Campaign Structure? Campaigns, Ad Sets & Ads Explained](https://adadvisor.ai/docs/learn/campaign-structure.md): Meta Ads uses a three-level campaign structure: campaigns, ad sets, and ads. Learn how each level works and what settings live where.
- [What is CBO? Campaign Budget Optimization Explained](https://adadvisor.ai/docs/learn/cbo.md): CBO (Campaign Budget Optimization) lets Meta distribute your campaign budget across ad sets automatically. Learn when to use CBO vs. ABO.
- [What Are Conversions? Ad Conversions Explained](https://adadvisor.ai/docs/learn/conversions.md): A conversion is any valuable action someone takes after seeing your ad. Learn how Meta tracks conversions and how to optimize for more.
- [What is the Conversions API (CAPI)? Server-Side Tracking for Meta](https://adadvisor.ai/docs/learn/conversions-api.md): The Conversions API sends conversion data from your server to Meta, bypassing browser limitations. Learn why CAPI matters after iOS 14.5.
- [What is CPA? Cost Per Acquisition Explained](https://adadvisor.ai/docs/learn/cpa.md): CPA (Cost Per Acquisition) is how much you spend on ads to get one purchase. Learn the formula, benchmarks, and how to lower your CPA.
- [What is CPC? Cost Per Click Explained](https://adadvisor.ai/docs/learn/cpc.md): CPC (Cost Per Click) is how much you pay each time someone clicks your ad. Learn the formula, benchmarks, and how to lower it.
- [What is CPL? Cost Per Lead Explained](https://adadvisor.ai/docs/learn/cpl.md): CPL (Cost Per Lead) measures how much you spend to generate one lead. Learn the formula, see benchmarks by industry, and how to lower your CPL.
- [What is CPM? Cost Per Thousand Impressions Explained](https://adadvisor.ai/docs/learn/cpm.md): CPM (Cost Per Mille) is the cost to show your ad 1,000 times. Learn the formula, see average CPMs by platform and industry, and what drives CPM.
- [What is CTR? Click-Through Rate Explained](https://adadvisor.ai/docs/learn/ctr.md): CTR (Click-Through Rate) is the percentage of people who click your ad after seeing it. Learn the formula, benchmarks, and tips.
- [What Are Custom Audiences? Meta Ads Targeting Guide](https://adadvisor.ai/docs/learn/custom-audiences.md): Custom audiences target people who already know your brand. Learn how to create them from website visitors, email lists, and past buyers.
- [What is Ad Frequency? When Your Audience Has Seen Enough](https://adadvisor.ai/docs/learn/frequency.md): Ad Frequency is the average number of times each person in your audience has seen your ad. Learn the formula, benchmarks, and how to avoid ad fatigue.
- [What Are Impressions? Reach vs. Impressions Explained](https://adadvisor.ai/docs/learn/impressions.md): Impressions count how many times your ad was displayed. Learn how impressions differ from reach and how to use them in ad analysis.
- [Learn Digital Advertising](https://adadvisor.ai/docs/learn/index.md): Learn digital advertising from the ground up. Plain-English definitions, formulas, benchmarks, and examples for every metric you need.
- [What is Interest Targeting? Meta Ads Audience Guide](https://adadvisor.ai/docs/learn/interest-targeting.md): Interest targeting lets you reach people based on their hobbies, behaviors, and preferences on Meta. Learn when to use interests vs broad targeting.
- [What is the Learning Phase? Meta Ads Optimization Period](https://adadvisor.ai/docs/learn/learning-phase.md): The learning phase is when Meta's algorithm explores who to show your ads to. Learn what triggers it and how to exit faster.
- [What Are Lookalike Audiences? Meta Ads Guide](https://adadvisor.ai/docs/learn/lookalike-audiences.md): Lookalike audiences find new people who resemble your best customers. Learn how to create them, what percentage to use, and when they work best.
- [What is LTV? Customer Lifetime Value Explained](https://adadvisor.ai/docs/learn/ltv.md): LTV (Customer Lifetime Value) is the total revenue a customer generates over their relationship with your business. Learn the formula and benchmarks.
- [What is MER? Marketing Efficiency Ratio Explained](https://adadvisor.ai/docs/learn/mer.md): MER (Marketing Efficiency Ratio) measures total revenue against total marketing spend. Learn why DTC brands use it to replace platform ROAS after iOS 14.5.
- [What is the Meta Pixel? Setup, Events & Tracking Guide](https://adadvisor.ai/docs/learn/meta-pixel.md): The Meta Pixel is a JavaScript snippet that tracks visitor actions on your website. Learn how it works, what events to set up, and why it matters.
- [What Are Offline Conversions? Track Phone Sales & In-Store Purchases](https://adadvisor.ai/docs/learn/offline-conversions.md): Offline conversions let you tell Meta (Facebook) about sales that happen off your website, like phone orders and in-store purchases. Learn how to set them up and why they matter.
- [What is Profit Margin? How It Affects Your Ad Strategy](https://adadvisor.ai/docs/learn/profit-margin.md): Profit margin is the percentage of revenue left after costs. Learn the formula, see industry benchmarks, and find out how it drives your break-even ROAS.
- [What is Prospecting? Prospecting vs Retargeting in Meta Ads](https://adadvisor.ai/docs/learn/prospecting.md): Prospecting targets new people who haven't interacted with your brand yet. Learn prospecting vs retargeting, budget allocation, and strategies.
- [What is Reach? Reach vs. Impressions Explained](https://adadvisor.ai/docs/learn/reach.md): Reach is the number of unique people who saw your ad. Learn how reach differs from impressions, what drives it, and what a good reach looks like.
- [What is Retargeting? Retargeting vs Prospecting Explained](https://adadvisor.ai/docs/learn/retargeting.md): Retargeting shows ads to people who already visited your site or engaged with your content. Learn when to retarget and how to segment.
- [What is ROAS? Return on Ad Spend Explained](https://adadvisor.ai/docs/learn/roas.md): ROAS (Return on Ad Spend) measures revenue earned per dollar of ad spend. Learn the formula, see benchmarks by industry, and what a good ROAS looks like.
- [How to Scale Meta Ads: Vertical & Horizontal Scaling Guide](https://adadvisor.ai/docs/learn/scaling-ads.md): Scaling ads means increasing spend while maintaining profitable results. Learn vertical vs horizontal scaling and when to scale.
- [What Are UTM Parameters? URL Tracking for Meta Ads](https://adadvisor.ai/docs/learn/utms.md): UTM parameters are tags added to URLs to track where your traffic comes from. Learn the five UTM parameters and how to use them with Meta Ads.
- [What Are View-Through Conversions? Impression-Based Attribution](https://adadvisor.ai/docs/learn/view-through-conversions.md): View-through conversions are purchases or leads from people who saw your ad but didn't click. Learn how Meta tracks them and when they matter.
- [AdAdvisor Foundation Skill: Account Discovery and Unit Economics](https://adadvisor.ai/docs/skills/adadvisor.md): The AdAdvisor foundation skill auto-loads on every session. Handles Meta (Facebook) account discovery, business-context grounding, unit economics, and KPI decoding that every other AdAdvisor skill depends on.
- [AdAdvisor Audit Skill: Full Meta Ad Account Audit with AI](https://adadvisor.ai/docs/skills/adadvisor-audit.md): Run a senior media buyer's audit on your Meta (Facebook) ad account. Pixel integrity, structure, performance baseline, red-flag detection, all from natural-language prompts to Claude.
- [AdAdvisor Creative Skill: Test and Refresh Meta Ad Creative](https://adadvisor.ai/docs/skills/adadvisor-creative.md): Pick a testing framework (3-2-2, 5-3-1, 3-3-3). Track refresh cadence by spend tier. Preserve social proof on viral Meta (Facebook) posts. Detect creative fatigue before it shows up as CPA inflation.
- [AdAdvisor Diagnose Skill: Why Did My Meta Ad Performance Drop?](https://adadvisor.ai/docs/skills/adadvisor-diagnose.md): Diagnose Meta (Facebook) ad performance issues with Claude. Hook rate to hold rate to CTR to CVR diagnostic tree, plus unsentimental kill, hold, and scale decision rules expressed in multiples of target CPA.
- [AdAdvisor Launch Skill: Create Meta Ad Campaigns End to End](https://adadvisor.ai/docs/skills/adadvisor-launch.md): Launch Meta (Facebook) ad campaigns through Claude. Objective, structure (ASC vs manual, CBO vs ABO), audience, creative, conversion_domain, lead-form pairing, and PAUSED-by-default activation handled in one workflow.
- [AdAdvisor Playbooks Skill: BFCM, Product Launch, Lead-Gen, Recovery, Scale](https://adadvisor.ai/docs/skills/adadvisor-playbooks.md): Multi-week tactical playbooks for Meta (Facebook) ads. Black Friday timeline, new-product launch, lead-gen setup, banned-account recovery, $1k to $10k a day scaling plan, with operational checkpoints.
- [AdAdvisor Scale Skill: Scale Proven Meta Ad Winners Safely](https://adadvisor.ai/docs/skills/adadvisor-scale.md): Scale Meta (Facebook) ad winners without resetting the learning phase. The 20% rule, the Tichenor bid-cap method, the Faris target-ROAS portfolio, and the $1k to $10k a day stage plan, all triggered by natural language.
- [AdAdvisor Targeting Skill: Broad-First Meta Ad Audience Strategy](https://adadvisor.ai/docs/skills/adadvisor-targeting.md): Broad-first prospecting, lookalike tiers, retargeting funnels, custom-audience creation, and the exclusion logic that keeps Meta (Facebook) prospecting from cannibalizing retargeting.
- [Install AdAdvisor Skills in Claude.ai and Claude Desktop](https://adadvisor.ai/docs/skills/install-claude.md): Upload AdAdvisor Skills to Claude.ai (web) or Claude Desktop in a few clicks. One ZIP per skill, added through Settings, Capabilities, Skills.
- [Install AdAdvisor Skills in Claude Code (Plugin Marketplace)](https://adadvisor.ai/docs/skills/install-claude-code.md): Install the entire AdAdvisor skills plugin in Claude Code with two commands. The plugin marketplace handles installs, updates, and uninstalls automatically.
- [What Are AdAdvisor Skills? Pre-Built Workflows for Managing Meta Ads with AI](https://adadvisor.ai/docs/skills/welcome.md): AdAdvisor Skills are pre-built workflow templates that turn Claude into a senior Meta (Facebook) media buyer. Eight skills covering audits, diagnosis, launches, scaling, creative, targeting, and tactical playbooks.
- [Campaign Recommendations Panel](https://adadvisor.ai/docs/user-guide/campaign-recommendations-panel.md): Open the side panel to view and act on AI recommendations for any campaign directly from Ads Manager.
- [How the Campaign Wizard Works](https://adadvisor.ai/docs/user-guide/campaign-wizard.md): Walk through AdAdvisor's 7-step campaign wizard to create your first AI-optimized Meta ad campaign.
- [How Recommendations Work](https://adadvisor.ai/docs/user-guide/how-recommendations-work.md): Understand how AdAdvisor's AI analyzes your campaigns and generates optimization recommendations.
- [Implementing Recommendations](https://adadvisor.ai/docs/user-guide/implementing-recommendations.md): Use one-click auto-implementation to apply changes directly to Meta, or mark changes as done manually.
- [Managing Businesses](https://adadvisor.ai/docs/user-guide/managing-businesses.md): Add, edit, and remove businesses within your organization. Set key metrics like AOV and break-even ROAS.
- [Metrics & Filtering](https://adadvisor.ai/docs/user-guide/metrics-and-filtering.md): Switch between sales and leads metrics, filter by objective, and sort your ad data.
- [Navigating Ads Manager](https://adadvisor.ai/docs/user-guide/navigating-ads-manager.md): Explore AdAdvisor's Ads Manager with its campaign, ad set, and ad hierarchy.
- [Onboarding Walkthrough](https://adadvisor.ai/docs/user-guide/onboarding-walkthrough.md): Step-by-step guide through AdAdvisor's onboarding flow, from organization setup to your dashboard.
- [Rejecting Recommendations](https://adadvisor.ai/docs/user-guide/rejecting-recommendations.md): Dismiss recommendations you don't want to act on, and provide feedback to improve future suggestions.
- [Understanding Your Campaign Plan](https://adadvisor.ai/docs/user-guide/understanding-your-campaign-plan.md): Learn how to read the AI-generated campaign plan, including strategy, targeting, and budget recommendations.
- [Viewing Recommendations](https://adadvisor.ai/docs/user-guide/viewing-recommendations.md): Browse your recommendations by priority and type, and understand what each card is telling you.
- [Welcome to AdAdvisor](https://adadvisor.ai/docs/user-guide/welcome.md): Your AI-powered Meta Ads optimization platform. Learn what AdAdvisor does and how to get started.

## OpenAPI Specs

- [openapi](https://adadvisor.ai/docs/api-reference/openapi.json)