Vtex

Get Started

Backend in the Clerk.io backend

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 #

Nach dem Login bei my.clerk.io 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 den Befehl vtex install clerkiopartnerdk.integration-vtex aus. Sie können bestätigen, dass die App nun installiert ist, indem Sie erneut vtex ls ausführen.

  2. Öffnen Sie den Bereich 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 Felder wie angefordert aus. Für MultiBinding-Seiten klicken Sie auf die Konfigurationsaktivierung durch Binding, um einen Clerk Store jedem Binding zuzuordnen.

Konfigurationsoptionen #

Konfigurieren Sie jedes VTEX-Binding mit den folgenden Feldern. Ein Binding steht normalerweise für einen Storefront, eine Sprache oder einen Verkaufskanal.

  • Clerk.io Public API Key: Der Public Key für den Clerk.io Store, der auf diesem Binding verwendet wird. Sie finden ihn unter my.clerk.io > Developers > API Keys.

  • Clerk.io Private API Key: Der Private Key zur Autorisierung von Clerk.io, wenn Clerk.io den Datenfeed für dieses Binding anfordert.

  • Collect User Emails: Aktiviert das Email-Tracking für angemeldete Käufer und Newsletter-Abonnenten im Storefront.

    Sie können auch die automatische Erfassung von Emails in my.clerk.io aktivieren. Öffnen Sie Ihren Store, gehen Sie zu Developers > Clerk.js Config, aktivieren Sie Collect Emails, und klicken Sie auf Save.

    Dies identifiziert Besucher; es meldet sie jedoch nicht für das Marketing an.

  • Sales Channel: Die VTEX sales-channel ID, die diesem Binding zugeordnet ist. Die Integration verwendet sie, um die richtigen Produkte und Bestellungen zurückzugeben.

  • Default Locale: Das Locale, das beim Generieren des Produktfeeds verwendet wird, z.B. en-US oder pt-BR.

  • Binding Root Path: Der Storefront-Pfad des Bindings, ohne führenden oder nachfolgenden Schrägstrich. Lassen Sie das Feld leer, wenn das Binding keinen Pfad hat. Geben Sie z.B. outlet für einen Storefront unter /outlet/ ein.

  1. Generieren Sie die Feeds für Produkte, Kategorien und Bestellungen, indem Sie eine POST-Anfrage an die folgenden Endpunkte stellen (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 ist erforderlich, dass VtexIdclientAutCookie als Header gesendet wird.

Der erste Aufruf zur Generierung des Feeds beantwortet mit einem leeren Array. Abhängig von der Größe Ihres Shop-Katalogs kann die Generierung des Feeds einige Zeit in Anspruch nehmen.

3. Shop synchronisieren #

Die Synchronisierung der Daten verbindet Ihren VTEX-Shop mit Clerk, damit Clerk auf Ihre Produkte, Bestellungen, Kunden, Kategorien und weitere Shop-Informationen zugreifen kann. Dadurch kann Clerk personalisierte Empfehlungen und Suchergebnisse auf Basis Ihrer aktuellen Shop-Daten bereitstellen. Befolgen Sie die Schritte im Sync Data guide, um die Datensynchronisation einzurichten.

Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.