Integration

Nachdem Sie Shopify in Clerk.io verbunden haben, dient diese Seite als Referenz für die Shopify-spezifischen Synchronisierungseinstellungen 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 die Shopify-Synchronisierungseinstellungen in my.clerk.io > Data > Configuration.

Synchronisierungsmethode #

Wählen Sie aus, welchen Shopify-Connector-Typ Sie verwenden. Die meisten Setups sollten Shopify aus dem Dev Dashboard-Flow nutzen.

Shopify Domain #

Die .myshopify.com-Domain des Shops, zum Beispiel example-store.myshopify.com. Sie finden sie im Shopify-Adminbereich und in der Shop-URL.

Shopify API Key #

Der API Key aus der Shopify-App, die Sie für Clerk.io im Shopify Dev Dashboard erstellt haben.

Shopify API Access Token #

Das Access Token aus derselben Shopify-App. Clerk.io verwendet es zum Auslesen der Synchronisierungsdaten.

Shopify API Secret Key #

Der API Secret Key aus derselben Shopify-App.

Standardbildgröße #

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

Gängige Formate:

• 800x800
• 800x

Shopify generiert Bildgrößen bei Bedarf. Wenn das Seitenverhältnis des Quellbilds abweicht, liefert Shopify die nächstmögliche Größe.

Shop Market #

Verwenden Sie dies, wenn der Shop Shopify Markets nutzt. Geben Sie den Marktnamen exakt wie in Shopify konfiguriert ein (zum Beispiel Denmark, Europe oder United States).

Märkte beeinflussen die verfügbaren Produkte, Preise, Sprachen und den Lagerbestand-Kontext.

Shop Locale #

Verwenden Sie dies für mehrsprachige Setups. Geben Sie den standardisierten 2-Buchstaben-Locale-Code an (zum Beispiel da, sv, es).

Verwenden Sie den Sprachcode, nicht den Ländercode.

Wenn Sie unsicher sind, welches Locale zu verwenden ist, fragen Sie Shopify Sidekick nach den im Shop konfigurierten Locales.

URLs mit Locale-Präfix versehen #

Steuert, ob lokalisierte URLs den Locale-Pfadpräfix beinhalten.

Beispiel:

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

Relative URLs erzwingen #

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

• Ja: Erzwingt relative Pfade
• Nein: Erlaubt vollständige URLs mit Domain

Benutzerdefinierte Attribute #

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

Lagerorte #

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

Verwenden Sie dies, wenn die Produktverfügbarkeit je Lager/Standort variiert.

Seiten einbeziehen #

Importiert Shopify-Seiten als Page-Objekte in Clerk.io, einschließlich Inhalte wie Blogseiten und andere CMS-Seiten.

Alle ausverkauften Produkte einbeziehen #

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

„Continue Selling When Out-Of-Stock“-Produkte einbeziehen #

Steuert, ob Produkte mit der Shopify-Option „continue selling when out of stock“ importiert werden.

Shopify Veröffentlichungsstatus #

Steuert, welche Produktveröffentlichungszustände für den Import berechtigt sind.

Typische Verwendung:

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

Shopify Kategorie-Veröffentlichungsstatus #

Wie oben, aber für den Veröffentlichungsstatus von Kategorien.

Shopify Seiten-Veröffentlichungsstatus #

Wie oben, aber für den Veröffentlichungsstatus von Seiten.

Synchronisierungszeit #

Legt das Zeitfenster für den nächsten Synchronisierungslauf fest (UTC).

Echtzeit-Updates aktivieren #

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

Nur vorrätige Varianten-Daten importieren #

Steuert, ob variantenbezogene Attribute nur vorrätige Varianten enthalten sollen.

Beispiel Varianten-Ausgabe:

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

Wenn die Einstellung auf Ja steht, enthalten die Variantenlisten nur vorrätige Varianten.

Varianten-Optionen trennen #

Teilt Varianten-Optionen in separate Attribute auf, sodass jede Option unabhängig in Filterungen und Designs verwendet werden kann.

Bestellhistorie #

Steuert, wie viele historische Bestelldaten pro Vorgang importiert werden.

Verfügbare Bereiche sind:

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

Eine gängige Vorgehensweise ist „alle Zeiten“ beim ersten Import, danach ein kürzerer Zeitraum (z.B. 1 Monat) für wiederkehrende Importe.

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 „bestimmte Tags einschließen/ausnehmen“ gesetzt ist.

Tags-Aufspaltung-Trennzeichen #

Zeichen, mit dem Tag-Name und Wert beim Aufspalten getrennt werden.

Beispiel:

• Tag: sale_10
• Trennzeichen: _

Tags-Aufspaltung-Präfix #

Präfix, das beim Aufspalten von Tags entfernt wird, bevor der Wert gespeichert wird.

Die Verwendung von sale_10 mit Trennzeichen _ und Präfix sale erlaubt die Verwendung von 10 als Wert.

Abonnentenstatus einbeziehen #

Importiert den Abonnentenstatus für Kunden (Newsletter/Abonnementstatus), sofern in Shopify verfügbar.

Pakete & Bestellstatus importieren #

Importiert Paket-/Trackinginformationen und Bestellstatuswerte aus Shopify.

Diese Daten werden von Chat genutzt, um Versand- und Bestellstatus-Fragen zu beantworten.

Deinstallation #

Nachfolgend finden Sie eine Anleitung zum Entfernen der Tracking-Skripte und allgemeine Schritte zur Deinstallation von Clerk aus Ihrem Shopify-Shop.

Entfernen von Tracking-Skripten #

Um Clerk-Tracking aus Ihrem Webshop zu entfernen, müssen sowohl das Besucher- als auch das Verkaufs-Tracking-Skript aus Ihren Shopify-Theme-Dateien und dem Abschnitt „Zusätzliche Skripte“ entfernt werden.

• Zuerst entfernen Sie die Besucher-Tracking-Skripte aus der Theme-Datei, in die Sie den Embed-Code ursprünglich im Setup platziert haben.

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

Sie können diese Datei öffnen, indem Sie sich im Shopify-Admin-Portal anmelden und dann „Onlineshop“ > „Themes“ auswählen. Unter „Live Theme“ wählen Sie dann „Code bearbeiten“ aus dem Dropdown-Menü „Aktionen“.

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

• Als Nächstes müssen Sie beide Tracking-Skripte aus dem Bereich „Zusätzliche Skripte“ entfernen.

Diesen finden Sie im Shopify-Admin-Portal, indem Sie unten links auf „Einstellungen“ klicken. Löschen Sie dann einfach beide Skripte aus dem Textfeld „Zusätzliche Skripte“.

Berechtigungen für private App aktualisieren #

Sie können auch die Berechtigungen für die Clerk-Private-App, die Sie beim Setup erstellt haben, ändern, um sicherzustellen, dass auf die betreffenden Datenfelder nicht mehr zugegriffen werden kann.

Sie finden die API-Berechtigungen Ihrer App, indem Sie sich im Shopify-Admin-Portal anmelden, „Apps“ > „Private Apps verwalten“ > „Clerk.io“ auswählen.

Unter „Admin-API-Berechtigungen“ passen Sie alle diese Dropdowns, in denen derzeit „Leseberechtigung“ steht, auf „Kein Zugriff“ an:

my.clerk.io aktualisieren #

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

Melden Sie sich an, wählen Sie im linken Menü „Data“ und gehen Sie zu „Configuration“. Klicken Sie nach Abschluss unbedingt auf „Save“: