Zum Inhalt

Prämienartikel PRO (Shopware 6)

Biete deinen Kunden Prämien an, um den Warenkorbwert zu erhöhen und die Kundenbindung zu festigen. Mit der Erweiterung wählst du Artikel aus, die der Kunde ab einem festgelegten Warenkorbwert oder beim Kauf bestimmter Artikel kostenlos erhält.

Prämienartikel PRO Plugin für Shopware 6 im Shopware Store


Funktionen

  • Prämien je erreichtem Warenkorbwert (Warenkorb-Prämie), z. B. 1 Stück je 50 € Warenkorbwert
  • Gratis-Zugaben zu gekauften Artikeln (Artikel-Zugabe), nach Stückzahl oder nach Warenwert der Auslöser-Artikel
  • Auslöser: Produkte (mit ihren Varianten) und Kategorien (mit ihren Unterkategorien)
  • Mehrere Stück einer Prämie je erreichter Stufe
  • Gemeinsames oder getrenntes Kontingent für Artikel-Zugaben
  • Hinweis auf Gratis-Zugaben auf der Produktdetailseite
  • Prämienauswahl auf einer eigenen Seite, im Offcanvas-Warenkorb und über das Erlebniswelten-Element „Prämien-Liste“
  • Automatisches Hinzufügen zum Warenkorb mit einstellbarer Menge und Priorität
  • Warenkorbwert mit oder ohne Versandkosten oder nur aus Positionen, die eine Regel erfüllen
  • Limits pro Bestellung, pro Kunde über alle Bestellungen und für alle Prämien zusammen
  • Einschränkung nach Verkaufskanal und Regel aus dem Rule Builder
  • Statistik je Prämie mit Kennzahlen und Verlaufsdiagramm nach Tag, Woche oder Monat
  • Eigene Produktnummern im Payload, z. B. für die Warenwirtschaft
  • Store API für Headless- und PWA-Shops

Installation

  1. Installiere und aktiviere die Erweiterung unter Erweiterungen → Meine Erweiterungen.
  2. Lege in der Konfiguration der Erweiterung deine Einstellungen fest (Abschnitt Einstellungen).
  3. Lege unter Marketing → Prämien deine Prämien an (Abschnitt Prämie anlegen).
  4. Leere den Cache und teste die Prämien im Shop.

Prämie anlegen

Unter Marketing → Prämien siehst du alle Prämien mit ihrer Bedingung, der Anzahl der bisher gewählten Einheiten („Anzahl gewählt“) und dem Zeitpunkt der letzten Bestellung mit dieser Prämie („Zuletzt gewählt“). Über Prämie anlegen legst du eine neue Prämie an. Im Kontextmenü einer Prämie öffnest du ihre Statistiken oder Duplizierst sie; die Kopie heißt wie das Original mit dem Zusatz „Kopie“ und ist zunächst inaktiv.

Die Prämie selbst ist ein gewöhnliches Produkt aus deinem Katalog. Im Warenkorb erscheint sie mit 0,00 €: Die Erweiterung legt das Produkt zusammen mit einem Rabatt von 100 % in den Warenkorb.

Stammdaten

Feld Wirkung
Aktiv Nur aktive Prämien werden im Shop angeboten. Eine neue Prämie ist zunächst inaktiv.
Name Name der Prämie. Er steht im Warenkorb und in der Bestellung. Ob die Prämienauswahl im Shop diesen Namen oder den Produktnamen zeigt, legst du mit der Einstellung Prämienname fest. Der Name ist übersetzbar, wähle dazu oben die Sprache.
Produkt Das Produkt, das der Kunde als Prämie erhält. Varianten sind auswählbar. Prämien ohne Produkt werden im Shop nicht angeboten.

Bedingung

Feld Wirkung
Prämienart Warenkorb-Prämie: richtet sich nach dem Warenkorbwert. Artikel-Zugabe (nach Stückzahl) und Artikel-Zugabe (nach Warenwert): richten sich nach gekauften Auslöser-Artikeln. Artikel-Zugaben gelten zusätzlich zu Warenkorb-Prämien, sie werden nicht miteinander verrechnet.
Warenkorbwert je Stufe Nur bei Warenkorb-Prämien: der Warenkorbwert, ab dem der Kunde die Prämie erhält. Wird ohne Umrechnung mit dem Warenkorbwert in der Währung des Kunden verglichen. Wie der Warenkorbwert berechnet wird, legst du mit der Einstellung Warenkorbwert für Warenkorb-Prämien fest.
Gekaufte Auslöser-Artikel je Stufe Nur bei Artikel-Zugabe (nach Stückzahl): wie viele Auslöser-Artikel der Kunde kaufen muss.
Warenwert der Auslöser-Artikel je Stufe Nur bei Artikel-Zugabe (nach Warenwert): welcher Warenwert der Auslöser-Artikel erreicht sein muss. Auch dieser Wert wird ohne Umrechnung in der Währung des Kunden verglichen.
Prämien je Stufe Wie viele Stück der Prämie es für jede erreichte Stufe gibt.
Auslöser-Produkte Nur bei Artikel-Zugaben: beim Kauf welcher Produkte es die Zugabe gibt. Bei einem Hauptprodukt zählen auch seine Varianten.
Auslöser-Kategorien Nur bei Artikel-Zugaben: beim Kauf aus welchen Kategorien es die Zugabe gibt. Unterkategorien werden automatisch einbezogen.
Kontingent mit anderen Prämien teilen Nur bei Artikel-Zugaben, standardmäßig an. Siehe Kontingent.

Unter den Feldern fasst ein Hinweis die Bedingung in einem Satz zusammen, z. B. „Je 10,00 € Warenkorbwert erhält der Kunde 1 Stück dieser Prämie.“ Eine Artikel-Zugabe lässt sich erst speichern, wenn mindestens ein Auslöser-Produkt oder eine Auslöser-Kategorie gewählt ist.

So rechnet die Erweiterung: Für jede volle Stufe gibt es die eingestellte Zahl an Prämien. Beispiel: Warenkorbwert je Stufe 50 €, Prämien je Stufe 2, Warenkorbwert 120 € → 2 volle Stufen → bis zu 4 Stück.

Als gekaufte Artikel zählen alle Produktpositionen im Warenkorb außer den Prämien selbst. Als Warenwert zählt der Gesamtpreis der passenden Positionen.

Kontingent

Warenkorb-Prämien teilen sich immer den Warenkorbwert: Was eine gewählte Prämie verbraucht, steht für andere Warenkorb-Prämien nicht mehr zur Verfügung. Die Prämienseite zeigt dazu den „Für Prämien verwendeten Wert“ und den „Für Prämien verwendbaren Wert“.

Artikel-Zugaben mit Kontingent mit anderen Prämien teilen teilen sich die gekauften Auslöser-Artikel mit anderen Artikel-Zugaben, bei denen der Schalter ebenfalls an ist. Ist der Schalter aus, erhält die Prämie die volle Menge zusätzlich.

Beispiel: Tasse und Löffel gibt es je 1 Stück je gekauftem Kaffee-Artikel, der Kunde kauft 2 Kaffee-Artikel.

Kontingent mit anderen Prämien teilen Wählbar
an (bei beiden Prämien) 2 Stück insgesamt, z. B. 1 Tasse und 1 Löffel oder 2 Tassen
aus 2 Tassen und 2 Löffel

Einschränkungen

Feld Wirkung
Verkaufskanäle In welchen Verkaufskanälen die Prämie angeboten wird. Ohne Verkaufskanal wird die Prämie nirgends angeboten.
Regel Regel aus dem Rule Builder, die zutreffen muss, damit der Kunde die Prämie sieht und wählen kann. Trifft die Regel nicht mehr zu, wird die Prämie aus dem Warenkorb entfernt. Ohne Regel gilt die Prämie immer.
Max. pro Bestellung Wie viele Stück der Prämie der Kunde höchstens in einer Bestellung erhält. Trage mindestens 1 ein, bei 0 kann die Prämie nicht gewählt werden.
Limit pro Kunde Schaltet das Limit über alle Bestellungen ein.
Max. pro Kunde (über alle Bestellungen) Wie viele Stück der Prämie ein Kundenkonto insgesamt erhalten kann. Gezählt werden die Prämien aus allen bisherigen Bestellungen dieses Kundenkontos, unabhängig vom Bestellstatus. Ist das Limit erreicht, wird die Prämie dem Kunden nicht mehr angezeigt.

Zusätzlich begrenzt der Bestand: Ist das Prämienprodukt ein Abverkaufsartikel, kann der Kunde nur so viele Stück wählen, wie nach seinen gekauften Stück desselben Produkts noch auf Lager sind. Auch die maximale Bestellmenge des Produkts gilt. Ist das Prämienprodukt inaktiv oder nicht verfügbar, zeigt die Prämienauswahl „Prämie ist nicht mehr verfügbar“, und eine bereits gewählte Prämie wird aus dem Warenkorb entfernt.

Automatisch zum Warenkorb hinzufügen

Feld Wirkung
Automatisch zum Warenkorb hinzufügen Die Prämie wird automatisch in den Warenkorb gelegt, sobald sie dem Kunden zusteht. Entfernt der Kunde sie, wird sie nicht erneut hinzugefügt.
Menge beim automatischen Hinzufügen Nur bei Warenkorb-Prämien: wie viele Stück automatisch hinzugefügt werden. Höchstens so viel, wie die Limits dieser Prämie erlauben (pro Bestellung, pro Kunde, Warenkorbwert, globales Limit). Ist die Menge größer als 1, passt sie sich dem Warenkorbwert an, bis der Kunde sie selbst ändert. Vom Kunden selbst gewählte Prämien haben Vorrang.
Priorität Prämien mit höherer Priorität werden zuerst hinzugefügt.

Bei Artikel-Zugaben folgt die Menge den gekauften Auslöser-Artikeln, bis der Kunde sie selbst ändert. Der Kunde kann sie reduzieren oder die Prämie entfernen.


Prämien im Shop

Prämienseite

Die Erweiterung bringt eine eigene Prämienseite mit, erreichbar unter /lenz_premiums. Sie zeigt eine Übersicht mit dem Warenkorbwert, dem für Prämien verwendeten und dem noch verwendbaren Wert und, wenn ein globales Limit eingestellt ist, der Anzahl gewählter Prämien. Darunter stehen die Prämien als Karten. Gibt es auch Artikel-Zugaben, erscheinen sie in einem eigenen Abschnitt „Gratis-Zugaben zu Ihren Artikeln“, die Warenkorb-Prämien unter „Prämien für Ihren Warenkorbwert“.

Jede Karte zeigt die Bedingung als Kennzeichen (z. B. „je 50,00 €“ oder „1x gratis je gekauftem Artikel“), bei Artikel-Zugaben die Auslöser-Produkte und -Kategorien und, wenn die Prämie schon im Warenkorb liegt, die gewählte Menge. Fehlt noch etwas für ein weiteres Stück, nennt die Karte den fehlenden Betrag oder die fehlenden Artikel, z. B. „noch 10,01 €“. Auslöser-Produkte und -Kategorien werden nur genannt, wenn sie im Verkaufskanal sichtbar sind.

Statt der mitgelieferten Seite kannst du eine eigene Seite mit dem Erlebniswelten-Element Prämien-Liste gestalten, siehe Wie kann ich die Prämienseite anpassen?.

Warenkorb und Offcanvas-Warenkorb

  • Im Warenkorb führt der Button Prämien wählen! unter der Zusammenfassung zur Prämienseite.
  • Im Offcanvas-Warenkorb erscheinen derselbe Button und die Prämienauswahl, beides abschaltbar in den Einstellungen.
  • Eine gewählte Prämie steht als eigene Position mit 0,00 € im Warenkorb. Darunter zeigt „Produkt-Bundle enthält“ das Prämienprodukt und den Rabatt.
  • Wird eine Prämie entfernt, weil ihre Bedingungen nicht mehr zutreffen, erhält der Kunde die Meldung „Prämie … wurde entfernt, da Bedingungen nicht mehr zutreffen.“

Produktdetailseite

Gehört ein Produkt zu den Auslösern einer Artikel-Zugabe, zeigt die Produktdetailseite unter dem Warenkorb-Button den Hinweis „Gratis zu diesem Artikel“ mit den Zugaben, z. B. „1x Prämie: Schrittzähler je gekauftem Artikel“. Wird eine Zugabe automatisch hinzugefügt, steht dabei „Wird automatisch in den Warenkorb gelegt.“, sonst führt der Link Zugaben auswählen zur Prämienseite.


Einstellungen

Die Einstellungen öffnest du unter Erweiterungen → Meine Erweiterungen über Konfigurieren. Alle Einstellungen kannst du je Verkaufskanal festlegen.

Prämien Einstellungen

Einstellung Wirkung
Link zu Prämienseite in Offcanvas-Warenkorb anzeigen Zeigt im Offcanvas-Warenkorb den Button Prämien wählen!, sofern es Prämien gibt. Standard: an.
Prämien in Offcanvas-Warenkorb anzeigen Zeigt die Prämienauswahl direkt im Offcanvas-Warenkorb. Standard: an.
Prämienartikel nach der Bestellung mit Hauptartikel zusammenführen? Ist die Option an, übernimmt die Bestellung nur das Prämienprodukt als eigene Position mit dem Preis der Prämie (0,00 €). Die Prämienposition und der Rabatt entfallen. Im Warenkorb ändert sich nichts. Standard: aus.
Warenkorbwert für Warenkorb-Prämien Gilt nur für Warenkorb-Prämien. Warenkorbwert (inkl. Versandkosten): die Gesamtsumme des Warenkorbs (Standard). Warenkorbwert (excl. Versandkosten): die Gesamtsumme abzüglich Versandkosten. Regel: nur die Positionen, die die Regel unten erfüllen. Brutto oder netto richtet sich danach, wie dem Kunden die Preise angezeigt werden.
Maximale Anzahl an Prämien, die pro Bestellung wählbar sind (0 für unbegrenzt) Wie viele Prämien ein Kunde in einer Bestellung insgesamt wählen darf. Gilt für alle Prämien zusammen, unabhängig von ihrer Prämienart und davon, ob sie ihr Kontingent teilen.
Regel für den Warenkorbwert von Warenkorb-Prämien Wird nur verwendet, wenn der Warenkorbwert oben auf „Regel“ steht: Dann zählt der Gesamtpreis der Positionen, die diese Regel erfüllen. Die Regel wird für jede Position einzeln geprüft, als läge nur diese Position im Warenkorb. Ist keine Regel gewählt, ist der Warenkorbwert 0.
Alternative URL zu Prämien-Seite Ersetzt die mitgelieferte Prämienseite: Die Buttons Prämien wählen! und der Link Zugaben auswählen führen dann zu dieser URL, z. B. /praemien/. Siehe Wie kann ich die Prämienseite anpassen?.
Mengenauswahl für Prämien +/- Buttons (Standard): mehrere Klicks werden zusammengefasst, die Seite lädt kurz nach dem letzten Klick neu und behält die Scroll-Position (im Offcanvas-Warenkorb per AJAX). Mengen-Auswahl mit In den Warenkorb-Button: Auswahlfeld und Button Prämie auswählen, ein Request pro Auswahl.
Prämienname Ob die Prämienauswahl und der Hinweis auf der Produktdetailseite den Name der Prämie (Standard) oder den Name des Produkts zeigen. Im Warenkorb steht immer der Name der Prämie.

Experten-Einstellungen

Einstellung Wirkung
Optional: Produkt-Nummer für Typ lenzpremium in payload (z.B. für Warenwirtschaft) Produktnummer, die die Prämienposition im Payload mitbringt, z. B. für die Übergabe an deine Warenwirtschaft. #productNumber# wird durch die Produktnummer des Prämienprodukts ersetzt. Standard: #productNumber#.
Optional: Produkt-Nummer für Typ lenzpremium-discount in payload (z.B. für Warenwirtschaft) Produktnummer, die die Rabattposition der Prämie im Payload mitbringt. #productNumber# wird durch die Produktnummer des Prämienprodukts ersetzt. Leer: Die Rabattposition bringt keine Produktnummer mit.

Hinweis

Die Produkt-Nummer für Typ lenzpremium-discount wertet die Erweiterung nur aus, wenn unter Alle Verkaufskanäle ein Wert eingetragen ist. Ein abweichender Wert für einen Verkaufskanal wird dann für diesen Verkaufskanal verwendet.


Statistiken

Den Reiter Statistiken öffnest du in einer Prämie oder über das Kontextmenü in der Übersicht.

  • Filter: Über Anzeigen schränkst du die ausgewerteten Bestellungen ein nach Verkaufskanälen, Bestellstatus, Zahlungsstatus, Lieferstatus, Zahlungsart, Versandart, Rechnungsland, Lieferland und Kundengruppe.
  • Auswertungszeitraum: Von und Bis, Standard sind die letzten 12 Monate.
  • Kennzahlen: Gewählte Einheiten, Bestellungen mit dieser Prämie, Warenkorbwert brutto und netto (Summe und Ø), Verschenkter Warenwert (Summe), Warenkorbwert brutto (Ø, alle Bestellungen), Warenkorb-Uplift (brutto) und Zuletzt gewählt.
  • Zeitlicher Verlauf: Diagramm mit wählbarer Datenquelle (Gewählte Einheiten, Bestellungen mit dieser Prämie, Warenkorbwert brutto, Warenkorbwert netto, Verschenkter Warenwert) und Aggregation nach Tag, Woche oder Monat.

Alle Beträge sind in die Standardwährung umgerechnet. Der Warenkorb-Uplift vergleicht den durchschnittlichen Bruttowert der Bestellungen mit dieser Prämie mit dem aller Bestellungen im selben Zeitraum und mit denselben Filtern.


Rule Builder

In der Bedingung Position vom Typ steht zusätzlich der Typ Prämie zur Auswahl. Damit kannst du z. B. Versandarten oder Aktionen davon abhängig machen, ob eine Prämie im Warenkorb liegt.


Bestellbestätigung: Prämie in einer Zeile ausgeben

In der Standard-Bestellbestätigung erscheint die Prämie in drei Zeilen: die Prämie, das Prämienprodukt und der Rabatt. Mit der folgenden Änderung im E-Mail-Template (Einstellungen → Inhalte → E-Mail-Templates) wird nur eine Zeile ausgegeben.

Vorher:

{% if nestedItem.children.count > 0 %}
    {% set nestingLevel = nestingLevel + 1 %}
    {% for lineItem in nestedItem.children %}
        {% set nestedItem = lineItem %}
        {{ block('lineItem') }}
    {% endfor %}
{% endif %}

Nachher:

{% if nestedItem.children.count > 0 and nestedItem.type != "lenzpremium" %}
    {% set nestingLevel = nestingLevel + 1 %}
    {% for lineItem in nestedItem.children %}
        {% set nestedItem = lineItem %}
        {{ block('lineItem') }}
    {% endfor %}
{% endif %}

Mit der Einstellung Prämienartikel nach der Bestellung mit Hauptartikel zusammenführen? ist die Änderung nicht nötig, die Bestellung enthält dann nur das Prämienprodukt.


Store API

Für Headless- und PWA-Shops listet die Route /store-api/lenz-premium (GET oder POST) die Prämien, die im aktuellen Verkaufskanal verfügbar sind, mit der verdienten Menge je Prämie. Eine Prämie legst du über die Shopware-Route /store-api/checkout/cart/line-item in den Warenkorb, mit dem Typ lenzpremium und der ID der Prämie als referencedId.


Deinstallation

Beim Deinstallieren entfernt die Erweiterung ihre Tabellen mit allen Prämien und Statistikdaten, sofern du nicht auswählst, die Daten zu behalten.