Migrationsleitfaden: Instagram (IX) zu Meta Business Extension v2

Als eine*r unserer Partner*innen für Instagram-Action-Buttons auf Basis der Instant Experiences-(IX-)Integration solltest du die folgenden Anforderungen der Meta Business Extension (MBE) v2 erfüllen, damit du deine Call-to-Action-Buttons Essen bestellen und die Stories-Sticker-Funktionalität für Essensbestellungen weiter nutzen kannst:

1. Authentifizierungs-URL: Um das Onboarding deines Unternehmens bei MBE von Facebook oder Instagram zu ermöglichen.
2. Webhook: Um sofortige Benachrichtigungen zu erhalten, wenn eines deiner Unternehmen MBE installiert oder deinstalliert.
3. Pixel-Events auslösen: Damit deine Unternehmen neue Kundschaft besser ansprechen, die Anzahl der Transaktionen auf deinen Websites erhöhen und direkt messen können, inwieweit die MBE-Integration zur Verbesserung der Ergebnisse beiträgt.

Nachdem du die MBE-Entwicklung und -Tests abgeschlossen hast, überprüft und bestätigt Meta deine Integration. Wenn sie genehmigt wurde, steht deine App öffentlichen Nutzer*innen zur Verfügung.

Bevor du beginnst

• Falls noch nicht geschehen, registriere dich als Meta-Entwickler*in, um auf unsere Entwicklungstools zuzugreifen und Meta-Apps zu erstellen.
• Erstelle eine Meta-App, sofern du noch keine erstellt hast.
• Erstelle eine Test-App aus deiner Live-/Produktions-App und führe damit alle neuen Entwicklungs- und Testaufgaben aus.
• Deine Apps (Live/Produktion und Test) müssen vom Typ Business-App sein und einem Business Manager gehören, der ein verifiziertes Unternehmen ist. Erfahre mehr darüber, wie du dein Unternehmen verifizierst und wie du dem Unternehmen Apps hinzufügst.
• Gib deine App-IDs an deinen Meta-Partner weiter, damit er dir Zugriff auf die MBE-Funktion manage_business_extension erteilen kann. Nach der Genehmigung kannst du mit der Implementierung beginnen.

Integration über das Developer Panel einrichten

Das Meta Business Extension Developer Panel ist ein Produkt in deinem Developer App Dashboard. Wenn deinen Apps die MBE-Funktion erteilt wurde, solltest du das Developer Panel verwenden, um die Integration einzurichten und zu validieren (einschließlich Authentifizierungs-URL und Webhook-Endpunkt).

Schritt 1: Füge das MBE Developer Panel zu deinen Facebook Developer Apps hinzu.

Schritt 2: Wähle auf dem Setup-Tab die Option Food and Drink als einzige Branche aus, wähle Instagram Call to Action Button und Page Surface Call To Action Button als Features aus und nimm alle Domains deiner App auf der Karte für Platzhalter-Domains aus.

Schritt 3: Gehe nach der Erstellung der Authentifizierungs-URL auf dem Setup-Tab zu „Business-Apps“, um die URL zu validieren (eventuelle Fehler werden dort angezeigt). Wenn das grüne Häkchen erscheint, kannst du zu Meta-Business-Apps gehen, um End-to-End-Tests durchzuführen.

Schritt 4: Erstelle den Webhook und richte ihn dann im Webhooks-Produkt ein. Wenn das Setup erfolgreich ist, wird ein grünes Häkchen auf dem Tab „Übersicht“ für das Element „Webhook validiert“ angezeigt.

Schritt 5: Nachdem du die erforderlichen Pixel-Events ausgelöst hast, fülle den Pixel-Fragebogen aus (einschließlich eines Videos zum Validieren deiner Pixel-Implementierung).

Schritt 6: Erleichtere unserem Team die Verifizierung und Genehmigung deiner Integration, indem du Details auf der Karte „Integration zur Überprüfung“ auf dem Tab „Integration zur Überprüfung“ angibst. Diese Angaben sollten die Anmeldeinformationen deiner Plattform enthalten, um sich bei deiner Authentifizierungs-URL anzumelden. Füge einen Screencast-Link hinzu, der das vollständige Onboarding-Erlebnis und deine aktivierten Features zeigt.

Schritt 7: Nachdem du die MBE-Implementierung abgeschlossen hast, durchlaufe die Checkliste im Tab „Übersicht“ im Developer Panel. Fülle die Formulare für App-Details und Überprüfung der Integration auf dem Tab „Integration zur Überprüfung“ aus. Durch Klicken auf den Button „Senden“ startest du die Überprüfung. Wenn deine Integration genehmigt wurde, kannst du den Launch deiner App über den Tab „Starten“ vornehmen, sodass sie öffentlichen Nutzer*innen zur Verfügung steht. Erfahre mehr über den Prozess der Integrationsüberprüfung und darüber, wie du Feedback und den aktuellen Status von unserem Team erhältst.

Authentifizierungs-URL erstellen

Die auf Meta-Oberflächen verfügbaren Business-Apps sind der Ort, an dem Unternehmen externe Business-Apps entdecken und sich mit ihnen verbinden können, um zu niedrigen Technikkosten Business-Tools einzurichten, die sie beim Wachstum und bei der Erreichung der Geschäftsziele unterstützen.

MBE v2 verwendet eine Authentifizierungs-URL als vertrauenswürdigen Kanal zum Teilen der Unternehmenskonfiguration der Nutzer*innen (Name, URL für den CTA usw.) zwischen deiner Plattform und Instagram/Facebook.

Deine Authentifizierungs-URL muss einen GET-Abfrageparameter redirect_uri akzeptieren. Dabei empfehlen wir dir Folgendes:

1. Lasse zu, dass deine Nutzer*innen sich bei deiner Plattform anmelden, und stelle auch eine Option zum Registrieren eines neuen Kontos auf der Plattform bereit.
2. Wenn du in deiner Plattform mehrere Unternehmen pro Konto unterstützt, zeige eine UI an, über die Nutzer*innen auswählen können, welches Unternehmen auf deiner Plattform mit ihrer Facebook-Präsenz verknüpft werden soll.
3. Rufe den erhaltenen redirect_uri-Abfrageparameter ab und hänge ihn als Abfrageparameter an das codierte extras-Objekt an.
4. Leite Nutzer*innen zur resultierenden URL um (nur, wenn die erhaltene redirect_uri unserem regulären Ausdruck entspricht).

Beispiel: Verwende das extras-Objekt, um ein Unternehmen zu konfigurieren und seinen Instagram-Profil-CTA und Facebook-Seiten-CTA zu aktivieren.

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

Alle Einzelheiten zur Implementierung und zum Testen findest du unter Business-Apps.

Webhook erstellen

Nachdem deine App über Business-Apps installiert, aktualisiert oder deinstalliert wurde, erhältst du die Details zur jeweiligen Handlung per Webhook.

Für die Einrichtung des Webhooks musst du folgendermaßen vorgehen:

1. Erstelle einen Endpunkt auf einem sicheren Server, der POST-Anfragen von Facebook verarbeiten kann.
2. Konfiguriere das Webhooks-Produkt im App-Dashboard deiner App, um das fbe_install-Feld des User-Objekts zu abonnieren.

Alle Einzelheiten zur Implementierung und Einrichtung findest du unter Webhook.

Pixel-Events auslösen

Meta-Pixel spielt eine wesentliche Rolle in der Meta Business Extension v2. Du musst die folgenden Standard-Pixel-Events korrekt für jedes MBE-integrierte Unternehmen auf deiner Plattform auslösen.

Erforderliche Events

• Für alle Seiten, die an der Essensbestellung beteiligt sind: Löse PageView aus.
• Nachdem die Bestellung aufgegeben wurde: Löse Purchase aus.

Optionale Events

• Löse AddToCart aus, wenn der Bestellung ein Artikel hinzugefügt wird.

Alle Standard-Events können ausgelöst werden, indem die fbq('track')-Funktion des Pixels mit dem Event-Namen und (optional) einem JSON-Objekt als Parameter aufgerufen wird. Das Kauf-Event erfordert beispielsweise Parameter für Währung und Wert:

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

Alle Einzelheiten zur Implementierung findest du unter Pixel-Events auslösen.

Hilfstool für Pixel

Wir empfehlen dringend, dass du unsere Chrome-Erweiterung mit dem Hilfstool für Pixel installierst. Das Hilfstool für Pixel liefert dir besonders nützliches Feedback, mit dem du sicherstellst, dass dein Pixel richtig funktioniert. Das bietet sich vor allem an, wenn du mit dem Tracken von Conversions beginnst, da hierbei oft Formatierungsfehler auftreten.

Überprüfung der Integration und Launch

Nachdem du die MBE-Implementierung abgeschlossen hast, durchlaufe die Checkliste im Tab „Übersicht“ im Developer Panel. Fülle die Formulare für App-Details und Überprüfung der Integration auf dem Tab „Integration zur Überprüfung“ aus. Durch Klicken auf den Button „Senden“ startest du die Überprüfung.

Bei der Integrationsüberprüfung verifiziert Meta deine Integration in Meta Business Extension. Wenn deine Integration genehmigt wurde, kannst du den Launch deiner App über den Tab „Starten“ vornehmen, sodass sie öffentlichen Nutzer*innen zur Verfügung steht. Erfahre mehr über diesen Prozess.

Nachdem du deine Integration im Developer Panel auf dem Tab „Integration zur Überprüfung“ übermittelt hast, kannst du den Status sowie Updates und Feedback von unseren Prüfer*innen auf der Karte „Integration zur Überprüfung“ im Abschnitt „Einreichungsverlauf“ anzeigen.

Unsere Prüfer*innen geben dir ausführliches Feedback. Sollte deine App abgelehnt werden, führe alle erforderlichen Schritte aus, bevor du einen neuen Überprüfungsprozess startest. Dazu klickst du auf dem Tab „Integration zur Überprüfung“ auf den Button „Erneut einreichen“.