Dolphin / Fbtool
Dolphin and Fbtool.pro have no tracker integrations of their own. Both services do exactly one thing: send costs to Keitaro via its Admin API. So "Dolphin/Fbtool support" in Orbitra is a compatible incoming endpoint that the services call, believing they are talking to 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" }
}
The response follows the Keitaro shape: {"success":true, ...} or an HTTP code + {"success":false,"error":"..."}.
The endpoint is implemented in admin_api.php; routing lives in .htaccess (Apache) and core/nginx_config.php (nginx). Regenerating the nginx config after an update picks up the location automatically.
1. Creating an API key
The endpoint accepts the tracker's personal keys (table user_api_keys) β the same ones MCP uses.
- An admin opens β β Users β API keys.
- Creates a key with write permissions (read-only keys get
403). - The key is passed in the
Authorization: Bearer <key>orX-Api-Key: <key>header.
2. Dolphin setup
Dolphin β Settings β Cost export β Keitaro:
- Tracker URL:
https://your-tracker.com - API key: the key from step 1
- Matching: by Adset ID (default) β then the
sub_id_3filter will match the
click's adset_id parameter automatically.
3. Fbtool.pro setup
Fbtool β Costs β Keitaro:
- Admin panel URL:
https://your-tracker.com - API key: the key from step 1
- Fbtool matches by
ad.idand sends thesub_id_4filter β it will match the
click's ad_id parameter automatically.
4. What must be configured on the campaign
Filters match against click parameters (clicks.parameters_json). The Facebook traffic source template puts those parameters on each click: the campaign must receive traffic with a link containing
ad_id={{ad.id}}&adset_id={{adset.id}}&campaign_id={{campaign.id}}
In the campaign editor this is done by selecting the "Facebook Ads" source: the parameters are filled in automatically (the "Parameters" tab, the link with macros).
5. How the cost is distributed
- The campaign's clicks over
[start_date .. end_date], narrowed by the filters. - The filter key is tried as a parameter name as-is (
ad_id,adset_id,
campaign_id, β¦) plus the Keitaro FB-template defaults: sub_id_3βadset_id, sub_id_4βad_id. Multiple filters are combined with AND.
- The sum is converted to the tracker currency (
core/CurrencyRates.php) and split
evenly across the matching clicks (flat CPC) β the same model used by core/CostImporter.php.
- Re-sending the same period overwrites the distribution instead of
adding to it (the services send costs every 60β90 minutes).
- If no clicks were found, the sum is stored in
cost_recordsunder a hidden
external_api connection without attribution β so the cost does not vanish silently. Check the filters and the campaign's parameters if the cost "never arrives".
6. Verification
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"}}'
The response {"success":true,"clicks":N,...} means the cost was recorded and distributed across N clicks. clicks:0 β the cost was parked without attribution: the filter matched no click in the period.
Added in v0.9.7.7.
Quick start: your first campaign
The short path: install the tracker, create a campaign, and get your first clicks and conversions in under an hour.
Read guide βDocsInstallation and updates
Install Orbitra on a fresh Ubuntu or Debian server with one command, and update to new versions safely.
Read guide βDocsMigrating from Keitaro
Move campaigns, offers, sources and domains from Keitaro to Orbitra in one click β what transfers and what to check.
Read guide βDocsMigrating from Binom
Move campaigns and streams from Binom to Orbitra: what transfers automatically and what to set up by hand.
Read guide βDocsFeature overview
Everything Orbitra can do: campaigns and streams, cloaking, landings, PWA, postbacks, costs, reports and integrations.
Read guide βDocsCampaigns and streams
The complete reference: campaign settings, stream types, schemas, rotation, filters, test links and every option explained.
Read guide βDocsCloaking
Full cloaking reference: detection layers, global settings, per-stream filters, verdicts and reports.
Read guide βDocsBrowser check
How the JS check catches bots, VMs and emulators through contradictions in the browser environment.
Read guide βDocsLanding pages
Landing types, the {offer} macro, the JS adapter, LeadForge and multi-offer landings β the complete reference.
Read guide βDocsPWA and Web Push
Build installable PWA apps and collect push subscribers: settings, icons, events and notifications.
Read guide βDocsPWA Funnel
A multi-step PWA funnel: install prompts, event tracking and re-engagement notifications.
Read guide βDocsConversion popups
Show real conversion events as on-page popups: setup, triggers and placement.
Read guide βDocsSession recordings and heatmaps
Replay real visits and see click and scroll maps. Storage limits and privacy notes.
Read guide βDocsContent gallery
Central storage for icons, screenshots and creatives used across PWAs and landings.
Read guide βDocsCreatives library
Store creatives with subid tracking and test them across campaigns.
Read guide βDocsExternal PWA and Telegram channels
Publish PWAs to external domains and run Telegram channels as a traffic source.
Read guide βDocsPostbacks and conversions
Incoming postbacks, conversion statuses and types, and outgoing S2S postbacks to your traffic source.
Read guide βDocsCosts
Import spend from Facebook, TikTok and Google Ads, or update it via API and cron β and how the revenue aggregator works.
Read guide βDocsPush and pop networks
Working with push and pop traffic sources: feeds, zone optimization and the zone killer.
Read guide βDocsFacebook / Meta
Cost import from Meta Ads and the Conversions API: server-side events with deduplication.
Read guide βDocsDolphin / Fbtool
Receive Facebook costs through the Dolphin (Fbtool) API in real time.
Read guide βDocsFB comment cleaner
Bulk-moderate comments under Meta ads: hide, delete and filter by keywords.
Read guide βDocsTraffic sources and affiliate networks
Catalog of 50+ traffic sources and 440+ networks: templates, parameters and postback URLs.
Read guide βDocsReports, logs and metrics
The report builder, saved reports, click logs and every metric explained.
Read guide βDocsDomains and SSL
Add domains, DNS, free Let's Encrypt certificates, redirects, parking and every switch on the page.
Read guide βDocsCloudflare
How to run campaign domains through Cloudflare: DNS, SSL modes and what to turn off.
Read guide βDocsAdministration
Users, roles and permissions, security settings, geo databases, updates and system health.
Read guide βDocsTelegram bot
Manage the tracker from Telegram: stats, conversions and alerts in chat.
Read guide βDocsMCP: an AI assistant in the tracker
Connect Claude or any MCP client to Orbitra and manage campaigns with plain-language commands.
Read guide β