Documentation
MediaSafe documentation
How to connect your site, what verdicts mean, and how to read reports in the dashboard.
1. Quick start
- Sign up in the dashboard
- Add a site in Settings — get your key and snippet
- Install the snippet in your site's
<head>(see the setup guide) - First data appears in Overview within minutes
2. What verdicts mean
clean — visit looks like a regular human, score < 30 points.
suspicious — some suspicious signals (30–59 points), but not critical.
fraud — the combination of signals (60+ points) indicates a bot or manipulated traffic.
3. Main detection signals
- webdriver — browser automation (Selenium/Puppeteer)
- datacenter — visit comes from a hosting/datacenter IP, not a residential address
- traffic_exchange — signs of a traffic exchange in the User-Agent
- no_interaction — visit with no mouse movement, scroll or tap at all
- unauthorized_seller — SSP not authorized in the publisher's ads.txt/sellers.json (spoofing)
4. Blocklist and auto-blocking
Every IP with a fraud verdict goes into your dashboard's blocklist. Once you connect OAuth to Yandex.Direct/Google Ads (in Settings), the blocklist is automatically exported to your ad account.
5. Limits and plans
Each plan includes a monthly limit of scored events. At 90% of the limit you'll get an email alert; once fully used, new events are temporarily paused until the next period or a plan upgrade.
Snippet setup →