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. Dal pannello scegli i filtri visibili, la vetrina iniziale e le regole di ricerca avanzate e le altre funzioni incluse nel piano. Le ricerche del mese e il limite disponibile sono visibili nello store.

Collega anche gli ordini per misurare il fatturato.

Con l’attribuzione inclusa nel piano, i moduli PrestaShop, WooCommerce e Storely collegano i prodotti trovati nella ricerca alle righe d’ordine. Configura la chiave di scrittura nell’apposito campo del modulo: la chiave pubblica del widget serve solo per cercare e non può inviare ordini.

Il pannello mostra il valore degli ordini assistiti dalla ricerca, separato per valuta: ordini contenenti almeno un prodotto collegato a Efindly. Il valore riguarda i prodotti nell’ordine e non include la spedizione. Su un’integrazione su misura l’invio degli ordini va collegato dal server tramite API. Il riepilogo settimanale, se incluso e attivo, riporta anche questi dati quando disponibili.

Sul sito

Tre strade, secondo com'è 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 un modulo, nessuno.

Modulo PrestaShop

PrestaShop 1.7.8, 8.x e 9.x

Scarica il modulo

  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.

Plugin WooCommerce

WordPress 6.0+, PHP 7.4+, WooCommerce attivo

Scarica il plugin

  1. Bacheca → Plugin → Aggiungi nuovo → Carica plugin, e scegli lo zip.
  2. Attiva Efindly Search. Senza WooCommerce il plugin lo dice e non parte.
  3. WooCommerce → Efindly Search: endpoint, chiave API e i selettori del campo di ricerca del tuo tema.
  4. Copia l'URL di export nell'importatore Efindly.

Ogni variazione è una riga del catalogo, con prezzo, giacenza e SKU suoi: «solo disponibili» più «taglia M» risponde sulla taglia M. Nei risultati, però, le variazioni di uno stesso prodotto occupano una riga sola. La pagina WooCommerce lo racconta per esteso.

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 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.

Collega il tuo catalogo e inizia gratis.

Il piano gratuito non scade: inizi con i limiti previsti e scegli un piano superiore quando ti servono più prodotti, ricerche o funzioni.

Inizia con il piano gratuito