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

# Impostazioni generali

Questa sezione ti consente di configurare le impostazioni generali di un indice di ricerca per il tuo eCommerce. Qui puoi impostare i dettagli relativi al nome dell'indice, i domini associati e le informazioni chiave necessarie per l'integrazione con il tuo sito. Ecco una descrizione dei principali campi configurabili.

## Cos’è un Indice in Smartypilot?

In Smartypilot, un Indice rappresenta un'unità di gestione e ricerca dei prodotti che corrisponde direttamente a un **feed prodotti specifico.** Ogni indice contiene le informazioni di un gruppo di prodotti organizzati i**n base a una lingua specifica**. Questo approccio permette di adattare e personalizzare i risultati di ricerca per i diversi mercati e localizzazioni linguistiche serviti dal tuo eCommerce.

### Indici per Lingua: Come Funzionano

Per assicurare che gli utenti visualizzino i prodotti nella lingua corretta, viene creato un indice separato per ciascuna lingua. **Ogni indice è in grado di gestire più valute**, rendendo la configurazione più semplice e flessibile. Ecco come funziona:

Se il tuo eCommerce serve clienti in Italia e Francia, sarà necessario creare un indice per ciascuna lingua, indipendentemente dalla valuta. Le valute saranno gestite direttamente all'interno dello stesso indice.

Ad esempio

* Un indice per i clienti italiani conterrà i prodotti in **lingua italiana** e supporterà **tutte le valute** offerte dal negozio (es. Euro, Dollaro).
* Un altro indice per i clienti francesi conterrà i prodotti in **lingua francese** e supporterà anch’esso **tutte le valute** disponibili nel tuo eCommerce.

In questo modo, gli utenti visualizzeranno i prodotti tradotti nella loro lingua e con prezzi aggiornati nella valuta appropriata.

### Perché creare un indice per ogni lingua?

Ogni indice ha un feed prodotti corrispondente. Questo feed contiene tutti i prodotti configurati per una lingua specifica, con prezzi in più valute.

* **Lingua:** Nel feed prodotti di ciascun indice, le descrizioni, i titoli e tutte le informazioni testuali dei prodotti sono tradotti nella lingua scelta, garantendo che gli utenti trovino i prodotti comprensibili e localizzati.
* **Prezzi in Valuta:** I prezzi dei prodotti sono configurati per supportare più valute, senza necessità di creare più indici. Ad esempio, un indice in lingua italiana conterrà prezzi in Euro, Dollari, o altre valute configurate nel sistema.

Esempio di un indice con lingua italiana:

* Prodotti descritti in italiano.
* Prezzi disponibili in Euro, Dollari e altre valute configurate nel tuo eCommerce.

### Come funziona il feed prodotti di un indice

Supponiamo che il tuo eCommerce serva diversi mercati linguistici con più valute. Ecco come potrebbe apparire una configurazione con più indici:

* **Indice 1:** Italiano (per il mercato italiano con supporto per Euro e Dollari).
* **Indice 2:** Inglese (per il mercato internazionale di lingua inglese con supporto per Euro, Dollari e altre valute).
* **Indice 3:** Francese (per il mercato francese con supporto per Euro e altre valute).

Ogni indice avrà un feed prodotti distinto in base alla lingua, con la gestione centralizzata delle valute all'interno dello stesso indice.

{% hint style="info" %}

### Esempi di Configurazioni di Indice

Supponiamo che il tuo eCommerce serva diversi mercati linguistici con più valute. Ecco come potrebbe apparire una configurazione con più indici:

* **Indice 1:** Italiano (per il mercato italiano con supporto per Euro e Dollari).
* **Indice 2:** Inglese (per il mercato internazionale di lingua inglese con supporto per Euro, Dollari e altre valute).
* **Indice 3:** Francese (per il mercato francese con supporto per Euro e altre valute).

Ogni indice avrà un feed prodotti distinto in base alla lingua, con la gestione centralizzata delle valute all'interno dello stesso indice.
{% endhint %}

### Riepilogo

In sintesi, in Smartypilot ogni indice è un contenitore unico che corrisponde a una lingua specifica, mentre la gestione delle valute avviene all'interno dello stesso indice. Questo approccio semplifica la configurazione del sistema, garantisce una maggiore coerenza tra le lingue e le valute e migliora l’esperienza utente, fornendo risultati di ricerca localizzati e accurati.

## Come gestire le impostazioni generali un indice

<figure><img src="/files/tUUU2ZspO9ew6zsb9Z4l" alt=""><figcaption><p>Le impostazioni generali di un catalogo</p></figcaption></figure>

### Nome descrittivo dell'indice

* **Descrizione**: Inserisci un nome identificativo per l'indice. Questo nome è solo per uso interno e ti aiuterà a distinguere facilmente tra diversi indici, soprattutto se gestisci più store o localizzazioni.
* **Esempio**: "Demo Store IT".

### Dominio del sito

* **Descrizione**: Specifica i domini del tuo sito eCommerce dove questo indice sarà attivo. Inserisci l'indirizzo completo del dominio, separando eventuali domini multipli con una virgola. Non includere "www" all'inizio del dominio.
* **Esempio**: "smartypilot.ai".

### ID dello Store

* **Descrizione**: L'ID dello store è un codice numerico univoco che deve essere utilizzato nelle configurazioni del tuo CMS per collegare correttamente Smartypilot al tuo store.
* **Nota**: Questo campo è preimpostato e non modificabile.

### Chiave API (per lo script)

* **Descrizione**: Un codice unico da utilizzare nello script di integrazione nel tuo sito. Questa chiave autentica la connessione tra il tuo sito e l'indice in Smartypilot.
* **Nota**: La chiave è generata automaticamente e non può essere modificata manualmente.

### Chiave CMS

* **Descrizione**: La chiave da incollare nel wizard di configurazione del plugin ufficiale Smartypilot per [PrestaShop](/smartypilot/cms-supportati/cms-supportati/prestashop.md), [OpenCart](/smartypilot/cms-supportati/cms-supportati/opencart.md) o Magento. Accanto al campo c'è un pulsante per copiarla.
* **Nota**: non condividerla pubblicamente. Il campo compare solo se il tuo store ha già una chiave generata.

### Lingua

* **Descrizione**: Seleziona la lingua predefinita per questo indice. Questa impostazione garantisce che i risultati di ricerca siano adattati alla lingua dell'utente finale.
* **Opzioni**: Italiano, Inglese, Francese, ecc.

### Valuta

* **Descrizione**: Seleziona la valuta di default associata a questo indice. La valuta scelta sarà utilizzata per visualizzare i prezzi dei prodotti nei risultati di ricerca anche se non specificata nel feed prodotti (questo è il caso di un eCommerce con una sola valuta).
* **Opzioni**: Euro, Dollaro, ecc.
