Meta mit einem Token verbinden (System User)

Schritt 1 — Unternehmenseinstellungen öffnen

Gehen Sie zum Meta Business Manager und melden Sie sich mit einem Administrator-Konto an.

Meta Business Settings öffnen

ℹ️ Wenn Sie mehrere Unternehmen verwalten, prüfen Sie oben links, dass das richtige ausgewählt ist: jenes, dem das Werbekonto gehört.

Schritt 2 — Systemnutzer erstellen

Der Systemnutzer (System User) ist ein „technischer Nutzer" des Unternehmens, genau für Integrationen gedacht.

1. Im linken Menü zu Nutzer → Systemnutzer.
2. Auf Hinzufügen klicken.
3. Einen erkennbaren Namen geben, z. B. RoyLead Sync.
4. Rolle: Employee (Mitarbeiter) — Admin ist nicht nötig. Die Schreibrechte kommen von den Assets, die Sie in den Schritten 3-5 zuweisen, nicht von der Rolle. Auf Systemnutzer erstellen klicken.

Schritt 3 — Werbekonten zuweisen (mit Schreibzugriff)

Der Token sieht nur die Assets, die Sie diesem Nutzer ausdrücklich zuweisen.

1. Mit ausgewähltem Systemnutzer auf Assets zuweisen klicken.
2. Asset-Typ: Werbekonten → die Konten auswählen, die Sie verbinden möchten. Wenn Sie mehrere nutzen wollen, wählen Sie jetzt alle aus: RoyLead verbindet sie in einem Durchgang.
3. Bei den Berechtigungen unter Teilweiser Zugriff „Kampagnen verwalten" einschalten: das ist ads_management, die Berechtigung zum Erstellen und Starten. („Leistung ansehen" schaltet sich selbst ein, es ist enthalten.)
4. „Werbekonten verwalten" (Vollzugriff) ausgeschaltet lassen: das würde auch Kontrolle über Zahlungen und Kontoeinstellungen geben, die RoyLead nicht braucht.
5. Auf Assets zuweisen klicken.

⚠️ Nur mit „Leistung ansehen" wird das Konto verbunden und die Ausgaben kommen an, aber der Start funktioniert nicht: Meta lehnt die Kampagnenerstellung mit einem Berechtigungsfehler ab.

Schritt 4 — Pixel zuweisen

Beim Start deklariert die Anzeigengruppe den Pixel als Conversion-Ziel, und dieser Aufruf erfolgt mit dem Token: sieht der Token den Pixel nicht, antwortet Meta mit einem Berechtigungsfehler.

1. Weiter in Assets zuweisen, Asset-Typ Datensätze wählen (in älteren Unternehmen heißt es Pixel).
2. Den Pixel auswählen, den Sie für diese Kampagnen nutzen.
3. Berechtigungen: „Event-Datensatz verwenden" (Teilweiser Zugriff) einschalten — dort steht ausdrücklich „Anzeigen für Conversions mit diesem Datensatz erstellen". „Event-Datensatz verwalten" ausgeschaltet lassen.
4. Auf Assets zuweisen klicken.

ℹ️ Das ist etwas anderes als der CAPI-Token, mit dem RoyLead die Events an Meta sendet. Hier dient es nur dazu, dass die Kampagne auf diesen Pixel zeigen kann.

Schritt 5 — Facebook-Seite zuweisen

Jede Meta-Anzeige hat eine Seite als Absender. Seiten werden in einem anderen Bereich zugewiesen, nicht im Fenster „Assets zuweisen".

1. Linkes Menü: Konten → Seiten.
2. Die Seite auswählen, die Sie in den Anzeigen verwenden.
3. Auf Personen zuweisen klicken und den Systemnutzer RoyLead Sync wählen.
4. „Werbeanzeigen" (Anzeigen der Seite erstellen und verwalten) und „Insights" einschalten, dann auf Zuweisen klicken.

⚠️ Wenn beim Start ein Berechtigungsfehler zur Seite erscheint, kommen Sie hierher zurück und erhöhen auf Vollzugriff: die Verknüpfung des Instagram-Kontos verlangt das manchmal.

Schritt 6 — App vorbereiten

Der Token wird über eine App des Unternehmens generiert, und der Systemnutzer muss eine Rolle auf dieser App haben. Wenn Sie bereits eine mit dem Systemnutzer verknüpfte App haben, springen Sie zu Schritt 7.

App erstellen (falls Sie keine haben)

Keine Meta-Genehmigung nötig: die App ist nur der technische „Container" für den Token, und jede Unternehmens-App mit der Marketing API genügt.

1. Gehen Sie zu Unternehmenseinstellungen → Konten → Apps → Hinzufügen → „Neue App-ID erstellen".

2. App-Name: z. B. RoyLead Sync (die Kontakt-E-Mail ist schon Ihre).

3. Anwendungsfälle: „Werbeanzeigen mit der Marketing API erstellen und verwalten" ausgewählt lassen (die erste Option, standardmäßig angehakt).

4. Unternehmen: die App mit Ihrem Business-Portfolio verknüpfen, damit sie zum richtigen Unternehmen gehört.
5. Die Übersicht prüfen und auf App erstellen klicken. Die Marketing API ist durch den gewählten Anwendungsfall schon enthalten.

App mit dem Systemnutzer verknüpfen

Die App zu erstellen genügt nicht: der Systemnutzer muss eine Rolle auf der App haben, sonst bleibt der Schritt „Berechtigungen zuweisen" beim Token leer.

1. Gehen Sie zu Konten → Apps und wählen Sie Ihre App.
2. Klicken Sie auf Personen zuweisen.

3. Den Systemnutzer (z. B. RoyLead Sync) auswählen, den Schalter „App entwickeln" einschalten und auf Zuweisen klicken. „App verwalten" ausgeschaltet lassen.

App veröffentlichen (zum Starten nötig)

Eine neu erstellte App ist im Entwicklungsmodus: sie liest Daten, kann aber keine Anzeigen erstellen. Der Start bricht auf halbem Weg beim Creative ab, mit „Das Werbeanzeigen-Creative wurde von einer App im Entwicklungsmodus erstellt" (1885183).

1. Öffnen Sie Ihre App auf developers.facebook.com/apps.
2. App-Einstellungen → Basis: die zwei Felder ausfüllen, die Meta zum Veröffentlichen verlangt — URL der Datenschutzrichtlinie und Kategorie. Speichern.
3. Im linken Menü Veröffentlichung: die App von „Nicht veröffentlicht" veröffentlichen.

ℹ️ Das ist nicht Metas App Review, die Sie nicht brauchen: es ist nur der Schalter, der die App aus dem Entwicklungsmodus holt.

Schritt 7 — Token generieren

1. Zurück zu Nutzer → Systemnutzer, Ihren Nutzer auswählen und auf Neues Token generieren klicken.
2. Ihre App aus der Liste wählen (die aus Schritt 6).
3. Ablauf des Tokens: Nie, für eine dauerhafte Verbindung.
4. Diese Berechtigungen anhaken:

5. Auf Token generieren klicken und ihn sofort kopieren.

⚠️ Wenn im Schritt „Berechtigungen zuweisen" „Keine Berechtigungen verfügbar" steht, ist die App nicht mit dem Systemnutzer verknüpft: erledigen Sie Schritt 6 und versuchen Sie es erneut.

🔒 Meta zeigt den Token nur einmal. Ihn zu verlieren ist kein Problem: generieren Sie einen neuen und fügen Sie ihn wieder in RoyLead ein.

Schritt 8 — Token in RoyLead einfügen

1. Öffnen Sie den Tab Werbekonten Ihres Teams in RoyLead.
2. Klicken Sie auf Konto verbinden und wählen Sie „Meta · verbinden Sie den ganzen Business Manager".
3. Fügen Sie den Token ein und bestätigen Sie.

Zu den Werbekonten ↗

RoyLead prüft den Token sofort bei Meta, findet alle diesem Token zugewiesenen Werbekonten, holt Name und Währung automatisch und verbindet sie. Am Ende sehen Sie, wie viele Konten neu sind und wie viele aktualisiert wurden.

ℹ️ Es wird keine Konto-ID verlangt: erscheint ein Konto nicht, ist es dem Systemnutzer nicht zugewiesen (zurück zu Schritt 3).

Schritt 9 — Pixel in das Register importieren

In der Kampagnenansicht listet das Dropdown Pixel nur Pixel, die mit diesem Werbekonto verknüpft sind. Ein von Hand im Register angelegter Pixel ist mit keinem Konto verknüpft, das Dropdown bleibt also leer und der Start ist blockiert.

1. Öffnen Sie den Bereich Pixel in RoyLead.
2. Klicken Sie auf Aus Meta importieren.
3. Wählen Sie das gerade verbundene Meta-Konto und bestätigen Sie.

Zu Pixel gehen ↗

RoyLead importiert die Pixel dieses Kontos und verknüpft sie mit der Verbindung. Ein manueller Pixel mit derselben ID wird überschrieben, nicht dupliziert, und sein CAPI-Token wird der des Systemnutzers.

Schritt 10 — Prüfen

Zur Verbindung:

• das Konto erscheint in der Liste mit dem Status Verbunden;
• die automatische Synchronisierung läuft alle paar Stunden; erzwingen können Sie sie mit der Schaltfläche Synchronisieren;
• nach dem ersten Sync erscheinen Ausgaben und ROI in Analytics neben Ihren Leads.

Zum Start, in der Kampagnenansicht → Zielkonten, müssen Sie pro Konto wählen können:

• die Facebook-Absenderseite (Schritt 5);
• den Pixel (Schritt 9), bei Conversion-Zielen Pflicht;
• den Begünstigten (EU/DSA).

Dann Validieren und Auf Meta starten.

⚠️ Aus dem Dashboard wird die Kampagne aktiv veröffentlicht (oder geplant auf das gewählte Datum und die Uhrzeit, in der Zeitzone des Werbekontos): sie beginnt ab dem Start Geld auszugeben. Nur Starts, die ein Agent über MCP auslöst, werden pausiert veröffentlicht.

Nur der Token startet, „Mit Facebook anmelden" nicht

Ein mit „Mit Facebook anmelden" (OAuth) verbundenes Konto bleibt schreibgeschützt: es importiert Ausgaben und ROI, erscheint aber nie unter den Zielkonten einer Kampagne. Der Grund: die App von RoyLead hat nur Leseberechtigungen für Kosten, nicht ads_management.

Wenn Sie es dennoch versuchen, erscheint der Fehler „Werbekonto ungültig oder nicht startfähig (ein System-User-Token ist erforderlich)". Die Lösung: dasselbe Konto mit dem Token verbinden — die Verbindung wird an Ort und Stelle aktualisiert, ohne die Ausgabenhistorie zu verlieren.

ℹ️ Eine Sache noch: der Token ist an die Meta-App gebunden, mit der er generiert wurde. Sperrt Meta diese App, stehen Token und OAuth gleichzeitig still. Der Token schützt Sie vor Problemen des Login-Flows, nicht vor einer App-Sperre.

Wenn der Token abläuft oder nicht mehr funktioniert

Läuft ein Token mit Ablaufdatum ab oder widerrufen Sie ihn im Business Manager, markiert RoyLead das Konto mit einem Fehlerstatus.

So beheben: den Business Manager mit dem neuen Token über dasselbe Fenster wie in Schritt 8 erneut verbinden (bestehende Konten werden aktualisiert, nicht dupliziert), oder auf der Kontokarte das Menü ⋯ → Zugangsdaten bearbeiten nutzen. Auf Meta-Seite muss nichts neu eingerichtet werden.

Problembehandlung

💡 Generieren Sie den Token mit Ablauf Nie, um Unterbrechungen zu vermeiden: das ist für eine laufende Synchronisierung am bequemsten.

Bewährte Praktiken

• 🔑 Ein eigener Systemnutzer für RoyLead: ein widerrufener Token blockiert nur diese Integration.
• 🔒 Weisen Sie dem Systemnutzer nur die Werbekonten, Pixel und Seiten zu, die Sie wirklich nutzen wollen.
• 🧱 Minimale Rechte: „Kampagnen verwalten" statt „Werbekonten verwalten", „Event-Datensatz verwenden" statt „Event-Datensatz verwalten".
• 🚨 Behandeln Sie den Token wie ein Passwort: bei Verdacht auf ein Leck im Business Manager neu generieren und den neuen einfügen.