Integration

Nach dem Verbinden von Shopify in Clerk.io dient diese Seite als Referenz für die Shopify-spezifischen Synchronisationseinstellungen in my.clerk.io > Data > Configuration.

Verwenden Sie diese Anleitung zusammen mit Get Started und Sync Data.

Einstellungen Referenz #

Dies ist eine vollständige Nachschlage-Referenz für Shopify-Synchronisationseinstellungen in my.clerk.io > Data > Configuration.

Synchronisationsmethode #

Wählen Sie aus, welchen Shopify-Connector-Typ Sie verwenden. Verwenden Sie Shopify für eine App, die im Shopify Dev Dashboard erstellt wurde. Verwenden Sie Shopify (Legacy Custom App) nur für eine bestehende App, die im Shopify-Administrationsbereich erstellt wurde.

Shopify-Domain #

Die aktuelle .myshopify.com-Domain des Shops, z. B. example-store.myshopify.com. Verwenden Sie diesen Wert anstelle der öffentlichen benutzerdefinierten Domain. Sie finden sie unter Shopify > Settings > Domains.

Client ID #

Für die aktuelle Shopify-Synchronisationsmethode verwenden Sie die Client ID von der Settings-Seite der Clerk.io-App im Shopify Dev Dashboard.

Client Secret #

Für die aktuelle Shopify-Synchronisationsmethode verwenden Sie das Client Secret von derselben Shopify Dev Dashboard-Seite. Bewahren Sie dieses geheim auf und teilen Sie es nur über einen genehmigten sicheren Kanal.

Legacy-Zugangsdaten #

Für Shopify (Legacy Custom App) verwenden Sie den API Key, API Access Token und API Secret Key aus der bestehenden Custom App. Siehe Legacy Custom App für die Schritte zur Legacy-Einrichtung.

Standardbildgröße #

Steuert, welche Shopify-Bildauflösung Clerk.io importiert.

Gängige Formate:

• 800x800
• 800x

Shopify generiert Bildgrößen nach Bedarf. Wenn das Seitenverhältnis des Quellbildes abweicht, liefert Shopify die nächste passende Größe.

Markt-Einrichtung #

Verwenden Sie die folgenden Einstellungen, wenn der Shopify-Shop mehrere Märkte, Sprachen, Domains oder Lagerstandorte hat. Die Werte müssen mit der Shopify-Einrichtung übereinstimmen, bevor eine neue Synchronisation gestartet wird.

Shop-Markt #

Verwenden Sie diese Einstellung, wenn der Shop Shopify Markets nutzt. Geben Sie den Marktnamen genau so ein, wie er in Shopify konfiguriert ist (z. B. Denmark, Europe oder United States).

Märkte können sich auf verfügbare Produkte, Preise, Sprachen und Lagerbestand-Kontext auswirken.

Shop-Locale #

Verwenden Sie diese Einstellung für Mehrsprachigkeit. Geben Sie den standardisierten zweistelligen Sprachcode (z. B. da, sv, es) ein.

Verwenden Sie den Sprachcode, nicht den Ländercode.

Wenn Sie sich nicht sicher sind, welches Locale verwendet werden soll, fragen Sie Shopify Sidekick nach den im Shop konfigurierten Locales.

URLs mit Locale-Präfix versehen #

Steuert, ob lokalisierte URLs das Locale als Präfix im Pfad enthalten.

Beispiel:

• Ja: /da/product-name
• Nein: /product-name

Nur relative URLs erzwingen #

Steuert, ob Clerk.io relative URLs oder vollständige absolute URLs importiert.

• Ja: Nur relative Pfade verwenden
• Nein: Volle URLs inklusive Domain erlauben

Lagerorte #

Durch Kommas getrennte Liste von einem oder mehreren Lagerorten, aus denen bei Shopify synchronisiert werden soll.

Verwenden Sie diese Einstellung, wenn die Produktverfügbarkeit je nach Lager/Standort variiert.

Daten-Einstellungen #

Mit den folgenden Einstellungen steuern Sie, welche Shopify-Daten Clerk.io importiert und wie diese verarbeitet werden.

Benutzerdefinierte Attribute #

Durch Kommas getrennte Liste zusätzlicher Shopify-Attribute, die importiert werden sollen, einschließlich Metafeldern und anderen benutzerdefinierten Attributen.

Seiten einbeziehen #

Importiert Shopify-Seiten als Seitenobjekte in Clerk.io, einschließlich Inhalte wie Blog-Seiten und andere CMS-Seiten.

Alle ausverkauften Produkte einbeziehen #

Wenn aktiviert, werden auch vollständig ausverkaufte Produkte importiert.

“Weiterverkauf bei Ausverkauf” Produkte einbeziehen #

Steuert, ob Produkte mit Shopifys Funktion “Weiterverkauf bei Ausverkauf” importiert werden.

Shopify-Veröffentlichungsstatus #

Steuert, welche Produkt-Veröffentlichungsstatus für den Import in Frage kommen.

Typische Verwendung:

• nur veröffentlichte Produkte
• alle Produkte (einschließlich nicht veröffentlichte)

Shopify-Kategorien Veröffentlichungsstatus #

Wie oben, aber auf Kategorie-Veröffentlichungsstatus bezogen.

Shopify-Seiten Veröffentlichungsstatus #

Wie oben, aber bezogen auf den Veröffentlichungsstatus von Seiten.

Synchronisationszeit #

Legt den Zeitplan für das nächste Synchronisationsintervall fest (UTC).

Echtzeit-Updates aktivieren #

Wenn aktiviert, erhält Clerk.io Aktualisierungen von Shopify, sobald Änderungen erfolgen (z. B. Lager- oder Preisänderungen), anstatt auf den nächsten vollständigen Synchronisationszyklus zu warten.

Nur “Auf Lager”-Varianten importieren #

Steuert, ob variantenbezogene Attribute nur “auf Lager”-Varianten enthalten sollen.

Beispiel-Ausgabe für Varianten:

• variant_names: ["Xs", "M"]
• variant_option_size: ["Xs", "M"]
• variant_stocks: [1, 7]
• variants: ["55970989179259", "55970989244795"]

Wenn die Einstellung Ja ist, enthalten die Listen nur “auf Lager”-Varianten.

Variantenoptionen trennen #

Teilt Variantenoptionen in separate Attribute auf, sodass jede Option unabhängig für Filter und Designs verwendet werden kann.

Bestellhistorie #

Steuert, wie viele historische Bestelldaten pro Synchronisation importiert werden.

Verfügbare Bereiche:

• 1 Monat
• 3 Monate
• 6 Monate
• 1 Jahr
• alle Zeiten

Ein gängiger Ansatz ist, beim ersten Import “alle Zeiten” zu wählen und für wiederkehrende Importe einen kürzeren Zeitraum (z. B. 1 Monat) zu wählen.

Tags importieren #

Steuert die Importstrategie für Tags.

Verfügbare Modi:

• alle Tags importieren
• bestimmte Tags ausschließen
• bestimmte Tags einbeziehen
• keine Tags importieren

Bestimmte Tags #

Durch Kommas getrennte Tags, die verwendet werden, wenn Tags importieren auf das Ein- oder Ausschließen bestimmter Tags eingestellt ist.

Tags Separator beim Zerlegen #

Zeichen, das bei der Zerlegung von Tags zur Trennung von Tagname und Wert verwendet wird.

Beispiel:

• Tag: sale_10
• Separator: _

Tags-Präfix beim Zerlegen #

Präfix, das beim Zerlegen von Tags vor der Speicherung des Werts entfernt wird.

Durch die Verwendung von sale_10 mit Separator _ und Präfix sale kann 10 als Wert genutzt werden.

Abonnentenstatus einbeziehen #

Importiert den Abonnentenstatus für Kunden (Newsletter-/Abonnementstatus), sofern von Shopify bereitgestellt.

Pakete & Bestellstatus importieren #

Importiert Paket-/Sendungsverfolgungsinformationen sowie Bestellstatuswerte von Shopify.

Diese Daten werden von Chat beim Beantworten von Versand- und Bestellstatusfragen verwendet.

Deinstallation #

Im Folgenden finden Sie eine Anleitung zum Entfernen der Tracking-Skripte und allgemeine Schritte, um Clerk.io aus Ihrem Shopify-Shop zu deinstallieren.

Entfernen von Tracking-Skripten #

Um das Clerk.io-Tracking aus Ihrem Webshop zu entfernen, müssen Sie sowohl das Besucher- als auch das Verkaufs-Tracking-Skript aus Ihren Shopify-Theme-Dateien und dem Bereich “Zusätzliche Skripte” löschen.

• Zunächst entfernen Sie Ihre Besucher-Tracking-Skripte aus der Theme-Datei, in der Sie den Embed-Code während der Einrichtung ursprünglich eingefügt haben.

Das Besucher-Tracking befindet sich wahrscheinlich in der “theme.liquid”- oder “index.liquid”-Datei Ihres Webshops.

Sie können auf diese Datei zugreifen, indem Sie sich in Ihr Shopify-Admin-Portal einloggen und dann “Onlineshop” > “Themes” auswählen. Wählen Sie dann unter “Live Theme” im Dropdown-Menü “Aktionen” die Option “Code bearbeiten”.

Suchen Sie Ihre Haupt-Theme-Datei, suchen Sie dann das Besucher-Tracking-Skript und löschen Sie es:

• Anschließend müssen Sie beide Tracking-Skripte aus dem Bereich “Zusätzliche Skripte” entfernen.

Sie finden diesen Bereich in Ihrem Shopify-Admin-Portal, indem Sie unten links auf “Einstellungen” klicken. Löschen Sie dann einfach beide Skripte aus dem Textfeld “Zusätzliche Skripte”.

Private App-Berechtigungen aktualisieren #

Sie können auch die Berechtigungen für die während der Einrichtung von Clerk.io erstellte Private App ändern, um sicherzustellen, dass kein Zugriff auf die entsprechenden Datenfelder besteht.

Sie finden die API-Berechtigungen Ihrer App, indem Sie sich in Ihr Shopify-Admin-Portal einloggen, “Apps” > “Private Apps verwalten” > “Clerk.io” auswählen.

In “Admin-API-Berechtigungen” stellen Sie jedes der Dropdown-Felder, das derzeit “Lesezugriff” anzeigt, auf “Kein Zugriff” um:

my.clerk.io aktualisieren #

Sie können außerdem den Shopify API Key, das Passwort und das Secret aus dem my.clerk.io Backend Ihres Shops entfernen.

Melden Sie sich an, wählen Sie im linken Menü “Data” und gehen Sie zu “Configuration”. Vergessen Sie nicht, danach auf “Save” zu klicken: