PlugsightDocs

Meta Ads

Connect Meta Ads so your AI can report on Facebook and Instagram ad spend, reach, results and ROAS next to Google and Microsoft Ads. Read-only.

Updated

Connect Meta Ads and your AI can report on every Facebook and Instagram ad account your Facebook login can open, in the same conversation as Google Ads and Microsoft Advertising. Plugsight only reads: it never changes campaigns, ad sets, ads, budgets or audiences.

What your AI can do

  • Report on ad accounts, campaigns, ad sets and ads, for any date range, per day or per month.
  • Show spend, impressions, reach, frequency, clicks, link clicks, CTR, CPC and CPM.
  • Show purchases, purchase value, ROAS, leads, cost per lead, adds to cart, checkouts started, registrations and landing page views.
  • Break results down by age, gender, country, region, platform (Facebook, Instagram, Audience Network, Messenger), placement, device and hour of the day.
  • Show campaign settings: status, objective, budget and bid strategy.
  • Include Meta Ads in the account overview and period comparison deep dives.

See How your AI analyses marketing data for how these tools work.

Example questions

  • "How much did we spend on Meta last month, and what was the ROAS by campaign?"
  • "Which ad sets have the highest cost per lead this month?"
  • "Is Instagram or Facebook cheaper per purchase for us?"
  • "Which ads are being shown too often to the same people?"
  • "Compare Meta, Google Ads and Microsoft Ads spend and conversions for the last 30 days."

What you need

  • A Pro or Agency plan, or the Free plan to try it: Free includes 1 marketing connection and 25 marketing tool calls a month. See Plans.
  • A Facebook account that can open your ad accounts in Meta Ads Manager.

Connect Meta Ads

  1. Open Connections and click Add connection.
  2. Choose Meta Ads (Facebook & Instagram).
  3. Log in to Facebook with the account that can open your ad accounts, if you aren't logged in already.
  4. Meta shows that Plugsight wants to read your ads. Continue, leaving that permission on.
  5. You're back on Connections, with a message such as "Connected Alex Morgan: 3 Meta ad accounts."

Then add the connection to an MCP server (or use a server set to All accounts). If this is your first marketing connection, refresh the tools list in your AI app and start a new chat.

To choose which ad accounts your AI can see, click Show sites & accounts next to the connection. See Choose which sites and accounts your AI can see.

What it can and can't change

Meta Ads is read-only in Plugsight. It only asks Meta for permission to read your ads, so your AI can't pause campaigns, change budgets or bids, or edit ads and audiences.

Limits

  • Meta's sign-ins last about 60 days and can't be renewed in the background. When yours expires, the connection asks to be reconnected: connect it again the same way.
  • Conversions and conversion value count purchases. To count another result, such as leads, ask your AI to use that result instead.
  • Reach counts each person once, so it can't be added up across days or ad accounts. For one ad account, ask for it without a daily split to get one figure. Across several ad accounts, combined reach shows as empty: ask for reach by account instead.
  • Meta only allows some breakdowns together: age with gender, and platform with placement and device. Ask for other combinations in separate questions.
  • Accounts in different currencies are added as-is, and your AI is told so. Ask it to split results by account.

Troubleshooting

Your Free plan includes 1 marketing connection. Upgrade to Pro to connect more.

What it means: the Free plan includes 1 marketing or analytics connection to try, and you already have that many.

How to fix it: remove the marketing connection you don't need on Connections, or upgrade to Pro or Agency on Billing.

Meta Ads isn't set up on this server yet.

What it means: This Plugsight server has no Meta app set up.

How to fix it: Contact info@plugsight.app.

You didn't allow access in Meta. Click Connect again and allow it, ticking every permission box.

What it means: You cancelled on Meta's screen.

How to fix it: Connect again and continue on Meta's screen.

Meta Ads access wasn't granted. Click Connect again and allow Plugsight to read your ads.

What it means: You turned off the permission to read your ads on Meta's screen.

How to fix it: Connect again and leave that permission on.

This login doesn't reach anything yet.

What it means: The Facebook account has no ad accounts it can open.

How to fix it: Ask the ad account's admin to give that Facebook account access in Meta, then click Refresh list. Or connect again with the right account.

This Meta Ads sign-in expired on …: Meta sign-ins last about 60 days. Reconnect Meta Ads on the Connections page.

What it means: About 60 days have passed since you connected, and Meta's sign-in has run out.

How to fix it: On Connections, connect Meta Ads again. Your hidden ad accounts and MCP servers stay as they were.

Meta no longer accepts this Meta Ads sign-in: it expired (Meta sign-ins last about 60 days) or access was removed. Reconnect Meta Ads on the Connections page.

What it means: Meta stopped accepting the sign-in early, for example because the Facebook password changed or Plugsight was removed from the account's apps.

How to fix it: On Connections, connect Meta Ads again.

Meta is limiting requests … right now. Wait a few minutes before asking again, and ask for fewer accounts or a shorter date range.

What it means: Meta allows only so many requests in a short time, for a login, an ad account or an app.

How to fix it: Wait a few minutes, then ask again, ideally about fewer ad accounts or a shorter period.

Meta can't return that much data at once. Ask for a shorter date range, fewer fields or fewer accounts.

What it means: The question asked Meta for more rows than it returns in one go.

How to fix it: Ask about a shorter period, fewer breakdowns or fewer ad accounts.