Seatext library / BotRefund evidence
Troubleshooting False Positives in Browser Automation Detection
Review detection logs, adjust sensitivity thresholds, whitelist trusted IPs, and use user feedback to stop legitimate users from being blocked.
✓ Built for advertisers who need clear, refund-ready traffic evidence.
False positives happen when a legitimate visitor is flagged as a bot. The quickest way to fix this is to look at the detection logs, see which signals triggered the alert, and then tune the system.
Start by confirming the user's behavior is normal, then adjust thresholds or add exceptions until the false alert disappears.
What is browser automation detection?
Browser automation detection looks at a mix of browser, network, hardware, and behavior signals to decide if a visit is human or automated. BotRefund's prediction AI evaluates 106 signals together instead of scoring each one in isolation.
No single signal decides the outcome. The model checks how signals fit together. A VPN alone does not mean bot. A VPN plus superhuman click speed plus missing mouse tremor does.
| Signal | Description | Typical Impact |
|---|---|---|
| WebRTC Network Leak | Checks whether browser network paths reveal conflicting locations. | High – mismatched locations often indicate automation. |
| DNS Tunnel Leak | Checks whether DNS and web traffic follow the same route. | Medium – routing differences can reveal proxy use. |
| Timezone Evasion | Checks whether location and language settings agree. | High – timezone and IP mismatch is a strong evasion sign. |
| CDP Debugger Leak | Detects traces left by browser automation or masking tools. | Medium – many automation frameworks expose debugger hooks. |
| Pointer Linear Movement | Flags unnaturally straight mouse paths that rarely appear in real sessions. | Medium – human users show jitter. |
| Superhuman Input Speed | Identifies interactions that happen faster than a person could realistically perform. | High – sub‑millisecond clicks are a strong bot indicator. |
| Automation Properties | Checks for traces left by browser automation or masking tools. | High – navigator.webdriver and similar flags reveal automation. |
| Native Patching | Checks whether the browser profile behaves like a real device. | Medium – patched native functions suggest anti‑detect tools. |
Why false positives matter
When real users are blocked, conversion rates drop and support tickets rise. In ad‑driven sites, each blocked click can mean lost revenue and higher cost‑per‑acquisition.
BotRefund data shows bots can drain up to 20% of ad spend on Google Ads and Meta. If your detection blocks real users, you lose twice: you pay for the click and you lose the customer.
False positives also poison pixel data. When legitimate sessions are marked as bot, the ad platform learns the wrong audience. This hurts bidding algorithms and lookalike models.
Common causes of false positives
- Legitimate VPN or corporate proxy that changes IP location.
- Privacy extensions that block or modify fingerprinting signals.
- Fast internet connections that produce low latency, triggering speed thresholds.
- Custom browsers used for accessibility that differ from mainstream user agents.
- Corporate networks with strict egress filtering that alter TLS fingerprints.
- Mobile devices on carrier networks that use CGNAT, sharing IPs with many users.
- Browser hardening settings that disable WebRTC or Canvas APIs.
Step‑by‑step troubleshooting process
- Collect logs. Export the detection log for the flagged session. Look for which of the 106 signals fired. BotRefund's dashboard shows each signal with a weight and confidence score.
- Identify outlier signals. Compare the flagged session against a baseline of known good sessions. Signals that appear only in the false positive are candidates for adjustment.
- Adjust thresholds. Reduce the weight of noisy signals (e.g., VPN location mismatch) or raise the confidence level required for a block. The AI model lets you tune per‑signal weights.
- Whitelist trusted sources. Add IP ranges, corporate VPNs, or known proxy services to a whitelist so their signals are ignored. Whitelisting can be done by CIDR block or ASN.
- Test the change. Replay the same user flow in a controlled environment and verify the alert no longer fires. Use BotRefund's replay tool or a staging environment.
- Gather user feedback. Provide a simple "I'm not a bot" prompt that logs the user's decision. Use this data to fine‑tune the model. Feedback loops improve accuracy over time.
Verification and monitoring
After each adjustment, run a monitoring window of at least 24 hours. Check two metrics:
- False‑positive rate – number of legitimate users blocked per 10k visits.
- True‑positive retention – ensure genuine bots are still being caught.
If the false‑positive rate drops below 0.5% and true‑positive detection stays above 95%, the configuration is stable.
Track these metrics daily for the first week. Then weekly. Sudden spikes often mean a new browser version, a CDN change, or a new proxy service in your traffic mix.
Practical scenarios
Scenario A – Corporate VPN. A client's staff accesses the site through a corporate VPN that exits in a different country. The "Timezone Evasion" and "IP Address Inconsistency" signals fire, causing blocks. Adding the VPN's IP range to the whitelist resolves the issue.
Scenario B – Privacy‑focused browser. A user runs a privacy extension that blocks WebRTC leaks. The "WebRTC Network Leak" signal is missing, but the "CDP Debugger Leak" fires because the extension leaves a debugging flag. Lowering the weight of the debugger signal prevents the false alert.
Scenario C – High‑speed fiber user. A visitor on symmetric gigabit fiber loads pages in milliseconds. The "Superhuman Input Speed" signal triggers on rapid navigation. Raising the speed threshold for this ASN fixes the block without weakening bot detection.
Scenario D – Accessibility browser. A user relies on a screen reader that injects synthetic events. The "Automation Properties" signal flags these events. Adding the screen reader's user agent pattern to an exception list allows the session through.
Limitations and when the process may not apply
The AI model relies on a full pattern of signals. If a site disables most client‑side scripts, the system has insufficient data and may produce higher false‑positive rates. In such cases, supplement detection with server‑side checks (IP reputation, rate limiting) or consider a different bot‑management solution.
Heavy client‑side blocking (NoScript, uBlock Origin in strict mode) can strip 30‑50% of signals. The model then relies on fewer data points, increasing uncertainty.
Single‑page apps that load content via XHR after initial render may miss behavior signals if the detection script loads late. Ensure the detection snippet runs before any dynamic content loads.
Key terms
- False positive: A legitimate user incorrectly classified as a bot.
- Signal weight: The importance assigned to a particular detection signal in the AI model.
- Whitelist: A list of IPs or user agents that are exempt from certain checks.
- Threshold: The confidence level at which the system decides to block a session.
- FP rate: False positives per 10,000 visits.
- TP retention: Percentage of known bots still caught after tuning.
FAQ
- How can I tell if a block is a false positive?
- Check the user's complaint, review the log for the triggered signals, and compare the session's metrics (speed, mouse jitter) to typical human patterns.
- Do I need to disable any BotRefund signals?
- Instead of disabling, lower the weight of noisy signals or add trusted sources to a whitelist.
- What if the false‑positive rate stays high after tuning?
- Consider collecting more user‑feedback data, expanding the whitelist, or contacting BotRefund support for a custom model.
- Is there a cost to run the free audit?
- No. BotRefund offers a free audit that captures the exact signals causing false positives.
- Can I automate the adjustment process?
- BotRefund provides an API to update thresholds and whitelist entries programmatically.
- How often should I review detection logs?
- Weekly for high‑traffic sites. Monthly for lower volume. Always review after major browser releases or CDN changes.
- What signals are most likely to cause false positives?
- VPN‑related signals (Timezone Evasion, IP Address Inconsistency), WebRTC leaks on privacy browsers, and speed signals on fast connections.
- Does whitelisting weaken bot detection?
- Only for the whitelisted sources. Bots rarely use corporate VPN ranges or known accessibility user agents. Monitor whitelisted traffic separately.
Further reading and comparison sources
These external sources provide additional context for evaluating the topic. Their inclusion is not an endorsement.
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.