Dokumentation Suche ohne Ergebnisse: Rettungsseite und Benachrichtigungen

Überblick

Das Modul Suche ohne Ergebnisse (dfzerosearch) übernimmt, wenn eine Suche in Ihrem Shop nichts findet. Statt einer leeren Seite sieht der Besucher eine Rettungsseite: das Ziel, das Sie für diese Suchanfrage festgelegt haben, Produkte mit ähnlicher Referenz, die korrigierte Suche, eine weiter gefasste Suche, die Bestseller der erratenen Kategorie und ein Formular „Benachrichtigen Sie mich“.

Im Back-Office wird jede verlorene Suche gezählt. Sie verknüpfen sie mit einem Produkt, einer Kategorie, einer anderen Suche oder einer URL, über eine exakte, eine „enthält“- oder eine Platzhalter-Regel. Anschließend misst das Modul, was diese Rettungen bringen: Rettungsquote, Bestellungen und Umsatz netto.

Installation und Update

Erstinstallation

1. Öffnen Sie Module > Modulverwaltung und klicken Sie auf Modul hochladen.
2. Wählen Sie das Archiv dfzerosearch.zip.
3. Das Modul legt seine Tabellen, sein Admin-Menü und seine Standardeinstellungen an. Es ist sofort aktiv.
4. Kopieren Sie die URL der geplanten Aufgabe von der Konfigurationsseite und lassen Sie sie stündlich aufrufen (siehe unten).

Update von einer früheren Version

Laden Sie die neue ZIP-Datei über die alte hoch, ohne zu deinstallieren. PrestaShop führt die Update-Skripte aus: neue Spalten, neue Einstellungen mit Standardwert, Leeren des Modul-Caches. Verlorene Suchanfragen, Regeln, Abonnenten und Statistiken bleiben erhalten.

Konfiguration

Die Seite Konfigurieren beginnt mit Verknüpfungen zu den drei Bildschirmen des Moduls, gefolgt von drei Einstellungsbereichen und dem Bereich der geplanten Aufgabe.

Rettungsseite

• Modul aktivieren: schaltet Erkennung und Rettungsseite ein oder aus.
• Tippfehlerkorrektur („Meinten Sie…“): korrigiert Tippfehler Wort für Wort anhand des Suchindex und zeigt die passenden Produkte.
• Ähnliche Referenzen: Bei einer Referenz, die nicht im Katalog ist, werden Produkte gezeigt, deren Referenz gleich beginnt. Bindestriche, Leerzeichen und Groß-/Kleinschreibung werden ignoriert, Kombinationsreferenzen sind eingeschlossen.
• Teilweise Übereinstimmung: Scheitert eine lange Suche an einem Wort („Lederstiefel Größe 45“), werden die Ergebnisse der nächstliegenden kürzeren Suche gezeigt.
• Bestseller der erratenen Kategorie: vergleicht die Suche mit den Kategorienamen, Unterkategorien eingeschlossen.
• Shop-Bestseller als letzte Möglichkeit: nur, wenn kein anderer Block etwas gefunden hat. Ohne Verkäufe werden die neuesten Produkte verwendet.
• Formular „Benachrichtigen Sie mich“: Der Besucher hinterlässt seine E-Mail, um benachrichtigt zu werden, sobald seine Suche ein Produkt findet.
• Produktminiaturen des Themes verwenden: Produkte sehen aus wie auf Ihren Kategorieseiten (In den Warenkorb, Schnellansicht, Labels). Deaktiviert nutzt das Modul seine kompakten Karten.
• Nur vorrätige Produkte: blendet ausverkaufte Produkte in allen Blöcken aus.
• Eigene Nachricht (pro Sprache): Text oben auf der Rettungsseite, zum Beispiel eine Telefonnummer oder ein Link zu Sonderbestellungen. %query% wird durch die gesuchten Wörter ersetzt.
• Beliebte Suchen: anklickbare Chips mit funktionierenden Suchen. Tragen Sie Ihre eigene Liste pro Sprache ein oder lassen Sie das Feld leer, um häufige erfolgreiche Suchen zu verwenden.
• Produkte pro Block: 1 bis 24 (Standard 8).

Tracking und Daten

• Mindestlänge der Suchanfrage: Kürzere Suchen werden weder erfasst noch gerettet (Standard 2).
• Nur ungefähre Treffer als verloren zählen: Die native unscharfe Suche von PrestaShop liefert bei einem unbekannten Wort oft unpassende Produkte. Findet eine Suche nur solche Treffer, gilt sie als verloren und der Rettungsblock erscheint darüber.
• Bots und Crawler ignorieren: Suchen von Suchmaschinen, SEO-Tools und Skripten werden nicht erfasst.
• Zuordnungszeitraum (Tage) (Standard 7): Eine Bestellung innerhalb dieses Zeitraums nach einer Rettung wird der Suchanfrage und dem Block zugeordnet, die den Besucher zurückgebracht haben (Last Touch).
• Rettungsergebnisse zwischenspeichern: speichert die Sucharbeit 15 Minuten pro Suchanfrage. Preise und Bestand bleiben live. Der Cache wird geleert, sobald Sie eine Einstellung oder Regel ändern.
• Aufbewahrung (Tage) (Standard 180): Verlorene Suchanfragen, die so lange nicht mehr vorkamen, und bereits benachrichtigte Abonnements werden von der geplanten Aufgabe gelöscht. 0 behält alles. Eine Schaltfläche löscht sofort.

Automatisierung

• Automatische Benachrichtigungs-E-Mails: Abonnenten werden benachrichtigt, sobald ihre Suchanfrage eine aktive Regel erhält oder die Suche wieder Produkte findet.
• Wochenbericht: alle 7 Tage verlorene Suchen, Rettungsquote und häufigste verlorene Suchanfragen per E-Mail.
• Empfänger des Berichts: leer lassen, um die Shop-E-Mail-Adresse zu verwenden.

Geplante Aufgabe

Der Bereich Geplante Aufgabe (Cron) zeigt eine durch Token geschützte URL. Rufen Sie sie stündlich über cPanel, Plesk oder einen beliebigen Cron-Dienst auf, zum Beispiel:

0 * * * * curl -s "https://www.ihr-shop.de/module/dfzerosearch/cron?token=..." > /dev/null

Sie versendet die automatischen Benachrichtigungen, wendet die Aufbewahrung an und versendet den Wochenbericht. Der Bereich zeigt das Datum des letzten Laufs, Jetzt ausführen startet die Aufgabe manuell und Neues Token erzeugen ersetzt die URL, falls sie bekannt geworden ist. Im Multistore richten Sie pro Shop eine Aufgabe mit der im jeweiligen Shop-Kontext angezeigten URL ein.

Die Rettungsseite

Ist das Ergebnisraster leer, lädt ein Skript die Rettungsseite per AJAX. Suchen mit Ergebnissen werden nicht verlangsamt. Die Blöcke erscheinen in dieser Reihenfolge, ohne doppelte Produkte zwischen den Blöcken:

1. Ihre Regel: Passt eine aktive Regel zur Suchanfrage, wird ihr Ziel hervorgehoben. Im Weiterleitungsmodus landet der Besucher direkt auf dem Ziel. Ein Synonym zeigt zusätzlich seine Produkte.
2. Ähnliche Referenzen: Produkte derselben Referenzfamilie.
3. „Meinten Sie…“: die korrigierte Suche und ihre Produkte, mit Link zur korrigierten Suche. Dieser Block erscheint nur, wenn die vorherigen Blöcke nichts gezeigt haben.
4. Teilweise Übereinstimmung: Ergebnisse der verkürzten Suche, nur wenn noch nichts gefunden wurde.
5. Bestseller der erratenen Kategorie.
6. Shop-Bestseller: nur als letzte Möglichkeit.

Die eigene Nachricht erscheint über den Blöcken, beliebte Suchen und das Benachrichtigungsformular darunter.

Ähnliche Referenzen

Viele Kunden suchen ein Produkt über seine genaue Referenz. Existiert diese Referenz nicht im Katalog, schlägt das Modul die Produkte derselben Familie vor.

• Das Modul erkennt in der Suchanfrage das Wort, das wie eine Referenz aussieht: mindestens 5 Zeichen, davon mindestens 2 Ziffern.
• Es vergleicht dieses Wort mit den Referenzen von Produkten und Kombinationen und ignoriert dabei Bindestriche, Leerzeichen, Punkte und Groß-/Kleinschreibung. M91650-0005, m91650 0005 und M916500005 werden gleich behandelt.
• Nur Produkte mit einem ausreichend langen gemeinsamen Referenzanfang werden behalten (mindestens 5 Zeichen und 60 % der gesuchten Referenz). Die ähnlichsten kommen zuerst.
• Beispiel: Eine Suche nach M91650-0005 zeigt M91650-0001 und M91650-0002, aber nicht M91651-0003.

Regeln: Verknüpfungen und Synonyme

Der Bildschirm Verknüpfungen und Synonyme listet Ihre Regeln. Um eine anzulegen, klicken Sie auf Verknüpfung hinzufügen oder nutzen die Aktion Verknüpfen bei einer verlorenen Suchanfrage, die das Formular vorausfüllt.

Übereinstimmungstypen

• Exakt: Die Suchanfrage muss mit der Regel identisch sein. Groß-/Kleinschreibung, Akzente und überzählige Leerzeichen werden ignoriert.
• Enthält: Die Regel muss als Wort oder Wortfolge in der Suchanfrage vorkommen. Bindestriche, Schrägstriche, Punkte und andere Trennzeichen zählen als Leerzeichen: Die Regel m91651 greift bei M91651-0003.
• Platzhalter: * steht für eine beliebige Zeichenfolge, ? für ein einzelnes Zeichen. M91650* deckt M91650-0001, M91650-0007 oder m916500009 ab, aber nicht M91659-0001. Jede Regel mit * oder ? wird automatisch als Platzhalter gespeichert.

Prioritäten

Passen mehrere Regeln zu einer Suchanfrage, gewinnt die genaueste: Eine exakte Regel geht vor einer Platzhalter-Regel, diese vor einer „enthält“-Regel. Bei gleichem Typ geht eine sprachspezifische Regel vor einer Regel für „alle Sprachen“, danach gewinnt die längere Regel.

Ziele und Modi

• Produkt: Suche nach Name, Referenz oder ID im Formular.
• Kategorie.
• Synonym (andere Suche): andere Wörter, die Ergebnisse liefern („Sweatshirt“ für „Pullover“). Die Produkte dieser Suche erscheinen auf der Rettungsseite.
• Eigene URL: absolute URL oder Pfad, der mit einem Schrägstrich beginnt.

Jede Regel arbeitet im Modus Vorschlag (Ziel auf der Rettungsseite hervorgehoben) oder Weiterleitung (der Besucher landet direkt auf dem Ziel). Eine Regel kann für eine Sprache oder für alle Sprachen gelten.

CSV-Import und -Export

Der Bereich Import / Export (CSV) im Regel-Bildschirm importiert bis zu 5.000 Zeilen und exportiert alle Regeln. Trennzeichen ; oder ,, Kopfzeile optional. Spalten:

query ; match ; language ; type ; target ; mode ; active
M91650* ; wildcard ; all ; category ; 12 ; redirect ; 1
pulli ; exact ; de ; search ; pullover ; suggest ; 1
M91651 ; contains ; all ; product ; M91651-0003 ; suggest ; 1

• match: exact, contains oder wildcard (Standard exact; Platzhalter wird automatisch erkannt, wenn die Regel * oder ? enthält).
• language: ISO-Code, oder leer, * bzw. all für alle Sprachen.
• type: product, category, search oder url.
• target: Produkt-ID oder -Referenz, Kategorie-ID, Suchwörter oder URL.
• mode: suggest oder redirect (Standard suggest). active: 1 oder 0 (Standard 1).

Eine bestehende Regel mit derselben Suchanfrage und Sprache wird aktualisiert. Der Importbericht nennt erstellte, aktualisierte und abgelehnte Zeilen mit ihrer Nummer.

Benachrichtigungen „Benachrichtigen Sie mich“

Das Formular auf der Rettungsseite hat ein standardmäßig nicht angehaktes Einwilligungsfeld und ein verstecktes Fallenfeld gegen Bots. Bei angemeldeten Kunden ist die E-Mail vorausgefüllt. Die Anfragen stehen im Bildschirm Benachrichtigungswünsche mit ihrem Status.

Mit der geplanten Aufgabe und der Option Automatische Benachrichtigungs-E-Mails erhält der Abonnent die E-Mail dfzerosearch_alert in seiner Sprache, sobald seine Suchanfrage eine aktive Regel erhält oder die Suche wieder Produkte findet. Sie können sie auch manuell über die Aktion Benachrichtigen einer Regel senden. Jede E-Mail enthält einen Abmeldelink.

Dashboard und geretteter Umsatz

Der Bildschirm Verlorene Suchanfragen zeigt die Kennzahlen der letzten 30 Tage: verlorene Suchen, Rettungsquote, Bestellungen nach Rettung, geretteter Umsatz netto, neue Abonnements und ausstehende E-Mails. Ein Diagramm vergleicht Tag für Tag verlorene und gerettete Suchen, ein weiteres zeigt die Klicks pro Rettungsblock (Regel, ähnliche Referenzen, Korrektur, teilweise Übereinstimmung, Kategorie, Bestseller, beliebte Suchen).

Die Liste der verlorenen Suchanfragen ist nach Volumen sortiert. Jede Zeile bietet Verknüpfen, Ignorieren / wiederherstellen und, wenn eine Korrektur gefunden wurde, Aus dieser Korrektur ein Synonym erstellen. Die Tabelle Letzte Bestellungen nach einer Rettung zeigt die zugeordnete Suchanfrage und den Block.

Wochenbericht

Alle 7 Tage versendet die geplante Aufgabe die E-Mail dfzerosearch_digest: verlorene Suchen, gerettete Besucher, Rettungsquote, Bestellungen und Umsatz netto nach Rettung, neue Benachrichtigungswünsche und die häufigsten verlorenen Suchanfragen. War die Woche ohne Aktivität, wird keine E-Mail versendet.

DSGVO

• Ausdrückliche Einwilligung: Feld standardmäßig nicht angehakt, klarer Einwilligungstext.
• Offizielles DSGVO-Modul: Das Modul ist bei psgdpr registriert. Export und Löschung der Kundendaten umfassen seine Benachrichtigungswünsche.
• Abmeldung: ein Link in jeder E-Mail.
• Aufbewahrung: automatisches Löschen alter Suchanfragen und benachrichtigter Abonnements.
• Selbst gehostet: Keine Daten gehen an einen Drittanbieter.

Kompatibilität und technische Angaben

• PrestaShop 8.0 bis 9.x, Multistore.
• Oberfläche und E-Mails auf Englisch, Französisch, Spanisch, Deutsch und Italienisch.
• Hooks: actionSearch, actionFrontControllerSetMedia, actionValidateOrder, registerGDPRConsent, actionDeleteGDPRCustomer, actionExportGDPRData.
• Tabellen: dfzerosearch_query, dfzerosearch_mapping, dfzerosearch_alert, dfzerosearch_stat, dfzerosearch_session, dfzerosearch_conversion.
• Menü AdminDfZeroSearch unter Module, mit drei Bildschirmen: verlorene Suchanfragen, Verknüpfungen und Synonyme, Benachrichtigungswünsche.
• Front-Controller: rescue (Rettungsseite, JSON), cron (geplante Aufgabe, Token) und unsubscribe.
• Keine Abhängigkeiten: kein Composer, JavaScript ohne jQuery, kein externer Dienst.

Fehlerbehebung

• Die Rettungsseite erscheint nicht: Prüfen Sie, ob das Modul aktiviert ist und die Suche wirklich null Ergebnisse liefert, und leeren Sie den PrestaShop- und Browser-Cache. Bei einem stark angepassten Theme kontaktieren Sie uns mit dem Namen des Themes.
• Eine Suche zeigt unpassende Produkte und gilt nicht als verloren: Aktivieren Sie Nur ungefähre Treffer als verloren zählen.
• Keine ähnlichen Referenzen: Das gesuchte Wort braucht mindestens 5 Zeichen mit 2 Ziffern, und aktive, in der Suche sichtbare Produkte müssen den Anfang dieser Referenz teilen.
• Eine Platzhalter-Regel greift nicht: Prüfen Sie, ob sie aktiv ist, die richtige Sprache hat und keine exakte Regel Vorrang hat. Testen Sie sie ohne Trennzeichen (M91650*), wenn Kunden die Referenz unterschiedlich eingeben.
• Keine Korrektur vorgeschlagen: Die Korrektur schlägt nur Wörter aus dem Index vor; bauen Sie den PrestaShop-Suchindex neu auf, wenn sich der Katalog stark geändert hat.
• Automatische E-Mails oder der Bericht werden nicht versendet: Prüfen Sie das Datum des letzten Laufs der geplanten Aufgabe und die E-Mail-Einstellungen von PrestaShop. Die Schaltfläche Benachrichtigen zeigt bei einem Versandfehler eine eindeutige Meldung.
• Das Dashboard bleibt leer: Prüfen Sie die Mindestlänge der Suchanfrage und testen Sie mit einem normalen Browser, da Bots ignoriert werden.