Dolphin / Fbtool — приём расходов (Keitaro Admin API)
Dolphin и Fbtool.pro не имеют собственных интеграций с трекерами. Оба сервиса умеют только одно: отправлять расходы в Keitaro через его Admin API. Поэтому «поддержка Dolphin/Fbtool» в Orbitra — это совместимый входящий endpoint, который сервисы вызывают, думая, что говорят с Keitaro:
POST https://your-tracker.com/admin_api/v1/campaigns/CAMPAIGN_ID/update_costs
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"start_date": "2026-08-15",
"end_date": "2026-08-15",
"cost": 12.34,
"currency": "USD",
"timezone": "Europe/Berlin",
"filters": { "sub_id_4": "120212558973560058" }
}
Ответ — форма Keitaro: {"success":true, ...} или HTTP-код + {"success":false,"error":"..."}.
Endpoint реализован в admin_api.php, роутинг — в .htaccess (Apache) и core/nginx_config.php (nginx). Регенерация nginx-конфига после обновления подхватывает location автоматически.
1. Создание API-ключа
Endpoint принимает персональные ключи трекера (таблица user_api_keys) — те же, что использует MCP.
- Админ открывает ⚙ → Пользователи → API-ключи.
- Создаёт ключ с правами write (read-only ключи получают
403). - Ключ передаётся заголовком
Authorization: Bearer <key>илиX-Api-Key: <key>.
2. Настройка Dolphin
Dolphin → Настройки → Экспорт расходов → Keitaro:
- Адрес трекера:
https://your-tracker.com - API-ключ: ключ из шага 1
- Матчинг: by Adset ID (по умолчанию) — тогда фильтр
sub_id_3совпадёт с
параметром adset_id клика автоматически.
3. Настройка Fbtool.pro
Fbtool → Расходы → Keitaro:
- Адрес админки:
https://your-tracker.com - API-ключ: ключ из шага 1
- Fbtool матчит по
ad.idи шлёт фильтрsub_id_4— он совпадёт с параметром
ad_id клика автоматически.
4. Что должно быть настроено в кампании
Фильтры матчатся по параметрам клика (clicks.parameters_json). Параметры на клик ставит шаблон источника трафика Facebook: кампания должна получать трафик со ссылкой, содержащей
ad_id={{ad.id}}&adset_id={{adset.id}}&campaign_id={{campaign.id}}
В редакторе кампании это делает выбор источника «Facebook Ads»: параметры подставляются автоматически (вкладка «Параметры», ссылка с макросами).
5. Как распределяется расход
- Клики кампании за
[start_date .. end_date], суженные фильтрами. - Ключ фильтра пробуется как имя параметра как есть (
ad_id,adset_id,
campaign_id, …) плюс дефолты FB-шаблона Keitaro: sub_id_3→adset_id, sub_id_4→ad_id. Несколько фильтров объединяются по AND.
- Сумма конвертируется в валюту трекера (
core/CurrencyRates.php) и делится
поровну между совпавшими кликами (flat CPC) — та же модель, что у core/CostImporter.php.
- Повторная отправка того же периода перезаписывает распределение, а не
суммирует (сервисы шлют расход каждые 60–90 минут).
- Если кликов не нашлось, сумма сохраняется в
cost_recordsпод скрытым
подключением external_api без атрибуции — чтобы расход не пропал молча. Проверьте фильтры и параметры кампании, если расход «не доходит».
6. Проверка
curl -X POST 'https://your-tracker.com/admin_api/v1/campaigns/10/update_costs' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"start_date":"2026-08-15","end_date":"2026-08-15","cost":10,"currency":"USD","filters":{"ad_id":"123456"}}'
Ответ {"success":true,"clicks":N,...} — расход записан и распределён по N кликам. clicks:0 — расход запаркован без атрибуции: фильтр не совпал ни с одним кликом за период.
Добавлено в v0.9.7.7.
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите 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 и управляйте кампаниями обычными словами.
Читать гайд →