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 Entwickler-Dashboard von Shopify, 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 Entwickler-Dashboard von Shopify erstellen und sie in Clerk konfigurieren. Der Benutzer, der die Sync einrichtet, muss Zugang zum Entwickler-Dashboard und Berechtigungen zum Entwickeln von Apps im Shopify-Store haben.

Zugriffsvoraussetzungen: Nur Store-Inhaber oder Mitarbeiter mit Administratorrechten können die App erstellen (nicht über Kollaborationszugriff). Derselbe Shopify-Benutzer muss die App erstellen und installieren.

Die App erstellen #

  1. Gehen Sie in Shopify zu Einstellungen > Apps > Apps entwickeln.

  2. Klicken Sie auf Apps im Entwickler-Dashboard erstellen.

    • Wenn Sie diese Option nicht sehen, klicken Sie stattdessen auf Weitere Informationen.
    • Im neu geöffneten Fenster klicken Sie auf Zum Developer-Dashboard.
    • Alternativ können Sie nach dem Einloggen das Developer-Dashboard direkt öffnen.

  3. Klicken Sie im Entwickler-Dashboard auf App erstellen.

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

  5. Fügen Sie unter App-URL den Standard-App-Platzhalter von Shopify hinzu: https://shopify.dev/docs/apps/default-app-home

  6. Entfernen Sie unter App im Shopify Admin einbetten das Häkchen. Die App muss nur einmal installiert werden und muss nicht im Shopify-Seitenmenü angezeigt werden.

  7. Wählen Sie unter Webhooks API Version die neueste Version (mindestens 2025-07).

Scopes konfigurieren #

  1. Unter Zugriffsumfänge gewähren Sie Zugang zu den unten aufgeführten Scopes. Sie können den folgenden String 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 zuzugreifen (z.B. für das Synchronisieren von customer.unsub_url).

    Alternativ können Sie sie einzeln auswählen:

    • Kunden (read_ und write_)
    • Inventar (read_)
    • Sprachversionen (read_)
    • Standorte (read_)
    • Märkte (read_)
    • Markets Home (read_)
    • Metaobjekte (read_)
    • Shopseiten (read_)
    • Bestellungen (read_)
    • Alle Bestellungen (read_)
    • Produkte (read_)
    • Publikationen (read_)
    • Store-Inhalte (read_)
    • Übersetzungen (read_)

  2. Klicken Sie unten auf dem Bildschirm auf Veröffentlichen.

Die App installieren #

Wichtig: Der Shopify-Benutzer, der die App erstellt, muss sie auch installieren. Wenn ein anderer Benutzer versucht, die App zu installieren, blockt Shopify die Installation.

  1. Klicken Sie auf Home, dann auf App installieren in der oberen rechten Ecke.

  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 auf Installieren in der unteren rechten Ecke.

Mit Clerk verbinden #

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

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

  3. Fügen Sie die Client ID und Client Secret in das Formular ein. Klicken Sie dann auf Sync starten.

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

Märkte und Inventar #

Wenn Sie mehrere Shopify-Märkte, Sprachversionen oder Inventar-Standorte betreiben, bestätigen Sie diese Felder vor dem Sync:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Inventar-Standorte

Diese Werte müssen mit Ihrer Shopify-Markt-/Domain-Konfiguration übereinstimmen. Eine vollständige Zuordnung Feld für Feld finden sie unter Shopify-Integrationseinstellungen.

Variantendaten #

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

Typische Shopify-Variantenattribute in Clerk.io umfassen:

  • variant_inventory_policy (String-Liste)
  • variant_inventory_tracking (Boolesche Liste)
  • variant_list_prices (Numerische Liste)
  • variant_names (String-Liste)
  • variant_option_size (String-Liste)
  • variant_prices (Numerische Liste)
  • variant_stocks (Numerische Liste)
  • variant_weight (Numerische 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-Variantendaten importieren aktiviert ist, enthalten diese Listen nur vorrätige Varianten.

Produktdaten anpassen #

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

Gehen Sie einfach zum Eingabefeld Custom Attributes und tippen Sie die Produktattribute ein, die eingeschlossen werden sollen.

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

Attribute hinzufügen

Attribute sollten immer mit ihrem key geschrieben werden.

Dieser ist normalerweise komplett kleingeschrieben. Zum Beispiel sollte das Attribut “Sizes” als “sizes” angegeben werden.

Sie müssen das namespace nicht angeben – Clerk findet es automatisch anhand des key.

In Shopify finden Sie diese Keys meistens, indem Sie Ihr Attribut unter Einstellungen > Benutzerdefinierte Daten > Produkte/Varianten suchen:

Benutzerdefinierte Daten

Abonnenten synchronisieren #

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

Diese können einfach mit Clerk synchronisiert werden.

Ist diese Option aktiviert, importieren wir das Attribut “subscribed: true” für jede in Shopify angemeldete E-Mail-Adresse.

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

Gehen Sie einfach in Ihren my.clerk.io Store, dann Data -> Configuration und setzen Sie Include Subscriber State auf Yes. Klicken Sie dann auf Save und starten Sie einen neuen Sync.

Subscriber state configuration

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

Die Webhooks-API-Version muss mindestens auf 2022-04 gesetzt sein, da diese Unterstützung dort eingeführt wurde. Sie können dies in der für Clerk erstellten App im Entwickler-Dashboard unter Einstellungen prüfen.

Legacy Custom App #

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

Wenn Sie bereits eine benutzerdefinierte App haben und diese verwenden oder anpassen müssen, wählen Sie Shopify (Legacy Custom App) als Sync-Methode in my.clerk.io > Data > Configuration.

Diese Schritte gelten nur, wenn Ihr Shopify Store weiterhin Zugriff darauf hat, benutzerdefinierte Apps im Shopify Admin zu erstellen.

  1. Gehen Sie in Shopify zu Einstellungen > Apps > Apps entwickeln.
Develop apps page

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

  2. Klicken Sie auf Konfiguration → Admin API-Integration → Konfigurieren.

Berechtigungskonfiguration

  1. Unter Admin API Zugriffsumfänge gewähren Sie Lesezugriff (Scopes beginnend mit read_) auf Folgendes. Für Kunden setzen Sie es auf Lesen und Schreiben (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 zuzugreifen (z.B. für das Synchronisieren von customer.unsub_url).

    Sie können den folgenden String 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

    Alternativ können Sie sie einzeln auswählen:

    • Kunden (read_ und write_)
    • Inventar (read_)
    • Sprachversionen (read_)
    • Standorte (read_)
    • Märkte (read_)
    • Markets Home (read_)
    • Metaobjekte (read_)
    • Shopseiten (read_)
    • Bestellungen (read_)
    • Alle Bestellungen (read_)
    • Produkte (read_)
    • Publikationen (read_)
    • Store-Inhalte (read_)
    • Übersetzungen (read_)
API access scopes

  1. Klicken Sie auf Speichern, dann App installieren → Installieren.

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

API credentials

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

  2. Fügen Sie diese Werte in das Formular ein. Wählen Sie bei Aufforderung eine Standardbildgröße und klicken Sie anschließend auf Sync starten.

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