Google Ads

What It Does

Connect Google Ads and GeoSwap reads what each of your campaigns cost, every day, and adds it to Spend. The Attribution report then shows Spend, Cost / event and ROAS for your Google Ads campaigns next to the conversions GeoSwap records on your website. All Google Ads cost is counted under the Paid search channel.

GeoSwap only reads. It never creates, changes or deletes anything in your Google Ads accounts.

Before You Start

• A workspace admin connects Google Ads 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.
• Sign in with a Google account that can open your Google Ads accounts, directly or through a manager account.
• If the Google Ads card on Integrations says Coming soon, the connection isn't switched on in GeoSwap yet; email support@geoswap.co.

Before Google Verifies GeoSwap

Google is still checking GeoSwap's access to Google Ads (its standard review for this permission). Until it finishes:

• When you connect, Google shows a "Google hasn't verified this app" screen. Click Advanced, then "Go to GeoSwap (unsafe)", and continue. Google labels it unsafe only because its review isn't finished; GeoSwap only reads your Google Ads data. (Google's wording may differ slightly.)
• Until then Google lets up to 100 people in total connect GeoSwap to Google Ads. Once that's reached, Google shows an "Access blocked" page instead; contact support@geoswap.co.
• If your Google Workspace admin blocks unverified apps, ask them to allow GeoSwap, or wait until the review is done.

Connect Google Ads

1. In GeoSwap, open Integrations (in the Foundations menu) and find the Google Ads card.
2. Click Connect Google Ads.
3. Sign in with Google and allow the Google Ads permission. Keep its box ticked.
4. You land back on Integrations with "Google Ads connected." and the Manage Google Ads accounts popup opens by itself (if you close it, Choose accounts reopens it).
5. Tick the accounts to sync and click Save. Accounts you reach through a manager account show "via" its name; test accounts are marked.

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 account as "Synced" with the date, and "Connected as" with the Google account you used. To add or stop accounts later, click Manage accounts.

Permissions and Why

What Syncs, and How Often

• Once a day, from about 10: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 90 days, because Google 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, Google Ads cost replaces any Google Ads 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 Google Ads" instead of a box to type in.

Matching Campaigns

Cost is matched to the utm_campaign values on your ad clicks. A campaign that matches none is counted under Paid search with no campaign, so the channel's numbers stay right. For automatic matching, copy this line:

utm_source=google&utm_medium=cpc&utm_campaign={_campaign}&utm_id={campaignid}

1. In Google Ads, open your account settings and, under Tracking, paste it as the Final URL suffix.
2. On each campaign, under Campaign URL options, add a custom parameter named campaign with the campaign's name as its value. That's the name GeoSwap matches on (it also matches on the campaign ID in utm_id).
3. Leave auto-tagging on, so clicks are recognised as Paid search.

The Google Ads 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 Google Ads" table and a one-line status (manage it in Integrations).
• Attribution → Channels: Spend, Cost / event and ROAS on the Paid search row and its campaigns. With Group by set to Platform, Google Ads gets its own row with its spend and ROAS, and a Platform-reported column with Google's own conversions and value for the same weeks (labelled "Google-reported conversions").
• Campaign names: when a utm_campaign value is matched to a Google Ads 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 Google sends you back, GeoSwap shows one of these messages:

If Google later stops accepting GeoSwap's access (you removed it in your Google account, changed your password, or it went unused for 6 months), 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 → Google Ads → Manage accounts (admins):

• Stop one account: untick it and click Save. GeoSwap asks whether to delete the data synced from it or keep it in your reports. Kept accounts show "Not actively syncing".
• Disconnect Google Ads: GeoSwap asks, for each account, whether to delete its synced data or keep it. Disconnecting stops all access and revokes GeoSwap's access at Google (unless another GeoSwap workspace still uses the same Google sign-in).
• Delete data: next to an account that is no longer syncing, deletes what was synced from it.
• Delete all Google Ads data: offered once Google Ads is disconnected or its access has ended; deletes everything synced from Google Ads.

Reconnecting with a Google account that can't reach some of your syncing accounts asks the same question for just those accounts. You can also email support@geoswap.co from the address you connected with to have the data deleted.