Get Started

Collegare il tuo Store #

Il primo passo per installare Clerk.io è collegare il tuo store con il 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 a my.clerk.io, la prima cosa da fare è aggiungere il tuo store:

1. Scrivi il Nome e il Dominio del tuo webshop

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

3. Clicca su Add Store.

2. Installa e configura il modulo #

1. Sulla cli vtex esegui vtex install clerkiopartnerdk.integration-vtex. Puoi confermare che l’app è ora installata eseguendo di nuovo vtex ls.

2. Accedi alla sezione Apps nella pagina admin 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 enable configuration by binding per abbinare uno Store Clerk a ciascun Binding.

Opzioni di configurazione #

Configura ogni binding VTEX con i campi sottostanti. Un binding normalmente rappresenta uno storefront, una localizzazione o un canale di vendita.

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

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

• Collect User Emails: Attiva il tracciamento delle email per gli utenti autenticati e gli iscritti alla newsletter su lo storefront.

• Sales Channel: L’ID del canale di vendita VTEX associato a questo binding. L’integrazione lo usa per restituire i prodotti e gli ordini corretti.

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

• Binding Root Path: Il percorso dello storefront del binding, senza slash iniziali o finali. Lascialo vuoto se il binding non ha un path. Ad esempio, inserisci outlet per uno storefront servito sotto /outlet/.

3. Genera i feed per prodotti, categorie e ordini facendo 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 che VtexIdclientAutCookie sia inviato come header.

La prima chiamata alla generazione del feed risponderà con un array vuoto. A seconda delle dimensioni del tuo Catalogo store il feed potrebbe impiegare un po’ di tempo per essere generato

3. Sincronizza il tuo store #

La sincronizzazione dei dati collega il tuo store VTEX a Clerk, consentendo a Clerk di accedere ai tuoi prodotti, ordini, clienti, categorie e altri dati del negozio. Questo permette a Clerk di fornire raccomandazioni personalizzate e risultati di ricerca basandosi sui dati reali del tuo store. Segui i passaggi nella Guida alla sincronizzazione dei dati per configurare la sincronizzazione dei dati.