> 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/badge.md).

# Badge

La funzionalità dei **badge** permette di arricchire i box dei prodotti mostrati nei risultati di ricerca con informazioni visive aggiuntive. I badge possono essere utilizzati per evidenziare caratteristiche distintive dei prodotti, come offerte speciali, spedizione gratuita, o qualsiasi altro attributo configurabile nel sistema.

{% hint style="warning" %}
**Attenzione**, ogni modifica fatta ai badge non avrà alcun effetto se non si effettua una nuova [sincronizzazione del feed prodotti](/smartypilot/ricerca/sincro-prodotti.md)!
{% endhint %}

## Caratteristiche Principali

* **Tipologie di Badge**:
  * Badge testuali: mostrano un testo personalizzabile con supporto per colori configurabili.
  * Badge con immagine: permettono di utilizzare immagini caricate da locale o tramite URL.
* **Posizionamento**: possibilità di scegliere la posizione del badge (es. sinistra, destra).
* **Personalizzazione del testo**:
  * Utilizzare un testo statico definito dall'utente.
  * Visualizzare il valore di un attributo del prodotto.
* **Gestione della visibilità temporale**: i badge possono essere configurati per essere visibili solo in un determinato intervallo di date.
* **Corrispondenza dei valori dell'attributo**: i badge vengono attivati sulla base di una corrispondenza precisa tra il valore configurato e il valore dell'attributo prodotto.

<figure><img src="/files/cwMXV5taIweKVw9BDWNT" alt=""><figcaption><p>Modifica o inserimento di un badge</p></figcaption></figure>

## Configurazione dei Badge

**Accesso alla Funzionalità**

La configurazione dei badge è disponibile nel back-office di Smartypilot nella sezione **Badge nel menù dell'indice**.

**Creazione di un Badge**

I campi si presentano in questo ordine:

1. **Badge attivo?**: in cima alla scheda, decide se il badge viene incluso nei risultati di ricerca.
2. **Intervallo di visibilità**: le date di inizio e fine per la visualizzazione del badge.
3. **Termini di ricerca (separati da virgola)** (opzionale): limita la visualizzazione del badge alle ricerche che contengono uno di quei termini. Se lasci il campo vuoto, il badge viene mostrato indipendentemente da cosa cerca l'utente.
4. **Campo prodotto** e **Tipo di corrispondenza**: seleziona l'attributo che attiva il badge e come confrontarlo:
   * **Termini esatti** — il valore dell'attributo è identico al valore configurato.
   * **Iniziano per** — il valore dell'attributo inizia con il testo configurato.
   * **Contengono** — il valore dell'attributo contiene il testo configurato in qualsiasi posizione.
5. **Valori per visualizzare il badge**: inserisci uno o più valori che, se presenti nell'attributo selezionato, attivano il badge.
   * Esempio: Per evidenziare i prodotti con spedizione gratuita, seleziona l'attributo `attr_spedizione_gratuita` e imposta il valore su `si`.
   * **Se lasci l'elenco vuoto** il badge scatta per qualsiasi valore del campo.
   * Come per lo [Score Boost](/smartypilot/ricerca/score-boost.md), se il campo scelto è numerico compaiono due caselle **Minimo** e **Massimo**; se è un campo Sì/No, una tendina **Vero / Falso**.
6. **Posizione** e **Tipo di badge**, affiancati. Il tipo ha quattro opzioni:
   * **Immagine da URL** — indichi l'indirizzo dell'immagine (dimensioni consigliate: 64x64 px).
   * **Immagine da file sul tuo computer** — carichi il file direttamente.
   * **Testo personalizzato** — scrivi tu il testo, fino a **40 caratteri**, e scegli i colori di sfondo e testo.
   * **Testo: usa il valore del campo** — il badge mostra il valore dell'attributo. Si ottiene inserendo il segnaposto `{valore}` nel testo, eventualmente insieme ad altre parole (es. `Sconto {valore}%`).

**Salvataggio e Sincronizzazione**

Una volta configurato il badge, premi **Salva**. Per applicare le modifiche, **è necessario effettuare una nuova sincronizzazione del feed prodotti**.

## Visualizzazione nei risultati di ricerca

Nei risultati di ricerca, i badge configurati verranno visualizzati accanto ai prodotti che soddisfano i criteri definiti.\
Esempio:

* Badge **"Spedizione gratuita"**: visualizzato con un'icona o testo accanto al prodotto con attributo `attr_spedizione_gratuita` impostato su `si`.

***

{% hint style="info" %}

## Uso dei badge a scopo di marketing

* **Evidenzia le offerte speciali**:\
  Usa i badge per mettere in risalto promozioni temporanee come sconti, saldi stagionali o offerte esclusive. Ad esempio, un badge "Sconto del 50%!" cattura immediatamente l'attenzione dell'utente.
* **Rafforza il brand**:\
  Inserisci badge con il logo del tuo marchio o icone personalizzate per migliorare la riconoscibilità del brand all'interno del tuo sito.
* **Crea urgenza**:\
  Badge come "Ultimi pezzi disponibili" o "Offerta valida fino a domani" possono spingere i clienti a completare l'acquisto più velocemente.
* **Comunica vantaggi esclusivi**:\
  Sfrutta badge per evidenziare benefit riservati a categorie specifiche di utenti, come "Solo per membri VIP" o "Offerta per nuovi clienti".
  {% endhint %}

{% hint style="info" %}

## Uso dei badge per aumentare le vendite

* **Promuovi prodotti di punta**:\
  Evidenzia i bestseller o i prodotti più popolari con badge come "Più venduto" o "Scelto dai clienti". Questo aiuta a costruire fiducia e incentiva l'acquisto.
* **Spingi le vendite di prodotti in stock limitato**:\
  Usa badge come "Solo 5 disponibili" per generare FOMO (fear of missing out) e aumentare la conversione.
* **Evidenzia le nuove uscite**:\
  Aggiungi badge come "Novità" o "Appena arrivato" ai nuovi prodotti per attirare l'attenzione di clienti alla ricerca di articoli aggiornati.
* **Focalizzati su categorie chiave**:\
  Utilizza badge per guidare gli utenti verso categorie strategiche, come "Ideale per regali" o "Eco-friendly". Questo aiuta a collegare il prodotto a specifiche esigenze del cliente.
  {% endhint %}

{% hint style="info" %}

## Uso dei badge per migliorare l'esperienza utente

* **Rendi le informazioni più visibili**:\
  Utilizza badge per fornire informazioni essenziali come "Spedizione gratuita", "Consegna in 24h", o "Pagamento a rate". Questo aiuta gli utenti a identificare rapidamente i vantaggi.
* **Segnala recensioni o premi**:\
  Badge come "Top Rated" o "Premiato come miglior prodotto del 2024" aumentano la fiducia del cliente e facilitano il processo decisionale.
* **Personalizza l'esperienza d'acquisto**:\
  Usa badge dinamici per segmentare l'offerta in base alle preferenze dell'utente. Ad esempio, badge come "Ideale per vegetariani" o "Consigliato per sportivi" migliorano la pertinenza delle ricerche.
* **Evita il sovraccarico visivo**:\
  Non applicare troppi badge a un singolo prodotto: seleziona solo le informazioni più rilevanti per mantenere un layout pulito e leggibile.
* **Aiuta i clienti a confrontare i prodotti**:\
  Badge come "Rapporto qualità/prezzo" o "Migliore della categoria" rendono più immediato il confronto tra articoli simili.
  {% endhint %}