> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Guida all'Integrazione Shopify
**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
Una volta firmato il contratto, il tuo rappresentante Kleep avvia la fatturazione tramite GoCardless: [Configura l'addebito diretto →](https://pay.gocardless.com/BRT000352V7T67Q).
Una breve chiamata con il tuo rappresentante Kleep per allinearsi su tempistiche, contatti tecnici e requisiti specifici del negozio prima che inizi l'installazione.
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 →](https://ihu3s9tz3r8.typeform.com/to/fYQw9zJ5)**
Richiede circa 5 minuti. Una volta inviato, il nostro team esaminerà le tue risposte e confermerà i passi successivi entro 1 giorno lavorativo.
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](https://help.shopify.com/en/manual/your-account/staff-accounts/collaborator-accounts) per maggiori dettagli.
Ti invieremo una richiesta di accesso collaboratore dal nostro account Shopify Partner. Approvala da **Impostazioni → Utenti e permessi → Collaboratori** nel tuo admin Shopify.
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.
Rivedi le posizioni suggerite per il pulsante "Trova la mia taglia" e scegli quella che si adatta al tuo negozio: [Figma posizionamento CTA →](https://www.figma.com/design/DvsqgNPSjVPVPLjKV2efAY/KLEEP-CTA-POSITIONING-SUGGESTIONS?node-id=0-1\&p=f\&t=92MwlxQkzlfAYyk5-0).
### Installazione e test
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.
Ti inviamo un link di anteprima privato per testare l'integrazione end-to-end e condividere eventuali feedback o correzioni necessarie.
Una volta che dai il via libera, pubblichiamo Kleep sul tuo tema live.
### Post-integrazione
Forniamo le credenziali al tuo team per accedere alla [Dashboard Kleep](https://dashboard.kleep.ai), dove puoi monitorare i KPI delle prestazioni Kleep in tempo reale.
Abilitiamo il [Fit Feedback](/it/dashboard/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**
| Modalità | Descrizione |
| -------------------------------- | ---------------------------------------------------------------------------------- |
| **Popup (auto)** | Popup automatico al passaggio del mouse sulla taglia (desktop) / pulsante (mobile) |
| **Pulsante (auto)** | Pulsante CTA automatico vicino al carrello quando esaurito |
| **Solo pulsanti personalizzati** | Posizioni i pulsanti manualmente tramite il theme editor |
| **Popup + personalizzato** | Popup automatico + pulsanti personalizzati aggiuntivi |
| **Pulsante + personalizzato** | Pulsante automatico + pulsanti personalizzati aggiuntivi |
**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.
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
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.
***
## 3. Funzionalità Kleep Search
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"**.
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.
Seleziona Template Ricerca
**Passaggio 3: Nascondi la Ricerca Nativa**
Nella sezione Template, nascondi o rimuovi il blocco nativo **"Risultati ricerca"** cliccando sull'icona occhio.
Nascondi Ricerca Nativa
**Passaggio 4: Aggiungi il Blocco Kleep Search**
Clicca su **Aggiungi sezione**, poi nella scheda **Apps**, seleziona **"Search"** (kleep-dev).
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.
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](mailto: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**
| Evento | Descrizione |
| ------------------------ | ----------------------------------------------------- |
| `kleep_button_click` | L'utente ha cliccato il pulsante guida taglie |
| `kleep_drawer_open` | Il drawer guida taglie è stato aperto |
| `kleep_size_recommended` | È stata visualizzata una raccomandazione di taglia |
| `kleep_add_to_cart` | L'utente ha aggiunto il prodotto al carrello da Kleep |
| `kleep_similar_click` | L'utente ha cliccato su un prodotto simile |
**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ì.
Campo CSS Personalizzato
**Esempio di Personalizzazione**
```css theme={null}
.kleep-button {
all: unset;
font-style: normal;
font-size: 1.3rem;
font-weight: 400;
text-transform: none;
color: rgb(0, 0, 0);
background-color: rgb(255, 255, 255);
padding: 0;
margin: 0;
border: none;
border-radius: 0;
cursor: pointer;
display: inline-block;
position: relative;
}
```
## 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](/it/cms/cta-button)
***
## 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`:
```jsx theme={null}
{% render 'kleep-button', cms: section.settings %}
```
**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:
```jsx theme={null}
```
**Passaggio 4: Aggiungi lo Schema Impostazioni**
Aggiungi le seguenti opzioni al tuo schema Impostazioni alla fine del file di sezione:
```json theme={null}
{
"type": "header",
"content": "Button text",
"info": "If you enable this feature, the button text you enter will be replaced for all languages in your store"
},
{
"type": "checkbox",
"default": false,
"id": "custom_button_text_toggle",
"label": "Enable custom button text"
},
{
"type": "text",
"id": "custom_find_size_text",
"label": "Find my best size text",
"info": "What text will display instead of\"Find my best size\"?"
},
{
"type": "text",
"id": "custom_recommended_size_text",
"label": "Recommended size text",
"info": "What text will display instead of\"Recommended size\"?"
},
{
"type": "header",
"content": "Image"
},
{
"type": "url",
"id": "image_url",
"label": "Url Image"
},
{
"type": "range",
"id": "image_size",
"min": 0,
"max": 80,
"step": 2,
"unit": "px",
"label": "Image size (square)",
"default": 20
},
{
"type": "header",
"content": "CSS Styles"
},
{
"type": "checkbox",
"default": true,
"id": "default_font_family",
"label": "Theme font",
"info": "If checked, the css variable `--font-body-family` is used"
},
{
"type": "font_picker",
"id": "font_family",
"label": "Font Family",
"default": "helvetica_n4"
},
{
"type": "select",
"id": "text_style",
"label": "Text style",
"default": "normal",
"options": [
{ "label": "Normal", "value": "normal" },
{ "label": "Italic", "value": "italic" },
{ "label": "Oblique", "value": "oblique" }
]
},
{
"type": "select",
"id": "text_transform",
"label": "Text transformation",
"default": "none",
"options": [
{ "label": "Normal", "value": "none" },
{ "label": "Capitalize", "value": "capitalize" },
{ "label": "Uppercase", "value": "uppercase" },
{ "label": "Lowercase", "value": "lowercase" }
]
},
{
"type": "select",
"id": "text_weight",
"label": "Text weight",
"default": "400",
"options": [
{ "label": "100", "value": "100" },
{ "label": "200", "value": "200" },
{ "label": "300", "value": "300" },
{ "label": "400", "value": "400" },
{ "label": "500", "value": "500" },
{ "label": "600", "value": "600" },
{ "label": "700", "value": "700" },
{ "label": "800", "value": "800" },
{ "label": "900", "value": "900" }
]
},
{
"type": "range",
"id": "text_size",
"min": 2,
"max": 50,
"step": 2,
"unit": "px",
"label": "Font size",
"default": 16
},
{
"type": "checkbox",
"id": "text_underline",
"label": "Text underline",
"default": false
},
{
"type": "range",
"id": "text_underline_offset",
"min": 1,
"max": 20,
"step": 1,
"unit": "px",
"label": "Underline offset",
"default": 2
},
{
"type": "color",
"id": "text_color",
"label": "Button text color",
"default": "#ffffff"
},
{
"type": "color",
"id": "bg_color",
"label": "Background color",
"default": "#000000"
},
{
"type": "color",
"id": "border_color",
"label": "Border color",
"default": "#000000"
},
{
"type": "range",
"id": "border_width",
"min": 0,
"max": 8,
"step": 1,
"unit": "px",
"label": "Border width",
"default": 0
},
{
"type": "header",
"content": "Spacing"
},
{
"type": "checkbox",
"id": "center",
"label": "Center the button",
"default": false,
"info": "This will override 'Horizontal margin'"
},
{
"type": "range",
"id": "margin_y",
"min": 0,
"max": 80,
"step": 2,
"unit": "px",
"label": "Vertical margin",
"default": 0
},
{
"type": "range",
"id": "margin_x",
"min": 0,
"max": 80,
"step": 2,
"unit": "px",
"label": "Horizontal margin",
"default": 0
},
{
"type": "range",
"id": "padding_t",
"min": 0,
"max": 40,
"step": 2,
"unit": "px",
"label": "Padding top",
"default": 12
},
{
"type": "range",
"id": "padding_r",
"min": 0,
"max": 40,
"step": 2,
"unit": "px",
"label": "Padding right",
"default": 16
},
{
"type": "range",
"id": "padding_b",
"min": 0,
"max": 40,
"step": 2,
"unit": "px",
"label": "Padding bottom",
"default": 12
},
{
"type": "range",
"id": "padding_l",
"min": 0,
"max": 40,
"step": 2,
"unit": "px",
"label": "Padding left",
"default": 16
},
{
"type": "range",
"id": "border_radius",
"min": 0,
"max": 40,
"step": 2,
"unit": "px",
"label": "Border radius",
"default": 0
}
```
**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`:
```jsx theme={null}
```
Incolla il seguente codice dove vuoi che Kleep appaia. Deve far parte del blocco `Product info` nella cartella `snippets`.
```jsx theme={null}
{% render 'kleep-secondary-button', cms: section.settings %}
```
***
## 9. Temi Vintage - Configurazione Prodotti Simili
**Passaggio 1: Crea lo Snippet**
Crea il file `snippets/kleep-similar-button.liquid` con il seguente codice:
```jsx theme={null}
{% assign cms = block.settings %}
{% assign domain = shop.domain %}
{% assign translated_similar = '' %}
{% assign translated_similar_missing = true %}
{%- assign domain_key = domain | prepend: 'www.' | append: '.recommended' -%}
{% assign raw_domain_similar = domain_key | t %}
{% unless raw_domain_similar contains 'Translation missing'
or raw_domain_similar contains domain
%}
{% assign translated_similar = raw_domain_similar %}
{% assign translated_similar_missing = false %}
{% endunless %}
{%- if translated_similar_missing -%}
{% assign raw_global_similar = 'kleep.recommended.text.btn' | t %}
{% unless raw_global_similar contains 'Translation missing' %}
{% assign translated_similar = raw_global_similar %}
{% assign translated_similar_missing = false %}
{% endunless %}
{%- endif %}
```
**Passaggio 2: Renderizza lo Snippet**
Inserisci questa riga dove vuoi che il pulsante appaia:
```jsx theme={null}
{% render 'kleep-similar-button' %}
```
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:
```jsx theme={null}
{% render 'kleep-similar-button' %}
```
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`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "Find my ideal size",
"with_hash": "Ideal size"
}
},
"recommended": {
"text": {
"btn": "View similar",
"hint": "Size unavailable",
"link": "See similar products"
}
},
"search": {
"text": {
"inputPlaceholder": "Search...",
"productsBlockTitle": "Products",
"clearButton": "Clear"
}
},
"searchPage": {
"text": {
"header": "search results",
"query": "Results for",
"submit": "Search",
"input": "Search the store",
"viewProduct": "View product"
}
}
}
}
```
**Francese (`fr.json`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "Trouver ma taille idéale",
"with_hash": "Taille idéale"
}
},
"recommended": {
"text": {
"btn": "Voir similaire",
"hint": "Taille indisponible",
"link": "Voir des produits similaires"
}
},
"search": {
"text": {
"inputPlaceholder": "Recherche...",
"productsBlockTitle": "Produits",
"clearButton": "Effacer"
}
},
"searchPage": {
"text": {
"header": "résultats de la recherche",
"query": "Résultats pour",
"submit": "Recherche",
"input": "Rechercher dans la boutique",
"viewProduct": "Voir le produit"
}
}
}
}
```
**Italiano (`it.json`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "Trova la mia taglia ideale",
"with_hash": "Taglia ideale"
}
},
"recommended": {
"text": {
"btn": "Visualizza simili",
"hint": "Taglia non disponibile",
"link": "Visualizza prodotti simili"
}
},
"search": {
"text": {
"inputPlaceholder": "Cerca...",
"productsBlockTitle": "Prodotti",
"clearButton": "Cancella"
}
},
"searchPage": {
"text": {
"header": "risultati della ricerca",
"query": "Risultati per",
"submit": "Cerca",
"input": "Cerca nel negozio",
"viewProduct": "Visualizza prodotto"
}
}
}
}
```
**Tedesco (`de.json`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "Finde meine ideale Größe",
"with_hash": "Ideale Größe"
}
},
"recommended": {
"text": {
"btn": "Ähnliche Ansicht",
"hint": "Größe nicht verfügbar",
"link": "Ähnliche Produkte ansehen"
}
},
"search": {
"text": {
"inputPlaceholder": "Suchen...",
"productsBlockTitle": "Produkte",
"clearButton": "Klar"
}
},
"searchPage": {
"text": {
"header": "Suchergebnisse",
"query": "Ergebnisse für",
"submit": "Suchen",
"input": "Durchsuchen Sie den Shop",
"viewProduct": "Produkt ansehen"
}
}
}
}
```
**Spagnolo (`es.json`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "Encontrar mi talla ideal",
"with_hash": "Talla ideal"
}
},
"recommended": {
"text": {
"btn": "Ver similares",
"hint": "Talla no disponible",
"link": "Ver productos similares"
}
},
"search": {
"text": {
"inputPlaceholder": "Buscar...",
"productsBlockTitle": "Productos",
"clearButton": "Borrar"
}
},
"searchPage": {
"text": {
"header": "resultados de búsqueda",
"query": "Resultados para",
"submit": "Buscar",
"input": "Buscar en la tienda",
"viewProduct": "Ver producto"
}
}
}
}
```
**Giapponese (`ja.json`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "自分に合うサイズを探す",
"with_hash": "好みのサイズ"
}
},
"recommended": {
"text": {
"btn": "類似商品を見る",
"hint": "サイズがありません",
"link": "類似商品を見る"
}
},
"search": {
"text": {
"inputPlaceholder": "検索...",
"productsBlockTitle": "商品",
"clearButton": "クリア"
}
},
"searchPage": {
"text": {
"header": "検索結果",
"query": "検索結果",
"submit": "検索",
"input": "ストアを検索",
"viewProduct": "商品を見る"
}
}
}
}
```
**Coreano (`ko.json`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "내 이상적인 사이즈 찾기",
"with_hash": "추천 사이즈"
}
},
"recommended": {
"text": {
"btn": "유사한 상품 보기",
"hint": "사용 불가",
"link": "유사한 상품 보기"
}
},
"search": {
"text": {
"inputPlaceholder": "검색...",
"productsBlockTitle": "상품",
"clearButton": "지우기"
}
},
"searchPage": {
"text": {
"header": "검색 결과",
"query": "다음에 대한 결과",
"submit": "검색",
"input": "매장 검색",
"viewProduct": "상품 보기"
}
}
}
}
```
**Portoghese (`pt.json`)**
```json theme={null}
{
"kleep": {
"button": {
"text": {
"without_hash": "Encontrar meu tamanho ideal",
"with_hash": "Tamanho recomendado"
}
},
"recommended": {
"text": {
"btn": "Ver similar",
"hint": "Tamanho indisponível",
"link": "Ver produtos similares"
}
},
"search": {
"text": {
"inputPlaceholder": "Pesquisar...",
"productsBlockTitle": "Produtos",
"clearButton": "Limpar"
}
},
"searchPage": {
"text": {
"header": "resultados da pesquisa",
"query": "Resultados para",
"submit": "Pesquisar",
"input": "Pesquisar na loja",
"viewProduct": "Ver produto"
}
}
}
}
```
***
## 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 `
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
Aggiungi Blocco Kleep Similar Button
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.
Seleziona Template Ricerca
**Passaggio 3: Nascondi la Ricerca Nativa**
Nella sezione Template, nascondi o rimuovi il blocco nativo **"Risultati ricerca"** cliccando sull'icona occhio.
Nascondi Ricerca Nativa
**Passaggio 4: Aggiungi il Blocco Kleep Search**
Clicca su **Aggiungi sezione**, poi nella scheda **Apps**, seleziona **"Search"** (kleep-dev).
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.
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
Campo CSS Personalizzato
**Esempio di Personalizzazione**