Shopify

Sync Data

Erfahren Sie, wie Sie Daten aus Ihrem Shopify-Shop synchronisieren und anpassen können

Synchronisieren Sie Ihre Shopify-Produkte, Metafelder und Abonnenten mit Clerk. Diese Anleitung beschreibt das Erstellen einer App im Shopify Developer Dashboard, das Anpassen von Produktdaten und das Synchronisieren von Abonnenteninformationen.

Sync einrichten #

Um Ihre Shopify-Store-Daten mit Clerk zu synchronisieren, müssen Sie eine App im Shopify Developer Dashboard erstellen und diese in Clerk konfigurieren. Der Benutzer, der das Sync einrichtet, benötigt Zugriff auf das Developer Dashboard und die Berechtigungen, Apps im Shopify-Store zu entwickeln.

Zugangsvoraussetzungen: Nur Store-Inhaber oder Mitarbeiter mit Administratorberechtigung können die App erstellen (nicht über Kollaborationszugang). Wenn Sie es für einen Kunden einrichten, benötigen Sie Mitarbeiterzugang oder die Zugangsdaten der App vom Kunden.

Die App erstellen #

  1. Klicken Sie in Shopify auf Settings.

  2. Klicken Sie auf Apps and sales channels.

  3. Klicken Sie auf Develop apps.

  4. Klicken Sie auf Build apps in Dev Dashboard.

    • Falls Sie diese Option nicht sehen, klicken Sie stattdessen auf Learn more.
    • Im neuen Fenster klicken Sie auf Go to Dev Dashboard.
    • Alternativ können Sie das Dev Dashboard direkt öffnen, nachdem Sie sich angemeldet haben.

  5. Klicken Sie im Developer Dashboard auf Create App.

  6. Geben Sie Clerk.io als App-Namen ein.

  7. Fügen Sie in App URL die Standard-App-Placeholder von Shopify hinzu: https://shopify.dev/docs/apps/default-app-home

  8. Entfernen Sie unter Embed App in Shopify Admin das Häkchen. Die App muss nur einmal installiert werden und muss nicht im Shopify-Seitenmenü erscheinen.

  9. Wählen Sie in Webhooks API Version die neueste Version (mindestens 2025-07) aus.

Berechtigungen (Scopes) konfigurieren #

  1. Gewähren Sie unter Access scopes Zugriff auf die unten aufgelisteten Scopes. Sie können die folgende Zeichenkette direkt in das Eingabefeld einfügen, um alle Scopes auf einmal hinzuzufügen:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations
    Warum benötigen wir Schreibzugriff? Clerk liest nur Daten, aber Shopify verlangt den Scope write_customers, um auf kundenbezogene Marketing-URL-Felder zugreifen zu können (z. B. um customer.unsub_url zu synchronisieren).

    Oder wählen Sie sie einzeln aus:

    • Customers (read_ und write_)
    • Inventory (read_)
    • Locales (read_)
    • Locations (read_)
    • Markets (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Publications (read_)
    • Store Content (read_)
    • Translations (read_)

  2. Klicken Sie unten auf dem Bildschirm auf Release.

Die App installieren #

  1. Klicken Sie auf Home, dann oben rechts auf Install app.

  2. Shopify leitet Sie auf eine Seite weiter, auf der Sie den Shopify-Store auswählen, in dem Sie die App installieren möchten. Wählen Sie Ihren Store in der Liste aus.

  3. Überprüfen Sie auf der folgenden Seite die Zusammenfassung der App-Informationen und klicken Sie unten rechts auf Install.

Mit Clerk verbinden #

  1. Gehen Sie zurück zum Developer Dashboard und klicken Sie innerhalb der Clerk.io-App auf Settings. Hier finden Sie die Client ID und Client Secret.

  2. Gehen Sie zu my.clerk.io > Data > Configuration. Wählen Sie unter Sync Method Shopify aus.

  3. Fügen Sie die Client ID und die Client Secret in das Formular ein. Klicken Sie anschließend auf Start Sync.

Bekanntes Problem: Shopify kann beim ersten Sync möglicherweise kein Token generieren, was zu einem Authentifizierungsfehler führt. Dies ist ein bekanntes, gelegentlich auftretendes Problem bei Shopify. Warten Sie einfach 1–2 Minuten und versuchen Sie es dann erneut.

Märkte und Lagerbestand #

Wenn Sie mehrere Shopify-Märkte, -Locales oder Lagerorte betreiben, prüfen Sie diese Felder vor dem Sync:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Inventory locations

Diese Werte sollten mit Ihrer Shopify-Markt-/Domainkonfiguration übereinstimmen. Eine komplette Zuordnung Feld für Feld finden Sie unter Shopify integration settings.

Variantendaten #

Shopify-Variantendaten können sich je nach Einstellung Nur Lager-Varianten importieren unterschiedlich verhalten.

Typische Shopify-Variantenattribute in Clerk.io umfassen:

  • variant_inventory_policy (String-Liste)
  • variant_inventory_tracking (Boolean-Liste)
  • variant_list_prices (Zahlen-Liste)
  • variant_names (String-Liste)
  • variant_option_size (String-Liste)
  • variant_prices (Zahlen-Liste)
  • variant_stocks (Zahlen-Liste)
  • variant_weight (Zahlen-Liste)
  • variant_weight_unit (String-Liste)
  • variants (String-Liste, Varianten-IDs)

Beispiel:

{
  "variant_inventory_policy": ["deny", "deny"],
  "variant_inventory_tracking": [true, true],
  "variant_list_prices": [240, 240],
  "variant_names": ["Xs", "M"],
  "variant_option_size": ["Xs", "M"],
  "variant_prices": [120, 120],
  "variant_stocks": [1, 7],
  "variant_weight": [0.4, 0.4],
  "variant_weight_unit": ["KILOGRAMS", "KILOGRAMS"],
  "variants": ["55970989179259", "55970989244795"]
}

Wenn Nur Lager-Varianten importieren aktiviert ist, enthalten diese Listen nur Varianten mit Lagerbestand.

Produktdaten anpassen #

In Shopify können von Ihnen erstellte Metafelder und andere Attribute über my.clerk.io > System status > Data sync synchronisiert werden.

Gehen Sie einfach zum Eingabefeld Custom Attributes und geben Sie die Produktattribute ein, die Sie einbeziehen möchten.

Um mehrere Attribute hinzuzufügen, trennen Sie diese durch Kommas.

Add attributes

Attribute sollten immer mit ihrem key geschrieben werden.

Dieser ist in der Regel komplett kleingeschrieben. Zum Beispiel sollte das Attribut “Sizes” als “sizes” geschrieben werden.

Sie müssen den namespace nicht angeben – Clerk findet ihn automatisch anhand des key.

In Shopify finden Sie diese Schlüssel oft, indem Sie in Settings > Custom data > Products/Variants nach Ihrem Attribut suchen:

Custom data

Abonnenten synchronisieren #

Shopify unterstützt die Verwaltung von Abonnenten direkt in der Plattform.

Diese können einfach mit Clerk synchronisiert werden.

Wenn aktiviert, importieren wir das Attribut “subscribed: true” für jede E-Mail-Adresse, die in Shopify abonniert ist.

Dies kann dann für Auto-Email genutzt werden.

Gehen Sie einfach zu Ihrem my.clerk.io Store, dann Data -> Configuration und setzen Sie Include Subscriber State auf Yes. Klicken Sie anschließend auf Save und starten Sie einen neuen Sync.

Subscriber state configuration

Wenn Sie einen Abmeldelink für Kunden nutzen möchten, hat jeder Kunde, der aus einem Shopify-Backend gezogen wird, ein unsub_url-Attribut, das für Auto-Email-Designs im Abmelde-Feld genutzt werden kann: {{customer.unsub_url}}

Die Webhooks API-Version muss mindestens auf 2022-04 gesetzt sein, ab der diese Unterstützung hinzugefügt wurde. Sie können dies in der von Ihnen für Clerk erstellten App im Developer Dashboard unter Settings überprüfen.

Legacy Custom App #

Ab Januar 2026 erlaubt Shopify nicht mehr, benutzerdefinierte Apps direkt im Shopify-Admin für Stores zu erstellen. Bestehende eigene Apps funktionieren weiterhin, aber diese Methode sollte nur verwendet werden, wenn bereits eine eigene App eingerichtet ist. Für alle anderen Setups verwenden Sie die oben beschriebene Developer Dashboard-Methode.

Wenn Sie eine bestehende eigene App haben und diese nutzen oder ändern müssen, wählen Sie Shopify (Legacy Custom App) als Sync Method in my.clerk.io > Data > Configuration aus.

Diese Schritte gelten nur, wenn Ihr Shopify-Store noch Zugriff zum Erstellen benutzerdefinierter Apps im Shopify-Admin hat.

  1. Gehen Sie in Shopify zu Apps > App and sales channel settings und klicken Sie auf Develop apps.
Develop apps page

  1. Klicken Sie auf Create app, benennen Sie sie “Clerk.io”, wählen Sie den App-Entwickler und klicken Sie dann erneut auf Create app.

  2. Klicken Sie auf Configuration → Admin API integration → Configure.

Permissions configuration

  1. Gewähren Sie unter Admin API access scopes Leserechte (Scopes, die mit read_ beginnen) für die folgenden Bereiche. Bei Customers stellen Sie bitte Lese- und Schreibrechte ein (einschließlich write_customers).

    Warum benötigen wir Schreibzugriff? Clerk liest nur Daten, aber Shopify verlangt den Scope write_customers, um auf kundenbezogene Marketing-URL-Felder zugreifen zu können (z. B. um customer.unsub_url zu synchronisieren).

    Sie können die folgende Zeichenkette direkt in das Eingabefeld einfügen, um alle Scopes auf einmal hinzuzufügen:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations

    Oder wählen Sie sie einzeln aus:

    • Customers (read_ und write_)
    • Inventory (read_)
    • Locales (read_)
    • Locations (read_)
    • Markets (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Publications (read_)
    • Store Content (read_)
    • Translations (read_)
API access scopes

  1. Klicken Sie auf Save, dann auf Install App → Install.

  2. Öffnen Sie API Credentials und kopieren Sie Ihre Shopify-Domain sowie den API-Schlüssel, Access Token und Secret Key der App.

API credentials

  1. Gehen Sie zu my.clerk.io > Data > Configuration. Wählen Sie unter Sync Method Shopify (Legacy Custom App) aus.

  2. Fügen Sie diese Werte in das Formular ein. Wählen Sie ggf. eine Standardbildgröße und klicken Sie dann auf Start Sync.

Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.