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.io. Dieser Leitfaden behandelt das Erstellen einer App im Dev Dashboard von Shopify, das Anpassen von Produktdaten und das Synchronisieren von Abonnenteninformationen.

Sync einrichten #

Die Einrichtung besteht aus zwei Teilen: Zuerst erstellen und installieren Sie eine App in Shopify, dann geben Sie deren Zugangsdaten in my.clerk.io ein. Schließen Sie beide Schritte ab, bevor Sie die erste Synchronisierung starten.

Bevor Sie die Synchronisierung einrichten, stellen Sie sicher, dass Sie die aktuelle .myshopify.com-Domain des Shops haben. Folgen Sie bei Bedarf den Shopify-Domain-Schritten.

In Shopify #

Führen Sie diese Schritte im Dev Dashboard von Shopify aus. Siehe Shopifys aktuellen Dev Dashboard App-Leitfaden, falls sich die Bezeichnungen ändern.

App erstellen #

  1. Öffnen Sie das Shopify Dev Dashboard und melden Sie sich an.
  2. Öffnen Sie in der linken Navigation Apps und klicken Sie auf Create app.
  3. Wählen Sie Start from Dev Dashboard, geben Sie Clerk.io als App-Namen ein und klicken Sie auf Create.

App konfigurieren #

  1. Öffnen Sie den Tab Versions für die neue App.
  2. Geben Sie unter App URL https://shopify.dev/apps/default-app-home ein. Die App bietet nur API-Zugriff und benötigt keine eingebettete Admin-Oberfläche.
  3. Wählen Sie in Webhooks API Version die neueste verfügbare Version aus.
  4. Fügen Sie die im nächsten Abschnitt aufgeführten Access Scopes hinzu.

Scopes konfigurieren #

Gewähren Sie die untenstehenden Scopes. Diese erlauben Clerk.io, den Katalog, Bestellungen, Kunden, Seiten, Märkte, Standorte und die für die Shopify-Integration erforderlichen Daten zu importieren. Sie können die vollständige Liste in das Access-Scope-Feld einfü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.io liest nur Daten, aber Shopify erfordert den Scope write_customers, um auf Felder wie customer.unsub_url zuzugreifen.

Sie können die Scopes auch einzeln auswählen:

  • 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_)

Gehen Sie nach dem Hinzufügen der Scopes zurück zum Tab Versions der App und klicken Sie auf Release.

App installieren #

Installieren Sie die veröffentlichte App im Shopify-Store, der mit Clerk.io synchronisiert werden soll.

  1. Öffnen Sie in der App Home und klicken Sie auf Install app.
  2. Wählen oder erstellen Sie den Shopify-Store.
  3. Überprüfen Sie den angeforderten Zugriff und klicken Sie auf Install.

In Clerk.io #

Führen Sie diese Schritte in my.clerk.io mit den Zugangsdaten aus Shopify durch. Das Team des Shops kann dies direkt erledigen oder die Zugangsdaten sicher an eine dritte Partei weitergeben, die die Clerk.io-Synchronisierung einrichtet.

Sync konfigurieren #

  1. Öffnen Sie im Shopify Dev Dashboard in der Clerk.io-App Settings und kopieren Sie die Felder Client ID und Client Secret oder erhalten Sie diese über eine genehmigte sichere Übergabe vom Shopify-Team.
  2. Öffnen Sie in my.clerk.io den entsprechenden Store und gehen Sie zu Data > Configuration.
  3. Setzen Sie Sync Method auf Shopify.
  4. Geben Sie die aktuelle .myshopify.com-Domain des Shopify-Stores in Shopify Domain ein. Geben Sie keine öffentliche Domain, kein https:// und keinen Pfad ein.
  5. Fügen Sie die Client ID und Client Secret in die entsprechenden Felder ein.
  6. Klicken Sie auf Save, danach auf Start Sync.

Bewahren Sie das Client Secret vertraulich auf. Teilen Sie es nur über einen genehmigten sicheren Kanal und fügen Sie es niemals in ein öffentliches Dokument, Support-Ticket oder einen Chat ein.

Bekanntes Problem: Shopify kann beim ersten Sync eventuell keinen Token erstellen, was zu einem Authentifizierungsfehler führt. Dies ist ein bekanntes sporadisches Problem bei Shopify. Warten Sie einfach 1–2 Minuten und versuchen Sie es erneut.

Märkte und Inventar #

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

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

Diese Werte sollten Ihrer Shopify-Markt-/Domainkonfiguration entsprechen. Eine vollständige Feld-zu-Feld-Zuordnung finden Sie unter Shopify-Integrationseinstellungen.

Variantendaten #

Die Verarbeitung der Variantendaten in Shopify kann je nach Einstellung Nur vorrätige Variantendaten importieren unterschiedlich verlaufen.

Typische Shopify-Variantenattribute in Clerk.io umfassen:

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

Produktdaten anpassen #

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

Gehen Sie einfach zum Eingabefeld Custom Attributes und geben Sie die zu übernehmenden Produktattribute ein.

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

Add attributes

Attribute sollten immer mit ihrem key angegeben werden.

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

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

In Shopify finden Sie diese Keys in der Regel, indem Sie das Attribut finden unter Settings > Custom data > Products/Variants:

Custom data

Abonnenten synchronisieren #

Shopify unterstützt das Verwalten von Abonnenten direkt auf der Plattform.

Diese können einfach mit Clerk.io synchronisiert werden.

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

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

Gehen Sie einfach in Ihrem my.clerk.io-Store zu Data -> Configuration und stellen 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 bereitstellen möchten, hat jeder Kunde, der aus einem Shopify-Backend gezogen 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, ab der diese Unterstützung hinzugefügt wurde. Sie können dies in der von Ihnen für Clerk.io im Dev Dashboard erstellten App unter Settings prüfen.

Legacy Custom App #

Ab Januar 2026 ist das direkte Erstellen von Custom Apps im Shopify-Admin für Shops nicht mehr möglich. Bestehende Custom 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 bitte die oben beschriebene Developer Dashboard Methode.

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

Diese Schritte gelten nur, falls Ihr Shopify-Store weiterhin Zugang zum Erstellen von Custom Apps im Admin-Bereich hat.

  1. Gehen Sie in Shopify zu Settings > Apps > 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 (Scopes beginnend mit read_) für die folgenden Bereiche. Bei Customers wählen Sie Lese- und Schreibzugriff (einschließlich write_customers).

    Warum benötigen wir Schreibzugriff? Clerk.io liest nur Daten, aber Shopify erfordert den Scope write_customers, um auf Felder wie customer.unsub_url zuzugreifen (zum Beispiel für das Synchronisieren von 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:

    • 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. Wählen Sie unter Sync Method Shopify (Legacy Custom App).

  2. Fügen Sie diese Werte in das Formular ein. Wählen Sie falls gefragt eine Standard-Bildgröß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.