Integra un centro di ricerca nel tuo sito web
Usa l’Embed code generato quando il centro di ricerca deve comparire all’interno di una pagina che gestisci tu. L’integrazione richiede il runtime di Seekdown, un contenitore e l’ID srch-… del centro di ricerca.
Aggiungi l’integrazione pubblica
La struttura documentata è:
<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>
<div id="seekdown-assistant-root"></div>
<script>
document.addEventListener('DOMContentLoaded', function () {
if (window.skdwn && window.skdwn.startAssistant) {
skdwn.startAssistant({
assistantId: 'srch-your-search-center-id',
accessToken: ''
});
}
});
</script>Sostituisci l’ID di esempio con il valore dello snippet generato per il tuo centro di ricerca. Un token di accesso vuoto è adatto solo a un centro di ricerca pubblico con autenticazione None.
Posizionalo con criterio
Aggiungi il contenitore nel punto in cui deve comparire l’esperienza di ricerca. Lascia alla pagina una larghezza sufficiente per le schede dei risultati e verifica l’altezza dopo una risposta breve e una lunga.
Non aggiungere due volte lo stesso ID di contenitore nella stessa pagina. Il runtime punta a #seekdown-assistant-root.
Verifica l’implementazione
| Input o azione | Risultato atteso | Come verificarlo |
|---|---|---|
| Carica la pagina | L’interfaccia di ricerca compare nel contenitore | Controlla la console del browser per eventuali errori di script |
| Scegli un suggerimento | La query viene eseguita | Conferma il testo selezionato e il risultato |
| Fai una domanda nota | Compaiono la risposta e i documenti corretti | Confronta con la fonte attesa |
| Apri una scheda fonte | Si apre la pagina originale | Controlla la destinazione e il testo di supporto |
| Ridimensiona la pagina | L’interfaccia resta utilizzabile | Prova viewport stretti e ampi |
Diagnostica un’integrazione vuota
Controlla in quest’ordine l’URL del runtime, l’ID del contenitore, l’ID del centro di ricerca e la chiamata di inizializzazione. Per un centro di ricerca privato, controlla anche il token di accesso e gli Allowed origins.
Usa lo snippet copiato invece di ricostruire gli ID da un URL pubblico. Se l’accesso anonimo non è adatto, configura un centro di ricerca privato prima di pubblicare l’integrazione.