Документация

Push и pop сети

Импорт расхода из рекламных сетей push/pop-трафика плюс Zone Killer — правила, которые находят (а с вашего разрешения и блокируют) зоны, сжигающие деньги. Всё в одном месте: карточка Push/Pop сети в ⚙ → Интеграции, в группе рекламных сетей рядом с Facebook / TikTok / Google.

Сети

СетьУровень расходаAPI-ключ
AdMavenкампания × зонаРекламный кабинет → раздел API → API token
PropellerAdsкампания × зонаSSP → Profile → API token
Kadamкампания × зонаРекламный кабинет → раздел API → API token
Galaxionкампания × зонаE-mail и пароль аккаунта (трекер сам получит токен) или готовый API-токен
HilltopAdsтолько кампанияMy Account → вкладка API → API key
Adsterraтолько кампанияSettings → API → Generate new token (работает только последний созданный токен)
Clickaduтолько кампанияРекламный кабинет → раздел API → API key

У сетей с пометкой «только кампания» разбивка по зонам в API есть, но её строки не несут id кампании — зону там нельзя привязать к кампании, чьи клики она купила. Их расход распределяется по кликам кампании, и карточка подключения честно предупреждает об этом заранее.

Подключение

Выберите плитку сети, вставьте ключ, нажмите Проверить подключение — она показывает реальный баланс аккаунта, — и сохраните. У каждого подключения свой интервал обновления; кнопки в списке: Обновить расход (сейчас), пауза, изменить, удалить. Уже импортированный расход после удаления остаётся в отчётах.

Синхронизация идёт в том же проходе aggregator_cron.php, что и остальные расходные подключения (см. Расходы): каждый проход перечитывает последние 5 дней, первый — 30. Повторная синхронизация дня безопасна: расход пересчитывается, а не накапливается.

Как расход попадает на клик

Главное требование то же, что для Facebook или TikTok: кампания должна использовать шаблон источника этой сети, чтобы ссылка передавала id кампании сети (в ad_campaign_id) и id зоны (шаблоны Keitaro пишут его в source, встроенный шаблон PropellerAds — в zone). Без макроса зоны расход всё равно придёт — но только на уровень кампании, без разбивки по зонам.

Матчинг от самого специфичного уровня к самому широкому:

  1. кампания × зона — строка зоны относится только к кликам того же дня, несущим оба id: и зоны, и кампании сети. Голого id зоны мало: id зон не уникальны между сетями.
  2. кампания — строка зоны, чья зона не нашла кликов, суммируется на клики кампании без зоны (и никогда не залезает на клики, уже оценённые их собственными зонами, — несколько непривязавшихся зон складываются, а не затирают друг друга).

Ключи параметров клика, которые считаются зоной: zone, zone_id, zoneid, sub_source_id.

Если синхронизация отвечает «записей получено, но ни одна не легла на клики» — скорее всего, кампания не использует шаблон источника этой сети: ссылке не с чем матчиться. Диагностика «Получено N, сопоставлено 0» из Расходов применима и здесь.

Zone Killer

Карточка на вкладке Общие редактора кампании (кампания должна быть сохранена). Правило привязывает кампанию к одному push/pop-подключению и решает, какие зоны — кандидаты:

Кандидаты считаются по clicks.cost / clicks.revenue в разрезе зоны — по тем же распределённым числам, что показывают отчёты, и по тем же ключам зон, по которым матчился импорт расхода, поэтому правило не может осудить зону, которую импорт оценил иначе.

Блокировка идёт через write-API сети для AdMaven, HilltopAds, PropellerAds, Kadam и Galaxion. У Adsterra и Clickadu пригодного zone write-API нет: их правила остаются в dry-run, а карточка копирует выбранные id зон, чтобы вставить их в блэклист сети вручную.

Каждая блокировка и разблокировка — ручная или автоматическая — попадает в журнал (только добавление, с метриками, стоявшими за решением); текущий набор блоков — это зоны, чьё последнее успешное действие «блок». Журнал показывается под правилом.

Для сетей «только кампания» (HilltopAds, Adsterra, Clickadu) Zone Killer судит зоны приблизительно — по их доле кликов кампании, потому что API не даёт расход по зонам. Держите их правила в dry-run и просматривайте список перед блокировкой.

Крон

*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
*/30 * * * * php /var/www/orbitra/zone_rules_cron.php  >> /var/www/orbitra/var/logs/zone_rules.log 2>&1

Первая строка — крон, который установщик добавляет для синхронизации расходов. Вторую — исполнитель Zone Killer — добавьте сами, и только если используете режим auto; проход дешёвый (правило без кандидатов — один GROUP BY по кликам кампании). Флаги: --campaign=12 (одна кампания), --quiet.

← Назад
Расходы: импорт из рекламных кабинетов
Вперёд →
Facebook / Meta integration
Исходник на GitHub: github.com/fenjo26/Orbitra.link/wiki
Все гайды
Документация

Быстрый старт: первая кампания

Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.

Читать гайд →
Документация

Установка и обновление

Установите Orbitra на чистый сервер Ubuntu или Debian одной командой и безопасно обновляйтесь до новых версий.

Читать гайд →
Документация

Миграция из Keitaro

Перенесите кампании, офферы, источники и домены из Keitaro в Orbitra в один клик — что переносится и что проверить.

Читать гайд →
Документация

Миграция из Binom

Перенесите кампании и потоки из Binom в Orbitra: что переносится автоматически, а что настроить вручную.

Читать гайд →
Документация

Возможности Orbitra

Всё, что умеет Orbitra: кампании и потоки, клоакинг, лендинги, PWA, постбеки, расходы, отчёты и интеграции.

Читать гайд →
Документация

Кампании и потоки

Полный справочник: настройки кампаний, типы потоков, схемы, ротация, фильтры, тестовые ссылки и каждый параметр.

Читать гайд →
Документация

Клоакинг

Полный справочник по клоакингу: уровни детекции, глобальные настройки, фильтры потоков, вердикты и отчёты.

Читать гайд →
Документация

Проверка браузера

Как JS-проверка ловит ботов, виртуальные машины и эмуляторы через противоречия в окружении браузера.

Читать гайд →
Документация

Лендинги

Типы лендингов, макрос {offer}, JS-адаптер, LeadForge и мульти-оффер лендинги — полный справочник.

Читать гайд →
Документация

PWA-лендинги и Web Push

Собирайте устанавливаемые PWA-приложения и собирайте push-подписчиков: настройки, иконки, события и уведомления.

Читать гайд →
Документация

PWA-воронка

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

Читать гайд →
Документация

Конверсионные попапы

Показывайте реальные конверсии как попапы на странице: настройка, триггеры и размещение.

Читать гайд →
Документация

Записи сессий и карта кликов

Воспроизводите реальные визиты, смотрите карты кликов и скроллов. Лимиты хранения и приватность.

Читать гайд →
Документация

Галерея контента

Центральное хранилище иконок, скриншотов и креативов для PWA и лендингов.

Читать гайд →
Документация

Библиотека креативов

Храните креативы с отслеживанием по subid и тестируйте их в разных кампаниях.

Читать гайд →
Документация

Внешние PWA и Telegram-каналы

Публикуйте PWA на внешних доменах и используйте Telegram-каналы как источник трафика.

Читать гайд →
Документация

Постбеки и конверсии

Входящие постбеки, статусы и типы конверсий, исходящие S2S-постбеки в источник трафика.

Читать гайд →
Документация

Расходы: импорт из рекламных кабинетов

Импорт расходов из Facebook, TikTok и Google Ads, обновление через API и крон — и как работает агрегатор доходов.

Читать гайд →
Документация

Push и pop сети

Работа с пуш и поп источниками трафика: фиды, оптимизация зон и zone killer.

Читать гайд →
Документация

Facebook / Meta integration

Импорт расходов из Meta Ads и Conversions API: серверные события с дедупликацией.

Читать гайд →
Документация

Dolphin / Fbtool — приём расходов (Keitaro Admin API)

Получайте расходы Facebook через API Dolphin (Fbtool) в реальном времени.

Читать гайд →
Документация

Чистилка комментариев FB

Массовая модерация комментариев под рекламой Meta: скрывать, удалять и фильтровать по ключевым словам.

Читать гайд →
Документация

Источники трафика и партнёрские сети

Каталог 50+ источников трафика и 440+ сетей: шаблоны, параметры и адреса постбеков.

Читать гайд →
Документация

Отчёты, логи и метрики

Конструктор отчётов, сохранённые отчёты, логи кликов и каждая метрика с пояснением.

Читать гайд →
Документация

Домены и SSL

Добавление доменов, DNS, бесплатные сертификаты Let's Encrypt, редиректы, парковка и каждый переключатель на странице.

Читать гайд →
Документация

Cloudflare — DNS и SSL доменов

Как запускать домены кампаний через Cloudflare: DNS, режимы SSL и что отключить.

Читать гайд →
Документация

Администрирование

Пользователи, роли и права, настройки безопасности, гео-базы, обновления и состояние системы.

Читать гайд →
Документация

Telegram-бот

Управляйте трекером из Telegram: статистика, конверсии и алерты в чате.

Читать гайд →
Документация

MCP-сервер: работа с трекером через нейросеть

Подключите Claude или любой MCP-клиент к Orbitra и управляйте кампаниями обычными словами.

Читать гайд →