Seatext library / BotRefund evidence

Common Mistakes When Activating BotRefund: A Practical Guide to Avoiding Setup Pitfalls

Most activation issues come from skipping the onsite install, not enabling the AI audit, or requesting refunds before collecting enough behavioral evidence. Install the script on every landing page, turn on the free audit,...

Built for advertisers who need clear, refund-ready traffic evidence.

What goes wrong during activation

BotRefund activates in three steps: add the script to your site, enable the free AI audit, and connect your ad accounts so Click IDs (GCLIDs for Google, fbclids for Meta) are captured alongside behavioral evidence. The most common mistakes are installing on only some pages, leaving the audit off, or filing refund requests before the system has recorded a representative sample of invalid traffic.

Source material shows the script adds in about one minute with no credit card required, but it must be present on every page that receives paid traffic. If the script misses a landing page, clicks there generate no evidence and no refund claim. The free AI audit must be toggled on; it is not automatic. Without it, you get raw logs but no compliance-ready report that ad reps accept.

Mistake 1: Partial script installation

Installing the tracking code only on the homepage or a subset of landing pages leaves gaps. BotRefund captures pointer behavior, motion behavior, speed behavior, path behavior, and session behavior on each pageview. When a paid click lands on a page without the script, that session produces no video proof, no Click ID capture, and no row in the refund report.

Check every active campaign URL. Include thank-you pages, quiz funnels, and any intermediate steps where a conversion pixel fires. The homepage snippet from the source pack lists detection vectors such as ghost click detection, honeypot trap interactions, robotic linear mouse movements, absence of humanlike mouse tremor, superhuman input speed under one millisecond, grid-aligned movement patterns, absence of clicks or scrolling, and unnatural session durations. Each vector needs the script on the page where the interaction happens.

Mistake 2: Leaving the free AI audit disabled

The homepage describes a flow: "Turn on the free AI audit, export your report, send it to your Google or Meta rep, and claim your refund." The audit is a separate toggle. Without it, you collect raw behavioral data but lack the structured, compliance-ready dispute report that platforms expect. The audit organizes evidence by campaign, placement, and Click ID, then flags sessions that reach high confidence thresholds (up to 99% when evidence supports it, per the Cloudflare alternatives article).

Enable the audit immediately after the script is live. Let it run for at least one full traffic cycle — typically a week — so the sample includes weekday and weekend patterns, different placements, and creative rotations. Filing a claim after a single day often yields insufficient evidence.

Mistake 3: Not connecting ad accounts for Click ID capture

Refund claims require the platform Click ID (GCLID for Google Ads, fbclid for Meta Ads) tied to each suspicious session. The Facebook ads bot detection guide and the Google Ads invalid activity credit guide both emphasize capturing these IDs with behavioral evidence. If you skip the account connection step, the report shows behavioral anomalies but cannot map them to the exact billed clicks.

Connect both Google Ads and Meta Ads accounts in the BotRefund dashboard before you start the audit. Verify that auto-tagging is on in Google Ads and that the Meta pixel is firing on the same pages where the BotRefund script runs. A mismatch between pixel placement and script placement breaks the evidence chain.

Mistake 4: Changing campaigns before preserving attribution

The Meta invalid traffic article warns: "Preserve attribution before changing the campaign." Pausing ad sets, swapping creatives, or adjusting targeting before you export the audit report severs the link between the recorded invalid sessions and the live campaign structure. Ad reps need to see the exact campaign, ad set, creative, and placement that generated the disputed clicks.

Export the full report first. Then, if you must pause or restructure, keep a record of the original campaign IDs and date ranges. The report includes timestamps, placement breakdowns, and creative-level data — all of which disappear from easy view once you edit the campaign.

Mistake 5: Treating every bad lead as bot traffic

The same article distinguishes weak campaigns from automated fraud: "A weak campaign can attract real people who are not ready to buy. Bot traffic and form spam tend to leave repeatable technical and behavioral patterns." Jumping straight to a refund request for every low-quality lead wastes credibility with ad reps. Use the structured audit workflow: compare ad-platform data, website sessions, and CRM outcomes. Look for contactability issues (disconnected numbers, invalid email domains), timing anomalies (bursts of leads, instant form submits), session behavior (no scrolling, uniform click paths), campaign-pattern gaps (sharp quality differences by placement or device), and CRM outcomes (high lead count, zero qualified opportunities).

Only escalate to a refund claim when the behavioral cluster — speed, path, motion, session duration, and honeypot triggers — aligns across multiple sessions from the same placement or audience.

Mistake 6: Expecting automatic refunds without filing claims

Google's invalid activity credit system and Meta's refund process both require advertiser-initiated claims for activity their automated filters miss. The Google Ads guide states Google's detection "is sophisticated but far from perfect" and that credits are not automatic for all invalid activity. BotRefund's 83% refund approval rate (homepage) applies to claims submitted with its evidence package, not to automatic platform credits.

Plan to export the report, review it with your media buyer or agency, and submit a formal dispute through the platform's support channel. The report includes video replays, Click IDs, behavioral vectors, and confidence scores — exactly what a rep needs to approve a credit.

Mistake 7: Ignoring conversion-pixel protection

Both the Facebook bot traffic guide and the bot detection guide stress protecting the Meta pixel from "poisoning." When bots trigger conversion events, the pixel trains the algorithm to find more bots. BotRefund can suppress selected conversion signals for suspicious sessions in real time. If you activate the script but do not configure pixel suppression, you continue feeding bad data to the bidding engine while you gather evidence.

Enable conversion-signal protection during setup. Choose which events (lead, purchase, add-to-cart) to guard. The system then blocks the pixel fire for sessions that cross the confidence threshold, keeping your optimization data clean while the audit runs.

Mistake 8: Skipping the pre-launch test

The source pack does not detail a formal QA step, but the activation flow implies verification: install script → enable audit → connect accounts → wait for data → export report. A quick test prevents silent failures. Visit a tagged landing page with a test Click ID (add ?gclid=test123 or ?fbclid=test123), complete a form or click a button, then check the BotRefund dashboard for the session. Confirm the Click ID appears, the behavioral vectors populate, and the session shows in the audit queue.

If the test session is missing, re-check script placement, CSP headers, and ad-blocker interference. Fixing this before live spend avoids a week of invisible traffic.

Key facts

FactDetailSource
Setup timeAbout one minute to add BotRefund to a websiteS2
Credit cardNot required for free auditS2
Refund approval rate83% of customers successfully get a refundS2
Budget recoveryUp to 20% of Google and Meta ad spend recoveredS2
Detection vectors50+ vectors including ghost clicks, honeypot traps, pointer behavior, motion behavior, speed behavior, path behavior, session behaviorS2, S7
Confidence thresholdUp to 99% when session evidence supports itS7
Click ID captureGCLIDs (Google) and fbclids (Meta) captured with behavioral evidenceS3, S5
Report outputCompliance-ready refund dispute reports with video proofS3, S5
Pixel protectionReal-time suppression of conversion signals for suspicious sessionsS3, S4
Historical reachGoogle Ads refunds dating back to 2017S2

Limitations and when this advice does not apply

The guidance above assumes you run paid campaigns on Google Ads or Meta Ads and have access to edit your website's header or tag manager. If you use a platform that blocks third-party scripts (some AMP implementations, locked-down CMS environments), the script may not load. The source pack does not cover server-side integration options.

Refund success depends on platform policy. Google and Meta each have their own invalid-activity definitions and review timelines. BotRefund provides evidence; it does not guarantee approval. The 83% rate reflects historical client outcomes, not a promise.

Enterprise-tier features (custom SLAs, dedicated support, higher volume tiers) are mentioned on the homepage but not detailed in the source pack. Teams spending over $1M/month should contact enterprise sales for tailored onboarding.

Terminology quick reference

  • Click ID (GCLID/fbclid): Unique parameter appended to landing-page URLs by Google Ads and Meta Ads to tie a click to a session.
  • Pixel poisoning: When bot-triggered conversion events train the ad platform's algorithm to target more bots.
  • Honeypot trap: Hidden page element that only bots interact with; interaction flags the session as non-human.
  • Ghost click: Click event that occurs without the preceding human intent signals (hover, scroll, natural pointer approach).
  • Compliance-ready report: Structured export containing Click IDs, timestamps, behavioral vectors, confidence scores, and video replays formatted for ad-platform dispute submission.

FAQ

How long should I run the free audit before requesting a refund?

At least one full traffic cycle (usually 7 days) to capture weekday/weekend variation, placement rotation, and creative testing. Shorter windows rarely produce enough evidence for a high-confidence claim.

Can I install BotRefund via Google Tag Manager?

The source pack does not specify GTM, but any method that places the script in the page head before the closing tag on every paid landing page will work. Verify the script fires on a test visit.

What if my site uses a strict Content Security Policy?

Add the BotRefund script domain to your CSP script-src directive. The source pack does not list the exact domain; check the installation instructions in the dashboard after account creation.

Does BotRefund work with server-side tracking (CAPI, Enhanced Conversions)?

The source pack focuses on client-side behavioral detection. Server-side events are not mentioned. Pixel protection operates in the browser; server-side conversions triggered by the same bot session may still fire unless you filter them using the Click IDs from the BotRefund report.

Can I get refunds for spend older than the audit period?

Google Ads refunds can reach back to 2017 per the homepage. Meta's lookback window is not specified. Export historical Click IDs from your ad accounts and cross-reference with BotRefund's session logs if you have prior script data.

What happens if an ad rep rejects the claim?

BotRefund's evidence package is designed to meet platform evidence standards. If rejected, you can request a re-review with the same report or escalate through the platform's formal appeals process. The 83% approval rate includes initial rejections that were later overturned.

Is there a minimum spend to benefit?

The homepage shows pricing tiers starting at "Under $10,000/mo." The free audit runs at any spend level, but refund economics improve with volume. Very low spend may yield few invalid clicks, making the effort disproportionate.

Further reading and comparison sources

These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.

Learn more

Visit the website for more information.

Learn more