Как настроить Keitaro: полный гайд от AcePartners

Лить на iGaming без трекера — это фактически работа вслепую. Без него невозможно адекватно контролировать профит и вовремя отключать адсеты, которые просто сжигают бюджет. При этом жесткая модерация рекламных платформ не оставляет шансов без филигранной настройки клоакинга: нужно четко разделять потоки, чтобы модераторы и боты попадали на вайт-пейдж, а целевой трафик — на оффер. 

Для этого гайда специалисты Ace Partners по шагам разобрали настройку Keitaro, которая позволит проходить модерацию и видеть прозрачную статистику по каждому депозиту.

Подготовка Keitaro к работе

Прежде чем переходить к созданию кампаний и добавлению офферов, важно подготовить сам трекер. Базовые настройки после установки работают неплохо, но для работы с гемблингом их нужно усилить. Правильная конфигурация на старте позволит системе точнее фильтровать ботов и не пропускать модераторов на блэк-пейдж.

Настройка определения ботов

Первым делом нужно зайти в раздел «Обслуживание», «Настройки» и перейти во вкладку «Боты». Здесь стоит включить все доступные тумблеры для определения ботов.

Это активирует встроенные алгоритмы Keitaro, которые анализируют технические параметры зашедших по ссылке пользователей. Чем больше таких проверок включено, тем меньше шансов, что боты или модераторы пробьют клоаку.

Добавление списков IP и User-Agent

Стандартных баз трекера часто бывает недостаточно, особенно при работе с Facebook*. Чтобы защита была эффективнее, имеет смысл добавить в трекер актуальные списки IP-адресов, которые принадлежат серверам и дата-центрам соцсети. 

Актуальный список айпишников ботов и модераторов можно найти по этой ссылке — автор репозитория регулярно обновляет его.

В той же вкладке «Боты» находим пункт «Подключить дополнительный список IP» и вносим туда IP-адреса.

Помимо IP-адресов, ботов можно вычислить по User Agent — строке, которая передает данные о браузере и операционной системе. Многие автоматизированные скрипты используют специфические подписи, которые никогда не встречаются у обычных пользователей.

facebot

Python-urllib

python-requests

zgrab/0.x

Wget(linux)

facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)

facebookexternalhit/1.1 (http://www.facebook.com/externalhit_uatext.php)

Go-http-client/1.1

Go-http-client/2.0

Python/3.6 aiohttp/3.4.4

CheckMarkNetwork/1.0 (+http://www.checkmarknetwork.com/spider.html)

nadesiko

Jetty/9.4.15.v20190215

facebook

facebot

facebookexternalhit/1.0

Jersey/2.25.1 (Apache HttpClient 4.5)

Mediapartners-Google

Surf/1.0 (Linux 4.4.0-116-generic; go1.12)

SafeDNSBot (https://www.safedns.com/searchbot)

Mozilla/5.0 (compatible; YandexBot/3.0; +http://yandex.com/bots)

Mozilla/5.0 (compatible; BomboraBot/1.0; +http://www.bombora.com/bot)

dianomi bot / 1.0 ([email protected])

Ruby

Jetty/9.4.15.v20190215

weborama-fetcher (+http://www.weborama.com)

ShortLinkTranslate

bitlybot/3.0 (+http://bit.ly/)

facebookexternalhit/1.1 ( http://www.facebook.com/externalhit_uatext.php)

facebook

facebookexternalhit/1.0

proximic

facebookexternalhit/1.1

Чтобы их отсечь, в поле «Дополнительный список сигнатур User Agent’ов» нужно добавить список известных ботов. Так мы закроем еще одну лазейку для ботов, которые пытаются выдать себя за рядовых юзеров.

Обновление баз данных

Чтобы фильтры по странам и мобильным операторам работали без ошибок, информация внутри Keitaro должна быть свежей. Для этого переходим в раздел «Гео Базы» и нажимаем «Обновить все». 

Система в фоновом режиме подтянет актуальные данные о провайдерах и местоположении IP. Это важно для корректного распределения трафика: если база устареет, трекер может ошибиться с ГЕО пользователя и отправить потенциального игрока на вайт-пейдж или вовсе на пустую страницу.

Шаг 1. Добавляем источник трафика

Настройка источника это этап, на котором новички чаще всего совершают ошибку, выбирая в списке Facebook*. В 2026 году, когда большинство вебов заливают на PWA-приложения, воронка работает иначе. Клик в трекер приходит не напрямую из соцсети, а из инфраструктуры вашего сервиса приложений.

Для Keitaro источником является именно PWA-сервис, а не Facebook*. Если вы укажете соцсеть в качестве источника, трекер может некорректно считать данные, которые передает сервис аренды прил. 

Сервисы аренды приложений зашивают в ссылки свои макросы: ID клика, ID креатива и данные о токене. Чтобы Keitaro распознал эти данные и разложил их по sub-меткам, в настройках источника должны быть прописаны соответствующие параметры.

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

Переходим в раздел Traffic Sources и жмем Create.

Если вы работаете с крупным сервисом аренды PWA или WebView, проверьте наличие готового шаблона в списке.

Если шаблона под ваш сервис нет, придется создать его вручную.В этом случае необходимо обратиться к личному менеджеру или в службу поддержки вашего PWA-сервиса. 

Запросите у саппорта актуальный список макросов и правильную структуру ссылки для Keitaro. Вам должны выдать параметры для передачи external_id и дополнительных sub_id.

Шаг 2. Добавляем партнерскую сеть в Keitaro

Первым делом нам нужно добавить Ace Partners в трекер. Это нужно, чтобы Keitaro видел данные о каждой регистрации и депозите. Иначе в статистике будут отображаться только переходы, и вы не поймете, какой именно креатив или адсет приносит реальный профит.

В Keitaro процедура интеграции максимально упрощена за счет готовых шаблонов. Разработчики уже подготовили нужные наборы utm-параметров и макросов для большинства популярных сетей, что избавляет нас от рутины. Чтобы начать, переходим в верхнем меню во вкладку «Партнерские сети» и жмем кнопку «Создать».

В открывшемся окне находим поле «Из шаблона» и выбираем в списке Ace Partners. В этот момент трекер автоматически подтянет все настройки, включая параметры для передачи выплат и статусов лидов. 

 

Это очень удобно, так как не придется вручную прописывать макросы вроде {subid}. Cистема сама знает, в каком виде партнерка ожидает получить данные.

Ключевой элемент в этом меню это поле Postback URL. Это уникальный адрес вашего трекера, на который Ace Partners будет отправлять информацию о конверсиях. 

Копируем эту ссылку и сохраняем. Она понадобится нам на следующем этапе при настройке в личном кабинете ПП. После того как ссылка скопирована, нажимаем «Создать».

Шаг 3. Добавляем оффер

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

Прежде чем переходить в трекер, нужно подготовить ссылку в личном кабинете Ace Partners. Интерфейс может отличаться в деталях, но логика везде одинакова: выбираем подходящий гемблинг-оффер, настраиваем поток и получаем трекинг-ссылку.

Главное на этом этапе убедиться, что в ссылке предусмотрено место для передачи subid из трекера. Обычно это выглядит как специальный параметр в конце URL. В случае с Ace Partners будем передавать туда значение из Keitaro, чтобы связать каждый клик с конкретным действием игрока в будущем.

Когда ссылка из партнерки на руках, возвращаемся в Keitaro:

• Переходим в раздел «Офферы» в верхнем меню и нажимаем «Создать».

Название: рекомендуем использовать понятный нейминг, например: [Ace Partners] [GEO] [Offer Name]. Это упростит работу, когда кампаний на разные страны станет много.

Группа: если работа идет с разными вертикалями или командами, можно сразу раскидать офферы по группам для удобной фильтрации.

Партнерская сеть: в выпадающем списке выбираем Ace Partners, которую создали на первом шаге.

URL оффера: вставляем полученную в партнерке ссылку.

Важно: стоит заранее выбрать способ работы оффера. Чаще всего используется тип «Редирект», когда трекер перенаправляет пользователя на лендинг партнерки по внешней ссылке.

Однако в гемблинге эффективнее использовать тип «Локальный». В этом случае в трекер загружается zip-архив с файлами блэк-пейджа, полученного от партнерки. Это позволяет странице открываться мгновенно без лишних переходов, что уменьшает потери кликов и помогает при прохождении модерации. 

В дополнительных настройках можно вручную указать ГЕО оффера. Это не влияет на распределение трафика напрямую, но помогает в аналитике и защищает от ошибок. После заполнения всех полей нажимаем «Создать».

Шаг 4. Настройка постбека

Настройка постбека необходима для синхронизации данных между партнерской сетью и трекером. Это позволяет Keitaro в реальном времени получать информацию о действиях игроков и сопоставлять их с конкретными кликами. Без этого этапа будет невозможно анализировать эффективность кампаний и считать ROI, так как в статистике будут отображаться только переходы без привязки к депозитам.

Процесс строится на обмене уникальными идентификаторами. Когда пользователь переходит по ссылке, Keitaro присваивает этому клику subid (в шаблоне Ace Partners он передается через параметр visit_id). После того как игрок совершает целевое действие на стороне казино, Ace Partners отправляет запрос на ваш Postback URL, возвращая этот идентификатор вместе со статусом события и суммой выплаты.

Для настройки нам понадобится Postback URL, который система сгенерировала автоматически.

Чтобы найти его, перейдите во вкладку «Партнерские сети» и кликните на название созданной сети Ace Partners. В открывшемся окне, в блоке настроек, вы увидите поле Postback URL. Это и есть тот самый адрес, который нужно скопировать.

Настройка параметров для партнерки

В гемблинге критически важно разделять регистрации и депозиты, чтобы видеть полную воронку. Для этого к основной ссылке постбека, полученной в Keitaro, вручную добавляются параметры статусов:

1. Регистрация (Lead): в интерфейсе Ace Partners необходимо найти поле для постбека на регистрации и вставить туда URL из трекера, добавив в конец параметр: ?status=lead. Это даст системе команду фиксировать событие как «Лид».
2. Депозит (Sale): в поле для постбека на оплату или депозит вставляется та же ссылка, но с расширенным набором параметров: ?status=sale&payout={payout}&currency={currency}.

Использование макросов {payout} и {currency} позволяет трекеру автоматически подтягивать сумму вознаграждения и конвертировать ее в валюту вашего аккаунта. Это необходимо для корректного отображения прибыли в общих отчетах.

Проверка интеграции

После сохранения настроек в личном кабинете Ace Partners необходимо убедиться, что данные доходят до трекера. В Keitaro за это отвечают два раздела:

Логи постбеков: перейдите в раздел «Обслуживание», «Логи» и «Полученные постбеки». Как только произойдет первая конверсия, здесь появится запись. Если в колонке «Статус» указано «OK», значит, трекер успешно принял данные.

Раздел конверсий: все подтвержденные действия отображаются во вкладке «Конверсии» в главном меню или внутри конкретной кампании. Здесь можно увидеть время лида, статус и сумму выплаты.

Если данные не приходят, стоит проверить логи: ошибка «Click not found» обычно означает, что subid передается некорректно, а пустой лог говорит о том, что ссылка постбека в кабинете Ace Partners вставлена с ошибкой или не сохранена.

Шаг 5. Интеграция PWA-сервиса и Keitaro

Когда оффер и партнерка уже заведены в Keitaro, необходимо создать рекламную кампанию, которая станет связующим звеном между приложением и целевой страницей.

В главном меню переходим в раздел «Кампании» и жмем «Создать». В поле «Источник трафика» выбираем тот источник, который мы подготовили на первом шаге (ваш PWA-сервис).

В настройках потока во вкладке «Схема» добавляем наш оффер. 

В пункте «Ротация потоков» рекомендуем выставлять «По весу» — это позволит системе закэшировать переход. 

Если пользователь закроет приложение и откроет его снова, трекер не перекинет его на другой оффер или лендинг, что сохраняет конверсию.

После сохранения кампании трекер выдаст рабочую ссылку. Чаще всего она выглядит как http://[IP_вашего_сервера]/идентификатор.

Использовать ссылку в таком виде — верный способ слить бюджет. Залив на «голый» IP сервера в 2026 году приводит к тому, что пользователь видит предупреждение «Подключение не защищено». Большинство юзеров закроют страницу на этом этапе. Чтобы этого избежать:

1. Припаркуйте к трекеру трастовый домен.
2. Настройте SSL-сертификат (проще всего это сделать через Cloudflare).
3. В настройках Keitaro включите принудительный редирект на HTTPS.

В итоге ваша ссылка для вставки в панель PWA должна начинаться с https://ваш-домен.com/.

Настройка на стороне PWA-сервиса

Теперь берем итоговую ссылку из Keitaro и переходим в личный кабинет вашего сервиса аренды приложений. Несмотря на различия в интерфейсах, логика настройки везде одинаковая.

Проброс целевой ссылки. В настройках созданного приложения находим поле для ввода ссылки (обычно называется «Target URL» или «Оффер»). Вставляем туда нашу ссылку из Keitaro. Если вы планируете лить на несколько стран внутри одного приложения, убедитесь, что в панели включена опция «Мульти-гео».

Внутренний клоакинг сервиса. В 2026 году большинство PWA-сервисов имеют встроенную защиту от ботов. В настройках приложения нужно активировать режим клоакинга.

• Lite-режим: подходит для спокойных периодов в Facebook*, когда модерация проходит в штатном режиме.
• Hard-режим: включается в моменты «штормов», когда антифрод соцсети начинает банить аккаунты пачками.

Здесь же выбирается White Page — страница, которую будут видеть модераторы. Рекомендуем выбирать тематики, близкие к гемблингу, но нейтральные: например, блоги про психологию азарта, новости спорта или обзоры мобильных игр. Это создает меньше вопросов при ручной проверке.

Шаг 6. Настройка технологии клоакинга (уровень трекера)

Даже если вы используете встроенную защиту PWA-сервиса, дополнительный уровень фильтрации в Keitaro это ваша основная страховка. Трекер обрабатывает запросы сверху вниз, поэтому мы выстраиваем иерархию так, чтобы модератор или бот не смог пройти дальше первого потока.

Создание White Page (Перехватывающий поток)

Этот поток всегда стоит на позиции №1. Его задача идентифицировать модераторов и ботов по техническим признакам и перенаправить их на вайт. При создании в поле «Тип потока» выбираем «Перехватывающий».

Настройка фильтров для отсева: Во вкладке «Filters» нам нужно создать комбинацию условий. Логику работы фильтров переключаем на «Или» (достаточно совпадения одного условия, чтобы пользователь остался на вайте).

Выставляем следующие параметры:

• Бот: выбираем значение «Да». Это активирует встроенные базы Keitaro, которые обновляются автоматически.
• Прокси / VPN: значение «Да». Проверочные системы Facebook практически всегда скрывают реальное местоположение.
• ASN (Автономные системы): один из самых эффективных методов. Это фильтрация по признаку дата-центров. Реальные пользователи заходят через домашних провайдеров (ISP), а боты — через облачные серверы. Вносим ASN крупных систем: Google (AS15169), Amazon (AS16509), Microsoft (AS8075), DigitalOcean.
• Страны (Исключение): выбираем ваше целевое ГЕО (например, Венгрия) и жмем кнопку «Нет». Дополнительно в этот список стоит внести страны, где сидят основные команды модерации Facebook*: США, Ирландия, Израиль.
• User-Agent: блокируем специфические подписи скриптов. В поле вносим: python-requests, wget, curl, facebookexternalhit, zgrab.

Если вы все сделали правильно, у вас должна получиться следующая картина:

В разделе «Схема» выбираем тип «Локальный» и добавляем ваш White Page. Помните, что страница должна соответствовать языку ГЕО и выглядеть как рабочий сайт, а не как заготовка под залив трафика.

Cоздание Black Page (Обычный поток)

Создаем второй поток на позиции №2 с типом «Обычный». Здесь мы действуем от обратного, то есть, прописываем критерии, которым должен соответствовать реальный игрок.

Настройка фильтров: в этом потоке логику фильтров нужно обязательно переключить на «И». Пользователь попадет на блэк-пейдж только в том случае, если одновременно совпадут все факторы:

• Страна: ваше целевое ГЕО — значение «Да».
• Тип устройства: выбираем «Мобильный» и «Планшет». Если на ссылку кликнут с Windows или macOS — трекер пропустит переход дальше, не показывая казино. Это защищает от проверок с десктопов.
• Язык браузера: можно добавить фильтр по языку системы (например, венгерский). Если у юзера в системе стоит английский или русский при заливе на Венгрию — это повод для дополнительной фильтрации.

Во вкладке «Схема» добавляем ваш гемблинг-оффер или преленд, полученный в партнерке. Благодаря тому, что основной объем ботов мы уже отсеяли на первом шаге, сюда дойдет только целевой трафик.

Замыкающий поток

Финальный этап настройки — создание потока типа «Замыкающий». Он служит страховкой для трафика, который по каким-то причинам проскочил фильтры бота, но не подошел под условия обычного пользователя (например, живой юзер из Венгрии, зашедший с ноутбука).

Фильтры здесь не нужны. В схеме этого потока указываем тот же White Page, что и в первом шаге. Система сама отправит сюда всех «неопределившихся» посетителей, гарантируя, что модератор не увидит блэк-пейдж даже при технических накладках.

Практические рекомендации по проверке

Чтобы убедиться, что клоака настроена корректно и лиды не будут теряться, выполните следующие действия:

1. Тест на дырки: зайдите по ссылке кампании со своего обычного IP без VPN. Если вы не в целевом ГЕО, то должен открыться White Page. Затем проверьте ссылку через мобильные прокси нужной страны, должен открыться оффер.
2. Анализ логов: регулярно заходите в раздел «Обслуживание» → «Логи» → «Полученные клики». Если вы видите много переходов со статусом «Bot» из Ирландии или США, значит, фильтры ASN и ГЕО отрабатывают верно.
3. Поведение на странице: боты часто залетают на страницу на 1–2 секунды и не совершают действий. Если есть возможность, используйте JS-чекеры — они отсекают визиты без движения мыши или скролла.

В итоге структура кампании в Keitaro должна выглядеть как иерархия, где потоки идут друг за другом: первым стоит White Page (Перехватывающий), вторым Black Page и последним Замыкающий. Трекер обрабатывает запрос сверху вниз, поэтому такая последовательность гарантирует, что модератор споткнется о первый же фильтр и не увидит ничего лишнего.

Итог

В этом материале мы разобрали все этапы настройки: от подготовки фильтров до логики распределения потоков и постбека. В нынешних реалиях это база, без которой невозможно проходить модерацию и адекватно анализировать трафик. 

Правильная конфигурация Keitaro позволяет видеть прозрачную статистику по каждой регистрации и депозиту, не гадая, какой именно адсет приносит профит.

— * принадлежит компании Meta, признанной экстремистской и запрещенной на территории РФ.

👉 Подписывайтесь на Телеграм-канал Ace Partners – там вас ждет много информации по работе с трафиком в вертикали iGaming!  

👉 Льем на гемблинг сюда

👉 Наш YouTube