Skip to content
Browse the docs

Google Ads

Spurn blocks the networks behind fake clicks in your Google Ads account, imports every click Google billed you for, and builds refund claim packs from the clicks that should not have cost you anything.

What Spurn does in Google Ads#

What happensHow often
IP exclusionsFlagged IPs and /24 blocks go into your account's IP exclusion listsWithin five minutes of a verdict
Click importEvery billed click from Google's click report, matched to your landings by gclidHourly
Campaign statsClicks, cost, conversions and the clicks Google itself filtered as invalid, per campaign and dayHourly
Tracking templateSpurn offers to set its template when your account has noneOnce, when you ask
Placement exclusionsApps, sites and channels that send junk clicks, excluded account-wideWhen you choose them
Refund claimsAn evidence pack for Google's click quality teamWhen you build one

Placement exclusions need the Pro or Agency plan. Refund claim packs need Growth or higher. IP exclusions need any paid plan; on Free, Spurn detects and reports but does not push anything.

Connect your account#

  1. In Spurn, open Ad accounts and choose Connect Google Ads.
  2. Sign in with the Google account that can open your Google Ads account. Google now asks for a passkey when you authorise a new app for the Google Ads API. If you have never made one, Google walks you through it.
  3. Allow access to Google Ads. Leave the box ticked, or Spurn cannot see your account.
  4. Back in Spurn, every account you can reach is listed, including client accounts under a manager account.
  5. Enable the accounts you want protected. Your plan sets how many.
  6. Link each account to the sites its ads land on. Spurn only blocks a site's offenders in accounts linked to that site, and only matches clicks to landings on linked sites.

Manager accounts are listed so you can see the structure, but they cannot be enabled. Enable the client accounts under them. Spurn reaches those through the manager, so the person who connects needs access to the manager.

How the exclusion lists fill up#

Google gives every account one account-level IP exclusion list and one list per campaign, each capped at 500 entries.

  1. The account-level list first. It is the only list Performance Max honours, and it applies to every campaign in the account: Search, Shopping, Display, Demand Gen, YouTube, App and Performance Max.
  2. Then campaign lists. When the account list is full, further entries go on every enabled Search, Shopping and Display campaign. Google does not allow campaign-level IP exclusions on Performance Max, App, Video, Hotel or Smart Display campaigns, so those campaigns only get the account list.

By default Spurn uses 400 of the 500 slots in each list, leaving 100 for entries you add yourself. You can change that per account, from 0 to 500. Entries you made yourself are never touched, and they count towards Google's 500: if you already have 300 in the account list, Spurn uses at most 200 there.

When the lists are full, the worst offenders stay. Spurn ranks entries by their reasons (a known bot or an automated browser outranks a busy office network), then by what the network has cost you, then by how recently it misbehaved. A new entry that outranks the lowest one on the list takes its place: the lower one comes out of Google Ads and waits in Spurn as "Waiting for a free slot". Entries of equal rank never swap, so a full list does not churn.

Removing an entry. When an exclusion expires or you remove it, Spurn deletes exactly the entry it created in Google Ads and nothing else. Every add, removal and swap is in the block list's change log.

Switching blocking off for an account takes Spurn's entries back out of Google Ads. Click and stats imports carry on.

Disconnecting wipes Spurn's access straight away, so Spurn can no longer remove anything: its entries stay in your account until you delete them. If you want them gone, switch blocking off (or disable the account), wait a few minutes for the removal, then disconnect.

What Google does and does not allow#

  • No IP in Google's click report. Google reports each click with its gclid, campaign, keyword and location, but never the IP. Spurn gets the IP from its tag or the tracking template on your site and joins the two on the gclid.
  • Ghost clicks. A click Google billed that never loaded your page, two hours later, is a ghost click. Bots that request the ad link and leave produce them. The tracking template turns many of them into scored clicks with an IP.
  • Performance Max. IP exclusions reach Performance Max only through the account-level list. Google does not say whether every Performance Max and Shopping click appears in its click report, so ghost-click counts for those campaigns may be incomplete.
  • App campaigns for installs carry no gclid, so their clicks cannot be matched.
  • Click report history reaches back 90 days. Spurn imports the last seven days when you connect, then keeps up hourly.
  • Google's own filtering. The invalid clicks Google already filtered (and did not charge you for) are shown per campaign next to Spurn's numbers. Spurn's refund claims only cover clicks Google did bill.

Tracking template#

The tracking template lets Spurn see the IP behind a click even when the page never loads. If your account has no account-level template, Spurn offers to set it for you from the account's page. If one is already set, usually by another tracking tool, Spurn leaves it alone and shows you its own so you can decide. See Tracking template.

Placement exclusions#

On Pro and Agency, each Google Ads account has a Placements view. It lists the apps, sites and YouTube channels that sent you clicks, worst first, with:

  • Spurn's verdicts on clicks from that placement, and the share that were invalid;
  • Google's clicks, cost and conversions for it over the same days.

A placement counts as junk when at least three of its clicks reached Spurn and half or more were invalid, or when Google shows 20 or more clicks with no conversions. Choose the ones to exclude and Spurn adds them to the account-level placement exclusion list, which Performance Max honours too. Google allows 65,000 entries per account and can take up to 12 hours to apply them. Performance Max reports impressions only per placement, so its junk shows up through Spurn's verdicts rather than Google's clicks.

Refund claims#

Spurn builds a claim pack from the invalid clicks Google billed you for, plus ghost clicks, with a CSV and a summary to paste into Google's click quality form. See Refund claims.

When something goes wrong#

  • "Reconnect Google Ads". Google stopped accepting Spurn's access: the person who connected removed it, lost access to the account, or changed their Google security settings. Blocking pauses for that connection's accounts until someone reconnects. Reconnecting as the same Google user picks up where it left off, with the same accounts and settings.
  • An account shows an error. Google refused a change and Spurn shows Google's reason. The usual one is read-only access: the person who connected needs Standard or Admin access to the account.
  • An account is missing. Cancelled and suspended accounts are skipped. Client accounts appear only when the person who connected can reach them, directly or through a manager. Use Look for new accounts after you add access.
  • Entries that keep failing are retried after 2, 8, 32 and 128 minutes, then stop and raise an alert. Retry on the account's page sends them again.