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

# Integrazione

La sezione **Integrazione** ti permette di configurare Smartypilot in modo che funzioni correttamente con il tuo sito eCommerce. Attraverso questi parametri, puoi collegare il feed prodotti, identificare il campo di ricerca e recuperare i codici da inserire nel tuo sito.

<figure><img src="/files/uJJvgpJ7gLcGBeQ0BDcw" alt=""><figcaption><p>La pagina Integrazione del catalogo</p></figcaption></figure>

## Campi di Configurazione

### CMS

* **Descrizione**: Seleziona il sistema di gestione dei contenuti (CMS) su cui è basato il tuo eCommerce. Smartypilot supporta vari CMS, e questa configurazione può influenzare le istruzioni per l'integrazione e le funzionalità disponibili.
* **Esempio**: PrestaShop, Shopify, WooCommerce.

### Tipo feed

* **Descrizione**: Seleziona il formato del feed prodotti che Smartypilot dovrà leggere. Il formato dipende da come il tuo eCommerce esporta i dati del catalogo.
* **Opzioni**: **Nativo di Smartypilot** (il formato descritto in [Feed prodotti](/smartypilot/cms-supportati/cms-supportati/custom/feed-prodotti.md), usato anche dai plugin ufficiali), **Google shopping in formato XML**, **Google shopping in formato CSV**. Se hai già un feed Google Shopping puoi usarlo così com'è.

### URL feed prodotti

* **Descrizione**: Inserisci l'URL completo del feed prodotti che Smartypilot utilizzerà per accedere ai dati del tuo catalogo. Questo URL deve puntare al file del feed in cui sono elencati tutti i prodotti dell'indice specifico (lingua e valuta) configurato. Assicurati che l'URL sia aggiornato e accessibile.
* **Esempio**: `https://demo.smartypilot.ai/module/smartypilot/exportcsv?lang_id=1&shop_id=1&include_prices=1`.

### ID campo di ricerca

* **Descrizione**: Inserisci l'ID o il `name` del campo di ricerca presente nel tuo sito web. Questo valore permette a Smartypilot di identificare il campo di input in cui gli utenti inseriscono le parole chiave di ricerca.
* **Esempio**: Se il campo di ricerca nel tuo sito ha `id="s"`, inserisci "s" in questo campo.

{% hint style="info" %}
Questo campo e il **Selettore icona di ricerca** compaiono solo se il modulo Ricerca è attivo sul tuo piano.
{% endhint %}

### Selettore icona di ricerca (opzionale)

* **Descrizione**: campo facoltativo, puoi lasciarlo vuoto. Serve nei siti in cui il campo di ricerca **non è sempre visibile** e compare solo dopo aver cliccato un'icona (ad esempio una lente d'ingrandimento). Se lo compili, la ricerca di Smartypilot si aprirà quando il cliente clicca sull'elemento che indichi, al posto del comportamento predefinito del tema del tuo sito (come l'apertura di una finestra o il cambio pagina).
* **Come si compila**: devi indicare l'elemento del tuo sito (l'icona o il pulsante) che deve aprire la ricerca. Puoi usare il suo identificativo (es. `#search-icon`), la sua classe (es. `.header-search-btn`) oppure un attributo (es. `[data-action="search"]`).

{% hint style="info" %}
Se non sai quale valore inserire, chiedi a chi ha realizzato il tuo sito: si tratta di un dettaglio tecnico del tema. Nella maggior parte dei casi questo campo può restare vuoto.
{% endhint %}

## Codice di integrazione

La card contiene il codice script da aggiungere al tuo sito per attivare il widget di ricerca. Copialo e incollalo nelle pagine del tuo eCommerce, preferibilmente prima del tag `</body>`.

La card compare quando stai modificando un indice già creato, non durante la creazione.

{% hint style="info" %}
Il codice del **Chatbot AI** è un altro, e non si trova qui: lo trovi nella pagina [Chatbot → Layout](/smartypilot/chatbot-ai/layout.md).
{% endhint %}

## Salvataggio delle Impostazioni

Dopo aver configurato tutti i campi, clicca su **Salva** per applicare le impostazioni. Una volta salvate, Smartypilot sarà integrato con il tuo sito e pronto per gestire le ricerche in base ai dati del feed prodotti e alle preferenze configurate.