Get Started

Verbinden Sie Ihren Shop #

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-Shop 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 als Erstes Ihren Shop hinzufügen:

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

2. Wählen Sie VTEX als Plattform und wählen Sie Ihre Währung.

3. Klicken Sie auf Shop hinzufügen.

2. Modul installieren und konfigurieren #

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

2. Greifen Sie auf den Abschnitt Apps in der Administrationsseite Ihres Kontos zu und suchen Sie nach dem ClerkIO Integrationsfeld. Sobald Sie es gefunden haben, klicken Sie auf das Feld. Füllen Sie die Felder wie angefordert aus. Für MultiBinding-Seiten klicken Sie auf die Aktivierung der Konfiguration, indem Sie eine Clerk-Store mit jedem Binding verknüpfen.

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 den folgenden Endpunkt aus: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

Es erfordert, dass VtexIdclientAutCookie als Header gesendet wird.

Der erste Aufruf zur Generierung des Feeds wird mit einem leeren Array antworten. Je nach Größe Ihres Shop-Katalogs kann es einige Zeit dauern, bis der Feed generiert wird.

3. Synchronisieren Sie Ihren Shop #

Nachdem Sie das Modul konfiguriert haben, müssen Sie einfach nur Ihren Shop synchronisieren.

1. Gehen Sie zu my.clerk.io Systemstatus -> Datensynchronisationseinstellungen -> Wenn Sie aufgefordert werden, die URL einzugeben, geben Sie das folgende 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 “Neue Datensynchronisation starten”. Diese Feed-URL ist ausschließlich für die Verwendung von ClerkIO.

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 die VTEX-Authentifizierung.

Clerk.io wird nun Ihre Produkte, Kategorien und Verkäufe importieren. Wenn es fertig ist, ist Ihr Shop verbunden. Gute Arbeit!