Getting started
Install Spurn on your store, connect your ad accounts, pick how it should act, and check that your first paid click gets scored.
What Spurn does#
Spurn checks every paid click that lands on your store. It scores each visit from 0 to 100 using the visitor's network, device and behaviour, then gives it a verdict: valid, suspicious or invalid. Every verdict lists the reasons behind it, so you can see why a click was flagged. Organic visits are ignored: they are never sent to Spurn, never stored and never billed.
In protect mode, Spurn acts on invalid clicks. It adds the IP address or network to your Google Ads exclusion lists, including the account-level list that reaches Performance Max, and sends flagged visitors to exclusion audiences in Microsoft Ads and Meta Ads. Every change goes into a change log, and you can undo any of it. For clicks you have already paid for, Spurn builds refund claim packs you can file with Google.
Set up in four steps#
1. Create a workspace and a site#
Sign up at spurn.io/signup. The first run walks you through creating a workspace and your first site. A site is one store or domain, with its own keys, rules, allowlist and click log.
New workspaces also get a demo site filled with sample clicks, so you have something to look at before your own data arrives. The demo site is never billed and never touches your ad accounts.
Each site has two keys, under Sites, then your site, then the Keys tab:
| Key | Looks like | Used for |
|---|---|---|
| Public key | sp_pub_XXXXXXXX | The tag and the Shopify app. Safe to put in a page. |
| Secret key | sp_sec_XXXXXXXX | Server plugins, conversions and the REST API. Shown once. Keep it on your server. |
If you install the Shopify app from the App Store before you have a Spurn account, the app signs you up and creates the site, or links the store to a workspace you already have.
2. Install Spurn on your store#
Pick the guide for your platform:
| Platform | Guide | What gets installed |
|---|---|---|
| Shopify | Shopify guide | An app embed that loads the tag, and a web pixel that reports checkouts |
| WooCommerce | WooCommerce guide | A plugin: the tag, a server hit on paid landings, and order conversions |
| WordPress | WordPress guide | A plugin: the tag and a server hit on paid landings |
| Next.js | Next.js guide | The @spurn/next package: a script component, a proxy helper and server conversions |
| Anything else | Custom site guide | The one-line tag for Webflow, Wix, Squarespace, Google Tag Manager or your own code |
Every install comes down to the same tag:
<script async src="https://spurn.io/s.js" data-site="sp_pub_XXXXXXXX"></script>
On Shopify, the app sends you to the theme editor to switch the app embed on. Shopify does not let apps enable it on their own, so this one click is yours to make.
3. Connect your ad accounts#
Under Ad accounts, connect each platform you advertise on, choose the accounts to protect and link each one to the sites its ads land on.
| Platform | What Spurn does there | Guide |
|---|---|---|
| Google Ads | Adds flagged IPs to the account-level and campaign-level exclusion lists, imports your clicks every hour, and can set a tracking template for you | Google Ads guide |
| Microsoft Ads | Builds an exclusion audience from flagged visitors and attaches it to your campaigns | Microsoft Ads guide |
| Meta Ads | Builds an exclusion audience from flagged visitors and adds it to your active ad sets (Growth plan and up) | Meta Ads guide |
Detection works without connecting anything. Connecting is what lets Spurn block, match your landings to Google's own click records and estimate what invalid clicks cost you.
When you connect Google Ads and the account has no tracking template, Spurn offers to set one. It lets Spurn record the IP behind clicks whose page never loads. See Tracking template.
4. Choose a mode and a sensitivity#
In Sites, then your site, then the Rules tab:
- Mode. Monitor scores and reports every click but changes nothing in your ad accounts. Protect does the same and also pushes exclusions automatically. New sites start in protect. The Free plan is monitor only; automatic blocking starts on Starter.
- Sensitivity. Relaxed, Balanced or Strict. It sets how high a score must be before a click counts as suspicious or invalid. Balanced is the default.
Before you test anything, add your office or home IP address to the allowlist under Blocking, then Allowlist. Allowlisted addresses are never flagged, so your own test clicks and your team's ad checks never end up blocked.
More on both: Monitor and protect modes and Allowlist and rules.
Check the install works#
- Open your store with a test click id:
https://yourstore.com/?gclid=test-123. Change the number for each test. - Open Clicks in the dashboard. The visit shows up as a Google Ads click, first as pending.
- Close the tab, or wait three minutes. The click gets its final verdict and reasons.
- The site's Install tab now shows that Spurn is receiving landings. If you installed a plugin, the Next.js package or the Cloudflare Worker, it also shows when the last server hit arrived.
What to expect while testing:
- A visit without a click id shows nothing. Spurn only looks at paid landings: a URL with a click id such as
gclid,msclkidorttclid, or with a paidutm_mediumsuch ascpc. Organic visits are ignored by design. - Each test uses one credit. To Spurn it is a real paid landing.
- Repeated tests from one IP get flagged. More than 3 paid clicks from one IP in 24 hours triggers the Repeat clicks reason, and at Balanced that alone makes a click invalid. In protect mode your IP would be blocked. Allowlist yourself first.
- Tests from a VPN or a cloud server get flagged too. That is detection working.
What happens in the first day#
- Within minutes. Each paid click gets an instant verdict when the page loads and a final one when the visitor leaves, or three minutes after landing. In protect mode, a final invalid verdict creates an exclusion, and Spurn pushes it to every Google Ads account linked to the site.
- Every hour. Spurn imports your Google Ads clicks and matches them to landings by
gclid. That fills in campaign, keyword and an estimated cost per click. - After two hours. A Google Ads click with no landing on your store becomes a ghost click: billed, but the page never loaded.
- As visitors are flagged. Spurn sends them to your Microsoft and Meta exclusion audiences. An audience only includes the people the platform can match, so it fills up over time.
- Alerts. Spurn emails you when the invalid rate spikes within an hour, when an ad account needs reconnecting, when a site stops reporting while your ads run, and when you reach 80% and 100% of your monthly clicks. You also get a weekly summary.
What credits are#
One analysed paid click is one credit. Each plan includes a monthly allowance:
| Plan | Paid clicks a month |
|---|---|
| Free | 1,000 |
| Starter | 5,000 |
| Growth | 15,000 |
| Pro | 40,000 |
| Agency | 100,000 |
These never use a credit: organic visits, engagement updates on a click already counted, conversions, a second witness for the same click (a server hit, the tracking template or Google's own record), and anything on the demo site.
Clicks draw from your monthly allowance first, then from click packs (10,000 clicks for $15, never expire). If both run out, new clicks are still recorded but not analysed: no score, no blocking, and the dashboard marks them as unchecked. Exclusions already in place stay live. The allowance resets at the start of each billing period, or on the 1st of the month on the Free plan.
Plans and click packs are on the pricing page.