Ein praxisnaher Leitfaden zur Shopify-PIM-Verbindung — API-Sync, Metafelder, Feldmappings und die genauen Schritte, um mit Productbay live zu gehen.
Shopify ist die weltweit meistgenutzte E-Commerce-Plattform — aber sie wurde nie als Produktinformations-Management-System konzipiert. Sobald Ihr Katalog über ein paar Hundert SKUs wächst, stoßen Sie an eine Wand: keine Bulk-Anreicherung, kein strukturiertes Attributmanagement, keine Lieferantenimport-Pipeline, keine Multi-Channel-Distributionslogik. Am Ende kopieren Sie Daten manuell zwischen Tabellen, Lieferantenportalen und Ihrem Shopify-Admin.
Ein PIM, das mit Shopify verbunden ist, löst dieses Problem. Das PIM wird zur Single Source of Truth für alle Produktdaten. Shopify wird zum Publishing-Endpunkt. Diese Anleitung erklärt Schritt für Schritt, wie die Verbindung technisch funktioniert, welche Daten zwischen beiden Systemen fließen und wie Sie mit Productbay live gehen.
Shopifys Produkt-Admin ist gut gestaltet für einfache Kataloge. Sobald Sie skalieren, treffen Sie auf vier strukturelle Lücken:
Ein PIM schließt alle vier Lücken. Es sitzt vor Shopify, verwaltet den gesamten Daten-Lifecycle und spielt kanalfähige Daten automatisch in Ihren Shop.
Moderne PIM-Shopify-Integrationen nutzen Shopifys Admin REST API und GraphQL API, um Produktdaten programmgesteuert zu lesen und zu schreiben. Die wichtigsten Konzepte:
Shopify unterstützt sowohl REST als auch GraphQL. Moderne Integrationen — einschließlich Productbay — bevorzugen GraphQL für Produktoperationen: effizienter, präzisere Feldauswahl, und für MetaObjects sowie komplexe Metafeld-Strukturen zwingend erforderlich. REST wird noch für einige Legacy-Endpunkte genutzt.
Webhooks ermöglichen es Shopify, Ihr PIM in Echtzeit zu benachrichtigen, wenn sich etwas ändert — ein Produkt wird aktualisiert, eine Variante wird ausverkauft, eine Kollektion ändert sich. Das ist die Grundlage des bidirektionalen Syncs: Statt die API ständig zu pollen, hört das PIM auf Events und reagiert nur bei Bedarf.
Unidirektionaler Sync bedeutet, dass Daten nur in eine Richtung fließen: vom PIM zu Shopify. Das PIM ist der Master. Alles, was Sie in Shopify ändern, wird beim nächsten Sync überschrieben. Funktioniert gut, wenn das gesamte Produktmanagement im PIM stattfindet.
Bidirektionaler Sync bedeutet, dass Änderungen in Shopify auch ins PIM zurückfließen. Nützlich für Lagerbestände, Preise, die Ihr Merchandising-Team direkt in Shopify pflegt, oder kundengenerierte Inhalte. Bidirektionaler Sync erfordert klare Konfliktlösungsregeln — wenn beide Systeme dasselbe Feld ändern, welches gewinnt?
Echtzeit-Sync überträgt Änderungen sofort — nützlich für Preisänderungen oder Lagerbestandsaktualisierungen. Zeitgesteuerter Sync läuft in einem definierten Intervall (z. B. stündlich oder nächtlich) — besser für Bulk-Katalogaktualisierungen, bei denen sofortige Propagierung weniger kritisch ist. Productbay unterstützt beide Modi pro Feldgruppe.
Eine gut konfigurierte PIM-Shopify-Integration verwaltet folgende Datenobjekte:
| Datenobjekt | Shopify-Ressource | Details |
|---|---|---|
| Produkte | Product | Titel, Body-HTML, Vendor, Produkttyp, Tags, Status |
| Varianten | ProductVariant | SKU, Preis, Vergleichspreis, Gewicht, Barcode, Optionswerte |
| Bilder | ProductImage | Position, Alt-Text, zugeordnete Variante |
| Metafelder | Metafield | Namespace, Key, Typ, Wert — auf Produkt-, Varianten- oder Kollektionsebene |
| MetaObjects | MetaObject | Strukturierte Datentypen (z. B. Größentabellen, Materialspezifikationen) |
| Kollektionen | Collection | Manuelle Kollektionszugehörigkeit und Smart-Collection-Regeln |
| Lagerbestand | InventoryLevel | Lagerbestände je Standort (werden ins PIM zurückgelesen) |
Die folgenden Schritte gelten für ein frisches Productbay-Setup. Bei einer Katalogmigration ist der Prozess identisch — Productbay importiert zunächst Ihre bestehenden Shopify-Daten, sodass nichts verloren geht.
Productbay verbindet sich mit Shopify über eine Private App oder den Shopify-App-Store. Navigieren Sie in Ihrem Productbay-Dashboard zu Kanäle → Kanal hinzufügen → Shopify und folgen Sie dem Installationsflow. Productbay fordert die minimal nötigen API-Berechtigungen an: Produkte lesen/schreiben, Metafelder lesen/schreiben, Lagerbestand lesen.
Shopifys OAuth-Flow leitet Sie zu Ihrem Shopify-Admin weiter, um die Verbindung zu genehmigen. Nach Zustimmung erhält Productbay ein dauerhaftes Access-Token mit Store-Scope. Es werden keine Zugangsdaten gespeichert — nur das Token. Für Multi-Shop-Setups wiederholen Sie diesen Schritt für jeden Shop.
Feldmappings definieren, wie Productbay-Attribute auf Shopify-Felder gemappt werden. Beispiel: Ihr PIM-Attribut kurzbeschreibung mappt auf Shopifys body_html. Ihr Attribut materialzusammensetzung mappt auf ein Metafeld mit Namespace custom und Key material.
Productbays Mapping-UI zeigt alle verfügbaren Shopify-Felder — einschließlich aller bereits in Ihrem Store vorhandenen Metafelddefinitionen — und lässt Sie PIM-Attribute per Drag-and-drop darauf legen. Sie können Transformationsregeln setzen: Einheitenkonvertierung, Textkürzen, Konditionslogik.
Vor dem ersten Outbound-Sync bietet Productbay einen Import-Durchlauf: Es zieht alle bestehenden Shopify-Produkte ins PIM und bewahrt die vorhandenen Daten. Nach der Prüfung triggern Sie den ersten Sync von PIM zu Shopify. Productbay zeigt eine Diff-Ansicht — welche Felder neu angelegt, aktualisiert oder unverändert gelassen werden — bevor der Commit erfolgt.
Nach dem ersten Sync validieren Sie im Shopify-Admin: Prüfen Sie fünf bis zehn Produkte aus verschiedenen Kategorien. Kontrollieren Sie, ob Metafelder befüllt sind, Bilder in der richtigen Reihenfolge sind und Variantenoptionen stimmen. Productbays Sync-Log zeigt den Status jeder Push-Operation — inklusive feldbezogener Fehler — damit Sie ohne Rätselraten debuggen können.
Shopifys native Produktfelder decken die Basics ab. Metafelder sind der Ort, an dem das eigentliche Potenzial liegt — und ein PIM ist der einzig praktikable Weg, sie im großen Maßstab zu managen.
Was Metafelder sind: strukturierte Schlüssel-Wert-Paare, die an jede Shopify-Ressource angehängt werden können (Produkt, Variante, Kollektion, Kunde). Anders als die Produktbeschreibung, die ein einzelner HTML-Block ist, sind Metafelder typisiert — sie können Integer, Dezimalzahlen, Booleans, JSON, Dateireferenzen oder Rich Text enthalten.
Warum Metafelder wichtig sind:Shopify-Themes und Hydrogen-Storefronts können Metafelder direkt in Produktseiten rendern — Größentabellen, technische Spezifikationen, Nachhaltigkeitsdaten, Kompatibilitätstabellen. Apps wie Shopify Search & Discovery nutzen Metafelder für facettiertes Filtern. Ohne Metafelder sind Ihre Produktseiten generisch.
Von Shopify unterstützte Metafeld-Typen (via PIM verwaltbar):
single_line_text_field — kurze Labels, Codes, Identifikatorenmulti_line_text_field — längere strukturierte Texterich_text_field — formatierte HTML-Blöckeinteger, decimal — numerische Spezifikationenboolean — Ja/Nein-Attributejson — komplexe verschachtelte Attributobjektefile_reference — verknüpfte Medien-Assetslist.*-Varianten — Mehrfachwerte (z. B. Materialliste)MetaObjects sind Shopifys strukturierter Datentyp — vergleichbar mit wiederverwendbaren Datenschemata. Ein Größentabellen-MetaObject hat Felder für Brustumfang, Taille und Hüfte — verknüpft mit mehreren Produkten. Ein Lieferanten-MetaObject speichert Name, Herkunftsland und Zertifikate. PIM-Systeme können MetaObjects via GraphQL API anlegen, aktualisieren und verknüpfen, was die Verwaltung komplexer strukturierter Daten im großen Maßstab ermöglicht.
Die meisten PIM-Shopify-Integrationsprobleme entstehen durch eine Handvoll wiederkehrender Fehler:
integer-Feld zu pushen schlägt lautlos fehl. Prüfen Sie Ihre Metafelddefinitionen im Shopify-Admin, bevor Sie Mappings konfigurieren.Sehen Sie in einer 30-minütigen Demo, wie Productbay Ihren gesamten Produktkatalog mit Shopify synchronisiert — inklusive Metafelder, Bilder und Varianten.
Jetzt starten