Get Started

Collegamento del tuo Store #

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

Dopo aver seguito questi semplici passaggi, potrai vedere 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 su 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 Platform e seleziona la tua Currency.

3. Clicca su Add 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, cliccaci sopra. Compila i campi come richiesto. Per siti MultiBinding, abilita la configurazione cliccando su enable configuration by binding per associare ogni Binding a un Clerk Store.

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

Esegui una richiesta GET al seguente 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 alla 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 del tuo store. Questo permette a Clerk di offrire raccomandazioni personalizzate e risultati di ricerca basati sui dati effettivi del tuo store. Segui i passaggi nella guida Sync Data per configurare la sincronizzazione dei dati.