Meta Ads

What It Does

Connect Meta and GeoSwap reads what each of your Facebook and Instagram ad campaigns spent, every day, and adds it to Spend. The Attribution report then shows Spend, Cost / event and ROAS for your Meta campaigns next to the conversions GeoSwap records on your website. All Meta spend is counted under the Paid social channel.

GeoSwap only reads. It never creates, changes or deletes anything in your Meta ad accounts.

Before You Start

• A workspace admin connects Meta and manages it (any plan). Editors can change how campaigns are matched (see Matching Campaigns below). Everyone in the workspace who can open Attribution can see whether it's connected.
• Use a Meta login that can see the ad accounts you want in Meta's business tools.
• If the Meta Ads card on Integrations says Coming soon, the connection isn't switched on in GeoSwap yet; email support@geoswap.co.

Before Meta Approves GeoSwap

Meta is still reviewing GeoSwap's app (its standard App Review for reading ads data). Until it finishes, Meta lets only people with a role on GeoSwap's app connect. If you'd like to connect now, contact support@geoswap.co to be added. Depending on what Meta does for people without a role, it may stop the sign-in, or let you finish and show no ad accounts to pick (GeoSwap then says none were shared): either way, contact support.

Connect Meta

1. In GeoSwap, open Integrations (in the Foundations menu) and find the Meta Ads card.
2. Click Connect Meta.
3. In Meta's dialog, choose the ad accounts GeoSwap may read and allow access.
4. You land back on Integrations with "Meta connected." and the Manage Meta ad accounts popup opens by itself (if you close it, Choose ad accounts reopens it).
5. Tick the ad accounts to sync and click Save.

GeoSwap starts loading the last 13 weeks right away (the card says "Loading the last 13 weeks…"); the daily sync finishes anything left. The card then shows each ad account as "Synced" with the date. To add or stop ad accounts later, click Manage accounts.

Permissions and Why

What Syncs, and How Often

• Once a day, from about 09:20 UTC, and when an admin clicks Sync now (at most once every 10 minutes).
• The first sync loads the last 13 weeks. After that, each day re-reads the last 28 days, because Meta keeps updating recent days.
• Daily campaign figures are kept 400 days. The weekly totals built from them stay in your reports until you delete them.
• For the weeks it syncs, Meta spend replaces any Meta spend you typed or uploaded on the Spend page. The Spend page tells you when that happens, and for those weeks the Spend grid shows "Synced from Meta" instead of a box to type in.

Matching Campaigns

Spend is matched to the utm_campaign values on your ad clicks. A campaign that matches none is counted under Paid social with no campaign, so the channel's numbers stay right. For automatic matching, set these URL parameters on your Meta ads:

utm_source=meta&utm_medium=paid&utm_campaign={{campaign.name}}&utm_content={{ad.name}}&utm_id={{campaign.id}}

In Ads Manager, on each ad, paste it into URL parameters (under Tracking). Meta fills in the campaign name and ID for you.

The Meta campaigns table on Integrations shows how each campaign is matched. Editors and admins can change a match or apply a suggestion.

Where the Data Shows Up

• Attribution → Spend: a "Synced from Meta" table and a one-line status (manage it in Integrations).
• Attribution → Channels: Spend, Cost / event and ROAS on the Paid social row and its campaigns. With Group by set to Platform, Meta gets its own row with its spend and ROAS, and a Platform-reported column with Meta's own purchases and their value for the same weeks (labelled "Meta-reported purchases").
• Campaign names: when a utm_campaign value is matched to a Meta campaign, reports show the campaign's name (a name you set yourself in GeoSwap wins).

If Connecting Doesn't Work

If something goes wrong after Meta sends you back, GeoSwap shows one of these messages:

If Meta later stops accepting GeoSwap's access (for example, GeoSwap was removed in your Meta Business settings), the card shows a red notice. Your synced spend stays in your reports. An admin can click Reconnect, or disconnect and choose what to keep.

Stop Syncing, Disconnect and Delete

Everything is in Integrations → Meta Ads → Manage accounts (admins):

• Stop one ad account: untick it and click Save. GeoSwap asks whether to delete the data synced from it or keep it in your reports. Kept ad accounts show "Not actively syncing".
• Disconnect Meta: GeoSwap asks, for each ad account, whether to delete its synced data or keep it. Disconnecting stops all access and deletes GeoSwap's access token.
• Delete data: next to an ad account that is no longer syncing, deletes what was synced from it.
• Delete all Meta data: offered once Meta is disconnected or its access has ended; deletes everything synced from Meta.

Disconnecting in GeoSwap doesn't remove GeoSwap from your Meta account. To remove it there too, open Meta Business Settings → Integrations → Connected apps and remove GeoSwap.

You can also request deletion from your Facebook settings (remove GeoSwap and choose to delete your data). Meta tells us and we delete everything at once; the link Meta gives you shows the request's status on geoswap.co/meta/data-deletion. Reconnecting with a Meta login that can't read some of your syncing ad accounts asks the keep-or-delete question for just those ad accounts.