Sync Data

Synchronisieren Sie Ihre Shopify-Produkte, Metafelder und Abonnenten mit Clerk. Dieser Leitfaden behandelt das Erstellen einer App im Developer Dashboard von Shopify, die Anpassung von Produktdaten und das Synchronisieren von Abonnenteninformationen.

Datensynchronisierung konfigurieren #

Um die Daten Ihres Shopify-Shops mit Clerk zu synchronisieren, müssen Sie eine App im Developer Dashboard von Shopify erstellen und sie in Clerk konfigurieren. Der Benutzer, der die Synchronisierung einrichtet, muss Zugriff auf das Developer Dashboard und Berechtigungen zum Entwickeln von Apps im Shopify-Store haben.

Zugriffsanforderungen: Nur Shop-Inhaber oder Mitarbeiter mit Developer Dashboard-Berechtigungen können die App erstellen (nicht per Zusammenarbeit). Wenn Sie die Einrichtung für einen Kunden vornehmen, benötigen Sie Mitarbeiterzugang oder die App-Zugangsdaten vom Kunden.

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.

   • Wenn Sie diese Option nicht sehen, klicken Sie stattdessen auf Learn more.
   • In dem sich öffnenden neuen Fenster klicken Sie auf Go to Dev Dashboard.
   • Alternativ können Sie nach dem Login das Dev Dashboard direkt öffnen.

5. Klicken Sie im Developer 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 hinzu: 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 unter Webhooks API Version die neueste Version aus (mindestens 2025-07).

Berechtigungen konfigurieren #

10. Gewähren Sie unter Access scopes Lesezugriff (Berechtigungen beginnend mit read_) für folgende Bereiche:

• Customers

• Inventory

• Locales

• Markets

• Online Store Pages

• Orders

• Products

• Store Content

• Translations

11. Klicken Sie unten auf dem Bildschirm auf Release.

App installieren #

12. Klicken Sie auf Home und dann oben rechts auf Install app.

13. 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.

14. Überprüfen Sie auf der folgenden Seite die App-Zusammenfassung und klicken Sie unten rechts auf Install.

Mit Clerk verbinden #

15. Gehen Sie zurück zum Developer Dashboard und klicken Sie innerhalb der Clerk.io-App auf Settings. Hier finden Sie die Client ID und Client Secret.

16. Gehen Sie zu my.clerk.io > Data > Configuration. Wählen Sie unter Sync Method Shopify.

17. Fügen Sie die Client ID und Client Secret in das Formular ein. Klicken Sie anschließend auf Start Sync.

Bekanntes Problem: Shopify schlägt möglicherweise beim ersten Synchronisieren beim Generieren eines Tokens fehl, was zu einem Authentifizierungsfehler führt. Dies ist ein bekanntes, sporadisch auftretendes Problem bei Shopify. Warten Sie einfach 1–2 Minuten und versuchen Sie die Synchronisierung erneut.

Produktdaten anpassen #

In Shopify können von Ihnen erstellte Metafelder und andere 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 sie mit Kommas.

Attribute sollten immer mit ihrem key geschrieben werden.

Dies ist normalerweise alles kleingeschrieben. Beispielsweise sollte das Attribut “Sizes” als “sizes” geschrieben werden.

Sie müssen den namespace nicht angeben – Clerk wird diesen automatisch anhand des key finden.

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

Abonnenten synchronisieren #

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

Diese können einfach 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 einfach in Ihren 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.

Wenn Sie für Kunden einen Abmeldelink verwenden möchten, hat jeder Kunde, der über ein Shopify-Backend abgerufen wurde, 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 sein, ab der diese Unterstützung hinzugefügt wurde. Sie können dies in der von Ihnen für Clerk im Developer Dashboard erstellten App unter Settings überprüfen.

Legacy Custom App #

Ab Januar 2026 erlaubt Shopify das Erstellen benutzerdefinierter 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 benutzerdefinierte App eingerichtet haben. Für alle anderen Setups verwenden Sie bitte die oben beschriebene Developer Dashboard Methode.

Wenn Sie bereits eine benutzerdefinierte App haben und diese nutzen oder anpassen 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 darauf hat, benutzerdefinierte Apps im Shopify-Admin zu erstellen.

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 und klicken Sie dann erneut auf Create app.

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

4. Gewähren Sie unter Admin API access scopes Lesezugriff (Berechtigungen beginnend mit read_) für folgende Bereiche:

   • Customers

   • Inventory

   • Locales

   • Markets

   • Online Store Pages

   • Orders

   • Products

   • Store Content

   • Translations

5. Klicken Sie auf Save, dann 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 ins Formular ein. Wählen Sie ggf. eine Standardbildgröße aus und klicken Sie dann auf Start Sync.