Get Started

Verbindung Ihres Shops #

Der erste Schritt bei der Installation von Clerk.io besteht darin, Ihren Shop mit Ihrem Clerk.io-Konto zu verbinden.

Nachdem Sie diese einfachen Schritte befolgt haben, können Sie Ihren Demo Store sehen, der Ihnen einen persönlichen Überblick darüber gibt, wie Clerk.io in Ihrem Webshop funktioniert, bevor Sie den Rest des Systems einrichten.

1. Shop hinzufügen #

Nachdem Sie sich bei my.clerk.io angemeldet haben, müssen Sie zunächst Ihren Shop hinzufügen:

1. Geben Sie den Name und die Domain Ihres Webshops ein

2. Wählen Sie VTEX als Platform und wählen Sie Ihre Currency.

3. Klicken Sie auf Add Store.

2. Modul installieren und konfigurieren #

1. Führen Sie im vtex cli vtex install clerkiopartnerdk.integration-vtex aus. Sie können bestätigen, dass die App jetzt installiert ist, indem Sie erneut vtex ls ausführen.

2. Öffnen Sie den Abschnitt Apps auf der Admin-Seite Ihres Kontos und suchen Sie nach dem ClerkIO Integration box. Sobald Sie es gefunden haben, klicken Sie auf das Feld. Füllen Sie die geforderten Felder aus. Für MultiBinding-Seiten klicken Sie auf die Aktivierung der Konfiguration per Binding, um jedem Binding einen Clerk Store zuzuweisen.

3. Generieren Sie die Feeds für Produkte, Kategorien und Bestellungen, indem Sie eine POST-Anfrage an die folgenden Endpunkte senden (ersetzen Sie accountName, workspace und bindingID):

Führen Sie eine GET-Anfrage an diesen Endpunkt aus: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

Es ist erforderlich, dass VtexIdclientAutCookie als Header mitgesendet wird.

Beim ersten Aufruf zur Generierung des Feeds wird ein leeres Array zurückgegeben. Je nach Größe Ihres Shop-Katalogs kann die Feed-Erstellung einige Zeit in Anspruch nehmen

3. Shop synchronisieren #

Nach der Konfiguration des Moduls müssen Sie einfach Ihren Shop synchronisieren.

1. Gehen Sie zu my.clerk.io Data -> Configuration -> Wenn Sie zur Eingabe der URL aufgefordert werden, geben Sie folgendes URL-Format ein: https://{{accountName}}.myvtex.com/_v/integration-vtex/clerk-feed/{{bindingId}} und klicken Sie unten links auf der Seite auf Speichern.

2. Klicken Sie auf „Start new data sync“. Diese Feed-URL ist ausschließlich für die Nutzung von ClerkIO bestimmt.

Wenn Sie den Feed Ihres Shops validieren möchten, verwenden Sie stattdessen diesen Endpunkt: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}} dieser Endpunkt erfordert eine VTEX-Authentifizierung.

Clerk.io importiert nun Ihre products, categories and sales. Wenn der Vorgang abgeschlossen ist, ist Ihr Shop verbunden. Gut gemacht!