Sync Data

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

Datenabgleich konfigurieren #

Um die Daten Ihres Shopify-Shops mit Clerk zu synchronisieren, müssen Sie eine App im Shopify Developer Dashboard erstellen und sie in Clerk konfigurieren. Der Benutzer, der die Synchronisierung einrichtet, benötigt Zugriff auf das Developer Dashboard und die Berechtigung, Apps im Shopify-Shop zu entwickeln.

Zugriffsvoraussetzungen: Nur Shop-Besitzer oder Mitarbeiter mit Berechtigung für das Developer Dashboard können die App erstellen (nicht über Kollaborationszugriff). 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 Einstellungen.

2. Klicken Sie auf Apps und Vertriebskanäle.

3. Klicken Sie auf Apps entwickeln.

4. Klicken Sie auf Apps im Dev Dashboard erstellen.

   • Falls diese Option nicht angezeigt wird, klicken Sie stattdessen auf Mehr erfahren.
   • Im neuen Fenster klicken Sie auf Zum Dev Dashboard.
   • Alternativ können Sie nach dem Einloggen das Dev Dashboard direkt öffnen.

5. Klicken Sie im Developer Dashboard auf App erstellen.

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

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

8. Entfernen Sie unter App im Shopify-Admin einbetten 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 (mindestens 2025-07).

Rechte konfigurieren #

1. Unter Zugriffsrechte gewähren Sie Zugriff auf folgende Bereiche:

   • Kunden (read_ und write_)
   • Inventar (read_)
   • Sprachen (read_)
   • Märkte (read_)
   • Metaobjekte (read_)
   • Onlineshop-Seiten (read_)
   • Bestellungen (read_)
   • Alle Bestellungen (read_)
   • Produkte (read_)
   • Shop-Inhalte (read_)
   • Übersetzungen (read_)

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

App installieren #

1. Klicken Sie auf Startseite, dann oben rechts auf App installieren.

2. Shopify leitet Sie auf eine Seite weiter, auf der Sie den Shopify-Shop auswählen, in dem die App installiert werden soll. Wählen Sie Ihren Shop aus der Liste.

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

Verbindung mit Clerk #

1. Gehen Sie zurück zum Developer Dashboard und klicken Sie im Clerk.io-App-Bereich auf Einstellungen. Hier finden Sie die Client ID und Client Secret.

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

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 Abgleich möglicherweise keinen Token generieren, was zu einem Authentifizierungsfehler führt. Dies ist ein bekanntes, sporadisch auftretendes Problem in 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 eingeschlossen werden sollen.

Möchten Sie mehrere Attribute hinzufügen, trennen Sie diese durch Kommas.

Attribute sollten immer mit ihrem key geschrieben werden.

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

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

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

Abonnenten synchronisieren #

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

Diese lassen sich einfach mit Clerk synchronisieren.

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

Dies kann anschließend für Auto-Email verwendet werden.

Gehen Sie einfach zu Ihrem my.clerk.io Shop, dann Data -> Configuration und stellen Sie Include Subscriber State auf Yes. Klicken Sie anschließend auf Save und starten Sie einen neuen Abgleich.

Wenn Sie einen Abbestellen-Link für Kunden verwenden möchten, hat jeder Kunde, der aus einem Shopify-Backend übernommen wird, ein Attribut unsub_url, das für das auto email-Design im Feld zum Abbestellen verwendet werden kann: {{customer.unsub_url}}

Die Webhooks-API-Version muss mindestens auf 2022-04 eingestellt sein, ab der diese Funktion verfügbar ist. Sie können dies in der App, die Sie für Clerk im Developer Dashboard erstellt haben, unter Einstellungen nachprüfen.

Legacy Custom App #

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

Wenn Sie bereits eine benutzerdefinierte App haben und diese verwenden oder anpassen möchten, wählen Sie in my.clerk.io > Data > Configuration unter Sync Method Shopify (Legacy Custom App) aus.

Diese Schritte gelten nur, wenn Ihr Shopify-Shop weiterhin die Möglichkeit bietet, benutzerdefinierte Apps im Admin zu erstellen.

1. Gehen Sie in Shopify zu Apps > Einstellungen für Apps und Vertriebskanäle und klicken Sie auf Apps entwickeln.

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

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

4. Gewähren Sie unter Admin-API-Zugriffsrechte Lesezugriff (Berechtigungen beginnend mit read_) für folgende Bereiche. Bei Kunden stellen Sie auf Lesen und Schreiben (inklusive write_customers), da Shopify dies zum Zugriff auf Kunden-Marketing-URL-Felder benötigt (z. B. für customer.unsub_url).

   • Kunden (read_ und write_)
   • Inventar (read_)
   • Sprachen (read_)
   • Märkte (read_)
   • Metaobjekte (read_)
   • Onlineshop-Seiten (read_)
   • Bestellungen (read_)
   • Alle Bestellungen (read_)
   • Produkte (read_)
   • Shop-Inhalte (read_)
   • Übersetzungen (read_)

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

6. Öffnen Sie API-Zugangsdaten und kopieren Sie Ihre Shopify-Domain sowie den API Key, das Access Token und den 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 bei Aufforderung eine Standard-Bildgröße und klicken Sie dann auf Start Sync.