Dolphin / Fbtool
У Dolphin і Fbtool.pro немає власних інтеграцій із трекерами. Обидва сервіси роблять рівно одну річ: надсилають витрати до Keitaro через її Admin API. Тому «підтримка Dolphin/Fbtool» в Orbitra — це сумісний вхідний ендпоінт, який сервіси викликають, вважаючи, що говорять із 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":"..."}.
Ендпоінт реалізовано в admin_api.php; маршрутизація живе в .htaccess (Apache) та core/nginx_config.php (nginx). Після оновлення достатньо перегенерувати конфіг nginx — location підтягнеться автоматично.
1. Створення API-ключа
Ендпоінт приймає персональні ключі трекера (таблиця user_api_keys) — ті самі, що використовує MCP.
- Адміністратор відкриває ⚙ → Users → API keys.
- Створює ключ із правами write (ключі лише для читання отримують
403). - Ключ передається в заголовку
Authorization: Bearer <key>абоX-Api-Key: <key>.
2. Налаштування Dolphin
Dolphin → Settings → Cost export → Keitaro:
- Tracker URL:
https://your-tracker.com - API key: ключ із кроку 1
- Matching: за Adset ID (за замовчуванням) — тоді фільтр
sub_id_3автоматично збігатиметься з параметром клікаadset_id.
3. Налаштування Fbtool.pro
Fbtool → Costs → Keitaro:
- Admin panel URL:
https://your-tracker.com - API key: ключ із кроку 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»: параметри заповнюються автоматично (вкладка Parameters, посилання з макросами).
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) і ділиться порівну між кліками, що збіглися (рівний 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 через Public API: що переноситься автоматично, а що налаштувати вручну.
Читати гайд →ДокументаціяОгляд можливостей
Усе, що вміє Orbitra: кампанії та потоки, клоакинг, лендинги, PWA, постбеки, витрати, звіти та інтеграції.
Читати гайд →ДокументаціяКампанії та потоки
Повна довідка: налаштування кампаній, типи потоків, схеми, ротація, фільтри, тестові посилання та кожна опція з поясненням.
Читати гайд →ДокументаціяКлоакинг
Повна довідка з клоакингу: шари детекції, глобальні налаштування, фільтри потоку, вердикти та звіти.
Читати гайд →ДокументаціяПеревірка браузера
Як JS-перевірка ловить ботів, віртуальні машини та емулятори за суперечностями в браузерному оточенні.
Читати гайд →ДокументаціяЛендинги
Типи лендингів, макрос {offer}, JS-адаптер, LeadForge та мультиофферні лендинги — повна довідка.
Читати гайд →ДокументаціяPWA та Web Push
Створюйте встановлювані PWA-застосунки та збирайте push-підписників: налаштування, іконки, події та сповіщення.
Читати гайд →ДокументаціяPWA-воронка
Воронка візиту на PWA-лендинг: екрани до встановлення, трекінг кожного екрана, статистика показів і матриця переходів.
Читати гайд →ДокументаціяКонверсійні попапи
Попап із кнопкою оффера на лендингах: вкладка Popup, вертикальні шаблони, тригери показу і метрики показів та CTR.
Читати гайд →ДокументаціяЗаписи сесій і теплові карти
Реплеї реальних візитів, теплові карти кліків і скролу, ліміти сховища, приватність і запис цілих сайтів.
Читати гайд →ДокументаціяГалерея контенту
Повна довідка Галереї: папки, завантаження, MediaPicker у редакторах, контракти розміру, обмеження форматів і відео.
Читати гайд →ДокументаціяБібліотека креативів
Креативи з витратами, доходом і ROI: синк файлів з Facebook і TikTok, дедуплікація, звіти і алерт вигорання креативів.
Читати гайд →ДокументаціяЗовнішні PWA та Telegram-канали
Сторонні PWA-сервіси як цілі потоків (/eflow) і Telegram-канали як оффери: funnel-бот, вступи-конверсії та атрибуція.
Читати гайд →ДокументаціяПостбеки та конверсії
Вхідні постбеки, статуси й типи конверсій, вихідні S2S-постбеки на джерело, черга доставки, тестер і імпорт конверсій.
Читати гайд →ДокументаціяВитрати
Імпорт витрат з Facebook, TikTok, Google Ads і push/pop-мереж, розподіл по кліках, агентські комісії та агрегатор доходу.
Читати гайд →ДокументаціяPush- і pop-мережі
Імпорт витрат із push/pop-мереж і Zone Killer: правила, що знаходять і блокують зони, які палять бюджет.
Читати гайд →ДокументаціяFacebook / Meta
Імпорт витрат з Meta Ads і Conversions API: токени, мапінг статусів, серверні події з дедуплікацією і діагностика.
Читати гайд →ДокументаціяDolphin / Fbtool
Отримуйте витрати Facebook у трекер через API Dolphin (Fbtool) у реальному часі: API-ключ, налаштування сервісів і розподіл витрат по кліках.
Читати гайд →ДокументаціяЧистильник коментарів FB
Масова модерація коментарів під рекламою Meta за розкладом: набори правил, винятки, сухий прогін, журнал дій і авто-пауза.
Читати гайд →ДокументаціяДжерела трафіку та партнерські мережі
Два довідники, що налаштовують «краї» воронки: шаблони джерел і мереж, параметри, постбек у джерело та офферні параметри.
Читати гайд →ДокументаціяЗвіти, логи та метрики
Дашборд, список кампаній, конструктор звітів, тренди й когорти, лог трафіку та картка кліка — і як рахується кожна метрика.
Читати гайд →ДокументаціяДомени та SSL
Додайте домени, наведіть DNS на сервер, отримайте безкоштовний сертифікат Let's Encrypt і розберіться з кожним перемикачем на сторінці Domains.
Читати гайд →ДокументаціяCloudflare
Інтеграція з Cloudflare через API: A-записи ставляться автоматично, а з проксі SSL роздає Cloudflare — без certbot і очікування валідації.
Читати гайд →ДокументаціяАдміністрування
Користувачі, ролі та права по ресурсах, налаштування безпеки, гео-бази, оновлення панелі й розширення Ads Manager.
Читати гайд →ДокументаціяTelegram-бот
Керуйте трекером із Telegram: статистика, конверсії та сповіщення в чаті, вебхук або поллінг і алерти в канали.
Читати гайд →ДокументаціяMCP: ШІ-асистент у трекері
Підключіть Claude або будь-який MCP-клієнт до Orbitra й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →