Site search: vragen en begrippen

Veelgestelde vragen en problemen oplossen

Ik zie niets op mijn site

Loop deze punten langs, in deze volgorde:

1. Staat de module in testmodus? Dan zie je hem alleen in een browser met de debugger aan. Zie de debugger.
2. Staat het embed-script op de pagina? De debugger zegt het, of kijk onder Het embed-script.
3. Staat je domein in de lijst onder Beheer → Setup? Zo niet, dan krijgt je site geen resultaten.
4. Klopt de CSS-selector onder Instellingen → Installatie? Dit is de meest voorkomende oorzaak. De debugger laat op het tabblad Site search zien of het zoekveld gevonden is.
5. Is de index gebouwd? Op Overzicht moet Gezond staan, met een aantal documenten groter dan nul.

De overlay opent pas als ik typ, niet als ik in het zoekveld klik

Open de overlay bij focus werkt alleen als het startscherm aan staat (Indeling → Startscherm). Zonder startscherm is er niets te tonen voordat er iets getypt is.

De oude autocomplete van mijn shop verschijnt over de overlay

Zet de selector van die autocomplete onder Instellingen → Installatie → Verberg deze elementen. Voor de standaard autocomplete van je shopsysteem en voor veelgebruikte zoekextensies en zoekdiensten van derden staan knoppen die de gebruikelijke selectors toevoegen. In de debugger zie je hoeveel elementen elke selector op de pagina raakt.

Hij vindt mijn artikelnummer niet

Zoek het nummer onder Overzicht → Probeer een zoekopdracht. Staat het product er niet in, dan:

• is het product niet geïmporteerd, of
• staat het niet online (met Alleen producten die online staan aan), of
• is het een kind van een configureerbaar product (met Verberg de kinderen aan), of
• valt het onder een uitsluiting bij Nooit in zoekresultaten.

Staat het er wel, maar vindt je site het niet? Controleer dan of het nummer in het veld SKU, referentie of EAN staat. Die drie worden altijd exact doorzocht.

Waarom staat product X bovenaan?

Probeer een zoekopdracht toont per resultaat de boostregels die meededen; klik op een product voor Waarom hier: de relevantie, het gewicht en hoe het woord gevonden werd. Meestal is het een regel met een vermenigvuldiger, of het product past gewoon beter op de zoekterm dan je denkt.

Mijn nieuwe boostregel doet niets

Boostregels gaan in bij de volgende herbouw van de index. Klik Index opnieuw opbouwen op Overzicht, of wacht tot de nachtelijke herbouw. Kijk ook naar de sterkte onder Instellingen → Hoe hard boostregels spreken: op “Alleen gelijkspel breken” merk je bijna niets van een boost. En een beperkte regel (“Top 6”) werkt alleen als de resultaten op relevantie staan.

Hoe vaak wordt de index herbouwd?

Elke nacht rond 03:30 (het precieze tijdstip staat bij Automatisch opgebouwd), en op elk moment dat jij Index opnieuw opbouwen kiest. Het tijdstip verander je via Overzicht → Automatisch opgebouwd → Wijzigen. Nieuwe en gewijzigde producten komen er tussendoor bij zodra de sync ze binnenhaalt. Is een import te groot om product voor product bij te werken, dan start Nexym zelf een volledige herbouw.

Wat gebeurt er als de zoekmachine plat ligt?

Dan zegt de overlay “Zoeken lukte even niet. Probeer het opnieuw.” Wat hij nadrukkelijk niet doet, is nul resultaten tonen. “Niets gevonden” betekent voor een bezoeker dat je het niet verkoopt, en dat is een dure boodschap voor een storing van tien minuten. Zo’n mislukte zoekopdracht telt ook niet mee, dus je cijfers blijven kloppen. Op Overzicht zie je de status van de index.

Tijdens een herbouw merk je niets: de oude index blijft antwoorden tot de nieuwe klaar is.

Mijn bezoekers zien “Zoeken is op deze website nog niet beschikbaar”

Dan wordt er niet gezocht, en dat is vrijwel altijd een instelling: het domein staat niet in je lijst onder Beheer → Setup, de module staat uit, of er is geen zoekmachine ingesteld. Alle drie zijn snel opgelost.

Ik zie uitverkochte producten in de resultaten

Zet Verberg producten die niet op voorraad zijn aan onder Weergave → Filters. Dat werkt meteen, zonder herbouw. Wil je ze liever onderaan dan weg, maak dan een boostregel in_stock is gelijk aan 0 → ×0,2.

Zie je producten waarvoor nooit voorraad is binnengekomen (“Geen voorraaddata” in de productlijst)? Die tellen als op voorraad. Zet er dan ook Ook producten zonder voorraaddata verbergen bij aan. Dat werkt na de eerstvolgende herbouw.

Hetzelfde product staat er elf keer in

Dat zijn de varianten (maten, kleuren) van één configureerbaar product. Zet Verberg de kinderen van een configureerbaar product aan op Filters en bouw de index opnieuw op.

Een klik op een product geeft een foutpagina

Controleer Productlink onder Weergave → Filters. De standaard is /{key}; een .html aan het eind laat Nexym altijd weg. Gebruikt je shop een andere vorm, pas het dan aan en bouw de index opnieuw op.

Een filter ontbreekt

Filters komen uit je data. Markeer het veld als filterbaar in je shop, PIM of ERP; na de volgende import staat het onder Weergave → Filters. Staat het er wel, controleer dan of Tonen aan staat, en of Toon de filterkolom aan staat.

De sortering “Nieuwste” of “Populair nu” sorteert niets

Nieuwste, Hoogste korting, Best beoordeeld en Populair nu werken pas na de eerstvolgende herbouw van de index. Best beoordeeld vraagt de module Reviews, en Populair nu productweergaven die je site via het embed-script doorgeeft.

De knop “In winkelwagen” opent de productpagina

Dat gebeurt bewust bij een product waarvoor de hub niet genoeg weet om het goed toe te voegen, of als het toevoegen mislukt (bijvoorbeeld net uitverkocht). Heb je de knop net aangezet? Bouw dan de index één keer opnieuw op, zodat de producten hun winkel-id hebben. Zie Producttegel.

In welke taal staat de overlay?

In de taal van de website waarop hij draait. Die haalt Nexym uit je websites onder Beheer → Setup. Meegeleverd zijn Nederlands, Engels en Duits. Je eigen teksten, zoals de tekst bij niets gevonden, blijven staan zoals je ze invulde. De woorden op een tegel (knoptekst, tekst zonder foto, leverbelofte) typ je per taal bij Look & feel → Producttegel.

Waarom zie ik mijn nieuwe zoekterm nog niet bij de suggesties?

De zoeksuggesties zijn een samenvatting van wat bezoekers de afgelopen 90 dagen zochten. Die wordt één keer per nacht opgemaakt, bij de herbouw van de index. Een term die vandaag populair wordt, staat er dus morgen bij. En een term moet minstens twee keer gezocht zijn, en iets gevonden hebben, voordat hij aan een volgende bezoeker wordt getoond.

Tikfouten, meervouden en half getypte woorden tellen mee bij de zoekterm waar ze bij horen. “Garmn”, “Garm” en “Garmin 9” worden dus geen eigen suggestie naast “Garmin”, en van “Horloge” en “Horloges” blijft de vorm over die het vaakst gezocht is. Dezelfde lijst vult Veel gezocht op het startscherm.

Telt het zoeken van mijn collega’s mee?

Niet wat je in Probeer een zoekopdracht of Voorbeeld doet. Zoekopdrachten van de adressen onder Beheer → Debugger (bijvoorbeeld je kantoor) en van browsers met de debugger aan tellen ook niet mee. Zo stel je niet af op je eigen gedrag.

Analyse is leeg

Er is in de gekozen periode nog niet gezocht, of de zoekfunctie staat nog in testmodus (zoekopdrachten van testers tellen niet). Kies een langere periode, of controleer onder Instellingen → Installatie en Toolbox of de module live staat.

Waarom wijken de cijfers af van Google Analytics?

Nexym telt een zoekopdracht pas als de bezoeker klaar is met typen, en laat bots, testers en je kantoor weg. Een bezoek is bij Nexym één browser op één dag. GA4 gebruikt eigen regels en kan ook bezoekers missen die geen toestemming gaven. Kleine verschillen zijn daarom normaal. Vergelijk vooral de ontwikkeling in de tijd.

Kan ik een A/B test starten terwijl de module in testmodus staat?

Nee. Een test verdeelt echte bezoekers, dus de module moet live staan. De A/B-testpagina (via Instellingen → Meten) zegt dat ook. Zie A/B test.

Moet ik mijn thema aanpassen?

Nee. Site search haakt met een CSS-selector in op je bestaande zoekveld en opent een eigen overlay. Je thema blijft zoals het is. Zet je de module uit, dan werkt je oude zoekfunctie weer.

Wat gebeurt er met de synoniemen uit mijn huidige zoektool?

Exporteer ze als CSV uit die tool en importeer ze onder Merchandising → Synoniemen met Importeren. Redirects gaan op dezelfde manier. Een term die al bestaat, wordt bijgewerkt in plaats van dubbel toegevoegd. Zie Importeren uit een CSV. Andersom kan niet: synoniemen, redirects en boostregels exporteren kan niet.

Hoe snel staat een prijs- of voorraadwijziging in de zoekresultaten?

Direct na de import die hem in de hub zet. Nexym werkt dan alleen de gewijzigde producten bij, binnen enkele seconden tot minuten. Hoe snel de import zelf komt, hangt af van het schema van de productimport op je koppeling (standaard elk kwartier). Verwerkt één import meer dan 200 records, dan bouwt Nexym de hele index opnieuw op. Pas je een product in Nexym zelf aan (naam, prijs, beschrijving, ook een goedgekeurde AI-tekst), dan staat dat ook binnen een minuut in de zoekresultaten. Een actieprijs die op een bepaalde dag begint of eindigt, telt vanaf de volgende verversing van dat product of de nachtelijke herbouw.

Werkt het met configureerbare producten en varianten?

Ja. De zoekfunctie toont het hoofdproduct, met de laagste variantprijs boven nul en de voorraad van alle varianten samen. Verandert de prijs of voorraad van één variant (bijvoorbeeld één maat in Magento), dan werkt Nexym het hoofdproduct bij. De varianten zelf verbergt hij (dat zet je uit op Filters). Met In winkelwagen aan kiest de bezoeker de variant op de tegel.

Zien klanten hun eigen prijs?

Nee. Iedereen ziet de gewone prijs en, als die loopt, de actieprijs uit de hub. Klantspecifieke prijzen en B2B-prijslijsten staan niet in de zoekresultaten.

Kan ik bewijzen dat het beter werkt dan mijn huidige zoekfunctie?

Ja, met de A/B test. Die verdeelt bezoekers over je oude zoekfunctie en Nexym, en stopt vanzelf zodra het verschil op je hoofdmetric 95% zeker is.

Heb ik er een cookiemelding voor nodig?

Zoeken zelf zet geen cookie. Alleen de A/B test onthoudt de groep van een bezoeker, en die volgt de toestemming voor statistieken. Personalisatie op eerdere bezoeken gebruikt alleen wat met toestemming is vastgelegd. Zie Privacy en data.

Wat kost het als ik het na de proefperiode uitzet?

Niets. Uit betekent: niets van de zoekfunctie in het script op je site, en geen kosten meer. Je synoniemen, redirects en regels blijven bewaard voor als je hem weer aanzet.

Wat kan Site search niet?

• Alleen producten. Blogartikelen, CMS-pagina’s en pdf’s worden niet doorzocht. Categorieën zie je als filter, niet als zoekresultaat.
• Wat niet in de hub staat, is niet vindbaar. Site search heeft geen eigen productdatabase.
• Productnaam en omschrijving zijn niet per taal. Attributen en filterwaarden wel. Je eigen tekst in het zoekvak en bij niets gevonden geldt voor alle talen.
• Geen personalisatie op de eigen bestelgeschiedenis van een bezoeker. Wel op wat hij zei of aanvinkte, favoriete merken en categorieën (met toestemming) en segmenten.
• Geen start- en einddatum op boostregels. Zet een regel zelf aan en uit.
• Eén standaardsortering. Dezelfde keuze geldt met en zonder zoekterm.
• Geen pijltjestoetsen om door suggesties en resultaten te lopen.

Begrippen

• Overlay: het venster waarin de zoekresultaten van Nexym verschijnen, over of onder je eigen pagina.
• Zoekindex: een apart, heel snel naslagwerk van je producten, waarin de zoekmachine zoekt. Wordt elke nacht opnieuw gebouwd uit je catalogus in de hub.
• Herbouw (rebuild): de zoekindex helemaal opnieuw opbouwen. De oude index blijft antwoorden tot de nieuwe klaar is.
• CSS-selector: een aanwijzing welk element op een webpagina bedoeld is, zoals input[name=q] of #search.
• Synoniem: een woord dat ook een ander woord moet vinden. In één richting of in beide richtingen.
• Redirect: een zoekopdracht die direct naar een pagina gaat in plaats van naar resultaten.
• Boostregel: een regel die producten hoger of lager zet met een vermenigvuldiger.
• Vermenigvuldiger: het gewicht van een boostregel, van ×0,2 (omlaag) tot ×3,0 (omhoog).
• Laag (beperk tot de top): een boostregel die een vast aantal plekken bovenaan vasthoudt, in plaats van alle passende producten op te tillen.
• Relevantie: hoe goed een product bij de zoekopdracht past, volgens de zoekmachine.
• Filter (facet): een keuze waarmee een bezoeker de resultaten verfijnt, zoals merk of prijs.
• Startscherm: wat de overlay toont voordat er iets getypt is.
• Producttegel: één product in de zoekresultaten.
• Nul-resultaat: een zoekopdracht die niets vond.
• P95: 95 van de 100 zoekopdrachten waren sneller dan dit getal.
• Zekerheid (confidence): hoe waarschijnlijk het is dat een verschil in een A/B test geen toeval is.
• Hoofdmetric: het meetpunt waarop een A/B test de winnaar kiest.
• Vangrail: een veiligheid die een A/B test pauzeert als groep B geld lijkt te kosten.
• Embed-script, hub, koppeling, SKU, variant, signal, Impact, testmodus, live en toestemming: zie Begrippen.