Docs

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.

  1. Ein Admin öffnet ⚙ → Users → API keys.
  2. Er legt einen Key mit write-Rechten an (read-only-Keys bekommen ein 403).
  3. Der Key wird im Header Authorization: Bearer <key> oder X-Api-Key: <key> übergeben.

2. Dolphin einrichten

Dolphin → Settings → Cost export → Keitaro:

3. Fbtool.pro einrichten

Fbtool → Costs → Keitaro:

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

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.

← Zurück
Facebook / Meta
Weiter →
FB-Kommentar-Cleaner
Quelle auf GitHub ansehen: github.com/fenjo26/Orbitra.link/wiki
Alle Guides
Docs

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 →
Docs

Installation und Updates

Systemvoraussetzungen, der Ein-Befehl-Installer, PHP-Updates inklusive Sicherheits-Hinweisen, Panel-Zugriff per IP und die lokale Entwicklungsumgebung.

Guide lesen →
Docs

Migration 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 →
Docs

Migration von Binom

Kampagnen, Offers, Streams und mehr direkt über die Binom-v2-Public-API importieren — ohne Dump-Datei, inklusive Mapping-Hinweisen.

Guide lesen →
Docs

Funktionen 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 →
Docs

Kampagnen 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 →
Docs

Cloaking (Referenz)

Die vollständige Cloaking-Referenz: Detection layers, Sensitivity, Targeting filters, JavaScript-Verifizierung, Verdicts, Gründe und Diagnostik.

Guide lesen →
Docs

Browser check

Bots, Moderator-VMs, Emulatoren und Anti-Detect-Browser an Widersprüchen im Browser selbst erkennen — Modi, Anzeichen und der sichere Einstieg.

Guide lesen →
Docs

Landingpages (Referenz)

Die vollständige Landingpage-Referenz: lokale, Redirect-, Preload- und Action-Landingpages, das {offer}-Makro, SubID-Weitergabe, JS-Adapter und PHP-Landings.

Guide lesen →
Docs

PWA und Web Push

PWA-Landingpages und eigenes Web Push: Builder, Domain-Bindung, VAPID-Keys, Abonnenten, Messages, der Versand-Cron, Attribution und Fehlerbehebung.

Guide lesen →
Docs

PWA Funnel

Der PWA-Besuch als konfigurierbarer Funnel: Screens in fester Reihenfolge, Event-Tracking pro Screen und Re-Engagement-Benachrichtigungen.

Guide lesen →
Docs

Conversion-Popups

Echte Conversion-Events als Popup auf der Landing zeigen: Einrichtung pro Kampagne, Trigger und Platzierung.

Guide lesen →
Docs

Session-Aufzeichnungen und Heatmaps

Echte Besuche wie ein Video abspielen, dazu Klick-Heatmap und Scroll-Map. Speicher-Limits und Datenschutz-Hinweise.

Guide lesen →
Docs

Content Gallery

Die zentrale Mediathek des Trackers für Icons, Screenshots und Creatives, genutzt in PWAs und Landings: Ordner, Uploads, MediaPicker.

Guide lesen →
Docs

Creatives-Bibliothek

Creatives mit SubID-Tracking speichern und über Kampagnen hinweg testen.

Guide lesen →
Docs

Externe PWA und Telegram-Kanäle

PWAs auf externen Domains veröffentlichen und Telegram-Kanäle als Traffic-Quelle mit zuordenbaren Abonnenten fahren.

Guide lesen →
Docs

Postbacks und Conversions

Eingehende Postbacks, Conversion-Statuswerte und -Typen sowie ausgehende S2S-Postbacks an die Traffic-Quelle.

Guide lesen →
Docs

Kosten

Spend aus Facebook, TikTok und Google Ads importieren oder per API und Cron pflegen — und wie der Revenue Aggregator arbeitet.

Guide lesen →
Docs

Push- und Pop-Netzwerke

Arbeit mit Push- und Pop-Traffic-Quellen: Feeds, Zonen-Optimierung und der Zone Killer.

Guide lesen →
Docs

Facebook / Meta

Kosten-Import aus Meta Ads und die Conversions API: serverseitige Events mit Deduplizierung.

Guide lesen →
Docs

Dolphin / 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 →
Docs

FB-Kommentar-Cleaner

Spam-Kommentare unter Meta-Ads nach Zeitplan verstecken oder löschen: Regelwerke, Presets, Ausnahmen, Dry-run und Auto-Pause.

Guide lesen →
Docs

Traffic-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 →
Docs

Reports, 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 →
Docs

Domains und SSL

Domains hinzufügen, DNS und A-Records, kostenlose Let's-Encrypt-Zertifikate, Cloudflare-Proxy und alle Schalter der Domain-Einstellungen.

Guide lesen →
Docs

Cloudflare

Kampagnen-Domains über Cloudflare fahren: API-Token, Accounts, automatische A-Records, SSL-Modi und der orange Cloud-Proxy.

Guide lesen →
Docs

Administration

Users, Rollen und Rechte, Settings, Geo-Datenbanken, Updates und Systemstatus — die Verwaltung des Trackers über das ⚙-Menü.

Guide lesen →
Docs

Telegram-Bot

Den Tracker aus Telegram steuern: Statistiken, Kampagnen und Conversions per Befehl, dazu Benachrichtigungen und tägliches Digest.

Guide lesen →
Docs

MCP: 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 →