Docs

Facebook / Meta

Orbitra hat zwei unabhÀngige Facebook-Integrationen. Sie lösen die entgegengesetzten HÀlften desselben Kreislaufs und werden an unterschiedlichen Orten konfiguriert:

Was sie tutRichtungWo
Facebook CostsImportiert den Ad-Spend aus Meta in den TrackerMeta → OrbitraIntegrations → Facebook Costs
Facebook Conversions APISchickt Conversions vom Tracker an MetaOrbitra → MetaIntegrations → Facebook Conversions

Beide erreichst du auch von dort, wo die zugrunde liegenden Records leben: Cost-Connections erscheinen auf der Seite Aggregators (es sind aggregator_connections-Zeilen mit Engine facebook), und das Pixel einer Kampagne lĂ€sst sich ĂŒber deren eigenen Reiter Integrations bearbeiten. Dasselbe Datenmaterial — die Integrations-Seite ist der Eingang, die anderen beiden sind die kontextspezifischen Ansichten.

Keine hÀngt von der anderen ab. Der Kosten-Import gibt dir echten ROI; die Conversions API gibt Metas Optimierer die Events, die das Browser-Pixel verliert.


1. Kampagnen-Setup (von beiden nötig)

Beide Integrationen hÀngen an den Parametern, die die Anzeige in den Tracker trÀgt. Richte die Kampagne einmal ein, und beide funktionieren.

Lege die Kampagne an, wÀhle das Traffic-Quellen-Template Facebook und nutze die generierten URL-Parameter im Feld URL parameters der Anzeige:

ad_id={{ad.id}}&adset_id={{adset.id}}&campaign_id={{campaign.id}}&ad_name={{ad.name}}&adset_name={{adset.name}}&campaign_name={{campaign.name}}&site={{site_source_name}}

Regeln, die zÀhlen:

Orbitra erfasst diese ĂŒber den gemeinsamen Collector core/ClickParams.php. Er erfasst fbclid und verfĂŒgbare _fbp / _fbc-Werte; das Browser-Tracking sammelt auch Cookies, die nach dem ersten Request entstehen. Ad-URL-Makros erzeugen keinen fbp-Browser-Identifier. Zu externen Landings, Consent und Cross-Channel-Identity siehe Browser-Matching und Consent.


2. Facebook Costs

Access-Token holen

Ein langlebiger User Access Token oder ein System User Token mit ads_read funktioniert. Der System-User-Token ist der fĂŒr die Produktion — er lĂ€uft nicht mit der Session einer Person ab.

  1. <https://business.facebook.com/settings/system-users> → System-User hinzufĂŒgen
  2. Weise ihm den Ad-Account zu, mit View performance (oder voller Kontrolle)
  3. Generate token → wĂ€hle deine App → hake ads_read an → kopiere ihn

Der Token wird einmal gezeigt. Sichere ihn, bevor du den Dialog schließt.

Ad-Account-ID

Aus dem Ads Manager — der Wert act_1234567890. Orbitra akzeptiert ihn mit oder ohne act_-PrĂ€fix.

Die Connection anlegen

Integrations → Facebook Costs → Add account:

FeldHinweise
Access Tokenlanglebiger oder System-User-Token
Ad Account IDact_1234567890
Facebook API versionstandardmĂ€ĂŸig die neueste unterstĂŒtzte; Ă€ltere Accounts können eine Ă€ltere pinnen
Proxyoptional, scheme://user:pass@host:port, akzeptiert auch socks5://
Update spend everywie oft der Cron den Spend neu liest
Advanced: parameter mappingnur fĂŒr Traffic durch eine App — siehe unten

Jede Account-Zeile zeigt ihren Status und das nÀchste Update und trÀgt Update spend (ein manueller Sync jetzt), Pause/Resume, Clone und Delete.

Test connection liest den Ad-Account selbst (Name, WĂ€hrung, Zeitzone, Status), keinen Insights-Report — ein leerer Report ist eine gĂŒltige Antwort und wĂŒrde sonst einen toten Token verstecken.

Was synchronisiert wird, und wann

Cron — Sync-Intervalle unter der Stunde (20/30 min) brauchen den Cron selbst alle paar Minuten; die FĂ€lligkeitsprĂŒfung ist pro Connection, hĂ€ufige LĂ€ufe sind also billig:

*/5 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/log/orbitra_aggregator.log 2>&1

NĂŒtzliche Flags: --force (ignoriert das Intervall), --connection=5, --days=30.

Wie der Spend zu einem Klick kommt

FĂŒr jeden importierten Record löst Orbitra die Klicks auf, zu denen er gehört — spezifischste Ebene zuerst:

  1. ad_id (auch creative_id, creative)
  2. adset_id (auch adgroup, adgroupid, ad_group_id)
  3. campaign_id (auch campaign, campaignid, ad_campaign_id)

Der Tages-Spend wird dann gleichmĂ€ĂŸig auf die gematchten Klicks dieses Tages verteilt — dasselbe Flat-CPC-Modell wie bei der manuellen Cost-Eingabe.

WĂ€hrung

Meta reportet in der WĂ€hrung des Ad-Accounts. Orbitra rechnet vor dem Speichern in die Tracker-WĂ€hrung um (Settings → currency), sodass Cost und Revenue immer in derselben Einheit sind. Kurse kommen von open.er-api.com und werden 12 Stunden gecacht.

Um Kurse selbst festzulegen (Air-gapped-Installation, oder du willst den Kurs deiner Bank), setze die Einstellung fx_rates_manual_json — Werte sind Einheiten pro 1 USD:

{"EUR": 0.92, "RUB": 92.5}

Manuelle Kurse schlagen immer die geholte Tabelle. Der originale Betrag und die WÀhrung der Plattform bleiben in cost_records.raw_json unter _orbitra, sodass sich ein falscher Kurs nachtrÀglich rekonstruieren lÀsst.

Traffic ĂŒber eine App

Kommen die Makros umpackt an — Facebook → App → Orbitra — reiche sie als Sub-IDs weiter:

  1. In Facebook: sub_id_3={{adset.id}}
  2. Von der App zu Orbitra: sub_id_3={sub_id_3}
  3. In den Advanced: parameter mapping des Accounts setze Adset ID arrives in parameter auf sub_id_3

ad_id_param und campaign_id_param funktionieren genauso. Overrides werden zuerst versucht, die Standard-Keys bleiben als Fallback — eine partielle Zuordnung degradiert also, statt nichts zu matchen.

Fehlerbehebung

„Fetched N, matched 0" — der Spend ist angekommen, aber nichts ließ sich an einen Klick hĂ€ngen. Das Cron-Log sagt das explizit. Fast immer fehlen der Kampagnen-URL ad_id / adset_id / campaign_id. PrĂŒfe die Parameter eines aktuellen Klicks unter ⚙ → Logs → Traffic.

Update spend in der Account-Zeile nennt den genauen Grund (no_spend, no_clicks, no_ids, macros, ids_differ) mit Datum und den IDs auf beiden Seiten — siehe Kosten. Ungematchte Zeilen versuchen es bei jedem Sync erneut.

Der Sync meldet einen Fehler mit einer Meta-Meldung — die Meldung ist Metas eigene, wörtlich. HĂ€ufige:

Tagesgrenzen wirken verschoben — Meta reportet Tage in der Zeitzone des Ad-Accounts, der Tracker speichert Klicks in Serverzeit. Unterscheiden sich beide, landet Spend nahe Mitternacht auf dem Nachbartag. Gleiche die Zeitzone des Ad-Accounts an den Server an — oder akzeptiere den Rand.


3. Facebook Conversions API

Das Browser-Pixel wird bei einem relevanten Teil des Traffics blockiert — Ad-Blocker, ITP, iOS. Orbitra weiß von jeder Conversion, sobald das Affiliate-Netzwerk den Postback schickt, und es kennt die IP, den User-Agent, fbclid und _fbp des Klicks. Das Event serverseitig zu schicken, holt zurĂŒck, was das Pixel verliert.

Ein Conversions-API-Token holen

Events Manager → dein Pixel → Settings → Conversions API → Generate access token. Kopiere ihn sofort; er wird einmal gezeigt.

Die Pixel-ID steht auf derselben Seite (Events Manager → Data sources).

Einrichten

Integrations → Facebook Conversions → Add account (oder von innen einer Kampagne: deren eigener Reiter Integrations → Facebook Pixel — derselbe Record):

FeldHinweise
Campaignderen Conversions dieses Pixel empfÀngt
Pixel IDaus dem Events Manager
Conversions API tokendas schaltet das serverseitige Senden ein
Status → Meta eventwelcher Tracker-Status welches Meta-Event erzeugt
Test event codeoptional, aus dem Events Manager → Test events
Proxyoptional, dasselbe Format wie die Cost-Connection
Event source URLdie tatsĂ€chliche Seite, auf der das Event passiert; von Meta fĂŒr Website-Events verlangt

Eine Pixel-Zeile ohne Token bleibt Browser-only — die Liste markiert sie als Browser pixel only, statt sie als funktionierende Integration zu zeigen. Serverseitig geht nichts raus, solange kein Token da ist.

Standard-Mapping:

Tracker-StatusMeta-Event
leadLead
salePurchase
depositPurchase
registrationCompleteRegistration
rejectednicht gesendet
trashnicht gesendet

rejected und trash sind absichtlich nicht gemappt: Ein abgelehnter Lead als Conversion zurĂŒckzufĂŒttern lehrt den Optimierer, mehr von genau dem falschen Traffic zu kaufen.

Send test event postet sofort ein Event und nutzt deinen jĂŒngsten echten Klick mit fbclid, falls es einen gibt. PrĂŒfe es unter Events Manager → Test events.

Was gesendet wird

event_name          from the mapping
event_time          when the postback arrived
event_id            <click_id>_<status>[_<tid>]   ← reuse as browser eventID if sending both channels
action_source       website
event_source_url    configured event URL, or actual URL supplied with the postback
user_data
  client_ip_address the click's IP            (unhashed — Meta requires this)
  client_user_agent the click's user agent    (unhashed — Meta requires this)
  fbc               from _fbc, or rebuilt from fbclid
  fbp               from the _fbp cookie
  external_id       SHA-256 of the visitor's captured meta_external_id
  em, ph, fn, ln    SHA-256, from the postback
  ct, st, zp, country SHA-256, from the click's geo
custom_data
  value, currency   from the postback payout

IP, User-Agent, fbc und fbp werden ungehasht gesendet. Persönliche Matching-Felder und die Meta-External-ID des Besuchers werden gehasht. Der Legacy-Tracking-Parameter external_id bleibt unverÀndert: Bei anderen Traffic-Quellen kann er einen Ad-Klick bedeuten, wird also nicht automatisch als Meta-Visitor-Identity wiederverwendet.

Die Event-URL ist nicht der Acquisition-Referrer

Konfiguriere die echte Checkout-/Thank-you-URL an der Integration oder bringe den Partner dazu, eine URL-kodierte event_source_url in den Postback aufzunehmen. Eine explizit konfigurierte URL gewinnt. Die konfigurierten Makros {campaign_url}, {landing_url} und {clickid} bleiben verfĂŒgbar, nutze sie aber nur, wenn sie die Seite dieses Events beschreiben. {landing_url} nutzt erfassten Landing-Kontext (oder die gespeicherte Landing-URL), nie den Facebook/Google-Acquisition-Referrer des Klicks.

FĂŒr Events, die auf unterschiedlichen Seiten passieren, akzeptiert das Textfeld Event source URL der Kampagne zusĂ€tzlich eine fortgeschrittene JSON-Map, keyed ĂŒber den finalen Meta-Event-Namen:

{"InitiateCheckout":"{campaign_url}","Purchase":"{offer_url}"}

Das ist eine explizite Konfiguration, keine Default-Inferenz ĂŒber deinen Funnel. Nutze das Beispiel nur, wenn die Checkout-Initiierung auf der Kampagnen-Seite passiert und der Kauf auf der URL des gewĂ€hlten Offers abgeschlossen wird. Ein fehlender Map-Key erlaubt eine explizite URL aus der Integration; ein vorhandener, aber leerer/ungĂŒltiger Eintrag ersetzt keine andere Seite. Die URL-Wahl schaltet das Event selbst nie ab. Einfache URL-Einstellungen und bestehende Makros behalten ihr Verhalten.

{offer_url} löst den gewĂ€hlten Offer des persistierten Klicks ĂŒber die bestehenden Offer-/Netzwerk-Parameter- und Klick-Makro-Regeln auf. Er pickt nicht den ersten Offer einer Kampagne, folgt keinen Redirects und entdeckt keine BestĂ€tigungsseite eines Dritten. Er nutzt die Offer-Konfiguration zum Postback-Zeitpunkt, keinen historischen Snapshot: Halte sie stabil, wĂ€hrend Conversions pendent sind, oder lass dieses Event unkonfiguriert und liefere seine echte URL stattdessen ĂŒber die Integration. Nutze ihn nicht, wenn der Offer auf eine andere Seite weiterleitet, auf der das Event passiert.

Diese fortgeschrittene Map ist eine Einstellung auf Kampagnen-Ebene; das URL-Feld der Pixel Vault akzeptiert weiterhin eine einfache URL. Das Speichern eines verknĂŒpften zentralen Profils ĂŒberschreibt die URL-Overrides der Kampagne gemĂ€ĂŸ dem bestehenden Profil-Sync-Verhalten — prĂŒfe diese Overrides daher nach Profil-Bearbeitungen. Der manuelle Test-Endpoint liefert keinen Kampagnen-/Offer-Makro-Kontext; nimm fĂŒr einen reprĂ€sentativen manuellen Test eine explizite echte URL, statt zu erwarten, dass er einen Checkout entdeckt.

Orbitra leitet keine Checkout-URL eines Produzenten aus deiner Landingpage her. Ist keine gĂŒltige URL bekannt, loggt es eine Konfigurations-Warnung und lĂ€sst das Feld weg, behĂ€lt aber die eingereihte Absicht und Metas Zustellungs-Ergebnis. Vor dem Upgrade brauchen Integrationen, die sich auf den alten Referrer-Fallback verließen, eine echte Event-URL: Meta verlangt sie fĂŒr Website-Events und kann Requests ohne sie ablehnen. Ersetze sie nie durch eine Seite, die der Besucher nie genutzt hat. Das Browser-reportConversion() enthĂ€lt die aktuelle Seite; eine mitgelieferte event_source_url kann das ĂŒberschreiben, wenn die Integration es besser weiß.

Der native Landing-/Offer-Pfad und die aktuellen tracking.js, kclient.js und PHP KClient unterstĂŒtzen den gemeinsamen Collector meta-matching.js. Er bewahrt opake Cookie-Werte, inklusive Parameter-Builder-Suffixe. Ein neues fbclid ersetzt ein veraltetes fbc; wiederholte Beobachtungen desselben Klicks bewahren seinen Zeitstempel. Identifier werden nicht auf das allgemeine 512-Byte-Limit fĂŒr Tracking-Parameter gekĂŒrzt.

Neue Matching-Cookies/Identitys sind beschrĂ€nkt auf Besuche mit einem aktiven Facebook-Kampagnen-Pixel, bestehendem fbclid/fbc/fbp-Kontext oder explizitem meta_matching=1. Unbeteiligte Kampagnen holen sich nicht allein durch das Orbitra-Update Meta-Cookies. Bei einem qualifizierten gespeicherten Browser-Besuch, mit aktivierten Cookies, wiederverwendet der Collector _fbp oder legt einmal ein First-Party-Browser-Cookie an, falls fehlend. Er hĂ€lt außerdem 90 Tage eine anonyme orbitra_visitor-Identity. Beides entsteht nicht zum Conversion-Zeitpunkt. Das Cookie-Erfassen lĂ€uft frĂŒh und erneut nach dem Seitenladen, bei ausgehender Interaktion und beim Seiten-Exit. Ein signierter, klick-begrenzter POST kann nur fbp, fbc und die zuerst beobachtete Landing-URL aktualisieren, nicht die Visitor-Identity, IP, den User-Agent oder die Conversion. Diese Updates betreffen kĂŒnftige Payloads, nicht bereits eingereihte Events.

Externe Landings mĂŒssen ihre kopierten Client-Dateien ebenfalls aktualisieren. Der PHP KClient leitet die Visitor-IP/den User-Agent und Browser-Cookies weiter, nicht die IdentitĂ€t des Hosting-Servers; platziere echo $client->matchingScript(); frĂŒh im <head> der Landingpage, um spĂ€t entstehende Cookies zu erfassen (timerScript() enthĂ€lt es ebenfalls). Halte das Trusted-Proxy-Handling auf dem Landing-Server korrekt konfiguriert; vertraue keinen beliebigen weitergeleiteten IPs.

Das ist eine fokussierte Implementierung der dokumentierten Parameter-Regeln von Meta, keine Installation des offiziellen Parameter-Builder-SDKs oder all seiner optionalen Browser-Anreicherungs-Features. Siehe Metas Parameter-Builder-Guidance und fbp/fbc-Spezifikation.

Der Collector ist keine Consent-Management-Plattform. Betreiber mĂŒssen das Tracking nach ihrer Consent-Policy gaten. use_cookies=0 deaktiviert den Matching-Collector; meta_matching=0 bei einem eingehenden Besuch deaktiviert ihn fĂŒr diesen Klick. Bei externen JavaScript-Integrationen setze window.orbitra_meta_matching = false vor dem Laden der Clients, um abzuwĂ€hlen; PHP-Clients können ->param('meta_matching', '0') nutzen. Die native HTML-Injection nutzt ein Deferred-Skript: Ein vor den Deferred-Skripten in der Landingpage gesetztes Inline-Consent-Flag kann das Browser-Erfassen abschalten. Es kann serverseitig bereits gesetztes Erfassen/Cookies aus der HTTP-Antwort nicht rĂŒckgĂ€ngig machen. Nutze die serverseitigen Kontrollen, bevor du diesen Besuch auslieferst, wenn das Erfassen nicht erlaubt ist.

Die Visitor-ID im Browser-Pixel wiederverwenden

Der Collector installiert und feuert kein Meta-Pixel. In deinem bestehenden, konsentierten Pixel-Setup ĂŒbergib dieselbe rohe Identity vor dem ersten echten Browser-Event:

const visitorId = window.OrbitraMatching?.getExternalId();
if (visitorId) {
    fbq('init', 'YOUR_PIXEL_ID', { external_id: visitorId });
}
// Your existing real Pixel events follow; do not initialize the same Pixel twice.

Nutze das, nachdem Client/Collector bereit sind, inklusive Deferred-Laden auf nativen Landings. PHP-Integrationen bekommen denselben rohen Wert ĂŒber $client->getExternalId() (nutze json_encode, wenn du ihn in JavaScript einbettest). Orbitra hasht ihn einmalig fĂŒr die CAPI. Ersetze ihn nicht durch eine Order-ID, hashe ihn nicht erneut und lege im Postback keine weitere ID an. Die bestehende Click-/SubID-Beziehung trĂ€gt ihn durch die Affiliate-Conversion; E-Mail und Telefon braucht es nicht, um diese Beziehung zu halten. Es braucht trotzdem eine echte Pixel-/CAPI-Assoziation, um dem Meta-Matching zu helfen; allein eine ID zu erzeugen garantiert kein Match. Meta-External-ID-Guidance.

Um PII zu senden, nimm sie in den eingehenden Postback auf:

https://tracker.example/<postback_key>/postback?subid=3sh8so4er3&status=sale&payout=2.61&[email protected]&fn=John&ln=Snow&ph=+71234567890

Werte werden normalisiert, wie Meta es verlangt (E-Mail kleingeschrieben, Telefon auf Ziffern reduziert) vor dem Hashing — ein nicht normalisierter Hash matcht schlicht nie.

Zustellung und Wiederholungen

Die Conversion, die Klick-Summen und die qualifizierten CAPI-Intents committen in einer kurzen SQLite-Transaktion. Ein Queue-Schreibfehler rollt diese Einheit zurĂŒck und liefert einen Fehler (503 bei erschöpfter Lock-Konkurrenz), sodass der Sender es wiederholen kann. Das Browser-Conversion-GIF erhĂ€lt diese Server-Fehler, statt sie als HTTP 200 zu maskieren. Notifications und die Vorbereitung ausgehender S2S bleiben außerhalb der Schreib-Transaktion.

Wiederholte Postbacks nutzen die bestehende Intent fĂŒr dieselbe Conversion, dasselbe Pixel, denselben Event-Namen und dieselbe Event-ID wieder, inklusive fehlgeschlagener/zugestellter Zeilen. Ein anderer Status/Event oder eine andere Transaction-ID kann ein eigenstĂ€ndiges Event erzeugen. Die Queue-Idempotenz hĂ€lt, solange die ursprĂŒngliche Zustellungs-Zeile vorgehalten wird; Log-Bereinigung entfernt diese lokale Historie. Das ist keine automatische Browser-Deduplizierung: Das Pixel muss fĂŒr dieselbe Aktion dieselbe eventID und denselben Event-Namen nutzen. Die Schema-Migration 52 ergĂ€nzt einen indizierten Lookup und eine interne Signing-Key-Tabelle; sie stellt historische Conversions nicht wieder her und spielt sie nicht ab.

Events werden in s2s_postbacks_log eingereiht und von postback_queue_cron.php mit exponentiellem Backoff zugestellt — derselbe Worker, der ausgehende S2S-Postbacks ausliefert. Eine langsame Antwort von Meta verzögert nie die Antwort an den Postback des Affiliate-Netzwerks. Ein Sender, der timeoutet, darf es wiederholen; wiederholte Annahme nutzt die bestehende CAPI-Intent, statt dasselbe Event erneut einzureihen.

* * * * * php /var/www/orbitra/postback_queue_cron.php >> /var/log/orbitra_postback_queue.log 2>&1

Zustellungs-Status, HTTP-Code und bereinigte Fehlerdetails sind sichtbar im S2S-Logs-UI. Die bestehende Spalte response, auch von der Logs-API zurĂŒckgegeben, speichert jetzt begrenzte, bereinigte events_received, Warnungen/Meldungen und fbtrace_id, falls mitgeliefert. Sie behĂ€lt weder den beliebigen Rohtext der Antwort noch zurĂŒckgeschickte Credentials.

Bei Meta verlangt delivered jetzt HTTP 2xx, ein JSON-Objekt ohne API-Fehler und ein events_received, das den vollen Request bestĂ€tigt. Mehrdeutige Antworten und transiente Fehler folgen dem bestehenden begrenzten Backoff; dauerhafte Authentifizierungs- oder Validierungsfehler scheitern ohne nutzlose Wiederholungen. Der manuelle Test-Button nutzt dieselbe Validierung. Die Transport-Regeln fĂŒr generisches S2S und TikTok sind unverĂ€ndert.

Verbucht, eingereiht, von Meta bestĂ€tigt und einer Ad zugeordnet sind verschiedene Stadien. Eine bestĂ€tigte API-Antwort ist kein Beweis fĂŒr die Attribution einer einzelnen Kampagne und garantiert kein sofortiges Ads-Manager-Reporting.

Fehlerbehebung

Im Events Manager kommt nichts an — prĂŒfe der Reihe nach: Der Klick hat fbclid (⚙ → Logs → Traffic); fbclid={fbclid} steht nicht in den URL-Parametern der Anzeige; der Status ist auf ein Event gemappt; der Queue-Worker-Cron lĂ€uft; das S2S-Log zeigt den Versuch.

„Invalid parameter" von Meta — meist gehören Pixel-ID und Token zu verschiedenen Assets, oder der Token wurde fĂŒr ein Pixel erzeugt, das dir nicht mehr gehört.

Events kommen an, aber die Match-QualitĂ€t ist niedrig — prĂŒfe erfasste fbp/fbc, die echte Visitor-IP/den User-Agent, den Consent und ob dieselbe externe Identity das Browser-Pixel erreicht. Fehlende E-Mail/Telefon bedeutet nicht allein, dass ein Event abgelehnt wird. Cross-Domain-Cookies lassen sich aus dem Request einer anderen Seite nicht lesen: Nutze den externen Landing-Client auf dieser Domain. Bei einem sofortigen Redirect ohne Browser-Code lassen sich nur bereits verfĂŒgbare Identifier erfassen.


Dateien

PfadRolle
aggregator_engines/FacebookAdsEngine.phpMarketing-API-Insights-Reader
core/CostImporter.phpUpsert + Attribution + WĂ€hrung
core/CurrencyRates.phpFX-Tabelle, Cache, manuelle Overrides
core/ClickParams.phpwas auf einem Klick erfasst wird
core/FacebookConversions.phpCAPI-Payload, Hashing, Queueing
postback.phpreiht CAPI-Events bei Conversion ein
postback_queue_cron.phpstellt sie mit Wiederholungen zu
tests/facebook_integration_test.phpEnd-to-End-Abdeckung, ohne Netzwerk
← ZurĂŒck
Push- und Pop-Netzwerke
Weiter →
Dolphin / Fbtool
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 →