Vtex

Get Started

Backend in the Clerk.io backend

Collegamento del tuo store #

Il primo passo per installare Clerk.io è collegare il tuo store al tuo account Clerk.io.

Seguendo questi semplici passaggi potrai visualizzare il tuo Demo Store, che ti offre una panoramica personale di come Clerk.io funzionerà sul tuo webshop, prima di configurare il resto del sistema.

1. Aggiungi Store #

Dopo aver effettuato l’accesso a my.clerk.io, la prima cosa da fare è aggiungere il tuo store:

  1. Inserisci il Nome e il Dominio del tuo webshop

  2. Scegli VTEX come Piattaforma e seleziona la tua Valuta.

  3. Clicca su Aggiungi Store.

2. Installa e configura il modulo #

  1. Sul vtex cli esegui vtex install clerkiopartnerdk.integration-vtex. Puoi confermare che l’app è stata installata eseguendo nuovamente vtex ls.

  2. Accedi alla sezione Apps nella pagina di amministrazione del tuo account e cerca la ClerkIO Integration box. Una volta trovata, clicca sulla box. Compila i campi come richiesto. Per i siti MultiBinding, clicca su “abilita configurazione per binding” per associare uno Store Clerk a ciascun Binding.

Opzioni di configurazione #

Configura ogni binding VTEX con i campi seguenti. Un binding normalmente rappresenta una vetrina, una lingua o un canale di vendita.

  • Clerk.io Public API Key: La Public Key per lo store Clerk.io utilizzato su questo binding. Puoi trovarla in my.clerk.io > Developers > API Keys.

  • Clerk.io Private API Key: La Private Key utilizzata per autorizzare Clerk.io quando richiede il feed dati per questo binding.

  • Collect User Emails: Abilita il tracciamento delle email per i clienti registrati e gli iscritti alla newsletter sullo store.

    Puoi anche attivare la raccolta automatica delle email su my.clerk.io. Apri il tuo Store, vai su Developers > Clerk.js Config, abilita Collect Emails e clicca su Save.

    Questo identifica i visitatori; non li iscrive al marketing.

  • Sales Channel: L’ID del sales-channel VTEX associato a questo binding. L’integrazione lo utilizza per restituire i prodotti e gli ordini corretti.

  • Default Locale: La lingua utilizzata per generare il feed prodotti, ad esempio en-US o pt-BR.

  • Binding Root Path: Il percorso root del binding, senza slash iniziali o finali. Lascia vuoto se il binding non ha percorso. Ad esempio, inserisci outlet per una vetrina servita sotto /outlet/.

  1. Genera i feed di prodotti, categorie e ordini effettuando una richiesta POST ai seguenti endpoint (sostituendo accountName, workspace e bindingID):

Esegui una richiesta GET a questo endpoint: https://app.io.vtex.com/clerkiopartnerdk.integration-vtex/v1/{{accountName}}/{{workspace}}/_v/integration-vtex/clerk-feed/{{bindingId}}

È necessario inviare VtexIdclientAutCookie come header.

La prima chiamata per la generazione del feed risponderà con un array vuoto. A seconda delle dimensioni del Catalogo del tuo store, la generazione del feed potrebbe richiedere del tempo

3. Sincronizza il tuo store #

La sincronizzazione dei dati collega il tuo store VTEX a Clerk, consentendo a Clerk di accedere a prodotti, ordini, clienti, categorie e altre informazioni dello store. Questo permette a Clerk di offrire raccomandazioni e risultati di ricerca personalizzati basati sui dati reali del tuo store. Segui i passaggi nella guida Sync Data per configurare la sincronizzazione dei dati.

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.