PS PrestaShop Gemiddeld

Documentatie Zoekopdracht Zonder Resultaat: Inhaalpagina en Productmeldingen

dfzerosearch 1.3.0 installeren, configureren en gebruiken: inhaalpagina, vergelijkbare referenties, exacte, „bevat”- en jokerregels (M91650*), CSV-import, automatische meldingen en teruggewonnen omzet.

Bijgewerkt Moduleversie 1.3.0

Overzicht

De module Zoekopdracht Zonder Resultaat (dfzerosearch) neemt het over wanneer een zoekopdracht in uw winkel niets vindt. In plaats van een lege pagina ziet de bezoeker een inhaalpagina: het doel dat u voor die zoekopdracht hebt gekozen, producten met een referentie die op de getypte lijkt, de gecorrigeerde zoekopdracht, een bredere zoekopdracht, de bestsellers van de geraden categorie en een formulier „Houd mij op de hoogte”.

In de back-office wordt elke verloren zoekopdracht geteld. U koppelt die aan een product, een categorie, een andere zoekopdracht of een URL, met een exacte regel, een „bevat”-regel of een jokerregel. Daarna meet de module wat deze reddingen opleveren: reddingspercentage, bestellingen en omzet exclusief btw.

Nieuw in 1.3.0: het blok Similar references (een zoekopdracht naar M91650-0005 toont M91650-0001 en M91650-0002) en jokerregels (M91650* dekt een hele referentiefamilie met één regel).

De interface en e-mails van de module bestaan in het Engels, Frans, Spaans, Duits en Italiaans. In een Nederlandstalige winkel toont de module de Engelse versie, daarom staan de namen van de instellingen hieronder in die versie.

Installatie en update

Eerste installatie

  1. Open Modules > Modulebeheer en klik op Een module uploaden.
  2. Kies het archief dfzerosearch.zip.
  3. De module maakt zijn tabellen, zijn beheermenu en zijn standaardinstellingen aan. Hij is meteen actief.
  4. Kopieer de URL van de geplande taak op de configuratiepagina en laat die elk uur aanroepen (zie verderop).

Update vanaf een eerdere versie

Upload de nieuwe ZIP over de oude, zonder te deïnstalleren. PrestaShop voert de updatescripts uit: nieuwe kolommen, nieuwe instellingen met hun standaardwaarde en het legen van de modulecache. Verloren zoekopdrachten, regels, abonnees en statistieken blijven behouden.

Deïnstalleer de module niet om hem bij te werken: deïnstalleren verwijdert zijn tabellen en dus de hele geschiedenis.

Configuratie

De pagina Configureren begint met snelkoppelingen naar de drie schermen van de module, gevolgd door drie instellingenpanelen en het paneel van de geplande taak.

Rescue page

  • Enable module: zet de detectie en de inhaalpagina aan of uit.
  • Typo correction (“Did you mean…”): corrigeert typefouten woord voor woord op basis van de zoekindex en toont de bijbehorende producten.
  • Similar references: voor een referentie die niet in de catalogus staat, toont de producten waarvan de referentie hetzelfde begint. Streepjes, spaties en hoofdletters worden genegeerd, referenties van combinaties tellen mee.
  • Partial match: wanneer een lange zoekopdracht mislukt door één woord („leren laarzen maat 45”), toont de resultaten van de dichtstbijzijnde kortere zoekopdracht.
  • Best sellers of the guessed category: vergelijkt de zoekopdracht met de categorienamen, subcategorieën inbegrepen.
  • Global best sellers fallback: alleen getoond als geen ander blok iets vond. Zonder verkopen worden de nieuwste producten gebruikt.
  • “Notify me” form: de bezoeker laat zijn e-mailadres achter om bericht te krijgen zodra zijn zoekopdracht een product vindt.
  • Use the theme product miniatures: producten zien eruit zoals op uw categoriepagina’s (in winkelwagen, snel bekijken, labels). Uitgeschakeld gebruikt de module zijn eigen compacte kaarten.
  • In-stock products only: verbergt uitverkochte producten in alle blokken.
  • Custom message (per taal): tekst bovenaan de inhaalpagina, bijvoorbeeld een telefoonnummer of een link naar speciale bestellingen. %query% wordt vervangen door de gezochte woorden.
  • Popular searches: klikbare labels met zoekopdrachten die werken. Vul per taal uw eigen lijst in of laat leeg om veelgebruikte zoekopdrachten met resultaten te gebruiken.
  • Products per block: 1 tot 24 (standaard 8).

Tracking and data

  • Minimum query length: kortere zoekopdrachten worden niet opgeslagen en niet gered (standaard 2).
  • Treat approximate-only results as lost: de standaard fuzzy zoekfunctie van PrestaShop geeft bij een onbekend woord vaak producten zonder verband. Vindt een zoekopdracht alleen zulke resultaten, dan telt die als verloren en verschijnt het inhaalblok erboven.
  • Ignore bots and crawlers: zoekopdrachten van zoekmachines, SEO-tools en scripts worden niet opgeslagen.
  • Attribution window (days) (standaard 7): een bestelling binnen deze periode na een redding wordt toegeschreven aan de zoekopdracht en het blok die de bezoeker terugbrachten (laatste contact).
  • Cache rescue results: bewaart het zoekwerk 15 minuten per zoekopdracht. Prijzen en voorraad blijven live. De cache wordt geleegd zodra u een instelling of regel wijzigt.
  • Retention (days) (standaard 180): verloren zoekopdrachten die zo lang niet meer voorkwamen en abonnementen die al een melding kregen, worden door de geplande taak verwijderd. 0 bewaart alles. Met een knop verwijdert u direct.

Automation

  • Automatic notify-me emails: abonnees krijgen een e-mail zodra hun zoekopdracht een actieve regel krijgt of de zoekopdracht weer producten vindt.
  • Weekly digest: elke 7 dagen verloren zoekopdrachten, reddingspercentage en belangrijkste verloren zoekopdrachten per e-mail.
  • Digest recipient: leeg betekent het e-mailadres van de winkel.

Geplande taak

Het paneel Scheduled task (cron) toont een met een token beveiligde URL. Roep die elk uur aan via cPanel, Plesk of een andere cronservice, bijvoorbeeld:

0 * * * * curl -s "https://www.uw-winkel.nl/module/dfzerosearch/cron?token=..." > /dev/null

De taak verstuurt de automatische meldingen, past de bewaartermijn toe en verstuurt het weekrapport. Het paneel toont de datum van de laatste uitvoering, de knop Run now start de taak handmatig en Generate a new token vervangt de URL als die is uitgelekt. Bij multistore stelt u per winkel een taak in met de URL die in de context van elke winkel wordt getoond.

Is de taak 48 uur niet uitgevoerd, dan verschijnt een waarschuwing op het dashboard: automatische e-mails en het weekrapport wachten tot de taak weer draait.

De inhaalpagina

Wanneer het resultatenraster leeg is, laadt een script de inhaalpagina via AJAX. Zoekopdrachten die wel producten vinden, worden niet vertraagd. De blokken verschijnen in deze volgorde, zonder dubbele producten tussen blokken:

  1. Uw regel: als een actieve regel bij de zoekopdracht past, wordt het doel uitgelicht. In doorverwijsmodus komt de bezoeker direct op het doel terecht. Een synoniem toont daarnaast zijn producten.
  2. Vergelijkbare referenties: producten uit dezelfde referentiefamilie.
  3. „Bedoelde u…”: de gecorrigeerde zoekopdracht en de producten ervan, met een link naar de gecorrigeerde zoekopdracht. Dit blok verschijnt alleen als de vorige blokken niets toonden.
  4. Gedeeltelijke overeenkomst: resultaten van de ingekorte zoekopdracht, alleen als er nog niets is gevonden.
  5. Bestsellers van de geraden categorie.
  6. Bestsellers van de winkel: alleen als laatste redmiddel.

Het eigen bericht staat boven de blokken, populaire zoekopdrachten en het meldingsformulier eronder.

Vergelijkbare referenties

Veel klanten zoeken een product op zijn exacte referentie. Bestaat die referentie niet in de catalogus, dan stelt de module de producten uit dezelfde familie voor.

  • De module zoekt in de zoekopdracht het woord dat op een referentie lijkt: minstens 5 tekens, waarvan minstens 2 cijfers.
  • Dat woord wordt vergeleken met de referenties van producten en combinaties, zonder rekening te houden met streepjes, spaties, punten en hoofdletters. M91650-0005, m91650 0005 en M916500005 worden hetzelfde behandeld.
  • Alleen producten met een voldoende lang gemeenschappelijk begin van de referentie blijven over (minstens 5 tekens en 60% van de gezochte referentie). De meest verwante komen eerst.
  • Voorbeeld: een zoekopdracht naar M91650-0005 toont M91650-0001 en M91650-0002, maar niet M91651-0003.

De typfoutcorrectie verandert nooit een woord met minstens 2 cijfers: een referentie wordt niet „gecorrigeerd” naar een andere.

Regels: koppelingen en synoniemen

Het scherm Mappings & synonyms toont uw regels. Klik op Add a mapping om er een te maken, of gebruik de actie Map bij een verloren zoekopdracht, die het formulier vooraf invult.

Soorten overeenkomst

  • Exact (exact): de zoekopdracht moet identiek zijn aan de regel. Hoofdletters, accenten en overtollige spaties worden genegeerd.
  • Bevat (contains): de regel moet als woord of woordreeks in de zoekopdracht voorkomen. Streepjes, schuine strepen, punten en andere scheidingstekens tellen als spaties: de regel m91651 geldt voor M91651-0003.
  • Joker (wildcard): * staat voor een willekeurige reeks tekens en ? voor één teken. M91650* dekt M91650-0001, M91650-0007 of m916500009, maar niet M91659-0001. Elke regel met * of ? wordt automatisch als joker opgeslagen.

Een jokerregel heeft naast de jokers minstens 3 tekens nodig, en ** wordt geweigerd. Schrijf M91650* in plaats van M91650-* als uw klanten de referentie ook zonder streepje typen.

Prioriteiten

Passen meerdere regels bij een zoekopdracht, dan wint de nauwkeurigste: een exacte regel gaat voor een jokerregel, die gaat voor een „bevat”-regel. Bij hetzelfde type gaat een regel voor een specifieke taal voor een regel voor „alle talen”, daarna wint de langste regel.

Doelen en modi

  • Product: zoeken op naam, referentie of ID in het formulier.
  • Category.
  • Synonym (other search): andere woorden die wel resultaten geven („sweater” voor „trui”). De producten van die zoekopdracht verschijnen op de inhaalpagina.
  • Custom URL: absolute URL of pad dat met een schuine streep begint.

Elke regel werkt in de modus Suggest (doel uitgelicht op de inhaalpagina) of Redirect (de bezoeker komt direct op het doel). Een regel kan voor één taal of voor alle talen gelden.

CSV-import en -export

Het paneel Import / export (CSV) op het regelscherm importeert tot 5.000 regels en exporteert al uw regels. Scheidingsteken ; of ,, kopregel optioneel. Kolommen:

query ; match ; language ; type ; target ; mode ; active
M91650* ; wildcard ; all ; category ; 12 ; redirect ; 1
trui ; exact ; nl ; search ; sweater ; suggest ; 1
M91651 ; contains ; all ; product ; M91651-0003 ; suggest ; 1
  • match: exact, contains of wildcard (standaard exact; joker wordt automatisch herkend als de regel * of ? bevat).
  • language: ISO-code, of leeg, * of all voor alle talen.
  • type: product, category, search of url.
  • target: product-ID of -referentie, categorie-ID, zoekwoorden of URL.
  • mode: suggest of redirect (standaard suggest). active: 1 of 0 (standaard 1).

Een bestaande regel met dezelfde zoekopdracht en taal wordt bijgewerkt. Het importrapport vermeldt aangemaakte, bijgewerkte en geweigerde regels met hun regelnummer.

Meldingen „Houd mij op de hoogte”

Het formulier op de inhaalpagina heeft een standaard niet-aangevinkt toestemmingsvakje en een verborgen valveld tegen bots. Voor een ingelogde klant is het e-mailadres al ingevuld. De aanvragen staan op het scherm Notify-me requests met hun status.

Met de geplande taak en de optie Automatic notify-me emails ontvangt de abonnee de e-mail dfzerosearch_alert zodra zijn zoekopdracht een actieve regel krijgt of de zoekopdracht weer producten vindt. U kunt de e-mail ook handmatig versturen met de actie Notify bij een regel. Elke e-mail bevat een afmeldlink.

Dashboard en teruggewonnen omzet

Het scherm Lost queries toont de cijfers van de laatste 30 dagen: verloren zoekopdrachten, reddingspercentage, bestellingen na een redding, teruggewonnen omzet exclusief btw, nieuwe abonnementen en wachtende e-mails. Eén grafiek vergelijkt dag per dag verloren en geredde zoekopdrachten, een andere toont de klikken per inhaalblok (regel, vergelijkbare referenties, correctie, gedeeltelijke overeenkomst, categorie, bestsellers, populaire zoekopdrachten).

De lijst met verloren zoekopdrachten is gesorteerd op volume. Elke rij biedt Map, Ignore / restore en, als er een correctie is gevonden, Create a synonym from this correction. De tabel Latest orders after a rescue toont de toegeschreven zoekopdracht en het blok.

Toeschrijving gebeurt op basis van het laatste contact: de bestelling wordt toegeschreven aan de laatste redding van dezelfde bezoeker binnen de ingestelde toeschrijvingsperiode.

Weekrapport

Elke 7 dagen verstuurt de geplande taak de e-mail dfzerosearch_digest: verloren zoekopdrachten, geredde bezoekers, reddingspercentage, bestellingen en omzet exclusief btw na een redding, nieuwe meldingsaanvragen en de vaakst verloren zoekopdrachten. Gebeurde er die week niets, dan wordt er geen e-mail verstuurd.

AVG

  • Uitdrukkelijke toestemming: vakje standaard niet aangevinkt en een duidelijke toestemmingstekst.
  • Officiële AVG-module: de module is geregistreerd bij psgdpr. Export en verwijdering van de gegevens van een klant omvatten zijn meldingsaanvragen.
  • Afmelden: een link in elke e-mail.
  • Bewaartermijn: automatische verwijdering van oude zoekopdrachten en afgehandelde abonnementen.
  • Zelf gehost: er gaan geen gegevens naar een externe dienst.

Compatibiliteit en technische informatie

  • PrestaShop 8.0 tot 9.x, multistore.
  • Interface en e-mails in het Engels, Frans, Spaans, Duits en Italiaans.
  • Hooks: actionSearch, actionFrontControllerSetMedia, actionValidateOrder, registerGDPRConsent, actionDeleteGDPRCustomer, actionExportGDPRData.
  • Tabellen: dfzerosearch_query, dfzerosearch_mapping, dfzerosearch_alert, dfzerosearch_stat, dfzerosearch_session, dfzerosearch_conversion.
  • Menu AdminDfZeroSearch onder Modules, met drie schermen: verloren zoekopdrachten, koppelingen en synoniemen, meldingsaanvragen.
  • Front-controllers: rescue (inhaalpagina, JSON), cron (geplande taak, token) en unsubscribe.
  • Geen afhankelijkheden: geen Composer, JavaScript zonder jQuery, geen externe dienst.

Probleemoplossing

  • De inhaalpagina verschijnt niet: controleer of de module actief is en of de zoekopdracht echt nul resultaten geeft, en leeg daarna de cache van PrestaShop en van de browser. Bij een sterk aangepast thema kunt u contact met ons opnemen met de naam van het thema.
  • Een zoekopdracht toont producten zonder verband en telt niet als verloren: schakel Treat approximate-only results as lost in.
  • Geen vergelijkbare referenties: het gezochte woord moet minstens 5 tekens met 2 cijfers hebben, en actieve producten die zichtbaar zijn in de zoekfunctie moeten hetzelfde begin van de referentie hebben.
  • Een jokerregel werkt niet: controleer of de regel actief is, in de juiste taal staat en of er geen exacte regel voorgaat. Probeer hem zonder scheidingsteken (M91650*) als klanten de referentie op verschillende manieren typen.
  • Geen correctie voorgesteld: de correctie stelt alleen woorden uit de index voor; bouw de zoekindex van PrestaShop opnieuw op als de catalogus sterk is veranderd.
  • Automatische e-mails of het rapport worden niet verstuurd: controleer de datum van de laatste uitvoering van de geplande taak en de e-mailinstellingen van PrestaShop. De knop Notify toont een duidelijke foutmelding als het versturen mislukt.
  • Het dashboard blijft leeg: controleer de minimale lengte van de zoekopdracht en test vanuit een gewone browser, want bots worden genegeerd.
Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support