Skip to content

Отчёты и уведомления

Adsafee позволяет автоматизировать получение отчётов, делиться ими с коллегами и получать оперативные алерты о подозрительных всплесках трафика.

Отчёты по расписанию

Вы можете настроить автоматическую отправку отчёта по расписанию. Откройте нужный отчёт в Статистике и нажмите Расписание.

ПараметрОписание
ЧастотаОт каждых 30 минут до ежемесячно
Период данныхКакой период охватывает отчёт (последний час, сутки, неделя и т.д.)
Канал доставкиКуда отправлять (Email, Slack, Telegram)
Срок действияКогда прекратить отправку (опционально)

Отчёты по расписанию можно приостановить и возобновить в разделе Отчёты → вкладка Scheduled Reports.

Каналы доставки

Перед созданием отчёта по расписанию или алерта настройте хотя бы один канал:

КаналОписание
EmailОтчёты и алерты приходят на указанный адрес
SlackОтправка через Incoming Webhook. В интерфейсе есть пошаговая инструкция по настройке
TelegramОтправка через бота. Поддерживаются личные сообщения и групповые чаты
WebhookPOST-запрос на ваш HTTPS endpoint. Запрос подписывается секретом канала

Тестирование

Любой канал можно протестировать перед использованием — кнопка Test отправляет тестовое сообщение.

Важно

Отчёты по расписанию поддерживают Email, Slack и Telegram. Алерты о фроде можно отправлять в Email, Slack, Telegram или Webhook.

Алерты о фроде

Алерты помогают автоматически обнаруживать всплески по метрикам трафика. Откройте раздел Алерты и нажмите Новый алерт.

Правило алерта состоит из области проверки, условий, расписания и канала доставки:

ПараметрОписание
ИнтеграцияОбязательная интеграция, трафик которой будет проверяться правилом
Группировка по subsПо каким sub1sub6 объединять трафик. По умолчанию используется sub2:sub3
УсловияГруппы условий по количественным и процентным метрикам. Поддерживаются операторы: больше, не меньше, меньше, не больше, равно, не равно
ПериодЗа какой последний интервал агрегировать трафик: 5, 10, 15, 30 минут, 1 час, 3 часа, 6 часов или 12 часов
ЧастотаКак часто проверять правило: 5, 10, 15, 30 минут или 1 час
Пауза между повторамиЧерез сколько можно снова отправить алерт по той же зоне. Доступно: выключено, 30 минут, 1 час, 2 часа, 4 часа или 1 день
Первая проверкаМожно запланировать первый запуск в будущем или оставить пустым, чтобы начать сразу
КаналEmail, Slack, Telegram или Webhook канал доставки

При проверке Adsafee агрегирует события за выбранный период, группирует их по выбранным sub-полям и создаёт событие алерта для каждой зоны, где условия выполнены. Чтобы не отправлять одинаковые уведомления слишком часто, правило учитывает паузу между повторами для той же комбинации правила, интеграций и зоны.

Проверка правила

Перед сохранением нажмите Проверить. Adsafee покажет, сколько событий сработало бы в текущем окне, список найденных зон и пример payload для доставки.

История срабатываний

На вкладке События в разделе Алерты видны все срабатывания правил. Список можно фильтровать по статусу и искать по названию правила, зоне, группировке или каналу.

СтатусЧто означает
PendingСобытие создано, доставка ещё не завершена или ожидает повторной попытки
ДоставленоУведомление успешно отправлено в канал
ОшибкаДоставка не удалась

В деталях события доступны окно проверки, зона, метрики, количество попыток, ошибка доставки и технический контекст payload.

Webhook для алертов

Webhook-алерт отправляется POST-запросом с JSON payload:

json
{
  "schema_version": "fraud_alert.v1",
  "event_id": "string",
  "rule": { "id": 123, "name": "High fraud by zone" },
  "workspace_id": 1,
  "integration_id": 10,
  "zone": { "grouping": "sub2:sub3", "key": "source:campaign" },
  "window": { "minutes": 10, "start": "2026-06-11T10:00:00+00:00", "end": "2026-06-11T10:10:00+00:00" },
  "conditions": {},
  "metrics": { "hits": 120, "givt_total_rate": 35 },
  "context": { "top_countries": ["US"], "top_asns": ["Example ASN"] }
}

Запрос содержит заголовки:

ЗаголовокОписание
X-Adsafee-Event-IdУникальный ID события
X-Adsafee-TimestampUnix timestamp отправки
X-Adsafee-SignatureHMAC-SHA256 подпись в формате sha256=<hex>

Подпись считается по строке <timestamp>.<raw_body> с секретом webhook-канала. Endpoint должен быть HTTPS URL без логина и пароля; приватные, loopback и зарезервированные IP-адреса блокируются.

Ограничения

В одном workspace можно создать до 20 правил алертов. За один цикл проверки правило создаёт не больше 50 событий, а workspace — не больше 200 событий.

Общий доступ по ссылке

В Статистике нажмите Поделиться, чтобы создать публичную ссылку на текущий отчёт.

INFO

Ссылка работает без авторизации — её можно отправить клиенту или коллеге, у которого нет аккаунта. При создании можно задать срок действия или сделать ссылку бессрочной.

Все общие ссылки видны на вкладке Shared Links в разделе Отчёты, где их можно скопировать или удалить.

Экспорт

Данные из Статистики можно выгрузить в CSV или Excel через кнопку Экспорт в панели управления.

Что дальше

Adsafee — защита рекламного трафика от фрода