Pre-Bid Fraud Filter

Как это работает

На каждый входящий bid request ваш DSP вызывает pre-bid эндпоинт MediaSafe с IP запроса, User-Agent и вашим ключом сайта. MediaSafe возвращает решение allow/block меньше чем за 2 миллисекунды. При block DSP пропускает ставку — фрод-показ никогда не покупается.

Скоринг полностью stateless и в памяти: без обращения к БД в горячем пути. Блок-лист (IP, пойманные на кликах и показах) хранится в памяти и обновляется каждые 60 секунд.

Интеграция за три шага

Шаг 1 — вызывайте эндпоинт на каждый bid request

POST https://ingest.mediasafe.cc/prebid
Content-Type: application/json

{"site":"as_ВАШ_КЛЮЧ","ip":"203.0.113.45","ua":"Mozilla/5.0 ..."}

Или стандартным OpenRTB bid request — эндпоинт читает device.ip, device.ua и ключ из ext.mediasafe_key:

{"device":{"ip":"203.0.113.45","ua":"Mozilla/5.0 ..."},
 "ext":{"mediasafe_key":"as_ВАШ_КЛЮЧ"}}

Шаг 2 — читайте решение из ответа

Ответ приходит меньше чем за 2 мс:

{"decision":"block","verdict":"givt","score":100,"reasons":["datacenter"],"geo":"DE"}

Если decision = block — не участвуйте в аукционе за этот показ (фрод: датацентр, бот или известный фрод-IP). Если allow — торгуйтесь как обычно.

Шаг 3 — таймаут и fail-open

Установите короткий таймаут (5–10 мс). Если MediaSafe не ответил вовремя — считайте это allow, чтобы сбой фильтра никогда не ломал вашу закупку.

Поля ответа

decision	`block` / `allow` — действие, которое должен предпринять ваш DSP
verdict	givt (невалидный) или clean, по терминологии IAB
score	0–100 балл фрода
reasons	сработавшие сигналы: datacenter, known_bot_ua, headless_ua, known_fraud_ip
geo	код страны ISO по IP
ms	внутреннее время скоринга в миллисекундах

Что детектит

Pre-bid фильтр выполняет детерминированные проверки GIVT (General Invalid Traffic) — сигналы, оцениваемые мгновенно только по запросу:

Датацентры / хостинг IP

показы с серверной инфраструктуры — это не люди.

Известные боты и краулеры

Googlebot, headless-браузеры, инструменты автоматизации по User-Agent.

Известные фрод-IP

адреса, ранее пойманные на клик- или импрешн-фроде, из живого блок-листа.

Более сложный (SIVT) анализ — скорость, кросс-визитные паттерны — работает асинхронно на потоке показов и постоянно пополняет блок-лист, который использует pre-bid фильтр.

Примеры

Чистый трафик → allow

curl -X POST https://ingest.mediasafe.cc/prebid   -H "Content-Type: application/json"   -d '{"site":"as_your_key","ip":"203.0.113.45","ua":"Mozilla/5.0 (Windows NT 10.0) Chrome/122"}'

{"decision":"allow","verdict":"clean","score":0,"reasons":[]}

Датацентр-IP → block

curl -X POST https://ingest.mediasafe.cc/prebid   -H "Content-Type: application/json"   -d '{"site":"as_your_key","ip":"5.9.100.50","ua":"Mozilla/5.0 Chrome/122"}'

{"decision":"block","verdict":"givt","score":100,"reasons":["datacenter"]}

Начало работы

Получение ключа сайта и онбординг для pre-bid интеграции проходит вместе с нашей командой — напишите на support@mediasafe.cc.

Написать нам

Фильтр фрода до ставки