Connect Meta Ads — MerchantFlow

Connect Meta Ads to MerchantFlow

The Meta Ads integration connects your Facebook and Instagram advertising accounts to MerchantFlow via OAuth, bringing campaign performance, ad spend, and conversion data into your unified e-commerce analytics dashboard. This lets you track Meta Ads ROI alongside your Google Ads, TikTok Ads, and commerce data in one place.

What Is the Meta Ads Integration?

MerchantFlow's Meta Ads integration syncs your Facebook Ads and Instagram Ads campaign data into MerchantFlow. This includes campaign-level performance metrics, daily ad spend, and conversion data that feeds into your P&L ad spend reports and marketing attribution views.

What You Need

Before connecting Meta Ads:

• MerchantFlow owner or admin access (check your role)
• Verified email and two-factor authentication enabled (Security Settings)
• A Meta (Facebook) user with access to the ad account you want to sync

How to Connect Meta Ads

1. Start Meta Ads from onboarding marketing or Settings > Integrations
2. Approve the Meta OAuth flow -- this requests the ads_read, ads_management, and business_management permissions
3. Open the Meta configuration step
4. Choose the ad account(s) to sync
5. Save the configuration

You can reconnect Meta with a different login at any time from Settings > Integrations if your business or ad account changes.

Connecting Multiple Meta Ad Accounts

MerchantFlow stores one row per connected Meta ad account, so a single workspace can track several ad accounts side by side. From the Meta card in Settings > Integrations you can:

• Add another ad account, including one reached through a different Meta login
• Rename an account with a friendly label so the dashboard shows something readable instead of a numeric ID
• Pause an account, which stops it syncing without deleting its history
• Remove account, which deletes that account's ad spend data

Spend from every enabled account rolls up into your ad spend reports. Health rolls up with error precedence: if one Meta account is broken, the card reports a problem even when the others are syncing, because total spend is no longer complete.

Excluding Campaigns From This Store's Profit

By default every campaign on a connected ad account counts towards this store's profit. If the same Meta ad account also runs campaigns for another store, you can leave those campaigns out:

1. Open Settings > Integrations and find the Meta Ads card
2. Click Campaigns on the ad account
3. Untick the campaigns that do not belong to this store, then Save

What happens next:

• The excluded campaigns' spend disappears from your P&L, dashboard KPIs, order and product margins, Markets and reports - including history that was already synced. Profit is recalculated in the background for the affected days; this can take a few minutes.
• Campaigns created later count automatically until you exclude them.
• Nothing is deleted. Re-tick a campaign at any time and its spend comes straight back; MerchantFlow does not need to re-import anything from Meta.
• The account row shows how many campaigns are excluded, and the picker shows each campaign's spend over the last 90 days so you can tell them apart.

If Meta cannot be reached when you open the picker, MerchantFlow still lists the campaigns it has synced spend for, so you can change the selection while a token or rate-limit issue is being sorted out.

What Data Does MerchantFlow Sync from Meta Ads?

• Campaign performance -- impressions, clicks, and engagement metrics
• Ad spend -- daily spend data for P&L tracking and ROAS calculation
• Conversion metrics -- marketing conversion data shown in MerchantFlow attribution views

Troubleshooting Meta Ads Issues

If Meta connects but no usable account appears:

• Confirm the Meta user has ad account access in Meta Business Manager
• Confirm there is an actual ad account attached to that Meta login
• Reconnect Meta and resave the selected account if access changed
• See Troubleshooting Integrations for additional diagnostic steps

Frequently Asked Questions

Does MerchantFlow support both Facebook Ads and Instagram Ads?

Yes. The Meta Ads integration covers both Facebook and Instagram advertising through a single connection, since both platforms are managed through Meta's unified ad system.

Can I connect multiple Meta ad accounts?

Yes. MerchantFlow supports multiple Meta ad accounts per workspace, each stored as its own connection with its own label, enabled state, and health status. You can also add accounts that live under a different Meta login.

Can I stop certain campaigns from counting towards profit?

Yes. Click Campaigns on the ad account under Settings > Integrations and untick the campaigns to exclude. All campaigns count by default, the change is applied to history as well as future syncs, and you can re-include a campaign at any time without re-importing anything. See Excluding Campaigns From This Store's Profit.

How does Meta Ads data appear in MerchantFlow?

Meta Ads spend and performance data appear in your marketing dashboards, ad spend reports, and attribution views alongside your other advertising channels.

Related Guides

• Google Ads -- Google paid search and Shopping ads
• Snapchat Ads -- Snapchat campaign tracking
• TikTok Ads -- TikTok campaign tracking
• Ad Spend Tracking -- unified ad spend in your P&L
• Attribution -- multi-channel attribution views

---

Last updated: August 29, 2026