Meta (Facebook & Instagram)
Connect your Meta ad accounts to sync campaigns, ad spend, and enable conversion tracking with CAPI.
Meta (Facebook & Instagram)
The Meta integration connects your Facebook and Instagram ad accounts to Atribu. It syncs your full campaign hierarchy with daily performance data and enables two-way data flow through the Meta Conversions API (CAPI).
What you get
- Full campaign structure: campaigns, ad sets, and individual ads
- Daily spend, impressions, clicks, reach, and frequency for every ad
- Video creative source URLs for previewing ads directly in Atribu
- Automatic traffic classification -- visits from Meta ads are labeled Paid Social
- Conversion export via CAPI so Meta can optimize your ad delivery
Connecting Meta
Open Integrations
Go to Settings > Integrations in your Atribu workspace.
Start the connection
Click Connect next to the Meta (Facebook & Instagram) card. You will be redirected to Facebook.
Authorize on Facebook
Sign in with the Facebook account that manages your ad accounts. Grant Atribu the requested permissions:
- Ads Read -- lets Atribu pull campaign data and performance metrics
- Ads Management -- lets Atribu send conversion data back to Meta (CAPI)
- Pages Read Engagement -- lets Atribu load video creatives from your Page
Grant all permissions
If you skip a permission, some features will not work. Video previews require Pages Read Engagement, and CAPI requires Ads Management.
Select ad accounts
Choose which ad accounts you want to sync. Atribu will begin importing data immediately.
What syncs
| Data | Description |
|---|---|
| Campaigns | Campaign name, status, objective, budget |
| Ad Sets | Targeting, placement, schedule, bid strategy |
| Ads | Creative, copy, video IDs, thumbnail URLs |
| Daily Spend | Spend amount, impressions, clicks, reach, frequency per day |
| Video Sources | Playable video URLs for previewing creatives in Atribu |
Performance metrics like CPM, CPC, and CTR are calculated in real time from the raw data (spend, impressions, clicks) rather than stored as static values. This means they always reflect the most up-to-date numbers, even after currency normalization.
Sync frequency
After connecting, Atribu runs an initial sync to import your historical data. After that, data syncs periodically throughout the day. You can also trigger a manual sync from Settings > Integrations at any time.
New campaigns and ads typically appear within a few hours of being created in Meta Ads Manager.
Meta Conversions API (CAPI)
The Meta Conversions API sends your conversion data (leads, purchases, appointments) back to Meta. This helps Meta's algorithm understand which ad clicks lead to real business outcomes, so it can optimize your ad delivery and find more people like your best customers.
In simple terms: Atribu tells Meta "this person clicked your ad and then became a paying customer," so Meta can show your ads to similar people.
Why CAPI matters
As browser privacy restrictions grow (cookie blocking, iOS tracking limits), server-side conversion data through CAPI becomes increasingly important for accurate ad optimization. Without it, Meta may not know that many of your conversions came from their ads.
Click ID tracking
Meta automatically adds a fbclid parameter to the URL when someone clicks your ad. For example:
https://yoursite.com/landing-page?fbclid=AbC123xYz...Atribu detects this click ID and uses it to:
- Classify the visit as Paid Social in your traffic breakdown
- Link the visitor to the specific Meta campaign, ad set, and ad they clicked
- Track whether that visitor later converts (fills a form, makes a payment, etc.)
You do not need to set up UTM parameters manually -- fbclid handling is automatic.
Re-authorization
Re-authorization may be needed
If Atribu adds new features that require additional Facebook permissions, you may need to re-authorize the connection. Go to Settings > Integrations and click Re-authorize next to Meta. This will show the Facebook permissions dialog again so you can grant the new permissions.
Troubleshooting
Video previews are not loading
Ad videos are owned by your Facebook Page, not your personal account. Atribu needs the Pages Read Engagement permission to access them. If you skipped this permission during setup:
- Go to Settings > Integrations
- Click Re-authorize next to Meta
- Make sure all permissions are granted
I do not see all my ad accounts
Your Facebook user account needs access to the ad accounts through Business Manager. Check that:
- You are an admin or advertiser on the ad account
- The ad account is part of a Business Manager you have access to
- You selected the correct ad accounts during the connection step
Data seems outdated
Meta rate-limits API requests, so there may be a delay of a few hours for the latest data. You can trigger a manual sync from Settings > Integrations to refresh immediately.