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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 |