Shopify

Sync Data

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

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

Sync einrichten #

Um die Daten Ihres Shopify-Shops mit Clerk zu synchronisieren, müssen Sie eine App im Shopify Developer Dashboard erstellen und diese in Clerk konfigurieren. Der Benutzer, der die Synchronisierung einrichtet, muss Zugriff auf das Developer Dashboard und Berechtigungen zur App-Entwicklung im Shopify-Shop haben.

Zugriffsvoraussetzungen: Nur Shop-Besitzer oder Mitarbeiter mit Administratorrechten können die App erstellen (nicht über Kollaborationszugang). Wenn Sie die Einrichtung für einen Kunden vornehmen, benötigen Sie Mitarbeiterzugang oder die App-Zugangsdaten von diesem.

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, das sich öffnet, 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. Unter App URL fügen Sie den Standard-App-Platzhalter von Shopify hinzu: https://shopify.dev/docs/apps/default-app-home

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

  9. Bei Webhooks API Version wählen Sie die neueste Version (mindestens 2025-07).

Berechtigungen (Scopes) konfigurieren #

  1. Unter Access scopes gewähren Sie Zugriff auf die unten aufgeführten Scopes. Sie können die folgende Zeichenkette direkt ins 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 Sie wählen 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.

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, auf dem die App installiert werden soll. Wählen Sie Ihren Shop aus der Liste aus.

  3. Prüfen Sie auf der folgenden Seite die Zusammenfassung der App-Details und klicken Sie unten rechts auf Install.

Verbindung zu Clerk herstellen #

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

  2. Gehen Sie zu my.clerk.io > Data > Configuration. Unter Sync Method wählen Sie Shopify.

  3. Fügen Sie die Client ID und Client Secret in das Formular ein. Klicken Sie dann 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 in Shopify. Warten Sie einfach 1-2 Minuten und versuchen Sie die Synchronisierung erneut.

Märkte und Inventar #

Wenn Sie mehrere Shopify-Märkte, -Locales oder -Inventarstandorte betreiben, prüfen Sie vor der Synchronisierung diese Felder:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Inventarstandorte

Diese Werte sollten mit Ihrem Shopify-Markt-/Domain-Setup übereinstimmen. Eine vollständige Feld-für-Feld-Zuordnung finden Sie unter Shopify integration settings.

Variantendaten #

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

Typische Shopify-Variantenattribute in Clerk.io sind:

  • variant_inventory_policy (Aufzählung String)
  • variant_inventory_tracking (Aufzählung Boolean)
  • variant_list_prices (Aufzählung Zahl)
  • variant_names (Aufzählung String)
  • variant_option_size (Aufzählung String)
  • variant_prices (Aufzählung Zahl)
  • variant_stocks (Aufzählung Zahl)
  • variant_weight (Aufzählung Zahl)
  • variant_weight_unit (Aufzählung String)
  • variants (Aufzählung String, 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 Lagerbestand-Variantendaten importieren aktiviert ist, enthalten diese Listen nur Varianten, die auf Lager sind.

Produktdaten anpassen #

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

Gehen Sie einfach zum Eingabefeld Custom Attributes und geben Sie die Produktattribute ein, die übernommen werden sollen.

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

Add attributes

Attribute sollten immer mit ihrem key geschrieben werden.

Dies ist in der Regel alles kleingeschrieben. Zum Beispiel sollte das Attribut “Sizes” als “sizes” angegeben werden.

Sie müssen den namespace nicht angeben – Clerk findet diesen automatisch basierend auf dem key.

In Shopify finden Sie diese Keys oft, indem Sie Ihr Attribut hier suchen: Settings > Custom data > Products/Variants:

Custom data

Abonnenten synchronisieren #

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

Diese lassen sich einfach mit Clerk synchronisieren.

Wenn aktiviert, wird für jede in Shopify angemeldete E-Mail-Adresse das Attribut “subscribed: true” importiert.

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 eine neue Synchronisierung.

Subscriber state configuration

Wenn Sie einen Abmelde-Link für Kunden nutzen möchten, hat jeder Kunde, der von einem Shopify-Backend abgerufen wird, ein unsub_url-Attribut, das für Auto-Email-Designs im Abmeldefeld verwendet werden kann: {{customer.unsub_url}}

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

Legacy Custom App #

Ab Januar 2026 erlaubt Shopify das Erstellen von benutzerdefinierten Apps direkt im Shopify-Admin für Shops nicht mehr. Bestehende benutzerdefinierte Apps funktionieren weiterhin, aber diese Methode sollte nur verwendet werden, wenn Sie bereits eine Custom App eingerichtet haben. Für alle anderen Setups nutzen Sie die oben genannte Methode über das Developer Dashboard.

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

Diese Schritte gelten nur, wenn Ihr Shopify-Shop weiterhin Zugriff auf das Erstellen von Custom 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 aus und klicken Sie erneut auf Create app.

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

Permissions configuration

  1. Unter Admin API access scopes gewähren Sie Lesezugriff (Berechtigungen, die mit read_ beginnen) auf folgende Bereiche. Für Customers stellen Sie auf Lesen und Schreiben (inkl. write_customers), da Shopify dies erfordert, um auf Kunden-Marketing-URL-Felder zugreifen zu können (z.B. für customer.unsub_url).

    Sie können diese Zeichenkette direkt ins 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 Sie wählen 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 Install App → Install.

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

API credentials

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

  2. Fügen Sie diese Werte in das Formular ein. Wählen Sie falls erforderlich 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.