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 beschreibt das Erstellen einer App im Shopify Developer Dashboard, die Anpassung von Produktdaten und das Synchronisieren von Abonnenteninformationen.

Synchronisierung 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 die Synchronisierung einrichtet, benötigt Zugriff auf das Developer Dashboard und Berechtigungen zum Entwickeln von Apps im Shopify Store.

Zugriffsvoraussetzungen: Nur Shop-Besitzer oder Mitarbeiter mit Administratorrechten können die App erstellen (nicht über kolaborativen Zugriff). Wenn Sie die Einrichtung für einen Kunden durchführen, 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 diese Option nicht angezeigt wird, 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 eingeloggt haben.

  5. Im Developer Dashboard klicken Sie auf Create App.

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

  7. Fügen Sie in App URL den Standard-Platzhalter von Shopify ein: 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 bei Webhooks API Version die neueste Version (mindestens 2025-07).

Berechtigungen 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, anschließend 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 Store aus der Liste aus.

  3. Überprüfen Sie auf der nächsten Seite die Zusammenfassung der App-Details und klicken Sie rechts unten auf Install.

Verbindung zu Clerk herstellen #

  1. Gehen Sie zurück ins Developer Dashboard und klicken Sie im Clerk.io-App-Bereich auf Settings. Hier 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 anschließend auf Start Sync.

Bekanntes Problem: Shopify kann beim ersten Synchronisieren möglicherweise keinen 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 dann, erneut zu synchronisieren.

Märkte und Bestände #

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

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

Diese Werte sollten mit Ihrer Shopify Markt-/Domain-Konfiguration übereinstimmen. Für eine vollständige Feld-zu-Feld-Zuordnung siehe Shopify integration settings.

Variantendaten #

Shopify-Variantendaten können sich unterschiedlich verhalten, abhängig von der Einstellung Import only stock variant data.

Typische Shopify-Varianten-Attribute in Clerk.io umfassen:

  • variant_inventory_policy (string list)
  • variant_inventory_tracking (boolean list)
  • variant_list_prices (number list)
  • variant_names (string list)
  • variant_option_size (string list)
  • variant_prices (number list)
  • variant_stocks (number list)
  • variant_weight (number list)
  • variant_weight_unit (string list)
  • variants (string list, variant 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 Import only stock variant data aktiviert ist, beinhalten diese Listen nur Varianten, die auf Lager sind.

Produktdaten anpassen #

In Shopify können Meta-Felder und andere von Ihnen erstellte 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 meist komplett kleingeschrieben. Zum Beispiel sollte das Attribut “Sizes” als “sizes” geschrieben werden.

Sie müssen den namespace nicht einbeziehen – Clerk findet diesen automatisch anhand des key.

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

Custom data

Abonnenten synchronisieren #

Shopify ermöglicht die Verwaltung von Abonnenten direkt auf der Plattform.

Diese können problemlos mit Clerk synchronisiert werden.

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

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

Gehen Sie dazu einfach in Ihren my.clerk.io Store, anschließend Data -> Configuration und setzen Sie Include Subscriber State auf Yes. Klicken Sie dann auf Save und starten Sie eine neue Synchronisierung.

Subscriber state configuration

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

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

Legacy Custom App #

Ab Januar 2026 erlaubt Shopify nicht mehr die Erstellung von Custom Apps direkt im Shopify-Admin für Stores. Bestehende Custom Apps funktionieren weiterhin, aber diese Methode sollte nur genutzt werden, wenn Sie bereits eine Custom App eingerichtet haben. Für alle anderen Setups nutzen Sie die oben beschriebene Developer Dashboard Methode.

Wenn Sie eine bestehende Custom App haben und diese verwenden oder anpassen 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-Store weiterhin die Erstellung von Custom Apps im Shopify-Admin erlaubt.

  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 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 (Scopes mit read_) für die folgenden Bereiche. Bei Customers setzen Sie ihn auf Lesen und Schreiben (inklusive write_customers), da Shopify diesen benötigt, um auf Kunden-Marketing-URL-Felder zuzugreifen (z.B. für customer.unsub_url).

    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_)
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 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 eine Standardbildgröße, falls Sie dazu aufgefordert werden, 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.