Wie der Katalog indexiert wird

Die Suchmaschinen pro Shop, Sprache und Währung, was in jedes Dokument kommt, und die drei Wege, auf denen der Index aktuell bleibt.

Die Suche läuft nicht auf der Datenbank des Shops. Sie läuft auf einem Index von uns, einer Kopie des Katalogs, die darauf vorbereitet ist, in Millisekunden zu antworten. In diesem Leitfaden geht es darum, wie diese Kopie entsteht und wie sie treu bleibt.

Eine Suchmaschine pro Shop, Sprache und Währung

Beim Handshake sagt uns das Modul, welche Shops es gibt, in welchen Sprachen und mit welchen Währungen. Für jede Kombination entsteht eine Suchmaschine, und genau das sehen Sie unter Suche → Suchmaschinen: den Shop, zu dem sie gehört, was sie indexiert, die Sprache und die Währung, wie viele Dokumente sie hat und wann die letzte Indexierung war.

Die Trennung ist kein Detail der Ordnung. Der Name eines Produkts auf Französisch und auf Portugiesisch sind verschiedene Texte, und eine Suche nach "chaussures" soll keine Treffer über den portugiesischen Text finden. Die Preise folgen derselben Logik: jede Suchmaschine speichert die ihrer Währung.

Ein mehrsprachiger Shop hat also mehr als eine Suchmaschine, und fast alles, was pro Suchmaschine konfiguriert wird (Gewichte, Synonyme, Filter), wird einmal für jede konfiguriert.

Was in ein Dokument kommt

Von jedem Produkt speichern wir das, was zum Finden und zum Anzeigen taugt: Referenz, EAN und MPN, Name, Marke, Kategorien, Eigenschaften und Attribute, Beschreibungen, Preis, Bild, Bestandsstatus und die URL im Shop.

Drei Optionen des Moduls ändern, was dort ankommt:

• Preise mit MwSt.: entscheidet, ob der indexierte Preis mit oder ohne Steuer ist. Er muss mit dem übereinstimmen, was der Shop zeigt, sonst nennen die Ergebnisse eine Zahl und das Datenblatt eine andere.
• Bildgröße: welches der PrestaShop-Bilder in den Index wandert. Das für die Karten der Suche, nicht das für die Detailansicht.
• Produkte ohne Bestand: trotzdem indexieren, in den Ergebnissen zurückstufen oder verstecken.

Und drei optionale Signale, die der Shop teilt, wenn er will, und die nicht zum Suchen dienen, sondern zum Sortieren und Messen: das Verkaufsvolumen (speist die Sortierung "meistverkauft" und das Aufspüren unsichtbarer Bestseller), der Einkaufspreis (liefert Margen in Analytics) und die Bestellungen (verbinden die Suche mit dem Umsatz).

Achtung Die Freigabe von Verkäufen oder Kosten ein- oder auszuschalten verlangt eine vollständige Neuindexierung, damit der Index die Änderung abbildet. Das Modul weist darauf hin, wenn das passiert.

Die drei Wege, auf denen er aktuell bleibt

Nach der ersten vollständigen Indexierung erledigt sich der Alltag von selbst:

1. In Echtzeit. Ein Produkt speichern, löschen oder seinen Bestand ändern schiebt die Änderung sofort raus. Hier läuft die überwältigende Mehrheit der Aktualisierungen durch, und das ist es, was Preis und Bestand in der Suche mit denen im Shop gleich hält.
2. Periodische Synchronisierung. In regelmäßigen Zyklen bittet die Plattform den Shop, den Katalog durchzusehen, und das fängt ein, was die Echtzeit nicht gesehen hat (ein CSV-Import, eine Änderung direkt in der Datenbank). Damit das funktioniert, muss die Adresse https://a-tua-loja/module/buskara/sync von außen erreichbar sein.
3. Manuell. Der Button Alles neu indexieren im Modul, oder der Befehl auf der Kommandozeile. Siehe den Katalog neu indexieren.

Wann Sie Weg 2 misstrauen solltest Firewalls, Basic-Auth in Vorproduktionsumgebungen und Regeln nach dem Muster "nur meine IP" blockieren die periodische Synchronisierung, ohne einen sichtbaren Fehler im Back-Office zu erzeugen. Das Symptom ist ein Index, der sich tagelang nicht rührt, während die Echtzeit weiterläuft.

Was die Indexierung kostet

Nichts vom Plan. Indexieren zählt symbolisch (10 Anfragen je 10.000 indexierte Items) und wird nie berechnet: es rührt weder ans Limit noch erzeugt es Mehrverbrauch. Den Katalog aktuell zu halten soll keine Budgetentscheidung sein.

Was in der Nutzungsgrafik auftaucht, ist diese symbolische Zählung, und sie steht dort aus Transparenz, damit man sieht, was der Index getrieben hat. Siehe was als Anfrage zählt.

Eine zweite Suchmaschine, für die Inhalte

Der Blog und die Seiten des Shops können getrennt indexiert werden, in einer eigenen Suchmaschine, und in den Ergebnissen auftauchen, ohne den Produkten den Platz wegzunehmen. Das ist optional und wird im Modul eingeschaltet; es ist unter Artikel und Inhalte des Shops erklärt.