> For the complete documentation index, see [llms.txt](https://smartypilot.gitbook.io/smartypilot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smartypilot.gitbook.io/smartypilot/ricerca/showcase.md).

# Showcase

La funzionalità **Showcase** consente di visualizzare prodotti suggeriti all'utente prima che venga effettuata una ricerca attiva. Questa funzionalità è ideale per aumentare la visibilità di determinati articoli e migliorare l'esperienza d'acquisto, mostrando agli utenti prodotti rilevanti o popolari direttamente nella finestra di ricerca.

## Caratteristiche Principali

* **Regole di selezione dei prodotti**:\
  I prodotti di tendenza possono essere selezionati in base a:
  * **Prodotti più cliccati**: Mostra i prodotti che hanno ricevuto il maggior numero di click dagli utenti nella ricerca, con possibilità di filtrare per periodo.
  * **Regole basate su ricerca o filtro**: Consente di configurare parametri specifici per selezionare i prodotti da mostrare, ad esempio un termine di ricerca o un filtro su un attributo del prodotto.
  * **Selezione manuale**: Scegli tu esattamente quali prodotti mostrare e in che ordine.
* **Numero di prodotti visualizzati**:\
  Configura quanti prodotti mostrare (massimo 30). Non disponibile in modalità selezione manuale.

## Configurazione dei Prodotti di Tendenza

È possibile configurare lo Showcase nel back-office di Smartypilot nella sezione **Showcase**.

{% hint style="warning" %}
Lo Showcase richiede un catalogo già caricato: finché non hai eseguito almeno una [sincronizzazione del feed prodotti](/smartypilot/ricerca/sincro-prodotti.md), al posto del modulo di configurazione trovi un avviso con il link alla sincronizzazione.
{% endhint %}

<figure><img src="/files/yiHcfLDZdID3fLK2wKEE" alt=""><figcaption><p>Le impostazioni dello Showcase e i prodotti visualizzati</p></figcaption></figure>

### Passaggi per la configurazione

1. **Layout**:\
   Scegli come visualizzare i prodotti nella finestra di ricerca:
   * **Griglia**: i prodotti vengono mostrati in una griglia classica.
   * **Slideshow**: i prodotti scorrono orizzontalmente con frecce di navigazione. Selezionando questa modalità appaiono le opzioni aggiuntive:
     * **Prodotti per pagina (desktop)**: quanti prodotti mostrare contemporaneamente su desktop (3, 4, 5, 6 o Auto). Su mobile sono sempre mostrati 2 prodotti per pagina.
     * **Auto-scroll**: se attivo, lo slideshow avanza automaticamente senza che l'utente clicchi le frecce. Puoi impostare l'intervallo in millisecondi tra uno scorrimento e l'altro (es. 3000 = 3 secondi).
2. **Titolo** (obbligatorio, massimo 200 caratteri):\
   Il titolo da mostrare sopra i prodotti nella finestra di ricerca (es. "I più visti" o "Suggeriti per te").
3. **Tipo di regola da applicare**:\
   Scegli come selezionare i prodotti di tendenza:
   * **Prodotti più cliccati**: Mostra i prodotti che gli utenti hanno cliccato più spesso nei risultati di ricerca. Dopo aver selezionato questa opzione appare il campo **Periodo di riferimento** (vedi punto 4).
   * **Sulla base di una ricerca**: Configura parametri personalizzati, come:
     * **Termine di ricerca predefinito**: Inserisci una parola chiave per mostrare prodotti correlati. Questo valore è facoltativo e se viene indicato sarà usato in combinazione con i campi filtro.
     * **Nome campo**: Seleziona un campo specifico (es. `calc_ImportoSconto`) per restringere i risultati. Sotto compare il tipo di valore adatto al campo scelto: una tendina **Valore** per i campi di testo, le caselle **Minimo** e **Massimo** per i campi numerici, oppure **Vero / Falso** per i campi Sì/No.
   * **Scegli i prodotti singolarmente**: Seleziona manualmente i prodotti da mostrare. Puoi cercare i prodotti per nome o codice e aggiungerli alla lista uno per uno. Con questa opzione hai il pieno controllo su quali articoli vengono visualizzati e nel quale ordine.
4. **Periodo di riferimento** (solo per "Prodotti più cliccati"):\
   Filtra i click in base a un arco temporale. Le opzioni disponibili sono:

   * **Da sempre**: considera tutti i click registrati da quando Smartypilot è attivo.
   * **Ultima settimana**: considera solo i click degli ultimi 7 giorni.
   * **Ultimi 15 giorni**
   * **Ultimo mese**: considera solo i click degli ultimi 30 giorni.
   * **Ultimi 3 mesi**

   La lista si aggiorna automaticamente nel tempo: i click più vecchi del periodo impostato escono dalla selezione, quelli nuovi entrano.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Se al momento hai pochi prodotti con click registrati, potresti vedere meno prodotti del numero massimo impostato. Questo è normale: man mano che più utenti interagiscono con la ricerca, la lista si arricchisce automaticamente.</p></div>
5. **Numero di prodotti da visualizzare**:\
   Inserisci il numero massimo di prodotti da visualizzare nella finestra di ricerca (massimo 30).\
   Questo campo non è disponibile nella modalità **Scegli i prodotti singolarmente**.
6. **Escludi prodotti non disponibili** (solo per "Prodotti più cliccati" e "Sulla base di una ricerca"):\
   Se attivi questa opzione, i prodotti esauriti o non disponibili vengono esclusi automaticamente dallo Showcase. Utile per evitare di mostrare ai clienti articoli che non possono acquistare.
7. **Contenuto HTML avanzato** (opzionale):\
   Puoi inserire del contenuto HTML personalizzato da mostrare nella sezione dei prodotti di tendenza (es. un'immagine promozionale, un testo di benvenuto o un banner). Questo contenuto viene visualizzato insieme ai prodotti.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Non modificare questo campo se non sai esattamente cosa stai facendo.</p></div>
8. **Salvataggio delle configurazioni**:\
   Una volta configurata la regola, premi **Salva** per applicare le modifiche.

### Anteprima: Prodotti visualizzati

Nella colonna di destra c'è il pannello **Prodotti visualizzati**, che mostra quali articoli comparirebbero davvero con la configurazione attuale. Dopo aver cambiato una regola clicca **Aggiorna visualizzazione prodotti** per ricalcolare l'anteprima: è il modo più rapido per verificare una regola prima di salvarla.

### Riordinare i prodotti selezionati manualmente

Nella modalità **Scegli i prodotti singolarmente**, dopo aver aggiunto i prodotti puoi cambiarne l'ordine di visualizzazione trascinandoli con il mouse. Ogni card prodotto mostra un'icona con tre linee orizzontali in alto a sinistra: clicca e tieni premuto su quell'icona, poi trascina il prodotto nella posizione desiderata. L'ordine viene aggiornato automaticamente al salvataggio.

***

## Ricerche popolari

Nella stessa pagina Showcase trovi la card **Ricerche popolari**: le parole chiave che i tuoi clienti cercano con maggiore frequenza, mostrate come suggerimenti rapidi prima che l'utente inizi a digitare.

### Come abilitare le ricerche popolari

1. Attiva l'opzione **Visualizza termini più ricercati**.
2. Scegli il **Periodo di riferimento** per calcolare quali termini mostrare (Da sempre, Ultima settimana, Ultimi 15 giorni, Ultimo mese, Ultimi 3 mesi).
3. Imposta il **Numero di termini da mostrare** (da 1 a 15).
4. Se vuoi mostrare una miniatura del prodotto più rilevante accanto a ogni termine, attiva l'opzione **Mostra miniatura prodotto accanto a ogni termine**.
5. Clicca **Salva**.

{% hint style="info" %}
I termini più ricercati vengono mostrati ai clienti come elementi cliccabili nella finestra di ricerca, sia su desktop (in una colonna laterale accanto ai prodotti) sia su mobile (in una striscia orizzontale scorrevole). Cliccando su un termine il cliente avvia subito una ricerca con quella parola chiave.
{% endhint %}

***

## Suggerimenti su come usare i prodotti di tendenza

{% hint style="info" %}

### TIPS per il Marketing

* **Metti in evidenza i prodotti stagionali**:\
  Mostra prodotti correlati alla stagione attuale o a eventi speciali (es. "Offerte di San Valentino" o "Prodotti per l'estate").
* **Guida l'utente verso una categoria chiave**:\
  Configura regole per mostrare prodotti di una categoria specifica (es. "Elettronica" o "Moda") che vuoi promuovere maggiormente.
* **Evidenzia nuovi arrivi**:\
  Utilizza questa funzionalità per mostrare ai clienti le novità del tuo catalogo, anche prima che effettuino una ricerca.
  {% endhint %}

{% hint style="info" %}

### TIPS per massimizzare le vendite

* **Promuovi articoli con stock limitato**:\
  Usa i prodotti di tendenza per evidenziare articoli che sono in esaurimento, incentivando acquisti rapidi.\
  Esempio: "Solo pochi pezzi disponibili!" può essere comunicato nei risultati.
* **Spingi articoli con margine alto**:\
  Configura regole per mostrare prodotti con sconti particolari o margini elevati, aumentando così la redditività delle vendite.
  {% endhint %}

{% hint style="info" %}

### TIPS per l'esperienza utente

* **Usa il periodo recente per restare rilevante**:\
  Con la regola "Prodotti più cliccati" imposta il periodo su "Ultimo mese" o "Ultimi 3 mesi" per mostrare sempre ciò che è attualmente popolare, evitando che vecchi dati influenzino i risultati.
* **Riduci il tempo di ricerca**:\
  Offri suggerimenti utili che guidano l'utente verso articoli rilevanti, facilitando la scelta prima ancora che inserisca un termine di ricerca.
* **Rendi i risultati dinamici**:\
  Aggiorna frequentemente i prodotti di tendenza per offrire contenuti freschi e interessanti ogni volta che un utente visita il sito.
  {% endhint %}