Meta Business Extension

Meta Business Extension Developer Panel

Das Meta Business Extension Developer Panel ist ein Produkt, das in deinem App-Dashboard verfügbar ist. In diesem Abschnitt erläutern wir, wie du deine Integration mit Meta Business Extension dort einrichtest und validierst.

Auf das Meta Business Extension Developer Panel zugreifen

  1. Gehe zum Apps-Dashboard und klicke auf den Namen der gewünschten App, um das App-Dashboard zu laden. Erstelle, falls noch nicht geschehen, eine Meta-App mit dem Typ Business.
  2. Klicke im App-Dashboard auf Produkt hinzufügen.
  3. Suche Meta Business Extension in der Produktliste (möglicherweise musst du auf Weitere Produkte ansehen klicken).
  4. Klicke auf der Produktkarte auf Einrichten.
    5. Das MBE Developer Panel erscheint jetzt in der linken Spalte deines App-Dashboards. Wenn du durch die Tabs navigierst, sollte eine Checkliste mit Aufgaben und Einrichtungsschritten erscheinen, die du ausführen musst, wie zum Beispiel Erfüllen der Anforderungen, Einrichten eines Katalogs, Auswählen von Funktionen usw.
  5. Beginne mit den vorbereitenden Schritten und klicke dann auf den Setup-Tab (über das Menü auf der linken Seite), um die restlichen Informationen einzugeben.
  6. Deine Integration zum Review einreichen: Verwende den Tab Integration überprüfen im MBE Developer Panel. Sobald deine Integration genehmigt wurde, kannst du auf den Tab Launch-Status zugreifen, auf dem du deinen App für Nutzer*innen veröffentlichen kannst. Erfahre mehr über die Integrationsprüfung.

Meta Business Extension wird in der Produktliste nicht angezeigt?

  • Wenn du Meta Business Extension nicht in der Liste der Produkte finden kannst, erfordert deine App die private Berechtigung manage_business_extension. Wende dich an deinen Meta-Partner, um die App der Positivliste hinzuzufügen. Du wirst benachrichtigt, wenn die Berechtigung erteilt wurde.
  • Deine App muss den App-Typ „Business“ haben, damit du Zugriff auf das Meta Business Extension Developer Panel erhältst.

Tab „Übersicht“

Die Checkliste auf dem Tab Übersicht enthält alle Schritte, die du ausführen musst, bevor du deine FBE-Integration zur Überprüfung an unser Team senden kannst.

Dieser verständliche Leitfaden sorgt dafür, dass du keine erforderlichen Schritte auslässt. Elemente in der Checkliste werden automatisch als „Unvollständig“, „Optional“, „Mit Fehlern“ oder „Abgeschlossen“ markiert, während du Schritte auf dem Tab Setup ausführst.

Tab „Setup“

Auf dem Tab Setup konfigurierst und validierst du den Größten Teil deiner Integration. Überlege dir welche Anwendungsfälle, Authentifizierungs-Tools und Features deine App deinem Unternehmen bieten wird, bevor du beginnst. Hierdurch stellst du sicher, dass du die richtige Konfiguration vornimmst und die richtigen Tools erstellst.

  • Für welche Anwendungsfälle (Branchen) eignet sich meine App? Beispiele: Termine, Handel, Restaurantreservierungen usw. Die vollständige Liste der von MBE unterstützen Anwendungsfälle findest du hier.
  • Welche Features soll meine App für meine Unternehmen bieten? Beispiele: Instagram-CTA, Messenger-Chat usw.

Die Daten in jedem Abschnitt dieses Tabs werden validiert. So weißt du, ob Fehler mit deiner aktuellen Integration vorliegen, die du erst beheben musst. Wenn beispielsweise beim Einrichten von Business Login oder Authentifizierungs-URL einer der konfigurierten Werte nicht gültig ist (eine nicht unterstützte Währung, fehlerhafte Formatierungen, unvollständige Funktionskonfigurationen usw.) und du auf den Button Speichern klickst, werden Fehler angezeigt. Die Karte wird dann als „Mit Fehlern“ markiert.

Beispiel

Webhooks

Verwende die Webhooks-Karte, um die Webhooks-Konfiguration einzurichten und Änderungen daran vorzunehmen. Das System testet und validiert die hier eingegebene Rückruf-URL und den Verifizierungsschlüssel. Nach der Validierung wird der Webhook fbe_install automatisch abonniert – der Abonnementstatus kann jedoch mit dem Schalter unten auf der Karte umgeschaltet werden.


Platzhalter-Domains

Verwende die Platzhalter-Domains des Developer Panel, um allgemeine Validierungen für das Pixel durchzuführen. Mit diesen Validierungen identifizieren wir auch potenzielle Unternehmen, die von MBE profitieren könnten. Füge alle möglichen Formate für die URL eines Unternehmens in deiner Plattform hinzu.


Beispiele

  • https://www.example.com
  • https://www.example.com/*
  • Wenn Unternehmen benutzerdefinierte Subdomains haben können:
    • https://www.*.example.com
  • Wenn Unternehmen obligatorische Pfade haben müssen:
    • https://www.example.com/some_mandatory_path/*
    • https://www.example.com/*/some_mandatory_path/*

Pixel-Fragebogen

Verwende den Pixel-Fragebogen, um deine Pixel-Integration durchzugehen. Du findest den Fragebogen auf der Karte „Pixel konfigurieren“ auf dem Tab „Setup“. Klicke auf den Button zum Konfigurieren, um mit dem Fragebogen loszulegen. Bei der Integrationsprüfung machen wir uns anhand der Antworten im Fragebogen mit deiner Pixel-Auslöseimplementierung vertraut.

Tab „Integratiosüberprüfung“

Auf diesem Tab kannst du den Prozess zur Integrationsprüfung starten. Du kannst deine Integration zur Überprüfung senden, sobald alle erforderlichen Elemente der Checkliste auf dem Tab „Übersicht“ abgeschlossen sind.

Tab „Launch-Status“

Sobald deine Integration genehmigt wurde, kannst du auf diesen Tab zugreifen, auf dem du deinen App für Nutzer veröffentlichen kannst, indem du auf den Button App starten klickst.

Tab „Debugger“

In diesem Tab findest du zwei Tools, die du nach dem Launch nutzen kannst, wenn du mit dem Onboarding deiner Unternehmen beginnst. Damit kannst du Details zu deren FBE-Verbindung ermitteln und Probleme beim Onboarding lösen.

Wir empfehlen dir, die Debugger-Tools als ersten Hilfeschritt beim Onboarding deiner Unternehmen zu verwenden (beispielsweise wenn sie sich an dein Support-Team wenden, weil sie sich nicht verbinden können oder die erwarteten Features nicht funktionieren). Mit diesen Tools kannst du bestimmen, ob die Probleme auf deiner Seite gelöst werden können.

Fehler wegen falscher App-Konfiguration

Hier werden die verschiedenen Arten von Installationsfehlern aufgeführt, die das Onboarding wegen falscher Konfiguration deiner MBE-Integration verhindern. Für jeden Fehlertyp wird die Anzahl der betroffenen Unternehmen als „Insgesamt“ angezeigt.

Mit dem Dropdown-Menü rechts kannst du die Fehlerliste für einen bestimmten Zeitraum anzeigen (letzter Monat, letzte Woche, letzter Tag).

Beispiel


So löst du angezeigte Fehler

Alle in diesem Dashboard angezeigten Fehler sind auf eine falsche Konfiguration des extras-Objekts zurückzuführen. Dieses musst du beim Onboarding von Unternehmen mit deinem Business Login und deiner Authentifizierungs-URL an Facebook übergeben.

Um sie zu beheben, musst du ermitteln, welcher Teil des extras-Objekts fehlt bzw. falsch formatiert ist oder ungültige Werte verwendet. Für jeden aufgeführten Fehlertyp wird die Ursache angegeben. Du kannst die von deiner Integration gesendeten Werte also mit der FBE-Referenz für „extras“ vergleichen.

Gängige Beispiele:

  • Das Feld currency in setup ist nicht korrekt formatiert: Das bedeutet, dass du für einige Unternehmen einen Wert für die Währung im extras-Objekt sendest, der nicht von Facebook unterstützt wird.

  • Das Feld ig_cta in business_config enthält ungültige Werte: Das bedeutet, dass die Felder oder Werte für die Aktivierung des Instagram-CTA nicht diejenigen sind, die für das ig_cta-Objekt erwartet werden.

Meta Business Extension Debugger

Mit diesem Tool kannst du den Status und Details eines Unternehmens abrufen. Durch Angabe der external_business_id kannst du prüfen, ob ein Unternehmen derzeit mit MBE verbunden ist oder nicht. Für verbundene Unternehmen erhältst du Details zu den verbundenen Assets (beispielsweise Seite, Instagram, Katalog, Pixel usw.) sowie die Liste der MBE-Features, die durch die Verbindung aktiviert wurden.

Nächste Schritte