Sync Data

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

Daten-Sync konfigurieren #

Um die Daten Ihres Shopify-Shops mit Clerk zu synchronisieren, müssen Sie eine App im Shopify-Entwickler-Dashboard erstellen und diese bei Clerk konfigurieren. Der Benutzer, der die Synchronisierung einrichtet, benötigt Zugriff auf das Entwickler-Dashboard sowie Berechtigungen zum Entwickeln von Apps im Shopify-Shop.

Zugriffsanforderungen: Nur Shop-Besitzer oder Mitarbeiter mit Administrator-Berechtigungen können die App erstellen (nicht über Kollaborationszugriff). Wenn Sie dies für einen Kunden einrichten, benötigen Sie Mitarbeiterzugriff 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 nach dem Einloggen das Dev Dashboard direkt öffnen.

5. Klicken Sie im Entwickler-Dashboard auf Create App.

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

7. Fügen Sie unter App URL den Standard-App-Platzhalter von Shopify ein: 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ü angezeigt werden.

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

Berechtigungen (Scopes) konfigurieren #

1. Gewähren Sie unter Access scopes Zugriff auf die unten aufgeführten Scopes. Sie können die folgende Zeichenfolge 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_markets,read_metaobjects,read_online_store_pages,read_orders,read_products,read_content,read_translations
   

   Oder wählen Sie sie einzeln aus:

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

2. Klicken Sie am unteren Bildschirmrand 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-Shop zur Installation der App auswählen. Wählen Sie Ihren Shop aus der Liste.

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

Mit Clerk verbinden #

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

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

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

Bekanntes Problem: Shopify kann beim ersten Synchronisieren möglicherweise kein Token generieren und einen Authentifizierungsfehler verursachen. Dies ist ein bekanntes sporadisch auftretendes Problem bei Shopify. Warten Sie einfach 1-2 Minuten und versuchen Sie es erneut.

Produktdaten anpassen #

In Shopify können Metafelder 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 einbinden möchten.

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

Attribute sollten immer mit ihrem key geschrieben werden.

Dieser ist in der Regel vollständig 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 können Sie diese Schlüssel oft finden, indem Sie Ihr Attribut unter Settings > Custom data > Products/Variants aufsuchen:

Abonnenten synchronisieren #

Shopify unterstützt das Verwalten 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 verwendet werden.

Gehen Sie einfach zu Ihrem my.clerk.io Shop, dann Data -> Configuration und setzen Sie Include Subscriber State auf Yes. Klicken Sie dann auf Save und starten Sie eine neue Synchronisierung.

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

Die Webhooks-API-Version muss mindestens auf 2022-04 eingestellt sein, da diese Unterstützung dort hinzugefügt wurde. Sie können dies in der von Ihnen erstellten App für Clerk im Entwickler-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 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 die Developer Dashboard Methode oben.

Wenn Sie eine bestehende Custom 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-Shop weiterhin Zugriff zum 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.

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

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

4. Gewähren Sie unter Admin API access scopes Leseberechtigung (Scopes beginnend mit read_) für die folgenden Bereiche. Für Customers wählen Sie Lesen und Schreiben (inklusive write_customers), da Shopify dies zur Anzeige der Marketing-URL-Felder benötigt (zum Beispiel für customer.unsub_url).

   Sie können die folgende Zeichenfolge 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_markets,read_metaobjects,read_online_store_pages,read_orders,read_products,read_content,read_translations
   

   Oder Sie wählen sie einzeln aus:

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

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

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

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

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