Einen Shopify-Shop verbinden

Die App installieren, die Suche im Shop einschalten, und die Blöcke für Ähnliches und Empfohlenes, in der richtigen Reihenfolge.

In einem Shopify-Shop gibt es keinen Code einzufügen und keine Dateien zu bearbeiten: die Buskara-App installieren, den Lesezugriff bestätigen, und einen Schalter im Theme-Editor umlegen. Von da an synchronisiert sich der Katalog von selbst, Produkt- und Bestandsänderungen eingeschlossen, Sekunden nach dem Speichern im Shop. Was die Such-App für Shopify im Shop ändert, was gleich bleibt und was sie kostet, erzählt der Blog; diese Anleitung ist nur der Weg, in der richtigen Reihenfolge.

1. Die App installieren

Der übliche Weg beginnt bei Shopify:

1. Öffnen Sie im Shopify App Store die Seite von Buskara und klicken Sie auf Installieren. Shopify zeigt den Zustimmungsbildschirm mit den angefragten Zugriffen, alle nur lesend: Produkte, Inventar, Veröffentlichungen, Sprachen, Märkte und Bestellungen. Klicken Sie auf Installieren.
2. Die App öffnet sich im Adminbereich des Shops. Das Buskara-Konto wird in diesem Moment mit der E-Mail des Shops angelegt, und die erste Synchronisierung des Katalogs startet von selbst.
3. Klicken Sie auf Tarif wählen. Shopify zeigt die Tarife und die Testtage, und der gewählte Tarif wird von Shopify abgerechnet, auf derselben Rechnung wie der Shop; Tarifwechsel, Kündigung und Testphase werden von dort aus verwaltet, unter Apps → Buskara.

Wer bereits ein Buskara-Konto mit der E-Mail des Shops hat, bekommt den Shop in dieses Konto. Wer bei Buskara beginnt, unter /ativar, wählt Shopify und wird zur Buskara-Seite im Shopify App Store geführt: Die Installation beginnt immer bei Shopify, nie über eine bei Buskara eingetippte Adresse, und die Zustimmung ist dieselbe.

Das ist alles: der Shop erscheint im Panel unter Konto → Shops, und die Schaltfläche Buskara-Panel öffnen im Adminbereich des Shops betritt es ohne Passwort. Der erste Durchlauf des Katalogs dauert meist unter einer Minute, ein großer Katalog braucht ein paar.

Buskara verlangt keinerlei Schreibrechte über den Shop, und der Zugriff auf Bestellungen dient nur dazu, Verkäufe der Suche zuzuordnen, im Auftrag des Händlers.

2. Die Suche im Shop zeigen

Die Suche erscheint den Besuchern erst, wenn der Händler sie einschaltet, und der Schalter wohnt im Theme-Editor:

1. Öffnen Sie in der Shop-Administration Onlineshop → Anpassen.
2. Öffnen Sie in der Symbolleiste des linken Panels die App-Einbettungen (das Quadrate-Symbol, neben den Theme-Einstellungen).
3. Schalten Sie den Schalter Buskara ein und klicken Sie auf Speichern.

Ändern Sie das Feld "Adresse des Dienstes" in der Einbettung nicht: der Buskara-Support sagt Bescheid, falls es je nötig ist.

Von da an öffnen die Suchleiste und die Lupe des Themes das Buskara-Panel, mit dem Cursor bereit zum Schreiben. Den Schalter auszuschalten bringt die native Suche des Themes sofort zurück.

3. Der Knopf "ähnliche Produkte" auf den Produktseiten

Ein dezenter Knopf auf der Produktseite, der das Panel der ähnlichen Produkte öffnet, mit Filtern und Vergleich. Er kommt dorthin, wo der Händler ihn will:

1. Öffnen Sie im Theme-Editor eine Produktvorlage (Seitenauswahl oben → Produkte → die verwendete Vorlage).
2. Klicken Sie im Abschnitt der Produktdetails auf Block hinzufügen und wählen Sie "Buskara: Knopf ähnliche Produkte".
3. Ziehen Sie den Block an seine Stelle (unter dem Kaufknopf ist der übliche Platz) und Speichern.

4. Der Block "könnte Ihnen auch gefallen"

Das Empfehlungskarussell, gespeist von dem, was im Shop angesehen und gekauft wird:

1. Im selben Editor, auf jeder Vorlage (Produktseiten eingeschlossen), Abschnitt oder Block hinzufügen und "Buskara: Block könnte Ihnen auch gefallen" wählen.
2. Auf einer Produktseite gehen die Vorschläge von diesem Produkt aus; auf jeder anderen Seite zeigt das Karussell die allgemeinen Empfehlungen des Shops.
3. An die Stelle ziehen und Speichern.

Beide Blöcke zeichnen sich nur, wenn es Ergebnisse zu zeigen gibt: ein Block, der nichts zu sagen hat, nimmt keinen Platz ein.

Beide haben eine eigene Anleitung, mit dem Rest der Geschichte: der Knopf für ähnliche Produkte und der Block "könnte Ihnen auch gefallen" erzählt, was jeder von beiden zeigt, was im Panel eingestellt wird und was zu tun ist, wenn sie nicht erscheinen.

5. Der Alltag

Nach der ersten Synchronisierung hält sich der Katalog von selbst aktuell:

• In Echtzeit: ein Produkt anlegen, ändern oder löschen, oder den Bestand anfassen, erreicht den Index Sekunden später, direkt von Shopify.
• Periodisches Netz: in regelmäßigen Zyklen prüft Buskara, was sich seit dem letzten Durchlauf geändert hat, damit nichts zurückbleibt.
• Manuell: die Schaltfläche Alles neu indexieren auf der Shop-Seite im Panel. Die automatische Synchronisierung kostet nichts; eine vollständige Neuindexierung zu erzwingen kostet 1 bToken pro 1.000 Dokumente, und der Hinweis mit dem Betrag erscheint vor der Bestätigung.

Der Index folgt der Hauptsprache und Hauptwährung des Shops, plus den veröffentlichten Sprachen: ein Shop in zwei Sprachen bekommt die Suche in beiden, mit den Produktübersetzungen, die in Shopify existieren, und dem Original, wo sie fehlen.

6. Verbindung per Token, für Sonderfälle

Headless-Shops oder ungewöhnliche Aufbauten können sich ohne die App verbinden, mit einem von Hand erstellten Zugriffstoken: in der Shop-Administration unter Einstellungen → Apps und Vertriebskanäle → Apps entwickeln eine App mit den Leserechten (Produkte, Inventar, Veröffentlichungen, Sprachen, Märkte) erstellen, installieren, und das shpat_-Token auf dem Aktivierungsbildschirm von Buskara einfügen, über die Abkürzung "Sonderaufbau: mit einem Zugriffstoken verbinden". Alles Übrige verhält sich gleich.

7. Wenn etwas nicht aufgeht

• Die Suche erscheint nicht im Shop: prüfen Sie den Schalter der App-Einbettungen (Schritt 2) und ob gespeichert wurde.
• Produkte fehlen: Entwürfe, archivierte Produkte und nicht im Onlineshop-Kanal veröffentlichte Produkte bleiben absichtlich außerhalb des Index, weil sie keine Seite haben, auf die verwiesen werden kann. Die Anleitung zu den Produkten, die nicht erscheinen geht die übrigen Ursachen durch.
• Die Synchronisierung stoppte: das übliche Zeichen einer deinstallierten App oder eines widerrufenen Zugriffs. Installieren Sie erneut über Schritt 1; der Shop verbindet sich mit demselben Konto und nichts geht verloren.
• Das Shop-Limit des Plans ist erreicht: die Meldung nennt Plan und Limit; einen bereits vorhandenen Shop erneut zu verbinden wird nie blockiert.