Damit die Anbindung funktioniert, brauchst du ein paar Dinge auf Meta-Seite. Ohne diese kann der OAuth-Prozess fehlschlagen oder es kommen keine Daten an.
- Du bist Admin oder Werbeadmin im Meta Business Manager
- Es gibt mindestens ein aktives Werbekonto im Business Manager
- Deine Anzeigen sind aktiv (oder waren in den letzten 90 Tagen aktiv)
- Du hast einen Pop-up-Blocker für facebook.com deaktiviert
- Persönliche „Ad Accounts" ohne Business Manager werden von Meta zunehmend eingeschränkt — wir empfehlen, in den Business Manager zu wechseln
Die Verbindung läuft komplett über den offiziellen Meta-OAuth-Flow. Wir bekommen niemals dein Passwort, sondern nur ein Access-Token, das du jederzeit widerrufen kannst.
- Gehe zu „Profil → Integrationen"
- Klicke auf „Meta verbinden" in der Karte „Meta Ads Manager"
- Bestätige im Meta-Dialog die angeforderten Berechtigungen (ads_read, business_management)
- Wähle das Werbekonto aus, das du verbinden möchtest
- Du wirst zurück nach CreatrLabs geleitet — Status springt auf „Verbunden"
Illustration folgt
Wir lesen nur, was wir für die Auswertung deiner Creator-Kampagnen wirklich brauchen. Keine privaten Daten, keine Endkunden-PII, kein Zugriff auf Posts oder Nachrichten. Wir lesen: - Kampagnen-, Ad-Set- und Anzeigen-IDs - Anzeigentitel, Landing-URLs, UTM-Parameter - Performance-Metriken: Spend, Impressions, Klicks, Conversions, Revenue, ROAS, CTR, CPM - Synchronisations-Zeitstempel Wir lesen NICHT: - Audience-Daten oder Profile von Endnutzern - Werbe-Creatives (außer Titel + Landing-URL) - Anzeigen aus anderen Werbekonten, die du nicht verbunden hast - Pixel-Events oder CAPI-Rohdaten
- Tokens werden AES-256-GCM verschlüsselt gespeichert
- Sync läuft alle 6 Stunden automatisch + manuell auslösbar
- Trennen der Verbindung löscht das Token sofort
Damit eine Anzeige als „Creator-Performance" auftaucht, muss sie eindeutig einem Deal zugeordnet werden können. Dafür gibt es zwei Wege:
Weg A — `cl_deal` Short-ID (empfohlen): In der Anzeigen-Landing-URL setzt du den Parameter cl_deal=XXXXXXXXXX. Diesen Code generieren wir automatisch pro Deal. Wenn er gesetzt ist, ist die Zuordnung deterministisch — keine Verwechslungen möglich.
Weg B — UTM-Heuristik: Falls kein cl_deal gesetzt ist, versuchen wir über utm_source=creatrlabs + utm_campaign + utm_content zu matchen. Das funktioniert in den meisten Fällen, ist aber nicht 100% deterministisch.
- Der Tracking-Link inkl. cl_deal liegt im Dealroom unter „Tracking & Performance"
- Du kannst den Link kopieren und direkt in deine Anzeige einsetzen
- Ohne cl_deal landen Anzeigen ggf. im „Orphan-Posteingang" (siehe Guide UTM-Tracking)
Konkretes Beispiel folgt
Sobald die Verbindung steht, ändern sich folgende Dinge in deinem Dashboard: - Live-Performance-Werte ersetzen manuelle Eingaben — bleiben aber als Fallback erhalten - ROI-Forecast nutzt deine echten ROAS-Werte (gewichtet) statt nur Schätzungen - AI-Intelligence weiß, welche Hooks/Plattformen tatsächlich funktionieren - Im Creator-Vergleich siehst du eine Quelle pro Wert (Live · Manuell · Final)
- Source-Hierarchie: Final validiert (höchste) > Live (Meta) > Manuell
- Manuelle Eingaben gehen NIE verloren, nur temporär „überschrieben"
- Nach Deal-Abschluss kannst du die finalen Werte in der Post-Deal-Validierung bestätigen
Falls etwas hakt, sind das meistens diese Themen.
- „Invalid Scopes" — du hast eine alte App-Version genutzt; nochmal verbinden hilft
- „Keine Werbekonten gefunden" — du bist im Business Manager nicht als Admin/Werbeadmin eingetragen
- Werte stimmen nicht überein — Meta-Reporting hat 24h Verzögerung; sync ist also lag-toleriert
- Anzeigen tauchen nicht auf — prüfe, ob
cl_dealoder UTM-Parameter in der Landing-URL stehen
