AI-zoekbalk

Overzicht

De AI-zoekbalk is een zelfstandige zoekwidget voor uw website. Bezoekers typen in hun eigen woorden en passende resultaten verschijnen onder de balk zodra ze pauzeren: producten uit uw realtime gegevensfeed als kaarten met afbeelding en prijs, en pagina's uit uw kennisbank met een titel, een kort voorbeeld en een link. Omdat er op betekenis wordt gezocht en niet alleen op exacte trefwoorden, vindt een bezoeker die een omschrijving typt toch het juiste item.

Hij gebruikt dezelfde kennisbank als uw chatbot, dus er is niets extra's te indexeren of te onderhouden. De twee widgets zijn onafhankelijk: gebruik alleen de zoekbalk, alleen de chatwidget, of beide samen op dezelfde pagina's.

Toevoegen aan uw website

De AI-zoekbalk vereist het Standard-abonnement of hoger. Bij een lager abonnement verschijnt de balk wel op uw site, maar geeft hij nooit resultaten. Controleer dus eerst uw abonnement als er niets gebeurt.

Uw widget-ID staat op de pagina AI-zoekbalk in uw dashboard.

Het eenvoudigst: vervang het zoekvak dat u al heeft

Heeft uw site al een zoekfunctie - de zoekfunctie van een Shopify-thema, een WordPress-zoekformulier of uw eigen - dan hoeft u niets te plaatsen of uw thema te bewerken. Voeg data-replace toe aan de scripttag: de widget vindt uw huidige zoekformulier, verbergt het en verschijnt precies op die plek:

Dit script mag overal op de pagina staan, dus elke plugin die code aan de header of footer toevoegt volstaat. Op Enter drukken zonder een resultaat te kiezen opent nog steeds uw oude resultatenpagina, dus niets wat uw bezoekers kennen stopt met werken. Kiest de automatische detectie bij een ongebruikelijk thema het verkeerde element, geef dan een CSS-selector in plaats van auto, bijvoorbeeld data-replace=".header-search". Komt er niets overeen, dan laat de widget uw pagina met rust.

Zelf plaatsen

Heeft u nog geen zoekbalk, of wilt u hem op een specifieke plek, plak dan beide regels waar de balk moet komen - bijvoorbeeld in de header naast uw logo. De balk vult de breedte van het element waarin u hem plaatst, wat meestal betekent dat u een themabestand bewerkt.

Als iets niet werkt

• Er verschijnt helemaal geen balk. Controleer of de widget-ID in het script overeenkomt met die op de pagina AI-zoekbalk en of de code echt op de gepubliceerde pagina staat en niet alleen in een concept of voorbeeld.
• De balk verschijnt maar geeft nooit resultaten. Bijna altijd ligt het aan het abonnement: zoeken werkt vanaf Standard. Hetzelfde ziet u wanneer uw maandelijkse limiet aan AI-antwoorden op is.
• U krijgt pagina s maar geen producten. Producten komen uit een Real-Time Data Feed. Koppel er een op de pagina AI-zoekbalk en controleer of het vinkje voor die bron aanstaat.
• U krijgt helemaal niets, bij geen enkele zoekopdracht. Uw kennisbank is mogelijk nog leeg. Crawl eerst uw website of voeg inhoud toe in het dashboard en probeer het opnieuw.
• data-replace heeft uw zoekvak niet gevonden. Sommige thema s verbergen de zoekfunctie achter een knop of pop-up. Geef in plaats van auto een CSS-selector voor het gewenste element, en bekijk de pagina in een normaal browservenster in plaats van de thema-editor.

Zoekbronnen

Twee selectievakjes op de pagina AI-zoekbalk in uw dashboard bepalen wat de zoekfunctie mag gebruiken: websitepagina's (gecrawlde pagina's en toegevoegde URL's) en uw realtime gegevensfeed. Beide staan standaard aan. De feed is niet beperkt tot producten - alles wat u daar indexeert, zoals artikelen of advertenties, kan als resultaat verschijnen. Een wijziging is direct actief op uw site.

Productresultaten vereisen een verbonden datafeed. Beide soorten werken: de Realtime datafeed vanaf het Standard-abonnement en Realtime datafeed Max op Pro. Zonder feed werkt de zoekbalk gewoon door, hij geeft dan alleen uw websitepagina's terug, en de dashboardpagina markeert de feed als niet verbonden zodat u weet waarom er geen producten verschijnen.

Zoekstatistieken

De pagina AI-zoekbalk in uw dashboard toont de zoekopdrachten van de afgelopen 30 dagen: hoeveel er zijn uitgevoerd, hoeveel er niets vonden en hoe vaak een bezoeker een resultaat opende. Twee tabellen tonen uw meest voorkomende zoekopdrachten en de zoekopdrachten zonder resultaat. De tweede tabel is de nuttige, want die vertelt u precies wat bezoekers verwachten en niet kunnen vinden.

Vastleggen staat standaard aan en u kunt het uitzetten met één vinkje op dezelfde pagina. Staat het uit, dan wordt er geen enkele zoektekst opgeslagen en worden de tabellen niet meer bijgewerkt, terwijl het zoeken zelf precies zo blijft werken als eerst.

Zoekopdrachten die u zelf op de dashboardpagina uitvoert, tellen nooit mee. Websites met de Nul-bewaarmodus slaan helemaal geen zoektekst op, en als u een bewaarbeleid instelt, worden zoekgegevens volgens hetzelfde schema verwijderd als uw gesprekken.

Hoe de resultaten eruitzien

Twee instellingen op de AI Search Bar-pagina in je dashboard veranderen hoe de balk en de resultaten eruitzien. Beide worden meteen opgeslagen en geen van beide vereist een codewijziging.

Detail van productresultaten

Onder elke productnaam kan de balk één regel beschrijving uit je datafeed tonen. Of dat helpt hangt volledig af van wat je feed bevat. Een reisfeed die de reisduur en de resterende plaatsen noemt is het tonen waard. Een feed met een lijst kenmerken leest daarentegen als een database-uitdraai.

Jij kiest dus: alleen de naam, één regel of twee regels. Eén regel is de standaard en past bij de meeste feeds, omdat het genoeg is om twee vergelijkbare producten te onderscheiden zonder de lijst vol te maken. Dit geldt alleen voor productresultaten - een paginaresultaat toont altijd de tekst die overeenkwam met de zoekopdracht van de bezoeker.

Grootte van de balk

De balk heeft drie hoogtes: compact op 38 pixels voor een smalle header, de standaard 44 pixels, en groot op 52 pixels voor een pagina rond zoeken. De tekstgrootte verandert mee.

De breedte bepalen wij nooit. De balk vult altijd het element waarin je hem plaatst, dus de breedte regel je met je eigen opmaak. Het resultatenpaneel past zich automatisch aan de balk aan.

Kopieer je invoegcode opnieuw nadat je de grootte hebt gewijzigd. De nieuwe code bevat de grootte, dus de balk klopt meteen bij het laden van de pagina. Kopieer je hem niet opnieuw, dan past de balk zich alsnog aan, maar pas na de eerste zoekopdracht.

Als een zoekopdracht niets vindt

Staat uw chatwidget op dezelfde pagina, dan biedt de zoekbalk aan om de vraag door te geven aan uw assistent zodra een zoekopdracht geen resultaten oplevert. De bezoeker houdt zijn vraag en komt in de chat terecht met die vraag al ingevuld, zo wordt een doodlopend spoor een gesprek. Deze optie verschijnt alleen als de chatwidget aanwezig is.

Opties

De zoekbalk gebruikt automatisch de browsertaal van uw bezoeker voor de tijdelijke aanduiding, de resultaatkoppen en de laadtekst. Stel deze alleen in als u uw eigen tekst wilt gebruiken.

De twee kopjes kunnen ook worden hernoemd op de pagina AI-zoekbalk in uw dashboard, zonder codewijziging. Dat is eenvoudiger als uw feed artikelen of advertenties bevat in plaats van producten. Een attribuut op de scripttag gaat nog steeds voor op de dashboardinstelling.

Alle attributen zijn optioneel en horen op de scripttag:

• data-placeholder="Search products..." - tekst die in de lege zoekbalk wordt getoond
• data-accent="#0a7d4f" - focus- en accentkleur, passend bij uw merk
• data-max-results="8" - hoeveel resultaten worden getoond, 1 tot 20
• data-new-tab="true" - resultaten openen in een nieuw browsertabblad
• data-size="sm" - hoogte van de balk: sm, md of lg. Gaat boven de grootte die je in je dashboard hebt ingesteld
• data-label-products="Products" - kop boven feedresultaten, in uw taal - bijvoorbeeld Artikelen als uw feed artikelen bevat
• data-label-pages="Pages" - kop boven paginaresultaten, in uw taal
• data-label-empty="No results found" - bericht wanneer er niets overeenkomt
• data-label-searching="Searching..." - tekst die wordt getoond terwijl de resultaten laden
• data-label-ask-ai="Ask our assistant" - formulering van de optie die een zoekopdracht zonder resultaat doorgeeft aan uw chatbot
• data-target=".my-container" - toont de balk in dit element in plaats van in de standaardcontainer
• data-replace="auto" - vervangt de zoekbalk die uw thema al heeft, hierboven beschreven

Gebruik en facturering

Elke zoekopdracht van een bezoeker gebruikt 1 AI-antwoord van uw maandelijkse abonnementslimiet - dezelfde limiet die uw chatbotantwoorden gebruiken. Een zoekopdracht wordt uitgevoerd wanneer de bezoeker stopt met typen, niet bij elke letter. Zoekopdrachten die u op de pagina AI-zoekbalk in uw dashboard uitvoert, tellen niet mee. Wanneer uw maandlimiet is bereikt, toont de zoekbalk simpelweg geen resultaten totdat de limiet wordt gereset.

Goed om te weten

• Bezoekers kunnen in elke taal zoeken, ook als uw inhoud in een andere taal is geschreven.
• Typefouten en halve woorden vinden nog steeds het juiste, dus een zoekopdracht naar jaket vindt uw jassen.
• Productprijzen worden getoond met uw valutasymbool, overgenomen uit de valuta in uw feed.
• Dezelfde pagina in meerdere talen verschijnt één keer - de versie die overeenkomt met de zoektaal wint.
• Resultaten openen echte pagina's op uw site, dus de zoekbalk werkt ook als navigatie.
• De widget is één klein script zonder afhankelijkheden en vertraagt uw pagina niet.
• Toetsenbordbediening werkt direct: pijltjestoetsen om te navigeren, Enter om te openen, Escape om te sluiten.