Skip to main content
Questa guida ti accompagna nell’installazione di Kleep nel tuo negozio Shopify. Kleep offre tre funzionalità principali: una guida alle taglie intelligente (Kleep Sizing), raccomandazioni di prodotti simili (Kleep Similar Products) e una ricerca prodotti ottimizzata (Kleep Search).

Panoramica del Processo di Integrazione

Ecco cosa aspettarsi dalla firma del contratto al go-live e oltre. L’integrazione end-to-end richiede tipicamente circa 5–6 settimane.

Onboarding

1

Contratto firmato e fatturazione configurata

Una volta firmato il contratto, il tuo rappresentante Kleep avvia la fatturazione tramite GoCardless: Configura l’addebito diretto →.
2

Riunione di kickoff onboarding

Una breve chiamata con il tuo rappresentante Kleep per allinearsi su tempistiche, contatti tecnici e requisiti specifici del negozio prima che inizi l’installazione.
3

Compila il modulo di onboarding

Dopo il kickoff, ti chiederemo di condividere alcuni dettagli sulla tua azienda, fatturazione, ambienti del negozio e configurazione dei resi per poter preparare l’integrazione.Compila il nostro modulo di onboarding →Richiede circa 5 minuti. Una volta inviato, il nostro team esaminerà le tue risposte e confermerà i passi successivi entro 1 giorno lavorativo.
4

Condividi il tuo URL Shopify e il codice collaboratore

Inviaci l’indirizzo del tuo negozio (es. your-store.myshopify.com) insieme al tuo codice di richiesta collaboratore in modo che possiamo richiedere l’accesso al tuo negozio.
Più negozi Shopify? Se hai più istanze Shopify (es. regioni o brand diversi), inviaci un codice collaboratore per ogni negozio — abbiamo bisogno di un codice per negozio.
Non sai dove trovare questi? Nel tuo admin Shopify, vai su Impostazioni → Utenti e permessi — il tuo URL myshopify.com è mostrato in alto, e il Codice di richiesta collaboratore è elencato nella sezione Collaboratori. Consulta l’articolo di supporto Shopify sugli account collaboratore per maggiori dettagli.
5

Accetta la nostra richiesta di collaboratore

Ti invieremo una richiesta di accesso collaboratore dal nostro account Shopify Partner. Approvala da Impostazioni → Utenti e permessi → Collaboratori nel tuo admin Shopify.
6

Installa l'app Kleep su ogni negozio

Una volta che abbiamo accesso collaboratore, ti invieremo un link di installazione dell’app per ogni negozio. Dovrai installare l’app Kleep separatamente su ogni negozio Shopify dove vuoi abilitare Kleep.
7

Scegli il posizionamento del CTA

Rivedi le posizioni suggerite per il pulsante “Trova la mia taglia” e scegli quella che si adatta al tuo negozio: Figma posizionamento CTA →.

Installazione e test

1

Installiamo Kleep su un tema duplicato

Il nostro team duplica il tuo tema Shopify corrente e installa Kleep sul duplicato, in modo che il tuo negozio live rimanga intatto durante i test.
2

Anteprima e feedback

Ti inviamo un link di anteprima privato per testare l’integrazione end-to-end e condividere eventuali feedback o correzioni necessarie.
3

Go live

Una volta che dai il via libera, pubblichiamo Kleep sul tuo tema live.

Post-integrazione

1

Accesso alla dashboard cliente

Forniamo le credenziali al tuo team per accedere alla Dashboard Kleep, dove puoi monitorare i KPI delle prestazioni Kleep in tempo reale.
2

Fit Feedback abilitato

Abilitiamo il Fit Feedback nella tua dashboard in modo che il tuo team possa affinare le raccomandazioni di taglia di Kleep utilizzando dati di adattamento reali.

1. Funzionalità

Kleep viene integrato nel tuo negozio installando un’app personalizzata creata in precedenza. Consente di:
  1. Aggiungere il nostro CTA “Trova la mia taglia” nelle tue pagine prodotto
  2. Personalizzare la sua UI direttamente nel Theme Editor
La nostra app crea anche flussi automatizzati di Prodotti, Ordini e Dati sui Resi per rimanere aggiornata. Questi dati vengono recuperati su base giornaliera. Al momento dell’installazione, l’app crea un WebPixel utilizzato per tracciare molteplici metriche da cui deriviamo il ROI della soluzione.

2. Funzionalità Prodotti Simili

I Prodotti Simili suggerisce prodotti alternativi quando una taglia è esaurita. Questa funzionalità aumenta le conversioni offrendo alternative pertinenti ai clienti. Modalità di Visualizzazione Disponibili Configurazione Passaggio 1: Scegli la Modalità di Visualizzazione Nelle impostazioni dell’App Embed Kleep, trova l’opzione “Mostra prodotti consigliati” e seleziona la modalità desiderata dal menu a tendina. Screenshot_2025-12-09_at_11.48.24.png Selezione Modalità Prodotti Simili Aggiunta di Pulsanti Personalizzati (per le modalità personalizzate) Se hai scelto una modalità con “personalizzato”, puoi aggiungere pulsanti in posizioni specifiche:
  1. Vai al template della pagina Prodotto nel theme editor
  2. Nella sezione desiderata, clicca su Aggiungi blocco
  3. Clicca sulla scheda Apps e seleziona “Kleep Similar Button”
  4. Posiziona il blocco dove vuoi e salva
image.png Aggiungi Blocco Kleep Similar Button
I pulsanti Prodotti Simili appaiono solo quando una variante è esaurita. È normale se non li vedi su tutti i prodotti.
Aggiunta di Più Pulsanti Puoi aggiungere qualsiasi numero di pulsanti Prodotti Simili nella Pagina Prodotto. Per consentire più pulsanti, il widget deve essere impostato su uno di: custom_buttons, popup+custom, o button+custom. Per i temi OS 2.0:
  • Vai su Online Store → Customize
  • Apri il template della pagina Prodotto
  • Clicca su Aggiungi blocco → Kleep Similar Button
  • Ripeti se vuoi 2+ pulsanti nella pagina
Ogni pulsante appare automaticamente solo quando la variante selezionata è esaurita.
Kleep Search sostituisce la ricerca nativa di Shopify con una ricerca ottimizzata con filtri per taglia e raccomandazioni personalizzate. Passaggio 1: Abilita la Ricerca Personalizzata Nelle impostazioni dell’App Embed Kleep, abilita l’opzione “Abilita ricerca personalizzata”. Screenshot_2025-07-28_at_17.17.44.png Abilita Ricerca Personalizzata Passaggio 2: Accedi al Template Ricerca Nel theme editor, clicca sul menu a tendina in alto (predefinito “Home page”) e seleziona “Ricerca” dall’elenco dei template. Screenshot_2025-07-28_at_17.18.59.png Seleziona Template Ricerca Passaggio 3: Nascondi la Ricerca Nativa Nella sezione Template, nascondi o rimuovi il blocco nativo “Risultati ricerca” cliccando sull’icona occhio. Screenshot_2025-07-28_at_17.19.32.png Nascondi Ricerca Nativa Passaggio 4: Aggiungi il Blocco Kleep Search Clicca su Aggiungi sezione, poi nella scheda Apps, seleziona “Search” (kleep-dev). Screenshot_2025-07-28_at_17.19.48.png Aggiungi Blocco Kleep Search Passaggio 5: Configura le Opzioni Clicca sul blocco Search che hai aggiunto per accedere alle impostazioni: numero di risultati, visualizzazione a griglia/lista, ritardo di ricerca, ecc. Screenshot_2025-08-13_at_13.29.19.png Opzioni di Configurazione Ricerca

4. Integrazione Resi (Opzionale)

Se utilizzi una piattaforma di gestione dei resi, Kleep può integrare i dati dei resi per migliorare le raccomandazioni di taglia. Provider di Resi Supportati
  • Global-e
  • Aftership
  • Fast Return
  • Return Go
  • Altro (contattaci)
Configurazione
  1. Nella Dashboard Kleep, vai su Impostazioni → Resi
  2. Seleziona il tuo provider di resi
  3. Segui le istruzioni specifiche del provider per connettere il tuo account
Se il tuo provider non è elencato, contattaci a support@kleep.ai — possiamo configurare un’integrazione personalizzata tramite SFTP o API.

5. Tracciamento Eventi e Analisi

Kleep traccia automaticamente le interazioni degli utenti per le analisi. Assicurati che il tracciamento funzioni correttamente prima del go-live. Eventi Tracciati Verifica Per verificare che gli eventi vengano inviati correttamente:
  1. Apri gli Strumenti di Sviluppo del browser (F12)
  2. Vai alla scheda Network
  3. Filtra per “kleep”
  4. Interagisci con il pulsante guida taglie
  5. Dovresti vedere chiamate API per ogni evento
Prima del go-live: Assicurati che vengano attivati almeno 5 eventi e che i payload siano validi. Completa un percorso utente completo (clic sul pulsante → raccomandazione taglia → aggiungi al carrello) per validare l’integrazione.

6. Personalizzazione CSS

Puoi personalizzare l’aspetto degli elementi Kleep (pulsanti, popup, ricerca) aggiungendo CSS personalizzato. Dove Aggiungere il CSS Nelle impostazioni dell’App Embed Kleep, troverai un campo “Input custom CSS styles”. Incolla il tuo CSS personalizzato lì. Screenshot_2025-08-13_at_13.25.30.png Campo CSS Personalizzato Esempio di Personalizzazione

7. Ambienti Multipli

Se hai più ambienti Shopify (dev, staging, produzione), devi configurare Kleep per ciascuno. Configurazione per Ogni Ambiente
  1. Negozio di produzione — Negozio principale, completamente configurato
  2. Negozi Staging/Dev — Per i test prima di passare alla produzione
Per ogni ambiente:
  1. Installa l’app Kleep
  2. Abilita l’App Embed
  3. Contatta il tuo CSM Kleep per collegare l’ambiente al tuo account
Testa sempre le modifiche in staging prima di applicarle alla produzione.
URL Specifici per Ambiente Fornisci al tuo CSM Kleep:
  • URL di produzione: https://www.yourbrand.com
  • URL di staging: https://staging.yourbrand.com (se applicabile)
  • URL di dev: https://dev.yourbrand.com (se applicabile)

7.5 Pulsante CTA e Prodotti Simili — Guida Completa all’Installazione

Per il riferimento tecnico completo sull’installazione del pulsante CTA Kleep e della funzionalità Prodotti Simili (incluso tutto il codice Liquid, lo schema delle impostazioni e la configurazione del pulsante secondario), consulta la guida dedicata qui sotto: Pulsante CTA e Prodotti Simili — Guida Completa all’Installazione

8. Temi Vintage - Configurazione Guida Taglie

I temi vintage (chiamati anche “legacy” o creati prima di Online Store 2.0) non supportano gli App Block. L’installazione richiede modifiche al codice Liquid.
Questa sezione richiede conoscenze di sviluppo Shopify (Liquid).
Prerequisiti
  • Accesso all’editor di codice del tema (Online Store → Themes → Edit code)
  • L’App Embed Kleep deve essere abilitata nel tuo admin Shopify (Online Store → Themes → Customize → App embeds → Kleep)
Passaggio 1: Abilita l’App Embed Nel tuo admin Shopify, vai su Online Store → Themes → Customize → App embeds e attiva l’app Kleep. Passaggio 2: Chiama lo Snippet Incolla il seguente codice dove vuoi che Kleep appaia. Deve far parte del blocco Product info nella cartella snippets:
Passaggio 3: Crea lo Snippet del Pulsante Crea un nuovo file chiamato kleep-button.liquid nella tua cartella snippets. Inserisci il seguente contenuto al suo interno:
Passaggio 4: Aggiungi lo Schema Impostazioni Aggiungi le seguenti opzioni al tuo schema Impostazioni alla fine del file di sezione:
Passaggio 5: Convalida Convalida gli aggiornamenti nell’area Personalizza Tema di Shopify. Configura i visual nelle impostazioni del blocco informazioni prodotto. Opzionale: Pulsante Secondario Se vuoi aggiungere un pulsante secondario, crea un nuovo file chiamato kleep-secondary-button.liquid nella tua cartella snippets:
Incolla il seguente codice dove vuoi che Kleep appaia. Deve far parte del blocco Product info nella cartella snippets.

9. Temi Vintage - Configurazione Prodotti Simili

Passaggio 1: Crea lo Snippet Crea il file snippets/kleep-similar-button.liquid con il seguente codice:
Passaggio 2: Renderizza lo Snippet Inserisci questa riga dove vuoi che il pulsante appaia:
Posizionamento tipico: sotto i selettori di variante o vicino al modulo Aggiungi al Carrello. Passaggio 3: Abilita la Modalità Corretta Poiché i temi vintage non possono inserire blocchi OS 2.0, il widget deve utilizzare una delle seguenti:
  • custom_buttons
  • popup+custom
  • button+custom
Aggiunta di Più Pulsanti Per creare più pulsanti, posiziona semplicemente il codice dello snippet in aree diverse del template prodotto:
Ogni chiamata allo snippet crea un pulsante aggiuntivo. Ogni pulsante appare automaticamente solo quando la variante selezionata è esaurita.

10. Traduzioni (i18n)

Aggiungi le seguenti traduzioni ai tuoi file locale del tema. Inglese (en.json)
Francese (fr.json)
Italiano (it.json)
Tedesco (de.json)
Spagnolo (es.json)
Giapponese (ja.json)
Coreano (ko.json)
Portoghese (pt.json)

11. Riferimento Tecnico

Posizione CTA nella PDP La posizione è definita dai selettori DOM all’interno di KleepSDK.getConstants():
  • targetProductInfoBlockQueries — Array di selettori che puntano al contenitore principale dei dettagli del prodotto (titolo, prezzo, taglie, ecc.). Lo script scorre questi selettori e utilizza il primo trovato come punto di inserimento per il CTA o i popup.
  • targetVariantQueries — Dove si trovano le opzioni di taglia/variante. Una volta trovato il blocco informazioni prodotto, lo script cerca al suo interno gli elementi variante (come i selettori di taglia). Ogni <label> di variante (o equivalente) diventa un target per il popup CTA.
Popup vs. Pulsante (Desktop vs. Mobile) Il tipo di dispositivo viene rilevato con checkIfMobile(): Questa funzione controlla la stringa navigator.userAgent del browser rispetto a un elenco di dispositivi mobili (es. iPhone, Android, iPad).
  • Desktop: Il CTA viene visualizzato come popup al passaggio del mouse accanto alle etichette delle varianti
  • Mobile: Lo script sostituisce i popup al passaggio del mouse con un singolo pulsante, poiché le interazioni al passaggio del mouse non funzionano sui touchscreen
Configurazione Riferimento Prodotto Kleep utilizza i riferimenti prodotto per abbinare i prodotti nel catalogo. Configura come identificarli: Campo Riferimento: Dove trovare il riferimento prodotto del brand
  • Campo SKU Shopify
  • Metafield (specifica quale)
  • Tag (con prefisso, es. ref:ABC123)
Estrazione Prodotto Master: Come derivare l’ID prodotto master dagli SKU delle varianti
  • Esempio: Se gli SKU delle varianti sono ABC123-S, ABC123-M, ABC123-L, il riferimento prodotto master è ABC123
  • Regola: Prendi i primi 6 caratteri / Dividi per e prendi la prima parte / Regex personalizzato
Configura questo in Dashboard Kleep → Impostazioni → Riferimenti Prodotto. Note sulla Personalizzazione
  • Non sono previste altre varianti di posizionamento/layout oltre alla regolazione dei selettori e CSS
  • Per cambiare l’aspetto (colori, spaziatura, font, ecc.), incolla il tuo CSS nella casella “Input custom CSS styles” nelle impostazioni dell’App Embed Kleep

12. Checklist Go-Live

Prima di andare in produzione, verifica quanto segue: Visualizzazione Pulsante
  • Pulsante visibile su almeno 3 pagine prodotto
  • Pulsante funziona su desktop E mobile
  • Nessun conflitto CSS (pulsante non nascosto o disallineato)
  • Nessun problema di Cumulative Layout Shift (CLS) — il pulsante non causa salti di pagina
  • Solo temi vintage: Commit referenziato nel version control
Qualità dei Dati
  • >98% dei prodotti ha una guida taglie mappata
  • <1% delle varianti ha misure mancanti
  • 0 SKU orfani (prodotti senza mappatura di categoria)
Tracciamento
  • Tutti i 5 eventi vengono inviati correttamente
  • Percorso utente completo tracciato (pulsante → raccomandazione → carrello)
  • Payload validati
Prestazioni
  • Errori JS < 1%
  • Latenza API P95 < 500ms
  • Monitoraggio attivo
Percorso Utente
  • La guida taglie si apre correttamente
  • Le raccomandazioni vengono visualizzate correttamente
  • Aggiungi al carrello funziona dalla guida taglie
  • I prodotti simili vengono visualizzati (se abilitati)
  • Reattivo su tutti i dispositivi
Una volta verificati tutti gli elementi, notifica il tuo CSM Kleep per la validazione QA finale prima del go-live.

13. Risoluzione dei Problemi

Il pulsante non appare
  • Verifica che l’App Embed Kleep sia abilitato (attivo)
  • Assicurati di aver salvato le modifiche al tema
  • Svuota la cache del browser e ricarica la pagina
  • Controlla che il prodotto abbia varianti di taglia configurate
I Prodotti Simili non appaiono
  • Controlla che la modalità non sia impostata su “Disabilitato” nelle impostazioni
  • I pulsanti appaiono solo quando una variante è esaurita
  • Per le modalità “personalizzate”, verifica di aver aggiunto un App Block
La Ricerca non funziona
  • Verifica che “Abilita ricerca personalizzata” sia abilitato nell’App Embed
  • Assicurati di aver aggiunto il blocco Kleep Search al template Ricerca
  • Controlla che la ricerca nativa sia nascosta
Non riesco a trovare gli App Block Kleep Se non vedi i blocchi Kleep nella scheda “Apps” quando clicchi su “Aggiungi blocco”, il tuo tema è probabilmente un tema vintage. Fai riferimento alle Sezioni 11-12 per istruzioni di installazione alternative. Problemi di mappatura dati
  • Controlla che i dati del tuo prodotto contengano i campi attesi (tag, metafield, ecc.)
  • Verifica le mappature in Dashboard Kleep → Impostazioni → Mappatura Dati
  • Riesegui la scansione del prodotto per aggiornare i valori rilevati
Gli eventi non vengono inviati
  • Controlla la console del browser per errori JavaScript
  • Verifica che nessun ad-blocker o estensione per la privacy blocchi le richieste Kleep
  • Testa in modalità incognito
Contatta il Supporto Se riscontri problemi non elencati qui, contatta il team Kleep:

Grazie per aver scelto Kleep!

Il nostro team è a tua disposizione per aiutarti con l’installazione e l’ottimizzazione della tua guida taglie.--- Kleep è completamente subordinato al consenso del visitatore: lo script si carica solo dopo che il consenso è stato raccolto tramite la tua CMP, e devi condizionarne il caricamento di conseguenza. Per l’elenco completo dei tracker, i dati trattati, le finalità e le basi giuridiche, hosting, responsabili del trattamento e sicurezza, consulta Cookie, CMP & Privacy dei Dati.