Meta mit einem Token verbinden (System User)

Schritt 1 — Business-Einstellungen öffnen

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

Meta Business Settings öffnen

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

Schritt 2 — Einen Systembenutzer erstellen

Ein Systembenutzer (System User) ist ein "technischer Nutzer" des Unternehmens, speziell für Integrationen gedacht.

1. Gehen Sie im linken Menü zu Benutzer → Systembenutzer.
2. Klicken Sie auf Hinzufügen.
3. Geben Sie ihm einen erkennbaren Namen, z. B. RoyLead Sync.
4. Rolle: Mitarbeiter — Lesezugriff genügt, Admin ist nicht nötig. Klicken Sie auf Systembenutzer erstellen.

Schritt 3 — Das Werbekonto zuweisen

Der Token funktioniert nur bei Assets, die Sie diesem Benutzer explizit zuweisen.

1. Klicken Sie bei ausgewähltem Systembenutzer auf Assets zuweisen.
2. Wählen Sie unter Werbekonten das Konto, das Sie verbinden möchten.
3. Aktivieren Sie bei den Berechtigungen nur den Schalter "Leistung anzeigen" (unter Teilzugriff): das ist der Lesezugriff, den ads_read braucht. Lassen Sie "Kampagnen verwalten" und "Volle Kontrolle" deaktiviert.
4. Klicken Sie auf Assets zuweisen.

⚠️ Wenn Sie diesen Schritt überspringen, schlägt das Verbinden des Kontos mit einem Berechtigungsfehler fehl: der Token wäre gültig, würde aber kein Konto "sehen".

Schritt 4 — Die App vorbereiten

Der Token wird über eine App des Unternehmens generiert, und der Systembenutzer braucht eine Rolle für diese App. Wenn Sie bereits eine App mit dem Systembenutzer verknüpft haben, springen Sie zu Schritt 5.

Die App erstellen (falls Sie keine haben)

Eine Meta-App-Überprüfung ist nicht nötig: die App ist nur der technische "Container" für den Token, und jede Unternehmens-App mit der Marketing API funktioniert.

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 bereits Ihre).

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

4. Unternehmen: verknüpfen Sie die App mit Ihrem Unternehmensportfolio, damit sie zum richtigen Unternehmen gehört.
5. Prüfen Sie die Übersicht und klicken Sie auf App erstellen. Die Marketing API ist dank des gewählten Anwendungsfalls bereits enthalten.

Die App mit dem Systembenutzer verknüpfen

Die App zu erstellen reicht nicht aus: der Systembenutzer braucht eine Rolle für die App, sonst bleibt der Schritt "Berechtigungen zuweisen" des Tokens leer.

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

3. Wählen Sie den Systembenutzer roylead, aktivieren Sie den Schalter "App entwickeln" und klicken Sie auf Zuweisen.

Schritt 5 — Den Token generieren

1. Klicken Sie beim Systembenutzer auf Neuen Token generieren.
2. Wählen Sie Ihre App aus der Liste (die in Schritt 4 vorbereitete).
3. Kreuzen Sie bei den Berechtigungen ads_read an.
4. Token-Ablauf: Sie können ihn für eine dauerhafte Verbindung auf Nie setzen.
5. Klicken Sie auf Token generieren und kopieren Sie ihn sofort.

⚠️ Wenn im Schritt "Berechtigungen zuweisen" "Keine Berechtigungen verfügbar" steht, ist die App nicht mit dem Systembenutzer verknüpft: schließen Sie Schritt 4 ab und versuchen Sie es erneut.

🔒 Meta zeigt den Token nur einmal an. Wenn Sie ihn verlieren, kein Problem: generieren Sie einen neuen und fügen Sie ihn erneut in RoyLead ein.

Schritt 6 — Die Werbekonto-ID finden

1. Gehen Sie in den Unternehmenseinstellungen zu Konten → Werbekonten.
2. Wählen Sie das Konto aus: die ID ist die angezeigte Nummer (z. B. 123456789012345).

RoyLead akzeptiert sowohl die reine Nummer als auch das Format act_123456789012345.

Schritt 7 — Alles in RoyLead einfügen

1. Öffnen Sie den Bereich Anzeigen in RoyLead.
2. Klicken Sie auf Konto verbinden und wählen Sie Facebook · mit Token.
3. Fügen Sie den Token und die Konto-ID ein, dann bestätigen Sie.

Zu Anzeigen gehen ↗

RoyLead validiert den Token sofort bei Meta, ruft Name und Währung des Kontos automatisch ab (Sie müssen sie nicht auswählen) und speichert die Verbindung.

Schritt 8 — Prüfen

• Das Konto erscheint in der Liste mit dem Status Verbunden.
• Die automatische Synchronisierung läuft alle paar Stunden; Sie können sie auch über den Button Sync erzwingen.
• Nach der ersten Synchronisierung erscheinen Ausgaben und ROI in Analytics neben Ihren Leads.

Token und App: wie sie zusammenspielen

Der manuelle Token und "Mit Facebook anmelden" (OAuth) sind zwei Wege, um dasselbe zu erreichen: die Berechtigung, die Kontodaten zu lesen. Sie können den Token jetzt nutzen und jederzeit zu OAuth wechseln, ohne historische Daten zu verlieren.

ℹ️ Ein Hinweis: der Token ist an die Meta-App gebunden, mit der er generiert wurde. Wird diese App von Meta gesperrt, stoppen sowohl Token als auch OAuth. Der Token schützt Sie vor Problemen im Login-Ablauf, nicht vor einer App-Sperrung.

Wenn der Token abläuft oder aufhört zu funktionieren

Wenn Sie einen Token mit Ablaufdatum generieren und dieses eintritt, oder Sie ihn im Business Manager widerrufen, markiert RoyLead das Konto mit einem Fehlerstatus.

Zum Beheben: klicken Sie auf der Kontokarte auf ⋯ → Zugangsdaten bearbeiten, fügen Sie den neuen Token ein und speichern Sie. Die gesamte Verbindung muss nicht neu eingerichtet werden.

Fehlerbehebung

💡 Generieren Sie den Token mit Ablauf Nie, um Unterbrechungen zu vermeiden: das ist die bequemste Wahl für eine durchgehende Synchronisierung.

Best Practices

• 🔑 Nutzen Sie einen dedizierten Systembenutzer für RoyLead: das Widerrufen seines Tokens blockiert nur diese Integration.
• 🔒 Weisen Sie dem Systembenutzer nur die Werbekonten zu, die Sie tatsächlich synchronisieren möchten.
• 🚨 Behandeln Sie den Token wie ein Passwort: wenn Sie vermuten, dass er durchgesickert ist, generieren Sie ihn im Business Manager neu und fügen Sie ihn erneut ein.