Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.
Englisch aktualisiert: 30.11.2022

Übersicht

Wir empfehlen dir, diesen Leitfaden vollständig zu lesen und so viele Elemente unserer Commerce APIs wie möglich zu integrieren. Im Idealfall solltest du alle Elemente integrieren, die für deinen Anwendungsfall relevant sind.

Umfang der Entwicklungsrolle

Als Entwickler*in gehörst du wahrscheinlich einer dieser Kategorien an:

  • Verkäufer: Du gehörst einem E-Commerce-Unternehmen an, das über eigene, spezielle technische Voraussetzungen verfügt, und möchtest eine Integration mit den Commerce APIs von Meta vornehmen, um einen einzigen (oder einige wenige) Shop(s) mit den Technologien von Meta auszustatten.

  • Tech-Anbieter/Partner: Du gehörst einem Unternehmen für E-Commerce-Plattformen an oder einem Unternehmen, das bestehenden E-Commerce-Kunden Software-Dienste anbietet, jedoch nicht über einen eigenen Shop verfügt (zusammenfassend als Handels-Tech-Anbieter oder Partner bezeichnet), und möchtest im Namen der verschiedenen Shops, die deine Plattform unterstützt, eine Integration mit den Commerce APIs von Meta vornehmen.

Für beide Kategorien hat die Qualität deiner Integration einen enormen Einfluss auf die Interaktionen deiner Kund*innen mit Produkten und Shops, die über unsere Commerce APIs verwaltet werden. Dieser Leitfaden dient im Speziellen der Unterstützung von Partnerentwickler*innen, die:

  • eine Integration mit unseren Commerce APIs vornehmen möchten.

  • eine Übersicht aller Elemente erhalten möchten, die beim Erstellen einer hochwertigen Integration mit den Commerce APIs von Meta maßgeblich sind, um das „Gesamtbild“ zu erfassen.

  • erfahren möchten, wie die Integration zu positiven Geschäftsergebnissen führen kann, z. B. neue Kund*innen erreichen, mehr Verkäufe abschließen und die Anzeigen von Meta erfolgreich nutzen, um diese Ergebnisse zu fördern.

Abwägungen im Zusammenhang mit der Käufer*innenrolle

Käufer*innen haben hohe Ansprüche, wenn es um Kaufentscheidungen geht. Sie informieren sich eingehend über Produkte, die sie möglicherweise kaufen möchten. Sie suchen nach einem guten Angebot und erwarten, dass sie in einem Shop dieselben Rabatte und Promotions erhalten wie auf der eigenen Website des Verkäufers. Sie möchten zeitnah über Neuigkeiten zu ihren Bestellungen informiert werden und genaue Informationen zu Versand, Tracking und Rückgabe erhalten.

Das Bereitstellen all dieser Elemente für Meta trägt entscheidend zur Verbesserung der Conversion Rate von Käufer*innen in Shops bei.

Allgemeiner Ablauf für Entwickler*innen

Meta ermöglicht externen Entwickler*innen das Erstellen von Systemen, die über eine Reihe von Commerce API-Endpunkten, die Teil der Graph API sind, mit unseren Instagram- und Facebook-Plattformen integriert werden können. Hier wird der allgemeine Ablauf für Entwickler*innen beschrieben sowie die Komponenten, die bei der Erstellung einer hochwertigen Integration der Commerce API entscheidend sind.

Voraussetzungen

  • Du musst ein Unternehmen bei Meta einrichten und verifizieren.

  • Erforderliche Handelsverträge müssen unterzeichnet sein, darunter der Zusatz für Technologieanbieter und die ergänzenden Nutzungsbedingungen.

  • Du musst mit den Grundsätzen der Graph API vertraut sein, die als Hauptquelle für das Lesen und Schreiben von Daten aus der bzw. in die Commerce-Plattform von Meta dient.

Schritt 1: Entwicklungsapp erstellen

Um Anfragen an diese Graph API-Endpunkte senden zu können, musst du zunächst im Portal Meta for Developerseine App erstellen. In diesem Zusammenhang stellt eine App eine Sammlung von Funktionen dar, für die deiner Drittanbieter-Software Zugriff auf die Systeme von Meta gewährt wird. Jeder API-Aufruf, den du in den Systemen von Meta durchführst, wird mit dieser App verknüpft. Deine Funktionen bestimmen, auf welche API-Aufrufe deine Software Zugriff hat. Diese App ist mit deinem Unternehmen auf Meta verknüpft. Das Datenmodell von Meta ist so konzipiert, dass alle von dir erstellten Assets zum Betreiben deines Unternehmens auf Meta diesem Unternehmensobjekt gehören. Dieses Unternehmensobjekt, dem deine App gehört, kann auch Inhaber deiner Facebook-Seite, deines Instagram-Kontos, deines Werbekontos und deines Produktkatalogs sein.

Schritt 2: Zugriffsschlüssel erstellen (anhand eines Testkontos)

Im Rahmen des vorangestellten Genehmigungsprozesses für deine App musst du beim Durchführen von API-Aufrufen bei jedem Aufruf einen Zugriffsschlüssel bereitstellen. Mit diesem Zugriffsschlüssel kann deine App im Namen eines*einer Nutzer*in auf die Plattformen von Meta zugreifen. Zugriffsschlüssel sind das Äquivalent zu digitalen Schlüsseln, die dafür sorgen, dass Nutzer*innen bei Facebook angemeldet bleiben, sodass sie ihr Passwort nicht jedes Mal erneut eingeben müssen, wenn deine Drittanbieter-Software im Namen eines*einer Nutzer*in auf die Plattformen von Meta zugreifen muss.

Wenn du als Entwickler*in eines Partners eine Commerce-Integration erstellen möchtest, in der du mehrere Shops verwaltest, musst du mehrere Zugriffsschlüssel speichern – einen für jeden Shop, den du unterstützt und der auf Facebook- und Instagram-Kanälen verkauft.

Um zu beginnen, erstelle ein Test-Commerce-Konto, mit dem du die Assets verknüpfst, und generiere einen zugehörigen Zugriffsschlüssel, den du für die Entwicklung der Integration mit der Commerce API verwendest.

Die Verwendung eines Zugriffsschlüssels, der durch einen Systemnutzer gesichert ist, wird für den Zugriff auf die Commerce API empfohlen, da Zugriffsschlüssel, die von regulären Nutzer*innen abgerufen werden, nach einer bestimmten Zeit oder wenn diese*r Nutzer*in das Passwort für Facebook ändert, ihre Gültigkeit verlieren können. Mit Systemnutzern sind Server oder Softwareelemente gemeint, die API-Aufrufe an Assets senden, die einem Business Manager gehören oder von ihm verwaltet werden. Eine Schritt-für-Schritt-Anleitung findest du unter Einrichtung der API-Integration.

Schritt 3: Integrationen der Commerce API erstellen (anhand eines Testkontos)

Beginne mit der Integration der APIs für Katalog, Bestellungsverwaltung und Promotions (Angebote) und verwende dabei das Test-Commerce-Konto, das du in Schritt 2 erstellt hast. Nimm eine Integration mit den Katalog-APIs vor, um einen hochwertigen, aktuellen Katalog einzurichten und zu unterhalten, der die Kauferfahrung unterstützt und Kaufentscheidungen beeinflusst. Nimm eine Integration mit den APIs für die Bestellungsverwaltung vor, um den Lebenszyklus von Bestellungen, die Käufer*innen auf Facebook und Instagram aufgegeben haben, zu verwalten. Nimm eine Integration mit den APIs für Angebote vor, um verschiedene Angebotstypen zu synchronisieren und Käufe und Rückerstattungen mit Angeboten zu bearbeiten.

Erfahre, wie du die Integration dieser APIs vornimmst, um das Qualitätsniveau unserer Shops zu erreichen.

Schritt 4: App zum App Review einreichen

Der App Review ist ein integraler Teil des Prozesses der App-Entwicklung. Du initiierst einen App Review, indem du einzelne Berechtigungen anforderst und beschreibst, wie die angeforderte Berechtigung von deiner App verwendet wird, um die von dir unterstützten Unternehmen zu fördern. Anhand dieses Prozesses können wir sicherstellen, dass unsere Produkte und APIs von deiner App bestimmungsgemäß verwendet werden. Erfahre mehr über den App Review-Prozess.

Schritt 5: Vorgang für das Onboarding von Verkäufer*innen bei Meta Commerce implementieren

Implementiere die beste Möglichkeit für das Onboarding deiner Verkäufer*innen bei Meta Commerce. Am Ende dieses Vorgangs wird für jede*n von dir unterstützte*n Verkäufer*in ein Zugriffsschlüssel generiert, den du speicherst und verwendest, wenn du im Namen dieser*dieses Verkäufer*in API-Aufrufe durchführst.

Hier erhältst du detaillierte Anweisungen, wie du eine ideale Onboarding-Integration erstellst, die dem Qualitätsniveau unserer Shops entspricht.

Schritt 6: Integration der Commerce API optimieren (anhand eines Produktionskontos)

Optimiere deine Integration in Bezug auf den Umgang mit Grenzfällen und Fehlern. Stelle sicher, dass du die im Leitfaden zu Best Practices beschriebenen und empfohlenen Best Practices für Integrationen verstehst und anwendest. Teste deine Integration abschließend mit echten Bestellungen.

Qualitätsniveau der Integration

In der folgenden Tabelle sind die Aufgaben des*der Verkäufer*in (Jobs To Be Done, JTBDs) gruppiert nach verschiedenen Kategorien aufgelistet. Die Tabelle gibt außerdem an, ob diese speziell für Meta gelten oder auch auf andere Kanäle anwendbar sind, sowie die Anforderungen an das Qualitätsniveau der zugehörigen Commerce-Integration von Meta und mögliche Verbesserungen.

Kategorie Aufgaben des*der Verkäufer*in (Jobs To Be Done, JTBDs) Priorität Mehrere Kanäle/speziell bei Meta Qualitätsniveau: Mindestanforderung Qualitätsniveau: Verbesserungen

Onboarding und Verwalten von Shops

Onboarding bei Shops

0

Speziell bei Meta

Drittanbieter muss FBE verwenden

Anzeigen und Lösen von Problemen mit dem Shop (einschließlich BI-Problemen)

0

Einblicke und Empfehlungen für den Shop anzeigen

1

Speziell bei Meta

Nicht zutreffend

Erscheinungsbild des Shops anpassen

2

Speziell bei Meta

Nicht zutreffend

Käufer*innen bei Meta antworten/mit ihnen kommunizieren

0

Beide (viele Verkäufer*innen bevorzugen die Verwendung von Messenger/IGDM/WhatsApp, um Kund*innen zu antworten, während andere bei der Kommunikation mit Kund*innen auf Drittanbieter-Tools setzen)

Nicht zutreffend

Katalog verwalten

Produkte hinzufügen/entfernen/bearbeiten für einen umfassenden und aktuellen Katalog

0

Mehrere Kanäle

Der Drittanbieter muss den Produktkatalog mit Meta synchronisieren und Fehler behandeln. Er muss einen skalierbaren Synchronisierungsmechanismus für nicht flüchtige Felder verwenden (vollständige Katalogsynchronisierung alle 24 Stunden und Delta-Synchronisierung jede Stunde), Felder mit hoher Volatilität synchronisieren (Bestand und Preis) und Änderungen nahezu in Echtzeit vornehmen (mindestens alle 15 Minuten)

Der Drittanbieter sollte seine Produktpalette mit Meta synchronisieren

Spezielle Produktprobleme von Meta (z. B. BI-Kennzeichnung) anzeigen und beheben

0

Mehrere Kanäle (die eigentliche Problemlösung kann jedoch in einer Meta-Oberfläche erfolgen, z. B. BI-Einspruch)

Drittanbieter muss Untersuchungen mit eindeutigem Call-To-Action (CTA) für Verkäufer*innen bieten

Community Content (UGC) anzeigen und verwenden

1

Speziell bei Meta

Nicht zutreffend

Merchandise/Shop-Anzeigen schalten

Shop-Anzeigen schalten

0

Speziell bei Meta

Drittanbieter muss Verkäufer*innen einrichten und Anzeigensignal über Pixel zurücksenden

Drittanbieter sollte Verkäufer*innen einrichten und Anzeigensignal über CAPI zurücksenden

Performance und Analyse anzeigen (Anzeigen)

0

Mehrere Kanäle

Nicht zutreffend

Performance und Analyse anzeigen (organische Verkäufe)

1

Beide (es gibt zwar Tools, die Kennzahlen auf hoher Ebene aggregieren können, doch wir stellen heute tiefere organische Verkaufsmetriken über CM bereit)

Nicht zutreffend

Werbeaktionen durchführen (Angebote)

0

Mehrere Kanäle

Drittanbieter muss Bestellungen (Erfüllung, Stornierungen, Rückerstattungen) mit zugehörigen von Meta finanzierten Rabatten und den folgenden von dem*der Verkäufer*in finanzierten Standardrabatten bearbeiten: Rabatte, die einzelnen Artikeln in einer Bestellung zugewiesen werden, Rabatte, die Artikeln in einer Bestellung zugewiesen werden (möglicherweise mit Restbeständen), Rabatte für kostenlosen Versand, Rabatte nach dem Schema „Beim Kauf von X zusätzlich Y erhalten“

Wenn der Drittanbieter die Source of Truth für Rabatte ist: Drittanbieter muss Standardrabatte über die Offers API (derzeit ein geschütztes Feature) mit Meta synchronisieren. Andernfalls: Drittanbieter muss den Weiterleitungslink zum Commerce Manager für Verkäufer*innen anzeigen, um alle Standardrabatte mit Meta zu synchronisieren

Produkteinführungen auf Instagram durchführen

2

Speziell bei Meta

Nicht zutreffend

Live-Shopping-Events auf Instagram durchführen

2

Speziell bei Meta

Nicht zutreffend

Organische Beiträge mit Produktmarkierungen verfassen

2

Speziell bei Meta

Nicht zutreffend

Verwaltete Zahlungen

Verwalten von Zahlungsinformationen für den Onsite-Checkout

0

Speziell bei Meta

Drittanbieter muss FBE verwenden

Zahlungen erhalten/Rückerstattung von Zahlungen verarbeiten

0

Mehrere Kanäle

Drittanbieter sollte die von Meta erhaltenen Finanzberichte offenlegen

Zahlungen erhalten/Rückerstattung von Zahlungen verarbeiten

0

Mehrere Kanäle

Rückbuchungen verarbeiten

0

Beide

Steuerberichte erstellen und Verkäufe abgleichen

0

Mehrere Kanäle

Bestellungen verarbeiten und ausführen

Eingehende Bestellungen verwalten

0

Mehrere Kanäle

Drittanbieter muss von Meta in OMS empfangen und bestätigen

Bestellungen erledigen

0

Mehrere Kanäle

Drittanbieter muss Bestellstatus aus OMS mit Meta synchronisieren (Versand, Stornierung, Erstattung)

Von durch Käufer*in oder Verkäufer*in initiierten Rücksendungen und Rückerstattungen bearbeiten

0

Mehrere Kanäle

Drittanbieter muss Bestellstatus aus OMS mit Meta synchronisieren (Versand, Stornierung, Erstattung)

Drittanbieter sollte von Käufer*in initiierte Rücksendungen über Meta verarbeiten