Коротко
- Раздел Pulse → Реклама (/advertising): подключаются Google Ads, Яндекс.Директ и Facebook Ads (Meta).
- Смысл интеграции — выгружать антифрод-данные в кабинеты, а не тянуть оттуда spend и клики в ClikBy.
- Google и Яндекс: блок-листы IP по выбранным кампаниям. Meta: негативные сигналы по fbclid ботов (Conversions API), IP-блок недоступен.
- Нужны умные ссылки с реальным бот-трафиком в данных — иначе синхронизировать нечего. OAuth-приложение настраивает администратор платформы.
Где это в кабинете
Откройте меню Pulse → Реклама. Там список рекламных кабинетов: создать, отредактировать, подключить через OAuth, запустить синхронизацию.
Ключи приложений Google / Yandex / Meta задаёт администратор ClikBy в настройках платформы. Вам не нужно вставлять App Secret в карточку кабинета — только Account ID своей рекламы и (для Meta) Pixel ID.
Аккаунт должен быть подтверждён (verified). Если кнопка Connect пишет, что учётные данные платформы не настроены — напишите в поддержку ClikBy.
Что даёт подключение — и чего не даёт
Делает
- Google Ads — добавляет фрод-IP в negative criteria кампаний (до 500 IP на кампанию), список ротируется по threat score.
- Яндекс.Директ — блокирует IP/подсети в кампаниях (до 25 слотов на кампанию; при ≥3 ботах из одной /24 может уйти целая подсеть).
- Meta / Facebook Ads — шлёт негативные сигналы через Conversions API (событие FraudDetected с fbclid бот-визитов). IP в Meta этим разделом не блокируются — у платформы другой механизм.
Не делает
- Не импортирует расходы, CPC, ROAS и «красивый дашборд кабинета» внутрь ClikBy.
- Не подключает TikTok или LinkedIn как рекламный кабинет в этом разделе (пиксели на ссылках — отдельная история).
- Не заменяет пиксель на умной ссылке и не отменяет настройку Smart Traffic.
Источник данных для синка — бот-решения и визиты по вашим ссылкам (blocked / bot_server / bot_filter). Режим Smart Filter safe пишет would_block и в этот экспорт не попадает.
Общие шаги
Создайте кабинет
Реклама → Новый: название, платформа, Account ID.
Подключите OAuth
На странице редактирования нажмите Connect (для Яндекса — отдельный сценарий с кодом).
Настройте синк
Период сбора фрод-данных 7/14/30 дней, автосинхронизация каждые 6 часов при желании.
Выберите кампании (Google / Яндекс)
Load campaigns → отметьте кампании для IP-блокировки → сохраните.
Для Meta укажите Pixel ID
И включите отправку negative signals через Conversions API.
Sync now
Проверьте журнал синхронизации. Дальше может работать автосинк по расписанию.
Google Ads
В Account ID укажите Customer ID вида XXX-XXX-XXXX (Google Ads → настройки аккаунта). Если кабинет под MCC — заполните Manager Customer ID (MCC), когда это нужно для API.
- Создайте запись типа Google Ads и сохраните.
- Нажмите Connect — откроется Google OAuth с доступом к Google Ads.
- После статуса Connected загрузите кампании и выберите, куда писать IP-исключения.
- Включите автосинк или жмите Sync now.
- На стороне ClikBy у администратора должны быть Client ID/Secret и Developer Token Google Ads API — без developer token подключение не считается полноценным.
- Лимит: до 500 IP на кампанию; список обновляется, старые IP могут сниматься при ротации.
Без выбранных campaign_ids синк IP в Google не выполнится — сначала Load campaigns и сохранение выбора.
Яндекс.Директ
В Account ID — логин кабинета или Client ID (как в интерфейсе агентства). В API это уходит как Client-Login.
- Создайте запись типа Яндекс.Директ.
- Нажмите получение кода авторизации — откроется oauth.yandex.ru (verification code).
- Скопируйте код и вставьте в форму «Подключить по коду».
- Загрузите кампании, выберите нужные, сохраните, синхронизируйте.
- До 25 записей BlockedIps на кампанию.
- Умная агрегация: если из одной подсети /24 пришло ≥3 бот-IP, система может заблокировать подсеть целиком (один слот ≈ 256 адресов).
Если валидация после кода падает — проверьте, что у OAuth-пользователя есть доступ к этому логину Директа.
Meta (Facebook Ads)
В интерфейсе платформа называется Facebook Ads. Укажите Ad Account ID (act_… или число). Пользователь Facebook, которым вы логинитесь в OAuth, должен иметь доступ к этому ad account.
- Создайте запись → Connect → авторизация Meta с нужными правами (ads, business и связанные scopes).
- Введите Facebook Pixel / Dataset ID — без него негативные сигналы не уйдут.
- Включите опцию отправки negative signals via Conversions API.
- Sync now или автосинк каждые 6 часов.
Как это работает: ClikBy берёт fbclid с бот-визитов по вашим ссылкам и отправляет в пиксель событие FraudDetected (батчами). Это помогает оптимизации Meta — не путать с IP-blacklist, которого у Facebook в этой интеграции нет.
Чтобы появлялись fbclid, люди должны кликать рекламу Meta по ссылкам ClikBy (в URL обычно есть fbclid). Без бот-визитов с fbclid отправлять нечего.
Синхронизация
| Настройка | Что делает |
|---|---|
| Автосинхронизация каждые 6 часов | Команда ad:sync-fraud для кабинетов с auto_sync и активным токеном |
| Период сбора фрод-данных | 7 / 14 / 30 дней — окно, из которого берутся бот-IP и fbclid |
| Sync now | Ручной пересчёт скоров + выгрузка IP или fbclid-сигналов |
| Журнал синхронизации | Логи oauth_connect, ip_exclusion, fbclid_exclusion, token_refresh |
Токены обновляются фоново (если истекают в ближайшие дни). Статусы кабинета: Connected / Disconnected / Error.
Типичные проблемы
- «Учётные данные платформы не настроены» — админ ещё не ввёл App ID/Secret (и Developer Token для Google).
- Google Connected, но синк пустой — не выбраны кампании или нет бот-IP за период.
- Яндекс: код принят, доступ не подтвердился — неверный Client-Login или нет прав.
- Meta: ошибка без pixel_id — укажите Pixel/Dataset ID и включите negative signals.
- Safe mode Smart Filter — решения would_block не попадают в сборщик фрод-IP для синка.
- Нет умных ссылок / нет ботов в данных — подключение кабинета само по себе «тишину» не лечит.
Сначала убедитесь, что детект на ссылках работает: гайд по детекту. Объяснение фрода простым языком — здесь.