Dolphin / Fbtool
Dolphin und Fbtool.pro bringen keine eigenen Tracker-Integrationen mit. Beide Dienste machen genau eines: Kosten über die Admin-API an Keitaro schicken. „Dolphin/Fbtool-Support“ in Orbitra ist daher ein kompatibler eingehender Endpunkt, den die Dienste aufrufen, im Glauben, sie sprächen mit 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" }
}
Die Antwort folgt dem Keitaro-Format: {"success":true, ...} oder ein HTTP-Code + {"success":false,"error":"..."}.
Der Endpunkt ist in admin_api.php implementiert; das Routing liegt in .htaccess (Apache) und core/nginx_config.php (nginx). Regenerierst du nach einem Update die nginx-Konfiguration, zieht der die Location automatisch nach.
1. API-Key anlegen
Der Endpunkt akzeptiert die persönlichen Keys des Trackers (Tabelle user_api_keys) — dieselben, die auch MCP nutzt.
- Ein Admin öffnet ⚙ → Users → API keys.
- Er legt einen Key mit write-Rechten an (read-only-Keys bekommen ein
403). - Der Key wird im Header
Authorization: Bearer <key>oderX-Api-Key: <key>übergeben.
2. Dolphin einrichten
Dolphin → Settings → Cost export → Keitaro:
- Tracker URL:
https://your-tracker.com - API key: der Key aus Schritt 1
- Matching: über die Adset ID (Standard) — der Filter
sub_id_3matcht dann automatisch den Parameteradset_iddes Klicks.
3. Fbtool.pro einrichten
Fbtool → Costs → Keitaro:
- Admin panel URL:
https://your-tracker.com - API key: der Key aus Schritt 1
- Fbtool matcht über
ad.idund schickt den Filtersub_id_4— er matcht automatisch den Parameterad_iddes Klicks.
4. Was an der Kampagne konfiguriert sein muss
Filter matchen gegen die Klick-Parameter (clicks.parameters_json). Das Traffic-Quellen-Template von Facebook legt diese Parameter auf jedem Klick ab: Die Kampagne muss also Traffic über einen Link bekommen, der
ad_id={{ad.id}}&adset_id={{adset.id}}&campaign_id={{campaign.id}}
enthält. Im Kampagnen-Editor passiert das über die Auswahl der Quelle „Facebook Ads“: Die Parameter werden automatisch eingetragen (Reiter „Parameters“, der Link mit Makros).
5. Wie der Spend verteilt wird
- Die Klicks der Kampagne über
[start_date .. end_date], durch die Filter eingegrenzt. - Der Filter-Key wird als Parametername so probiert, wie er kommt (
ad_id,adset_id,campaign_id, …), plus die Defaults des Keitaro-FB-Templates:sub_id_3→adset_id,sub_id_4→ad_id. Mehrere Filter werden per UND kombiniert. - Die Summe wird in die Tracker-Währung umgerechnet (
core/CurrencyRates.php) und gleichmäßig auf die passenden Klicks verteilt (flat CPC) — dasselbe Modell wie incore/CostImporter.php. - Denselben Zeitraum erneut zu senden überschreibt die Verteilung, statt sie zu addieren (die Dienste schicken den Spend alle 60–90 Minuten).
- Werden keine Klicks gefunden, landet die Summe in
cost_recordsunter einer verstecktenexternal_api-Connection ohne Zuordnung — der Spend verschwindet also nicht unbemerkt. Prüfe die Filter und die Parameter der Kampagne, wenn der Spend „nie ankommt“.
6. Verifizieren
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"}}'
Die Antwort {"success":true,"clicks":N,...} bedeutet: Der Spend wurde verbucht und auf N Klicks verteilt. clicks:0 — der Spend wurde ohne Zuordnung geparkt: Der Filter hat im Zeitraum keinen Klick getroffen.
Hinzugefügt in v0.9.7.7.
Schnellstart
Von einem nackten Server zur ersten Conversion in neun Schritten: Installation, erster Login, Domain, Netzwerk und Offer, Traffic-Quelle, Kampagne, Prüfung, Kosten.
Guide lesen →DocsInstallation und Updates
Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.
Guide lesen →DocsMigration von Keitaro
Einstellungen per SQL-Dump von Keitaro zu Orbitra übertragen: was mitkommt, das Dump-Script, der Import und was du danach prüfen solltest.
Guide lesen →DocsMigration von Binom
Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.
Guide lesen →DocsFunktionen im Überblick
Alle Orbitra-Funktionen auf einen Blick: Traffic und Schemas, Postbacks und Kosten, Analytics, Infrastruktur und Verwaltung — mit Links auf die Detailseiten.
Guide lesen →DocsKampagnen und Streams
Der Kampagnen-Editor im Detail: Reiter, Kostenmodelle, Stream-Typen, alle Filter, Schemas, Rotation mit Auto-Optimierung, Test-Link und Duplikat-Schutz.
Guide lesen →DocsCloaking (Referenz)
Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.
Guide lesen →DocsBrowser check
Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.
Guide lesen →DocsLandingpages (Referenz)
Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.
Guide lesen →DocsPWA und Web Push
PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.
Guide lesen →DocsPWA Funnel
Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.
Guide lesen →DocsConversion-Popups
Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.
Guide lesen →DocsSession-Aufzeichnungen und Heatmaps
Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.
Guide lesen →DocsContent Gallery
Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.
Guide lesen →DocsCreatives-Bibliothek
Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.
Guide lesen →DocsExterne PWA und Telegram-Kanäle
PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.
Guide lesen →DocsPostbacks und Conversions
Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.
Guide lesen →DocsKosten
Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.
Guide lesen →DocsPush- und Pop-Netzwerke
Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.
Guide lesen →DocsFacebook / Meta
Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.
Guide lesen →DocsDolphin / Fbtool
Facebook-Kosten über den Keitaro-kompatiblen Admin-API-Endpunkt empfangen: API-Key, Dolphin- und Fbtool-Setup und wie der Spend auf die Klicks verteilt wird.
Guide lesen →DocsFB-Kommentar-Cleaner
Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.
Guide lesen →DocsTraffic-Quellen und Affiliate-Netzwerke
Die beiden Verzeichnisse am Funnel-Rand: Templates für rund 200 Quellen und 440 Netzwerke, Parameter, Makros und Postback-URLs.
Guide lesen →DocsReports, Logs und Metriken
Der Report-Builder, Traffic-Log, Klick-Karte und jede Metrik erklärt — von Clicks und Visits über ROI bis zur Scroll-Tiefe.
Guide lesen →DocsDomains und SSL
Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.
Guide lesen →DocsCloudflare
Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.
Guide lesen →DocsAdministration
Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.
Guide lesen →DocsTelegram-Bot
Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.
Guide lesen →DocsMCP: ein KI-Assistent im Tracker
Claude oder einen anderen MCP-Client an Orbitra anbinden und Kampagnen, Offers und Domains in natürlicher Sprache verwalten.
Guide lesen →