Dokumentation

Shop Quest

Stand: Version 1.0.0 · aktualisiert am 18.11.2026

Video-Anleitung

Beim Abspielen wird das Video von YouTube geladen und Daten werden an YouTube übertragen. Datenschutz

Überblick

Shop Quest macht aus deinem Shop eine kleine Spielwelt im Browser. Deine Kategorien werden zu Marktständen oder Räumen, die Produkte liegen mit Bild und Preis aus. Besucher laufen mit Tastatur und Maus, per Touch (Joysticks oder Antippen) oder mit dem Gamepad herum, sehen sich Produkte an und legen sie in die Tasche. Die Tasche ist der echte Shopware-Warenkorb, bezahlt wird im ganz normalen Checkout.

Der klassische Shop bleibt, wie er ist. Die Spielwelt ist ein zusätzliches Angebot unter /play (Hauptspiel) oder unter einer eigenen Adresse wie /play/weihnachtsmarkt. Du kannst sie das ganze Jahr anbieten oder nur für bestimmte Zeiträume.

Startseite von Maison Lumen mit dem Shop-Quest-Button im Header und der Einladung unten rechts
Einstiege im Shop: 1 Button im Header, 2 Einladung auf der Startseite (bleibt sichtbar, bis der Besucher sie schließt).
Spielwelt im Stil Toy Town mit Weihnachtspaket: Marktstände mit Produkten, oben die Bedienelemente
Toy Town mit Saisonpaket Weihnachten: 1 die Tasche (= Warenkorb), 2 Karte & Suche, 3 Aufgaben, 4 zurück zum klassischen Shop.

Alles Wichtige richtest du an einer Stelle ein: Marketing → Shop Quest. Dort findest du die Liste deiner Spiele und von dort aus den Assistenten, den Editor, das Level-Studio, den Saisonkalender, die Auswertung und die Einstellungen.

Solange kein Spiel eingerichtet ist, zeigt Shop Quest im Shop nichts an, auch keinen Header-Button. Du kannst das Plugin also in Ruhe installieren und alles vorbereiten.

Voraussetzung ist Shopware 6.7.

Einrichtung

  1. Installiere und aktiviere Shop Quest unter Erweiterungen → Meine Erweiterungen.
  2. Öffne Marketing → Shop Quest und klick auf Erstes Spiel einrichten (bzw. Neues Spiel, wenn es schon Spiele gibt).
  3. Geh die sechs Schritte des Assistenten durch (unten im Detail). Mit Gleich veröffentlichen ist die Welt sofort spielbar.
  4. Öffne deinen Shop: Im Header erscheint der Button zur Spielwelt, auf der Startseite die Einladung.
Shop Quest: Liste der Spiele mit den Buttons Auswertung, Saisonkalender, Einstellungen und Neues Spiel
Marketing → Shop Quest: 1 Auswertung, 2 Saisonkalender, 3 Einstellungen, 4 Neues Spiel. 5 Jede Zeile zeigt Stil, Adresse („Wo“), die Live-Version und die Verkaufskanäle; ein Klick öffnet den Editor.

Die Liste zeigt dir auch, wenn ein Verkaufskanal noch kein Spiel unter /play hat. So siehst du sofort, wo noch etwas fehlt.

Schritt 1: Wie

Assistent Schritt Wie: drei Wege, ein Spiel zu bauen
1 Aus meinen Kategorien: in einer Minute spielbereit. 2 Mit dem KI-Architekten (optionaler In-App-Kauf). 3 Leer beginnen und die Bereiche im Editor selbst anlegen.
  • Aus meinen Kategorien: Jede gewählte Kategorie wird ein Bereich mit ihren Produkten. Für die meisten Shops der beste Start.
  • Mit dem KI-Architekten: Du beschreibst deinen Shop, die KI schlägt drei Konzepte vor und baut die gewählte Welt. Ohne Buchung zeigt die nächste Seite, was der KI-Architekt umfasst und wie du ihn buchst (siehe KI-Architekt).
  • Leer beginnen: Nach dem Erstellen öffnet sich der Editor, dort legst du die Bereiche selbst an.

Schritt 2: Wo

Assistent Schritt Wo: Name, Verkaufskanäle und Adresse
1 Verkaufskanal mit Adresse und dem Spiel, das dort gerade unter /play läuft. 2 Hauptspiel unter /play oder 3 eigene Adresse /play/… für eine Aktion oder ein zweites Spiel.
  • Name: nur für dich in der Administration sichtbar.
  • Verkaufskanäle: Unter jedem Kanal steht, welches Spiel dort gerade unter /play läuft.
  • Adresse: Das Hauptspiel (/play) ist das Ziel von Header-Button, Einladung und Teaser. Mit Eigene Adresse (/play/…) läuft das Spiel zusätzlich, zum Beispiel unter /play/weihnachtsmarkt für eine Kampagne. Erlaubt sind Kleinbuchstaben, Ziffern und Bindestriche.

Hat ein Kanal schon ein Hauptspiel, bleibt das ältere Spiel unter /play. Der Assistent warnt dich in dem Fall. Gib dem neuen Spiel eine eigene Adresse oder deaktiviere danach das alte Spiel.

Schritt 3: Stil

Assistent Schritt Stil: sechs Stile mit Illustration
1 Die sechs Stile. Den Stil kannst du später im Editor jederzeit wechseln, die Bereiche bleiben gleich.

Mehr zu den Stilen und zum Weihnachtspaket findest du unter Stile und Saisonpaket.

Schritt 4: Bereiche

Assistent Schritt Bereiche: Kategorien, Produkte pro Bereich, Sortierung, nur Produkte mit Bild
1 Kategorien in der gewünschten Reihenfolge (leer: erste Ebene der Navigation), 2 Produkte pro Bereich (1–12, Standard 6), 3 welche Produkte zuerst, 4 nur Produkte mit Bild.
  • Kategorien (in dieser Reihenfolge): Die Reihenfolge ist die Aufstellung, die ersten Bereiche sehen Besucher zuerst. Lässt du das Feld leer, nimmt Shop Quest die erste Ebene der Navigation des Verkaufskanals. Ein Spiel hat Platz für bis zu zwölf Bereiche. Kategorien ohne zeigbare Produkte fallen weg.
  • Produkte pro Bereich: 1 bis 12.
  • Welche Produkte zuerst: Topseller, Neueste, Niedrigster Preis oder Höchster Preis.
  • Nur Produkte mit Bild: empfohlen, Produkte ohne Bild sehen in der Welt leer aus.

Schritt 5: Spiel

Assistent Schritt Spiel: Standard-Steuerung und Aufgaben
1 Standard-Steuerung auf Touch-Geräten, 2 Aufgaben und Schatzsuche ein- oder ausschalten.
  • Standard-Steuerung: Virtuelle Joysticks oder Tippen oder Klicken zum Laufen. Das gilt nur für Smartphones und Tablets, am Computer laufen Besucher immer mit Tastatur und Maus. Besucher können es im Spiel umstellen.
  • Aufgaben und Schatzsuche: ab Werk aus. Eingeschaltet wählst du hier gleich die Zahl der versteckten Gegenstände (3–8).

Belohnungen, Logo, Farben, das hervorgehobene Produkt und den Titel stellst du danach im Editor ein.

Schritt 6: Prüfen

Assistent Schritt Prüfen: Zusammenfassung mit Hinweis, was nicht ins Spiel passt
1 Im Spiel: wie viele Bereiche und Produkte die Welt tatsächlich zeigt. 2 Gleich veröffentlichen. Darunter erklärt der Hinweis „Nicht alles passt“, welche Produkte wegfallen und warum.

Der Assistent rechnet vor dem Erstellen aus, was in die Welt passt. Bereiche zeigen ihre ersten Produkte in ihrer Reihenfolge; ist die Grenze erreicht, sagt dir der Hinweis genau, was du tun kannst (Grenze erhöhen, Bereich aufteilen, Produkte von Hand wählen, anders sortieren). Mit Spiel erstellen legst du das Spiel an. Ohne Gleich veröffentlichen bleibt es ein Entwurf, den du dir über die Vorschau ansehen kannst.

Spiel bearbeiten (Editor)

Ein Klick auf ein Spiel in der Liste öffnet den Editor. Oben findest du KI-Architekt, Vorschau, Speichern und Veröffentlichen.

Speichern sichert nur den Entwurf. Besucher sehen Änderungen erst nach Veröffentlichen. Jede Veröffentlichung wird als neue Version gespeichert, die du jederzeit wieder live schalten kannst.

Editor eines Spiels: Karte Allgemein mit Stil, Steuerung und Adresse, oben Vorschau und Veröffentlichen
1 Stil, 2 Standard-Steuerung, 3 eigene Adresse (leer = Hauptspiel unter /play), 4 Vorschau des Entwurfs, 5 Veröffentlichen.

Allgemein

FeldBedeutung
NameNur für dich im Admin sichtbar.
StilEiner der sechs Stile. Ein Wechsel behält alle Bereiche.
AnsichtNur bei Block World: Von schräg hinten (über die Figur hinweg) oder Ego-Perspektive (durch die Augen der Figur).
Standard-SteuerungVirtuelle Joysticks oder Tippen oder Klicken zum Laufen (nur Touch-Geräte).
Eigene Adresse (optional)Leer: Das Spiel ist das Hauptspiel unter /play seiner Verkaufskanäle (bei mehreren Hauptspielen gilt das älteste). Mit Adresse: erreichbar unter /play/<adresse>.
VerkaufskanäleLeer lassen für alle Verkaufskanäle.
AktivAusgeschaltet ist das Spiel im Shop nicht erreichbar.

Unter Name der Welt legst du den Titel fest, den Besucher sehen, pro Sprache (höchstens 32 Zeichen). Behältst du den Standardtitel, passt Shop Quest ihn automatisch an Stil und Saison an, zum Beispiel „Pixel-Station“, „Nachtvilla“ oder mit Weihnachtspaket „Winterdorf“.

Bereiche (Stände bzw. Räume)

Jeder Bereich ist ein Marktstand oder ein Raum. Die Reihenfolge ist die Aufstellung, mit den Pfeilen ↑ ↓ sortierst du um. Ein Spiel hat bis zu 12 Bereiche mit je bis zu 12 Produkten, insgesamt zeigt eine Welt höchstens 64 Produkte.

Ein Bereich im Editor: Schild, Produktquelle, Sortierung, Anzahl und Präsentation
1 Schildtext pro Sprache, 2 woher die Produkte kommen, 3 Sortierung, 4 Anzahl (1–12), 5 Präsentation.
  • Schild: der Text über dem Stand oder an der Raumtür, pro Sprache. Am besten lesbar sind bis zu 16 Zeichen, erlaubt sind 24. Der Editor zeigt dir die Zeichenzahl an.
  • Produkte kommen aus:
    • Kategorie
    • Dynamische Produktgruppe
    • Ausgewählte Produkte (handverlesen, in deiner Reihenfolge)
    • Regel (Topseller, Neuheiten, Angebote), optional nur aus einer Kategorie
  • Sortierung: Topseller, Neueste, Preis aufsteigend, Preis absteigend.
  • Produkte (1–12): Unter dem Feld steht, wie viele Produkte tatsächlich ins Spiel kommen („Im Spiel: 7 von 9 Produkten“).
  • Präsentation: Automatisch (anhand von Bereichsname und Produkten: Größenvarianten kommen auf die Kleiderstange, Highlight-Produkte auf Podeste), Kleiderstange, Tisch (kleine Artikel), Podeste (Highlights) oder Staffeleien.
  • Plakatbild: Leer nimmt Shop Quest das Bild der Kategorie des Bereichs.

Oben in der Karte schaltest du Nur Produkte mit Bild für das ganze Spiel ein oder aus.

Zeigt ein Bereich nur einen Teil seiner Kategorie, verlinkt das Spiel auf den Rest („Alle … im Shop ansehen“). Besucher verpassen also nichts.

Marke

Die Welt zeigt deinen Shop: das Logo auf Banner und Schildern, die Markenfarben an Wimpelketten und Rahmen, Kategoriebilder als Plakate. Standardmäßig kommt alles aus deinem Storefront-Theme.

  • Shop-Logo zeigen, optional mit Eigenes Logo für diese Welt (leer: Logo aus dem Theme).
  • Eigene Markenfarben für diese Welt mit Primärfarbe und Sekundärfarbe. Aus: Primär- und Sekundärfarbe aus dem Theme.
  • Kategoriebilder als Plakate: Jeder Bereich zeigt das Bild seiner Kategorie (oder sein Plakatbild) an der Theke oder an der Raumwand.

Die Marken-Einstellungen gehören zum Spiel und werden mit ihm versioniert und veröffentlicht.

Anordnung und Versionen

In der Karte Anordnung siehst du, ob die Welt automatisch aus den Bereichen erzeugt wird oder eine eigene Anordnung aus dem Level-Studio hat. Mit Level-Studio öffnen geht es dorthin.

Karte Versionen: Notiz zur nächsten Veröffentlichung und Liste der Versionen
1 Notiz zur nächsten Veröffentlichung (z. B. „Neue Geschenkideen“), 2 die veröffentlichten Versionen; die markierte ist live. Über das Menü ··· gibt es Vorschau, Live schalten und In den Entwurf übernehmen.
  • Vorschau: öffnet die Version (oder oben den Entwurf) über einen Vorschau-Link im Shop. Vorschauen zählen nicht in der Statistik.
  • Live schalten: macht eine ältere Version sofort wieder sichtbar. Ideal, wenn nach einer Änderung etwas nicht stimmt.
  • In den Entwurf übernehmen: lädt eine Version zum Weiterbearbeiten. Danach Speichern nicht vergessen.

Stile und Saisonpaket

StilWeltAnsicht
Toy Townein fröhlicher Marktplatz mit Ständenvon oben, die eigene Figur läuft mit
Retroeine Pixel-Raumstation mit RäumenIch-Perspektive
Night Shiftein Herrenhaus bei Kerzenlicht, Räume voller PorträtsIch-Perspektive
Block Worldein Klötzchendorf mit Marktständenvon schräg hinten oder Ego-Perspektive (im Editor wählbar)
16-Bit Adventureeine Pixel-Marktstadt in 2Dvon oben, läuft auch ohne WebGL
Flagship Showroomein heller, moderner Store mit einem Raum pro BereichIch-Perspektive

In Toy Town, Block World und dem 16-Bit Adventure sehen Besucher ihre eigene Spielfigur. Angemeldete Kunden mit der Anrede „Herr“ oder „Frau“ bekommen eine passende Figur, alle anderen eine neutrale (abschaltbar in den Einstellungen).

Saisonpaket Weihnachten: Das Paket ist im Plugin enthalten und gibt jedem Stil sein weihnachtliches Aussehen, seine Illustration, Texte und Geräuschkulisse. Toy Town, Block World und das 16-Bit Adventure werden zum verschneiten Weihnachtsmarkt („Winterdorf“ statt „Marktplatz“), Retro zur geschmückten Raumstation, Night Shift zur Villa an Heiligabend und der Flagship Showroom zum festlichen Store. Ohne Paket zeigt jeder Stil sein ganzjähriges Aussehen.

Du schaltest das Paket auf zwei Arten ein:

  • dauerhaft in den Einstellungen unter Saison-Paket, oder
  • nur für einen Zeitraum über einen Termin im Saisonkalender (empfohlen, dann musst du nach Weihnachten an nichts denken).

Level-Studio

Im Level-Studio ordnest du die Welt selbst an: Stände, Räume und Deko verschieben, Bereiche tauschen, einen Bereich neu anordnen. Du öffnest es im Editor über Anordnung → Level-Studio öffnen. Das Spiel muss dafür einmal gespeichert sein.

Level-Studio: Werkzeugleiste, Plan der Welt und Auswahl, oben Probespielen und Anordnung speichern
1 Werkzeuge (Rückgängig, Wiederholen, Neue Anordnung, Bereich neu anordnen, Drehen), 2 Plan der Welt, 3 Auswahl mit Bereichen und Produkten, 4 Probespielen, 5 Anordnung speichern.

So arbeitest du im Studio:

  1. Klick etwas im Plan an, um es auszuwählen. Zieh es, um es zu verschieben.
  2. Zieh einen Bereich auf einen anderen, um die Plätze zu tauschen.
  3. Bereich neu anordnen würfelt die Aufstellung eines Bereichs neu, Neue Anordnung die ganze Welt.
  4. Mit Probespielen läufst du durch die Welt, so wie Besucher sie sehen. Dabei wird nichts gespeichert. Zurück zum Bearbeiten bringt dich zurück.
  5. Anordnung speichern legt sie im Entwurf ab. Erst mit Veröffentlichen im Editor sehen Besucher die neue Anordnung.

Tastenkürzel: Pfeiltasten verschieben die Auswahl, R dreht, Strg+Z macht rückgängig, Strg+Y wiederholt, Esc hebt die Auswahl auf.

Das Studio verhindert ungültige Anordnungen und sagt dir den Grund, zum Beispiel „es würde einen Stand, die Kasse oder den Ausgang versperren“ oder „Besucher kämen nicht mehr überall hin“. Mit Eigene Anordnung entfernen kehrt der Entwurf zur automatischen Anordnung zurück; veröffentlichte Versionen behalten ihre Anordnung, bis du erneut veröffentlichst.

Fügst du nach dem Speichern einer Anordnung Bereiche hinzu oder entfernst welche, weist dich der Editor darauf hin. Öffne dann das Level-Studio und speichere die Anordnung neu, sonst sehen Besucher womöglich die automatische Anordnung.

Aufgaben, Schatzsuche und Belohnungen

Kleine Aufgaben führen Besucher durch die Welt. Zum Abschluss gibt es ein Abzeichen und eine kleine Feier, auf Wunsch auch einen Gutscheincode. Keine Aufgabe verlangt einen Kauf. Du schaltest alles im Editor in der Karte Aufgaben und Schatzsuche ein (ab Werk aus).

Die Aufgaben im Spiel:

AufgabeWann sie erscheint
Sag dem Guide Hallowenn die Welt einen Info-Stand hat
Besuche 3 verschiedene Bereicheimmer (bei weniger Bereichen entsprechend weniger)
Sieh dir 3 Produkte genauer animmer
Finde Produktnur mit Hervorgehobenes Produkt, und nur wenn das Produkt in einem Bereich steht
Schatzsuche3 bis 8 versteckte Gegenstände

Jeder Stil versteckt eigene Dinge: goldene Sterne (Toy Town), Energiezellen (Retro), Schlüssel (Night Shift), Geschenke (Block World), Lebkuchenherzen (16-Bit Adventure) oder goldene Einkaufstüten (Showroom).

Karte Aufgaben und Schatzsuche mit versteckten Gegenständen, hervorgehobenem Produkt und einer Belohnung
1 Zahl der versteckten Gegenstände (3–8), 2 hervorgehobenes Produkt für die Aufgabe „Finde …“, 3 eine Belohnung: für welche Aufgabe, aus welcher Aktion, mit welchen Bedingungen.

Belohnungen (optional)

Besucher bekommen einen Gutscheincode aus einer deiner Aktionen (Marketing → Rabatte & Aktionen), wenn sie eine Aufgabe erledigen.

  1. Leg eine Aktion an und schalte dort die Aktionscodes ein.
  2. Klick im Editor auf Belohnung hinzufügen.
  3. Wähle bei Für die Aufgabe: Mit dem Guide sprechen, Bereiche besuchen, Produkte ansehen, Das hervorgehobene Produkt finden, Die Schatzsuche oder Alle Aufgaben erledigt. Jede Aufgabe kann eine Belohnung haben.
  4. Wähle die Aktion und schreib die Bedingungen (bis 200 Zeichen pro Sprache). Das Spiel zeigt sie zusammen mit dem Code.
  5. Speichern und veröffentlichen.

Unter der Belohnung zeigt der Editor den Zustand der Aktion: „Ein Code für alle: …“ oder bei individuellen Codes, wie viele frei, im Spiel vergeben und eingelöst sind. Kann die Aktion gerade keinen Code liefern (inaktiv, abgelaufen, noch nicht gestartet, ohne Aktionscode, nicht in allen Verkaufskanälen der Welt, Codes vergeben), siehst du dort einen Hinweis, und das Spiel bietet keinen Code an.

Ein Browserspiel kann nicht prüfen, ob eine Aufgabe wirklich gespielt wurde. Nimm deshalb eine Aktion mit individuellen Codes, die nur Shop Quest vergibt, und begrenze sie in der Aktion (Einlösungen pro Kunde, insgesamt, Mindestbestellwert). Individuelle Codes vergibt Shop Quest zusätzlich mit einer Begrenzung pro IP-Adresse.

Im Spiel kann der Besucher den Code kopieren oder direkt mit Code einlösen in die Tasche legen. Ist die Tasche noch leer oder sind die Bedingungen noch nicht erfüllt, wird der Code vorgemerkt und gilt, sobald es passt. In der Vorschau zeigt das Spiel einen Beispielcode, echte Codes gibt es nur im Live-Spiel.

Aufgabenliste im Spiel mit Fortschritt und Belohnung
Die Aufgabenliste mit Fortschritt, Schatzsuche und Belohnung. Besucher öffnen sie jederzeit mit dem Stern-Button oben oder der Taste J.

Im Spiel

So bewegen sich Besucher durch die Welt. Beim Start zeigt eine Titelkarte die Steuerung passend zum Gerät, danach helfen Hinweise in der Welt bis zum ersten Kauf.

GerätSteuerung
Tastatur und MausWASD oder Pfeiltasten laufen, Shift rennt, Klick auf den Boden läuft hin, E (oder Enter/Leertaste) sieht sich ein Produkt an, M Karte und Schnellreise, F oder / Produktsuche, J Aufgaben, Esc Menü bzw. Maus freigeben
Ich-Perspektive (Retro, Night Shift, Showroom, Block World mit Ego-Ansicht)erst ins Bild klicken, dann mit der Maus umsehen; Esc gibt die Maus frei und öffnet die Pause
Touchauf den Boden tippen zum Laufen, auf ein Produkt tippen zum Ansehen, oder virtuelle Joysticks; der Karten-Knopf oben links bringt dich überall hin
Gamepadlinker Stick laufen, rechter Stick umsehen bzw. Kamera drehen, A ansehen, B zurück, X Tasche, Y Karte, Schultertasten rennen, Start Menü
Karte und Suche im Spiel: Karte der Welt, Suchfeld und Liste der Bereiche
Taste M: 1 Karte der Welt (antippen = hinreisen), 2 Produktsuche, 3 Bereiche, Kasse und Eingang als Schnellreise-Ziele.
Produktdialog im Spiel mit Variantenauswahl und In-die-Tasche-Button
Produktdialog: 1 Varianten wählen, 2 In die Tasche, 3 Produktseite öffnen.

Im Produktdialog wählen Besucher Varianten und Menge und legen das Produkt in die Tasche, es fliegt sichtbar hinein. An der Kasse in der Welt sehen sie ihre Tasche und gehen mit Zur Kasse in deinen normalen Checkout. Auf Warenkorb- und Checkout-Seiten erscheint ein Link Zurück zum Marktplatz (bzw. passend zum Stil), damit sie weiterbummeln können.

Saisonkalender

Mit dem Saisonkalender planst du Zeiträume wie Advent, Ostern oder einen Sommer-Sale. Während ein Termin läuft, ist die Spielwelt geöffnet, mit der Welt, dem Stil, dem Saisonpaket und den Einstiegen dieses Termins. Außerhalb gilt der Saisonzeitraum aus den Einstellungen. Du öffnest ihn über Saisonkalender in der Spieleliste und legst Termine mit Neuer Termin an.

Termin im Saisonkalender: Beginn, Ende, Priorität, Welt, Saison-Paket und Einstiege
1 Beginn und Ende, 2 Priorität bei überlappenden Terminen, 3 Welt (leer: Standardwelt des Verkaufskanals), 4 Saison-Paket, 5 Einstiege während des Termins.
FeldBedeutung
Name, AktivBezeichnung und Schalter des Termins.
Beginn, EndeZeitraum mit Uhrzeit.
VerkaufskanäleLeer lassen für alle.
PrioritätLaufen mehrere Termine gleichzeitig, gilt der mit der höchsten Priorität.
WeltDas Spiel während des Termins. Leer: die Standardwelt des Verkaufskanals.
StilWie die Welt oder ein anderer Stil nur für diesen Zeitraum.
Saison-PaketWie in den Plugin-Einstellungen, Ganzjährig oder Weihnachten.
Button im Shop-Header, Einladung auf der StartseiteEinstiege während des Termins.

Die Liste zeigt für jeden Termin den Status: Geplant, Läuft, Vorbei oder Inaktiv.

Auswertung

Unter Auswertung siehst du, wie die Spielwelt genutzt wird, gefiltert nach Zeitraum (7, 30, 90 oder 365 Tage), Verkaufskanal und Welt.

Auswertung: Filter, Kennzahlen und Bereichs-Heatmap
1 Zeitraum, Verkaufskanal und Welt, 2 Kennzahlen im Überblick, 3 Bereiche: dunklere Felder = höherer Wert im Vergleich zu den anderen Bereichen.

Die Kennzahlen: Spielstarts, Bereichsbesuche, Produktansichten, In die Tasche gelegt, Kassenbesuche, Zum Checkout, Bestellungen, Bestellpositionen, Umsatz, Bestellungen pro Spielstart, Schatzsuchen beendet, Alle Aufgaben erledigt und Vergebene Gutscheincodes. Darunter gibt es den Verlauf Pro Tag (als Diagramm oder mit Als Tabelle anzeigen) und die Bereichs-Heatmap; für den genauen Wert zeigst du mit der Maus auf ein Feld.

Es sind anonyme Zähler ohne Cookies und ohne personenbezogene Daten. Vorschauen zählen nicht. Als Bestellung zählt jede Bestellung mit mindestens einem Produkt, das im Spiel in die Tasche gelegt wurde; der Umsatz ist der Umsatz dieser Produkte in der Standardwährung, ohne stornierte Bestellungen.

Für die Konsole gibt es den Bericht bin/console flink-shop-quest:stats mit den Optionen --days (Standard 30), --sales-channel und --world.

KI-Architekt (optional)

Der KI-Architekt ist ein optionaler In-App-Kauf (monatliches Abo im Shopware Store mit einem Kontingent an KI-Welten und Chat-Änderungen; den Preis zeigt der Buchungsdialog). Du öffnest ihn im Assistenten (Mit dem KI-Architekten) oder im Editor über KI-Architekt.

  • Du beschreibst deine Idee in ein paar Worten (optional), die KI schaut sich Kategorien, Bestseller und Preise an und schlägt drei Konzepte vor. Mit Direkt bauen geht es ohne Auswahl.
  • Die gewählte Welt entsteht live in der Vorschau. Danach bewertet die KI Bilder ihrer Welt und verbessert, was ihr auffällt.
  • Änderungen per Chat, zum Beispiel „Schals nach vorne“ oder „Eine Geschenkecke unter 30 €“.
  • Schildtexte werden in alle Sprachen deines Shops übersetzt.

Alles, was die KI baut, bleibt ein Entwurf, bis du es veröffentlichst. Ohne KI-Architekt entstehen Welten kostenlos aus deinen Kategorien.

Einstellungen

Die Einstellungen öffnest du über Einstellungen in der Spieleliste. Sie gelten für einen ganzen Verkaufskanal; alles zu einem einzelnen Spiel (Bereiche, Stil, Steuerung, Aufgaben) stellst du im Editor ein.

Shop Quest Einstellungen: Verkaufskanal-Auswahl und Karte Einstiege und Saison
1 Verkaufskanal wählen, 2 Saison-Paket, 3 Button im Shop-Header, 4 Einladung auf der Startseite, 5 Saisonzeitraum.

Einstiege und Saison

EinstellungBedeutungStandard
Saison-PaketGanzjährig (kein Saison-Paket) oder Weihnachten. Termine im Saisonkalender können das Paket für ihre Zeit einschalten.Ganzjährig
Button im Shop-HeaderFührt zu /play, dem Hauptspiel des Verkaufskanals. Ohne Hauptspiel zeigt der Shop keine Einstiege.an
Einladung auf der Startseite (schließbar, bis sie geschlossen wird)Kleine Einladung unten auf der Startseite.an
Saison beginntAb diesem Zeitpunkt werden die Einstiege gezeigt. Leer: sofort.leer
Saison endetDanach verschwinden die Einstiege; /play bleibt erreichbar, solange das Hauptspiel veröffentlicht und aktiv ist.leer

Spielseite

EinstellungBedeutungStandard
Produkte, die auf der Produktseite konfiguriert werdenFür Produkte mit Optionen, die das Spiel nicht zeigen kann (z. B. personalisierte Produkte), verlinkt das Spiel auf die Produktseite („Im Shop konfigurieren“), statt sie in die Tasche zu legen.leer
Spielfigur passend zur Anrede des KundenIn Toy Town, Block World und dem 16-Bit Adventure: männliche oder weibliche Figur für angemeldete Kunden mit Anrede „Herr“ oder „Frau“, sonst neutral. Aus: neutral für alle. Andere Besucher sehen diese Auswahl nie.an
Diese Elemente auf der Spielseite ausblendenEin CSS-Selektor pro Zeile, z. B. für eine Chat-Blase, die die Steuerung verdeckt. Gängige Chat-Widgets und Trust-Badges werden ohnehin ausgeblendet, der Cookie-Banner bleibt immer sichtbar.leer

Live-Modus (andere Besucher)

EinstellungBedeutungStandard
Andere Besucher in der Spielwelt zeigenAndere Besucher erscheinen als Figuren, mit Besucherzahl und Emotes. Benötigt den Shop-Quest-Relay-Server. Besucher können es im Spiel abschalten. Bitte in der Datenschutzerklärung erwähnen.aus
Relay-URL, Schlüssel-ID, GeheimnisZugangsdaten des Relays (Adresse beginnt mit wss://).leer
Gleichzeitig gezeigte andere Besucher1 bis 40.20
Verbindung testenPrüft Relay-Adresse, Schlüssel-ID und Secret und sagt dir, was nicht stimmt.–

Erlebniswelten-Teaser

Für Startseite, Kategorie- oder Landingpages gibt es den Erlebniswelten-Block Shop Quest: Teaser (Kategorie Commerce): eine Illustration der Welt mit Überschrift, Text und Button ins Spiel.

  • Überschrift, Text, Button-Text: leer lassen für den Standardtext des Stils (anpassbar unter Einstellungen → Textbausteine, Suche nach flinkShopQuest.teaser).
  • Darstellung: Festlich (Himmel der Illustration), Hell oder Dunkel.
  • Spielwelt: Wie in der Plugin-Konfiguration oder ein bestimmter Stil (mit passender Illustration).
  • Anzeigen: Nur während der Saison oder Immer, solange Shop Quest aktiv ist.

Ist Shop Quest deaktiviert oder die Saison vorbei, zeigt der Shop den Teaser nicht an. Der Block kann also das ganze Jahr im Layout bleiben.

Tipps & versteckte Funktionen

  • „In der Spielwelt ansehen“ auf der Produktseite: Steht ein Produkt (oder sein Hauptprodukt) in der Welt und ist das Spiel geöffnet, bekommt die Produktseite unter dem Kaufen-Button einen Link, der Besucher direkt zum Produkt in der Welt bringt.
Produktseite mit dem Button In der Spielwelt ansehen
1 „In der Spielwelt ansehen“ erscheint automatisch bei Produkten, die in der Welt stehen.
  • Stil oder Weihnachtspaket per Link ausprobieren: /play?style=retro zeigt die Welt in einem anderen Stil (toytown, retro, nightshift, blockworld, adventure, showroom), /play?pack=christmas mit Weihnachtspaket, /play?pack=standard ohne. Praktisch für Social-Media-Links oder um vor der Saison zu testen, ohne etwas umzustellen.
  • Einfache Ansicht: /play?view=simple zeigt alle Bereiche und Produkte als Liste ohne 3D. Besucher finden sie auch im Spielmenü unter Einstellungen → Einfache Ansicht (ohne 3D); ruckelt es, schlägt das Spiel sie von selbst vor.
  • Schnellreise: Mit M (oder dem Karten-Knopf) springen Besucher sofort zu jedem Bereich, zur Kasse oder zum Eingang. F öffnet direkt die Produktsuche.
  • Kamera: In Toy Town und Block World drehen Q und R die Kamera, +/− oder das Mausrad zoomen (auch im 16-Bit Adventure).
  • Emotes im Live-Modus: Mit 1, 2 und 3 winken Besucher, schicken ein Herz oder eine Schneeflocke.
  • Spiel-Einstellungen für Besucher: Ton, Lautstärke, Umgebungsgeräusche, Hintergrundmusik (ab Werk aus), Minikarte, Joysticks, Sichtfeld, Umsehen-Geschwindigkeit, Hoch/runter umkehren, Kameraabstand, Bewegungen reduzieren, flackerndes Licht (Night Shift) und Grafikqualität.
  • Zwei Spiele gleichzeitig: Ein Hauptspiel unter /play und weitere Spiele mit eigener Adresse, zum Beispiel ein Weihnachtsmarkt unter /play/weihnachtsmarkt für den Newsletter.
  • Texte anpassen: Alle Texte im Shop und im Spiel (Einladung, Button, Weltname, Aufgaben) sind Textbausteine mit dem Präfix flinkShopQuest. und lassen sich unter Einstellungen → Textbausteine ändern.
  • Vorher testen: Der Button Vorschau im Editor öffnet den Entwurf im Shop, auch wenn das Spiel noch nicht veröffentlicht ist. Vorschauen zählen nicht in der Auswertung.

Häufige Fragen

Im Shop erscheint kein Button und keine Einladung. Warum?

Die Einstiege erscheinen nur, wenn der Verkaufskanal ein veröffentlichtes, aktives Hauptspiel hat (ein Spiel ohne eigene Adresse) und die Saison läuft (Saison beginnt / Saison endet in den Einstellungen, oder ein laufender Termin im Saisonkalender). Prüfe außerdem Button im Shop-Header und Einladung auf der Startseite in den Einstellungen des richtigen Verkaufskanals. Die Einladung erscheint nur auf der Startseite und nicht mehr, nachdem der Besucher sie geschlossen hat. Nach Änderungen hilft es, den Shop-Cache zu leeren.

Ich habe etwas geändert, aber im Spiel ist es nicht zu sehen.

Speichern sichert nur den Entwurf. Erst Veröffentlichen macht die Änderung für Besucher sichtbar. Das gilt auch für Anordnungen aus dem Level-Studio.

Wie läuft die Spielwelt auf älteren Geräten und Smartphones?

Shop Quest wählt die Grafikqualität mit einem kurzen Test und passt sie beim Spielen an, auch wieder nach oben. Startet eine Welt auf einem Gerät nicht vollständig, folgt beim nächsten Mal ein leichterer, sicherer Start; nach zwei nicht beendeten Starts bekommt der Besucher die einfache Ansicht und den klassischen Shop. Ohne WebGL läuft das 16-Bit Adventure trotzdem, die anderen Stile zeigen dann die einfache Ansicht. Solche Startprobleme stehen mit Schritt und Grafikchip im Log des Shops (var/log/FlinkShopQuest-<Datum>.log), ohne Besucherdaten.

Shop Quest auf dem Smartphone mit virtuellen Joysticks
Auf dem Smartphone: 1 virtueller Joystick (oder Tippen zum Laufen), 2 Karte & Suche, 3 Tasche.

Wird die Spielseite von Suchmaschinen indexiert?

Nein. Die Spielseiten sind mit noindex, follow ausgezeichnet. Deine normalen Kategorie- und Produktseiten bleiben für SEO maßgeblich.

Muss ich mit dem HTTP-Cache etwas beachten?

Die Spielseiten werden nicht zwischengespeichert, Preise, Lagerbestand und Warenkorb sind deshalb immer aktuell. Produktbilder bereitet der Server zu Bildbögen auf, damit das Spiel schnell lädt; das passiert automatisch über eine geplante Aufgabe. Du kannst es mit bin/console flink-shop-quest:prepare-images auch von Hand anstoßen (Optionen --sales-channel, --world, --force). Nach Änderungen an den Einstiegen (Header-Button, Einladung) leere den Shop-Cache, falls die Seiten im Cache liegen.

Ein Produkt fehlt in der Welt.

Ein Bereich zeigt nur Produkte, die im Verkaufskanal sichtbar, verfügbar und (mit Nur Produkte mit Bild) mit Bild sind, und nur so viele, wie seine Grenze erlaubt. Der Editor zeigt pro Bereich „Im Spiel: x von y Produkten“ und erklärt, was du tun kannst. Ein ganzes Spiel zeigt höchstens 64 Produkte.

Was passiert mit Produkten mit Varianten oder individuellen Optionen?

Varianten wählen Besucher direkt im Produktdialog. Produkte, die das Spiel nicht konfigurieren kann (z. B. personalisierte Produkte), trägst du unter Produkte, die auf der Produktseite konfiguriert werden ein; das Spiel verlinkt dann auf die Produktseite.

Ein Chat-Widget verdeckt die Steuerung.

Trag den CSS-Selektor des Widgets in den Einstellungen unter Diese Elemente auf der Spielseite ausblenden ein, einen pro Zeile. Gängige Chat-Widgets blendet Shop Quest schon von selbst aus.

Funktioniert Shop Quest mit mehreren Sprachen?

Ja. Weltname, Schildtexte und Bedingungen der Belohnungen pflegst du pro Sprache, alle anderen Texte kommen aus den Textbausteinen (Deutsch und Englisch sind enthalten). Der KI-Architekt übersetzt Schildtexte in alle Sprachen deines Shops.

Was speichert Shop Quest im Browser der Besucher?

Shop Quest fügt der Cookie-Zustimmung einen optionalen Eintrag „Spielwelt Shop Quest“ (Komfortfunktionen) hinzu. Nur mit Zustimmung merkt sich der Browser Einstellungen wie Ton, Ansicht, Steuerung, die geschlossene Einladung und den Fortschritt der Aufgaben. Ohne Zustimmung gelten sie nur für den aktuellen Seitenaufruf. Es wird nichts an einen Server gesendet. Der Live-Modus überträgt die Position anonym an das Relay; Besucher können ihn im Spiel abschalten.

Was passiert bei der Deinstallation?

Wählst du beim Deinstallieren, die Daten nicht zu behalten, entfernt Shop Quest seine Tabellen und Daten vollständig.