Integrazione

Dal catalogo alla ricerca.

Tre passaggi nel pannello, poi una scelta sola: il modulo per la tua piattaforma, o due righe di JavaScript se il negozio è fatto su misura. Non serve toccare il database né spostare il catalogo.

Nel pannello

I primi tre passaggi

Alla prima registrazione parte una configurazione guidata. Sono quattro schermate e si può fermare a metà: quello che hai inserito resta.

  1. Crea lo store

    Nome, dominio e piattaforma. Il dominio serve a due cose concrete: le regole di redirect possono puntare solo agli host che dichiari, e con i controlli stretti attivi le pagine prodotto fuori da quei domini vengono rifiutate. Un negozio, uno store: indice, chiavi e impostazioni restano separati.

  2. Prendi la chiave

    Lo store nasce con una chiave pubblicabile, quella che finirà nel browser dei tuoi clienti. Ha permessi di sola ricerca sul tuo indice e nient'altro: non legge il catalogo di nessun altro, non scrive, non cancella. È fatta per stare in chiaro dentro una pagina HTML.

  3. Collega il catalogo

    Un feed CSV, XML o Google Shopping, che Efindly rilegge a intervalli e di cui aggiorna solo le righe cambiate. Oppure una spinta via API, se preferisci decidere tu quando. Per provare subito c'è un catalogo demo di dodici prodotti: si carica con un click e si cancella quando hai finito.

    Dopo il primo import lo store è ricercabile. Da qui in poi si lavora sulla qualità — sinonimi, regole, banner — che è la parte che non finisce mai.

Sul sito

Due strade, secondo come è fatto il negozio

Il risultato è lo stesso: il campo di ricerca del tuo sito comincia a rispondere con l'indice di Efindly. Cambia solo quanto codice devi scrivere — con il modulo, nessuno.

Modulo PrestaShop

PrestaShop 1.7.8, 8.x e 9.x

Scarica il modulo versione 1.4.1 · 63 KB

  1. Backoffice → Moduli → Carica un modulo, e trascina lo zip.
  2. Installa Efindly Search, poi Configura.
  3. Incolla la chiave API presa dal pannello. L'endpoint è già compilato con https://api.efindly.net/api/v1: si tocca solo se hai un'installazione tua.
  4. I selettori del campo di ricerca e del riquadro risultati hanno valori predefiniti che funzionano sui temi standard. Se il tuo tema è personalizzato, li cambi lì.

Il modulo porta anche l'export del catalogo: Efindly legge da lì, senza che tu prepari un feed a mano.

Piattaforma su misura

Qualsiasi sito HTML, qualsiasi backend

Un file JavaScript e una chiamata di avvio. Gli servono il campo di ricerca che hai già e un contenitore vuoto dove scrivere i risultati.

<script src="https://www.efindly.net/sdk/v1/search-client.js"></script>
<script>
  SearchClient.init({
    baseUrl: 'https://api.efindly.net',
    key: 'LA_TUA_CHIAVE_PUBBLICA',
    input: '#cerca',
    results: '#risultati',
    minChars: 2,
    limit: 6,
  });
</script>

Attenzione a un dettaglio che fa perdere tempo: qui baseUrl è il solo dominio, perché il percorso lo aggiunge la libreria. Nel modulo PrestaShop invece l'endpoint comprende /api/v1.

Tema, ordinamento, carrello e tracciamento dei click si configurano da lì: la libreria emette eventi DOM (efindly:search, efindly:add_to_cart) che puoi ascoltare per collegare il tuo carrello o la tua analitica.

Su Storely c'è un modulo dedicato, si installa dal negozio stesso. Per WooCommerce e Shopify non c'è ancora un modulo pronto: si passa dalla strada su misura qui sopra, che funziona ovunque. Scrivici se ti serve prima.

Domande tecniche

La chiave nel browser è un rischio?

È fatta per stare lì. Consente solo di cercare nel tuo indice: non legge cataloghi altrui, non scrive e non cancella. Le chiavi che possono modificare il catalogo sono altre e restano sul tuo server.

Devo spostare il catalogo da qualche parte?

No. Il catalogo resta dov'è: Efindly ne tiene una copia indicizzata per rispondere in millisecondi, e la riallinea a ogni import toccando solo le righe cambiate.

Quanto ci mette a rispondere?

Le ricerche si misurano in millisecondi, e il pannello te lo mostra su ogni prova. Il tempo che vede il tuo cliente dipende anche dalla rete, ma l'indice non è mai il collo di bottiglia.

Se Efindly non risponde, il sito si rompe?

No. Il modulo PrestaShop lascia partire il form come sempre, quindi la ricerca nativa del negozio resta raggiungibile. Sulla strada su misura decidi tu cosa fare nel callback di errore.

Posso provare senza toccare il sito in produzione?

Sì: nel pannello c'è un playground che interroga il tuo indice vero con la stessa chiave del browser. Si vede cosa troverebbe un cliente prima di installare qualsiasi cosa.

Quindici giorni per provarlo sul tuo catalogo.

Nessuna carta all'iscrizione. Se non fa per te, i dati restano tuoi e la configurazione non serve più a nessuno.

Inizia la prova gratuita