Meta Ads
Analyze your Meta Ads campaigns across Facebook and Instagram — performance metrics, audience insights, creative analysis, and more — through natural language in Claude Code.
Overview
The Meta Ads integration connects your Meta advertising account (Facebook Ads and Instagram Ads) to Claude Code through Presso. You can analyze campaign performance, compare ad sets, evaluate creative effectiveness, review audience targeting, and get optimization recommendations -- all through natural conversation.
Meta's advertising platform spans Facebook, Instagram, Messenger, and the Audience Network. With Presso, you get a unified view of performance across all these placements without switching between multiple screens in Meta Ads Manager.
Setup
Prerequisites
- A Meta Business account with an active Ad Account
- Admin or Analyst access to the Ad Account
- A Presso account connected to Claude Code (see MCP Connection)
Connecting your Meta Ads account
- Sign in to Presso and navigate to the Integrations page.
- Click Connect next to Meta Ads.
- You will be redirected to Meta's authorization screen. Sign in with your Facebook account and grant the requested permissions.
- Select the Ad Account you want to connect. If you manage multiple ad accounts, choose the one you want to analyze.
- Once authorized, you will be redirected back to Presso. Your Meta Ads account is now connected.
- In Claude Code, verify the connection by asking:
Show me a summary of my Meta Ads performance for the last 7 days.
Account structure
Meta Ads follows a three-tier hierarchy. Understanding this structure helps you ask precise questions.
Ad Account
└── Campaign (objective, budget, buying type)
└── Ad Set (audience, placement, schedule, bid strategy)
└── Ad (creative: image/video, copy, CTA, URL)
- Campaign -- Defines the marketing objective (e.g., conversions, traffic, awareness).
- Ad Set -- Controls who sees your ads (audience targeting), where they appear (placements), and how much you spend (budget and bid).
- Ad -- The actual creative that users see, including images, videos, headlines, descriptions, and call-to-action buttons.
Available data
Presso provides access to your Meta Ads data at every level of the account hierarchy.
Core tools
| Tool | Description |
|---|---|
meta_ads_run_report | Run a custom performance report with breakdowns, metrics, and date ranges |
meta_ads_list_campaigns | List all campaigns with status and summary metrics |
meta_ads_get_campaign | Get detailed campaign settings, targeting, and performance |
meta_ads_list_ad_sets | List ad sets with audience, budget, and performance data |
meta_ads_get_ad_set | Get detailed ad set settings including targeting and placements |
meta_ads_list_ads | List ads with creative details and performance metrics |
meta_ads_get_ad | Get detailed ad information including creative assets |
meta_ads_list_accounts | List accessible ad accounts |
meta_ads_get_ad_creatives | Get creative details including images, videos, and copy |
Key metrics
Delivery and reach metrics
| Metric | Description |
|---|---|
reach | Number of unique users who saw your ad |
impressions | Total number of times your ad was displayed |
frequency | Average number of times each user saw your ad (impressions / reach) |
cpm | Cost per 1,000 impressions |
cpp | Cost per 1,000 people reached |
Engagement metrics
| Metric | Description |
|---|---|
clicks | Total clicks (all types) |
linkClicks | Clicks on the ad's link/CTA |
ctr | Click-through rate (link clicks / impressions) |
cpc | Cost per link click |
postEngagement | Total post engagement (reactions, comments, shares, clicks) |
postReactions | Number of reactions on the ad |
postComments | Number of comments |
postShares | Number of shares |
videoViews | Number of video views (3+ seconds) |
videoThruPlays | Number of video views to completion (or 15+ seconds) |
Conversion metrics
| Metric | Description |
|---|---|
conversions | Total conversion events |
purchases | Number of purchase events |
purchaseValue | Total value of purchase events |
roas | Return on ad spend (purchase value / spend) |
costPerPurchase | Average cost to generate one purchase |
addToCart | Number of add-to-cart events |
costPerAddToCart | Average cost per add-to-cart event |
initiateCheckout | Number of checkout initiation events |
leads | Number of lead events |
costPerLead | Average cost per lead |
costPerConversion | Average cost per conversion event |
Spend metrics
| Metric | Description |
|---|---|
spend | Total amount spent |
dailyBudget | Daily budget setting |
lifetimeBudget | Lifetime budget setting |
Breakdowns and dimensions
You can break down Meta Ads reports by various dimensions for deeper analysis.
Time breakdowns
| Breakdown | Description |
|---|---|
date | Daily performance |
week | Weekly aggregation |
month | Monthly aggregation |
Delivery breakdowns
| Breakdown | Description |
|---|---|
age | Age ranges (18-24, 25-34, 35-44, etc.) |
gender | Male, Female, Unknown |
platform | Facebook, Instagram, Messenger, Audience Network |
placement | Feed, Stories, Reels, Right Column, Search, etc. |
device | Mobile, Desktop |
country | Geographic breakdown by country |
region | Geographic breakdown by region/state |
impression_device | iPhone, Android, Desktop, etc. |
Example queries
Campaign performance
Show me performance for all active campaigns over the last 30 days.
Include spend, reach, link clicks, purchases, and ROAS.
Which campaign has the highest ROAS this month?
List all campaigns and their current status (active, paused, completed).
Show me lifetime spend and results for each.
Compare my "Prospecting" and "Retargeting" campaigns.
Which one has a lower cost per purchase?
Ad set comparison
Compare all ad sets in my "Summer Sale" campaign.
Show me spend, CPC, CTR, and conversion rate for each.
Which ad sets have the lowest cost per conversion?
Are any ad sets spending heavily with poor results?
Show me ad set performance broken down by audience.
Which targeting is working best?
List ad sets with a frequency above 3. These audiences might be fatigued.
Ad and creative performance
Show me all ads in my "New Arrivals" campaign, ranked by ROAS.
Which ad creatives have the highest CTR? Are there common elements
(image vs. video, headline style) in the top performers?
Compare video ad performance vs. image ad performance across all campaigns.
Show me ads with CTR below 1%. These might need creative refreshes.
Audience insights
Break down my campaign performance by age and gender.
Which demographic segments are converting best?
Show me performance by country. Where am I getting the most
cost-efficient conversions?
What's the conversion rate for 25-34 year olds vs. 35-44 year olds?
Compare male vs. female audience performance across all campaigns.
Placement analysis
Break down performance by platform: Facebook vs. Instagram.
Where are my ads performing better?
Show me performance by placement: Feed, Stories, Reels, and others.
Which placement has the best ROAS?
Compare Instagram Stories vs. Instagram Reels performance for my campaigns.
Budget and spend analysis
Show me daily spend trend for the last 30 days.
Is my spend increasing or decreasing?
Am I on track for my monthly budget? Show me current spend
vs. projected month-end spend.
Which campaigns have the highest cost per result?
Should I reallocate budget?
Creative performance analysis
Understanding which creatives resonate with your audience is critical for Meta Ads optimization. Presso helps you analyze creative elements systematically.
Headline and copy analysis
Show me the top 5 ads by CTR. What headlines and descriptions are they using?
Compare ad copy performance -- which call-to-action buttons
(Shop Now, Learn More, Sign Up) generate the most clicks?
Video vs. image comparison
Compare the overall performance of video ads vs. static image ads.
Include reach, engagement, and conversion metrics.
For my video ads, what's the average view-through rate?
How many people watch to completion?
Creative fatigue detection
Show me ads that have been running for more than 14 days where CTR
has declined over time. These might be experiencing creative fatigue.
Which ads have a frequency above 4? High frequency often correlates
with declining performance.
Cross-platform comparison with Google Ads
If you have both Google Ads and Meta Ads connected, Presso enables powerful cross-platform analysis.
Compare Google Ads and Meta Ads performance for the last 30 days:
total spend, conversions, cost per conversion, and ROAS for each platform.
Which platform gives me a better cost per purchase -- Google Ads or Meta Ads?
Show me a unified view of all my ad spend across Google and Meta.
What's my blended ROAS?
Compare prospecting performance: Meta Ads broad targeting vs.
Google Ads Performance Max. Which is finding new customers more efficiently?
I spent $5,000 on Google Ads and $3,000 on Meta Ads last month.
Show me the return for each and recommend how I should allocate
next month's $8,000 budget.
Attribution considerations
When comparing platforms, keep in mind that attribution models differ:
- Meta Ads typically uses a 7-day click / 1-day view attribution window by default.
- Google Ads often uses data-driven or last-click attribution.
- GA4 uses its own attribution model (data-driven by default).
This means the same conversion may be claimed by multiple platforms. Ask Claude Code to help you interpret these differences:
Both Google Ads and Meta Ads are claiming conversions for the same period.
Help me understand the overlap and estimate true incremental value
for each platform.
Combining with Shopify data
Cross-referencing Meta Ads data with Shopify orders gives you ground-truth performance numbers.
Compare Meta Ads reported purchases with actual Shopify orders
attributed to Meta campaigns. Are there discrepancies?
Show me Shopify orders where the UTM source is Facebook or Instagram.
What's the actual revenue vs. what Meta Ads reports?
Which Meta Ads campaigns are driving the highest-value Shopify customers
(repeat purchasers with high lifetime value)?
Optimization tips
Here are high-value questions to ask regularly:
Budget optimization
Which campaigns have the lowest cost per purchase?
I want to increase budget on the best performers and pause the worst.
Audience refinement
Show me which age/gender/location segments are converting best.
I want to narrow my targeting to the most profitable audiences.
Frequency management
Are any of my campaigns suffering from ad fatigue?
Show me campaigns where frequency is above 3 and CTR has been declining.
Funnel analysis
Show me the full funnel: impressions to link clicks to add-to-cart
to checkout to purchase. Where's the biggest drop-off?
Limitations and notes
- Read-only access -- Presso provides read-only access to your Meta Ads data. You cannot create, modify, pause, or delete campaigns, ad sets, or ads through Presso.
- Data freshness -- Meta Ads data is typically available within a few hours. Real-time performance may have slight delays.
- Attribution window -- Conversions are reported based on your ad account's attribution settings (default: 7-day click, 1-day view). Changes to attribution settings in Meta Ads Manager will be reflected in Presso reports.
- iOS 14+ impact -- Due to Apple's App Tracking Transparency (ATT) framework, some conversion data may be modeled or estimated, especially for iOS users. Meta uses statistical modeling to fill gaps.
- Breakdown limitations -- Not all metric and breakdown combinations are available in the Meta Ads API. If a requested combination is not supported, Claude Code will let you know and suggest alternatives.
- API quotas -- The Meta Marketing API has rate limits. Normal analysis usage stays well within these limits.
- Multiple ad accounts -- Each Presso connection is linked to one ad account. If you manage multiple ad accounts, connect each one separately.
- Historical data -- Meta Ads retains reporting data for up to 37 months. You can query data within this retention window.
- Currency -- All monetary values are reported in your ad account's currency.