Wie der Katalog indexiert wird

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

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, ob der Shop auf PrestaShop oder auf Shopify läuft.

Eine Suchmaschine pro Shop, Sprache und Währung

Beim Handshake sagt uns das PrestaShop-Modul, welche Shops es gibt, in welchen Sprachen und mit welchen Währungen; in einem Shopify-Shop liest die App die veröffentlichten Sprachen und die Hauptwährung in dem Moment, in dem sie installiert wird. 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. Bei Shopify bekommt jede veröffentlichte Sprache die Produktübersetzungen, die im Shop vorhanden sind, und das Original dort, wo keine vorhanden sind: ein Produkt ohne Übersetzung verschwindet nie aus der Suchmaschine dieser Sprache.

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. Auch Kombinationen und Varianten kommen hinein, jede mit ihrer eigenen Referenz und ihrem Barcode: die von der Verpackung einer Größe abgelesene EAN findet das Produkt, und die Suche kann die richtige Größe oder Farbe in den Warenkorb legen.

Bei PrestaShop ändern drei Optionen des Moduls, 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. Ein Produkt, das der Shop auch ohne Bestand bestellen lässt, zählt in allen drei Optionen als vorrätig: es wird weder versteckt noch zurückgestuft, und es zeigt in den Ergebnissen die auf seinem Datenblatt hinterlegte Lieferzeit.

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). Bei Shopify kommen die Bestellungen über die Plattform selbst, und nur die, die die Suche oder der Assistent berührt haben, gehen ein.

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 Wege, auf denen er aktuell bleibt

Nach der ersten vollständigen Indexierung erledigt sich der Alltag von selbst, und die genaue Form hängt von der Plattform ab.

In einem PrestaShop-Shop

1. In Echtzeit. Ein Produkt speichern, löschen oder seinen Bestand ändern schiebt die Änderung sofort raus, über die Hooks des Moduls. 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://ihr-shop/module/buskara/sync von außen erreichbar sein.
3. Manuell. Der Button Alles neu indexieren, im Panel oder im Modul, oder der Befehl auf der Kommandozeile. Siehe den Katalog neu indexieren.

Wann Sie Weg 2 misstrauen sollten 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.

In einem Shopify-Shop

1. In Echtzeit, über Webhooks. Shopify selbst benachrichtigt Buskara, sobald ein Produkt angelegt, geändert oder gelöscht wird oder sich der Bestand bewegt, und die Änderung erreicht den Index Sekunden später. Es gibt nichts zu konfigurieren: die Abonnements werden bei der Installation der App eingerichtet.
2. Periodisches Netz. In regelmäßigen Zyklen prüft Buskara bei Shopify, was sich seit dem letzten Durchlauf geändert hat, damit nichts liegen bleibt, falls ein Webhook unterwegs verloren geht. Das hängt von keiner erreichbaren Adresse des Shops ab.
3. Manuell. Der Button Alles neu indexieren auf der Seite des Shops, im Panel. Siehe den Katalog neu indexieren.

Die Installation und der Alltag sind Schritt für Schritt unter einen Shopify-Shop verbinden beschrieben.

Die Inhalte, stündlich

Der Blog und die Seiten des Shops haben keinen Echtzeit-Hook, und es ergibt keinen Sinn, wegen eines Artikels den ganzen Katalog neu zu indexieren. In einem PrestaShop-Shop mit eingeschalteten Inhalten macht Buskara stündlich einen eigenen Durchlauf, nur über die Artikel und Seiten, und baut die Inhalts-Suchmaschine dabei komplett neu auf; nur so lässt sich auch einfangen, was zurückgezogen wurde. Dieser Durchlauf ist immer kostenlos, wer auch immer ihn anstößt.

Ein veröffentlichter Artikel erscheint also innerhalb einer Stunde in der Suche, ohne dass jemand irgendwo klickt.

Was die Indexierung kostet

Die Routine kostet nichts: die Echtzeit, die periodische Synchronisierung, die erste Synchronisierung eines Shopify-Shops und der stündliche Durchlauf der Inhalte werden nie berechnet. Sie rühren weder ans Limit des Plans noch erzeugen sie Mehrverbrauch. Den Katalog aktuell zu halten soll keine Budgetentscheidung sein.

Einen Preis hat das Erzwingen: ein Klick auf Alles neu indexieren kostet 1 bToken pro 1.000 gesendete Dokumente, und der Hinweis mit der Rechnung erscheint vor der Bestätigung. Erklärt ist das unter den Katalog neu indexieren; was ausgegeben wird, erscheint in der Nutzungsgrafik, in der Zeile reindex. 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.