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 tut | Richtung | Wo | |
|---|---|---|---|
| Facebook Costs | Importiert den Ad-Spend aus Meta in den Tracker | Meta â Orbitra | Integrations â Facebook Costs |
| Facebook Conversions API | Schickt Conversions vom Tracker an Meta | Orbitra â Meta | Integrations â 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:
{{adset.id}}ist nicht optional. Es ist der Fallback, den der Kosten-Import nutzt, wenn keine Ad-ID auf dem Klick liegt â zum Beispiel wenn Creatives unter Advantage+ rotieren.- FĂŒge kein
fbclid={fbclid}hinzu. Meta hĂ€ngtfbclidselbst an. Als Makro deklariert erzeugt es einen leeren Wert, der den echten ĂŒberschreibt â und die Conversions API hat dann nichts, worauf sie matchen kann. - LĂ€uft Traffic durch eine App oder einen Prelander, der die Makros umpackt, reiche sie als
sub_id_Nweiter und sage der Cost-Connection, wo sie gelandet sind â siehe Traffic ĂŒber eine App.
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.
- <https://business.facebook.com/settings/system-users> â System-User hinzufĂŒgen
- Weise ihm den Ad-Account zu, mit View performance (oder voller Kontrolle)
- Generate token â wĂ€hle deine App â hake
ads_readan â 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:
| Feld | Hinweise |
|---|---|
| Access Token | langlebiger oder System-User-Token |
| Ad Account ID | act_1234567890 |
| Facebook API version | standardmĂ€Ăig die neueste unterstĂŒtzte; Ă€ltere Accounts können eine Ă€ltere pinnen |
| Proxy | optional, scheme://user:pass@host:port, akzeptiert auch socks5:// |
| Update spend every | wie oft der Cron den Spend neu liest |
| Advanced: parameter mapping | nur 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
- Der geplante Sync (
aggregator_cron.php) liest bei jedem Lauf die letzten 5 Tage erneut, beim ersten Sync einer Connection 30 Tage. - Ad-Plattformen restatieren die Vergangenheit: Der Spend wird spÀt zugeordnet, und der aktuelle Tag ist eine laufende Summe, die den ganzen Tag wÀchst. Records werden deshalb auf
(connection_id, external_id)geupsertet und die Attribution neu gerechnet, nie akkumuliert â denselben Tag erneut zu syncen ist sicher und idempotent. - Der Spend wird auf Ad-Level mit
time_increment=1geholt, jede Zeile ist also eine Ad an einem Tag.
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:
ad_id(auchcreative_id,creative)adset_id(auchadgroup,adgroupid,ad_group_id)campaign_id(auchcampaign,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:
- In Facebook:
sub_id_3={{adset.id}} - Von der App zu Orbitra:
sub_id_3={sub_id_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:
- code 190 â Token abgelaufen oder widerrufen. Stelle ihn neu aus.
- code 100, â(#100) ... field" â die API-Version unterstĂŒtzt ein Feld nicht mehr. Zieh die Connection auf eine neuere Version.
- code 17 / 613 â Rate-Limit. Erhöhe das Sync-Intervall.
- leere oder blockierte Antworten â Meta filtert den Server des Trackers per Geo/IP. Setze einen Proxy auf der Connection.
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):
| Feld | Hinweise |
|---|---|
| Campaign | deren Conversions dieses Pixel empfÀngt |
| Pixel ID | aus dem Events Manager |
| Conversions API token | das schaltet das serverseitige Senden ein |
| Status â Meta event | welcher Tracker-Status welches Meta-Event erzeugt |
| Test event code | optional, aus dem Events Manager â Test events |
| Proxy | optional, dasselbe Format wie die Cost-Connection |
| Event source URL | die 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-Status | Meta-Event |
|---|---|
lead | Lead |
sale | Purchase |
deposit | Purchase |
registration | CompleteRegistration |
rejected | nicht gesendet |
trash | nicht 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Ă.
Browser-Matching und Consent
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
| Pfad | Rolle |
|---|---|
aggregator_engines/FacebookAdsEngine.php | Marketing-API-Insights-Reader |
core/CostImporter.php | Upsert + Attribution + WĂ€hrung |
core/CurrencyRates.php | FX-Tabelle, Cache, manuelle Overrides |
core/ClickParams.php | was auf einem Klick erfasst wird |
core/FacebookConversions.php | CAPI-Payload, Hashing, Queueing |
postback.php | reiht CAPI-Events bei Conversion ein |
postback_queue_cron.php | stellt sie mit Wiederholungen zu |
tests/facebook_integration_test.php | End-to-End-Abdeckung, ohne Netzwerk |
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 â