Sync Data

Synchronisieren Sie Ihre Shopify-Produkte, Metafelder und Abonnenten mit Clerk. Dieser Leitfaden beschreibt die Anpassung von Produktdaten und das Synchronisieren von Abonnenteninformationen.

Daten-Synchronisation konfigurieren #

Um Ihre Shopify-Shopdaten mit Clerk zu synchronisieren, müssen Sie eine eigene App in Shopify erstellen und sie in Clerk konfigurieren.

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. Unter Admin API access scopes gewähren Sie Lesezugriff (Scopes beginnend mit read_) auf Folgendes:

   • 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 und fügen Sie diese Werte in das Formular ein. Wählen Sie eine Standardbildgröße, falls Sie dazu aufgefordert werden, und klicken Sie dann auf Start Sync.

Produktdaten anpassen #

In Shopify können Metafelder und weitere 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 einschließen möchten.

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

Attribute sollten immer über ihren key angegeben werden.

Dieser ist üblicherweise 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 Schlüssel häufig, indem Sie das Attribut unter Settings > Custom data > Products/Variants suchen:

Abonnenten synchronisieren #

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

Diese lassen sich einfach mit Clerk synchronisieren.

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

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

Gehen Sie einfach zu Ihrem 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 einen Unsubscribe-Link für Kunden verwenden möchten, hat jeder Kunde, der aus einem Shopify-Backend importiert wird, ein unsub_url-Attribut, das für Auto-Email-Designs im Unsubscribe-Feld verwendet werden kann: {{customer.unsub_url}}

Die Webhook-API-Version von Shopify muss mindestens auf 2022-04 gesetzt sein, da diese Unterstützung dort hinzugefügt wurde. Sie können dies in der App überprüfen, die Sie für Clerk > Configuration > Admin API integration > Edit > Webhook subscriptions erstellen.