Konzepte

Diese Seite erklärt das Vokabular von ReelCart und die Gründe hinter dem Design. Die Begriffe hier sind dieselben wie in der Administration, in der Konfiguration und in Support-Tickets.

Reel

Ein Reel ist ein vom Plugin verwaltetes Kurzvideo — hochgeladen, aus der Shopware-Medienbibliothek gewählt oder aus den Fotos eines Produkts erstellt (ein Instant Reel). Es ist immer selbst gehostet: Die Datei liegt in Ihrem Shopware-Medienspeicher und wird von Ihrer eigenen Domain oder Ihrem CDN ausgeliefert — genau wie ein Produktbild. Bewusst gibt es keine YouTube-, Vimeo- oder TikTok-Einbettung: Eine Einbettung würde bei jedem Seitenaufruf Skripte und Cookies eines Drittanbieters laden, und genau das muss ein DSGVO-sauberes Setup vermeiden.

Ein Reel hat ein Cover (Posterbild) — aus dem Video erfasst oder hochgeladen —, das in Kacheln, Stories-Kreisen, der schwebenden Blase und Social-Link-Vorschauen für das Video steht.

Reel-Produkte — eine Liste, zwei Aufgaben

Die Reel-Produkte sind die geordnete Liste der Produkte, die ein Reel verkauft. Dieselbe Liste entscheidet, wo das Reel erscheint: Ein Reel zeigt sich auf den Detailseiten genau der Produkte in seiner Liste und automatisch nirgendwo sonst.

Das ist einfacher, als es zunächst wirkt. Frühere Versionen taggten Produkte als zeitlich gesetzte, positionierte „Hotspots“ im Videobild und führten daneben eine eigene Liste der Produkte, auf denen ein Reel platziert war. Die Zeitmarken kosteten den Händler echte Arbeit pro Reel und brachten dem Kunden nichts — auf dem Handy war die Produktleiste ohnehin schon eine Auswahl über die ganze Liste —, und zwei Listen zu pflegen hieß, eine Liste zweimal zu pflegen. Beides in eine flache, geordnete Liste zu legen, löste beide Probleme: Das Reel verkauft, was es zeigt, und es erscheint, wo es verkauft.

Einträge sind immer Haupt- oder eigenständige Produkte, nie Varianten. Die Variante wählt der Kunde im Player; jede Variantenseite erbt die Reels des Hauptprodukts.

Produktkarte und Viewer

Die Produktkarte ist die Produkt-Oberfläche, die der Storefront für ein Reel zeigt. In einer Kachel ist sie eine kompakte Leiste — Bild, Name, Preis und, wenn das Reel genau ein Produkt verkauft, ein Kaufbutton. Im Viewer ist sie das vollständige Panel neben dem Video (auf kleinen Bildschirmen darunter): Galerie, Name, Preis, Lieferzeit, Variantenauswahl, Beschreibung und In-den-Warenkorb. Alles darin sind Live-Produktdaten; das Plugin speichert keine Kopien von Preisen oder Beständen.

Der Viewer ist die einzige Einkaufsfläche. Ein Reel mit mehreren Produkten öffnet den Viewer auf einer Auswahl; die Wahl eines Produkts lädt es an Ort und Stelle. Das schwebende Reel hat keinen Viewer — seine Produktleiste verlinkt zur Produktseite.

Layout-Modi und das Shoppable-Video-Element

Das Shoppable-Video-Element ist ein einzelnes Erlebniswelten-Element mit vier Layout-Modi — Einzelplayer, Karussell, Raster, Stories-Leiste — und vier Inhaltsquellen: ein einzelnes Reel, eine Playlist oder die beiden automatischen Produkt-Quellen, die auf Produktdetailseiten aufgelöst werden. Ein Element mit Schaltern statt vier Elementen hält ein Layout bearbeitbar, ohne es neu zu bauen, wenn der Händler seine Meinung ändert.

Die automatischen Quellen sind seitenweise, nie gedeckelt. Das Element rendert die ersten zwölf Reels mit der Seite und lädt weitere Seiten nach, sobald der Kunde das Ende der Leiste erreicht — dasselbe Muster wie Shopwares eigenes Listing, sodass sich Caching und Performance so verhalten, wie Händler es kennen.

Playlist

Eine Playlist ist eine geordnete Gruppe von Reels, die als Einheit behandelt wird. Sie trägt ein Standard-Layout, das ein Element beim Auswählen vorbelegt und pro Platzierung überschreiben kann. Auf Playlists bauen das Element Playlist-Hub (Zeilen von Playlists, jede mit Alle abspielen) und ein playlistgesteuertes schwebendes Reel auf.

Galerie-Einbindung und Cover-Reel

Die Galerie-Einbindung fügt die Reels eines Produkts als Slides in seine Bildergalerie auf der Produktseite ein — ohne Layout-Änderung. Sie ist standardmäßig aus, weil sie jede Produktseite auf einmal verändert; sie einzuschalten ist eine bewusste, shopweite Entscheidung.

Ein Cover-Reel geht einen Schritt weiter: Der Händler legt ein Reel als Cover eines Produkts fest, und das Video des Reels wird überall dort zum Hauptbild, wo ein Cover erscheint — Listen, Warenkorb, Feeds —, während sein Posterbild als Link-Vorschau dient. Die Aktion ist explizit und umkehrbar: Das Plugin merkt sich das vorherige Cover und stellt es beim Entfernen wieder her. Ein Reel, das nur in der Liste eines Produkts steht, wird dadurch nicht zum Cover.

Schwebendes Reel

Ein schwebendes Reel ist eine kleine Blase in einer Ecke, die sich zu einem kompakten Player ausklappt — eine Kampagnenfläche, die den Kunden über Seiten hinweg begleitet. Sie wird nach Verkaufskanal, Rule-Builder-Regeln, Seitentyp, Kategorie, Produkt oder eigener URL ausgesteuert und nach Priorität gereiht: Pro Seite erscheint nur ein schwebendes Reel, der höchstpriorisierte Treffer, der etwas abzuspielen hat. Kunden, die es schließen, bleiben für den vom Händler gewählten Wiederanzeige-Zeitraum verschont.

Attribution — First-Party und cookielos

Bei aktiver Messung erfasst der Storefront Attributions-Events — impression, play, complete, card_click, add_to_cart, purchase — als Zeilen in der eigenen Tabelle des Plugins. Kein Beacon zu einem Drittanbieter, kein identifizierendes Cookie, keine personenbezogenen Daten in der Zeile.

Der zugeordnete Umsatz ist die Kernkennzahl des Plugins. Sie funktioniert über den Warenkorb selbst: Ein aus der Karte eines Reels hinzugefügtes Produkt trägt die Reel-ID an seiner Warenkorbposition; wird aus dem Warenkorb eine Bestellung, wird der Umsatz der Position diesem Reel gutgeschrieben. Das macht die Attribution ehrlich und eng — ein Reel bekommt nur Anerkennung für das, was es direkt in den Warenkorb gelegt hat. Es ist „reel-assistierte“ Attribution, kein Multi-Touch-Modell, und die Dashboard-Texte machen das deutlich.

Weil nichts den Kunden identifiziert, braucht die Messung kein eigenes Consent-Banner. Der Schalter existiert, damit Händler, die gar keine Daten erfassen wollen, sie komplett abschalten können.

Video-SEO

Mit aktivem Video-Structured-Data hinzufügen tragen Reel-Seiten schema.org/VideoObject-Markup (Titel, Beschreibung, Poster, Dauer, Content-URL), damit Suchmaschinen Reels als Video-Rich-Results zeigen können. Es ist standardmäßig aus, damit es nie mit einer SEO-App kollidiert, die bereits Video-Markup ergänzt.

Warum Shopware 6.7.7

Seit 2.1.0 übergibt das Plugin den In-den-Warenkorb-Ablauf im Viewer an Shopwares eigenes Warenkorb-Plugin und hängt sich nur in das Absenden des Formulars ein, um den Viewer offen zu halten. Dieser Hook beruht auf einer Methode, die der Core erst mit 6.7.7 eingeführt hat — deshalb verlangt das Plugin ~6.7.7, statt den Warenkorb-Ablauf selbst nachzubauen.