PDF herunterladen

Inhaltsverzeichnis

M0085 Gratisartikel für Gambio

Handbuch

Stand: 2026-08 (Modulversion 6.19) · (c) Xycons GmbH & Co. KG - www.xycons.de

1. Was das Modul macht

Das Modul schenkt Ihren Kunden einen Artikel, sobald sie eine von Ihnen festgelegte Schwelle erreichen. Sie entscheiden dabei, ob diese Schwelle ein Warenwert ist („ab 50 Euro gibt es ein Geschenk“) oder eine Anzahl verschiedener Artikel im Warenkorb („ab drei verschiedenen Artikeln gibt es ein Geschenk“).

Erreicht der Kunde die Schwelle, blendet der Warenkorb eine Auswahl aller verfügbaren Gratisartikel ein. Der Kunde wählt einen davon aus, und der Artikel wandert zum Preis von 0,00 Euro in den Warenkorb. Fällt der Warenkorb später wieder unter die Schwelle - etwa weil eine Position gelöscht wurde -, nimmt das Modul den Gratisartikel automatisch wieder heraus.

Solange der Kunde die Schwelle noch nicht erreicht hat, sieht er einen Hinweistext, der ihm sagt, wie viel ihm noch fehlt. Alle drei Hinweistexte gestalten Sie selbst über den Content-Manager Ihres Shops.

Darüber hinaus können Sie bis zu drei Staffelstufen einrichten, damit größere Warenkörbe mehr oder hochwertigere Geschenke bekommen, und jedem Geschenk einen Aktionszeitraum sowie bestimmte Kundengruppen mitgeben. Eine eigene Auswertung zeigt Ihnen anschließend, welche Geschenke tatsächlich gewählt werden.

Gut zu wissen: Gratisartikel werden vom Modul aus den üblichen Listen des Shops herausgehalten - aus „Neue Artikel“, den Topangeboten, den Sonderangeboten, der Artikelsuche und den Vorschlägen. Der Kunde bekommt sie also ausschließlich dort zu sehen, wo Sie sie ihm anbieten: im Warenkorb.

2. Das Setup öffnen

Sie finden die Einstellungen im Adminbereich Ihres Shops im Menü „Xycons-Module“ unter „Kundenkonto / Setups“. Dort wählen Sie den Reiter mit dem Namen des Moduls - „Gratisprodukte“.

Jede Einstellung ist dort auch direkt an Ort und Stelle kurz erklärt. Ganz oben schalten Sie das Modul ein oder aus. Das folgende Kapitel 3 geht jede einzelne Einstellung ausführlich durch - in genau der Reihenfolge, in der sie im Setup steht.

Die Auswertung des Moduls finden Sie an anderer Stelle: im Menü „Statistiken“ unter „Gratisartikel - Auswertung“ (Kapitel 10).

Wichtig: Solange das Modul ausgeschaltet ist, passiert im Shop nichts - es werden keine Gratisartikel angeboten und keine in den Warenkorb gelegt. Das Setup weist Sie in diesem Fall mit einem rot hinterlegten Hinweis darauf hin.

3. Das Setup - alle Einstellungen

Dieses Kapitel erklärt jede einzelne Einstellung des Moduls in der Reihenfolge, in der sie im Setup steht. Zu jeder Einstellung finden Sie, was sie bewirkt, was sie im Shop auslöst und wie sie im Auslieferungszustand steht.

Für den Einstieg brauchen Sie nur drei Dinge: das Modul einschalten, eine Werte-Schwelle eintragen und mindestens einen Gratisartikel anlegen (Kapitel 4). Alles Weitere ist Feinschliff.



3.1 Grundeinstellungen

Einstellung Bedeutung
Modulstatus - Gratisprodukte Schaltet das Modul ein und aus. Ist es ausgeschaltet, passiert im Shop nichts: Es werden keine Gratisartikel angeboten, keine in den Warenkorb gelegt und keine aus den Artikellisten herausgefiltert. Das Setup weist Sie darauf mit einem roten Hinweis hin.
(Standard: Ausgeschaltet)
Ihr Lizenzschlüssel Hier tragen Sie den Schlüssel ein, den Sie mit dem Modul erhalten haben. Ohne gültigen Schlüssel arbeitet das Modul nicht.
(Standard: leer)
Ihre Lizenz: Zeigt an, welche Lizenz für Ihren Shop hinterlegt ist. Reine Anzeige - dieses Feld können Sie nicht selbst ändern.
Kunden-Rückführung Meldet sich ein Kunde erst im Verlauf an oder legt er unterwegs ein Konto an, führt ihn das Modul anschließend zurück in den Warenkorb - dorthin, wo sein Geschenk auf ihn wartet. Ohne diese Rückführung landet er direkt im Checkout und übersieht die Auswahl leicht.
(Standard: Ja, Rückführung durchführen - so empfohlen)

3.2 Die drei Hinweistexte

Das Modul zeigt im Warenkorb je nach Situation einen von drei Texten. Diese Texte gestalten Sie im Content-Manager Ihres Shops; hier im Setup hinterlegen Sie nur, welche Content-Nummer für welche Situation gilt. Wie Sie die Texte inhaltlich aufbauen, steht in Kapitel 8.

Einstellung Bedeutung
Content - Unter Wert Die Content-Nummer des Textes, den der Kunde sieht, solange sein Warenkorb noch unter der Werte-Schwelle liegt. Typischerweise der Text mit dem noch fehlenden Betrag.
(Standard: 7777)
Content - Gratisauswahl Die Content-Nummer des Textes, der erscheint, sobald der Kunde die Schwelle erreicht hat und noch ein Geschenk auswählen darf.
(Standard: 7778)
Content - Neuauswahl Die Content-Nummer des Textes, der erscheint, wenn der Kunde alle ihm zustehenden Geschenke gewählt hat. Hier weisen Sie ihn darauf hin, dass er seine Wahl noch ändern kann.
(Standard: 7779)
Bei der Installation legt das Modul unter diesen drei Nummern deutschsprachige Standardvorlagen an, sofern die Nummern noch frei sind. Sie können also sofort loslegen und die Texte später nach Ihren Wünschen umgestalten. Sind die Nummern in Ihrem Shop bereits belegt, tragen Sie hier einfach drei andere Content-Nummern ein.

3.3 Werte-Schwelle und Staffel

Diese Einstellungen entscheiden, ab wann es ein Geschenk gibt und wie viele.

Einstellung Bedeutung
Werte-Schwelle Der Wert, ab dem es das erste Geschenk gibt - zugleich die Schwelle der ersten Staffelstufe. Je nach Auswertungsregel ist das ein Bruttobetrag (z. B. 50 für 50 Euro) oder eine Stückzahl (z. B. 3 für drei verschiedene Artikel).
(Standard: leer)
Wichtig: Bleibt das Feld leer, gilt die Schwelle null - dann bekommt jeder Warenkorb sofort ein Geschenk. Das Setup warnt Sie in diesem Fall mit einem gelben Hinweis.
Auswertungsregel Werteschwelle Als Warenwert: Gerechnet wird mit dem Bruttowarenwert des Warenkorbs.
Als Anzahl verschiedener Produkte: Gerechnet wird mit der Anzahl unterschiedlicher Artikel im Warenkorb - die Menge je Artikel spielt dabei keine Rolle, drei Stück desselben Artikels zählen also als eins.
(Standard: Als Warenwert)
Stufe 1 - Anzahl Geschenke Wie viele Geschenke der Kunde wählen darf, sobald er die Werte-Schwelle erreicht hat.
(Standard: 1)
Stufe 2 - Schwelle Ab welchem Wert die zweite Stufe greift. Bleibt das Feld leer, ist die zweite Stufe nicht in Betrieb - dann verhält sich das Modul wie mit einer einzigen Schwelle.
(Standard: leer)
Stufe 2 - Anzahl Geschenke Wie viele Geschenke es ab der zweiten Schwelle gibt.
(Standard: 2)
Stufe 3 - Schwelle Ab welchem Wert die dritte Stufe greift. Leer bedeutet auch hier: Stufe nicht in Betrieb.
(Standard: leer)
Stufe 3 - Anzahl Geschenke Wie viele Geschenke es ab der dritten Schwelle gibt.
(Standard: 3)

Wie die Staffel im Zusammenspiel mit den Artikeln arbeitet - und wie Sie hochwertige Geschenke erst ab einer bestimmten Stufe anbieten - lesen Sie in Kapitel 6.

3.4 Was auf die Schwelle einzahlt

Einstellung Bedeutung
Gutscheine Sollen gekaufte Gutscheine beim Warenwert beziehungsweise bei der Artikelanzahl mitzählen? Schalten Sie die Option aus, wenn ein reiner Gutscheinkauf kein Geschenk auslösen soll. Erkannt werden Gutscheine an der Artikelnummer, die - wie in Gambio üblich - mit GIFT_ beginnt.
(Standard: Ja, Gutscheine zählen mit)
Nutze Markerdaten Ist die Option eingeschaltet, zählen nur noch die Artikel auf die Schwelle, die Sie ausdrücklich dafür markiert haben. So lösen zum Beispiel stark rabattierte Waren oder ganze Warengruppen kein Geschenk mehr aus. Wie Sie markieren, steht in Kapitel 9.
(Standard: Nein, alle Artikel zählen)
Hinweis: Die Markierung wirkt nur zusammen mit der Auswertungsregel „Als Warenwert“.

3.5 Anzeige im Shop

Einstellung Bedeutung
Gratis-Artikel Anzeige Sollen die Geschenke auch Besuchern gezeigt werden, die noch nicht angemeldet sind? Eingeschaltet wirkt das als Kaufanreiz; ausgeschaltet vermeiden Sie Rückfragen von Kunden, die nach der Anmeldung feststellen, dass sie zu einer ausgeschlossenen Kundengruppe gehören.
(Standard: Nein, nicht anzeigen)
Gratis-Artikel Produktseite Sollen die Geschenke in der Auswahl auf ihre eigene Artikelseite verlinken? Denken Sie daran, dass die Artikelseite eines Geschenks dann auch erreichbar sein muss - regeln Sie das gegebenenfalls über die Kundengruppenprüfung des Shops.
(Standard: Nein, nicht verlinken)
Gratis-Hinweis Der Dateiname einer kleinen Grafik aus dem Ordner /images, die im Warenkorb neben dem Geschenk erscheint - zum Beispiel ein „Geschenkt!“-Störer. Zwei passende Grafiken (geschenkt.png und geschenkt_klein.png) bringt das Modul bereits mit. Lassen Sie das Feld leer oder existiert die Datei nicht, erscheint stattdessen ein Text, den Sie über „Texte ändern“ anpassen können (Kapitel 12).
(Standard: leer)
Umrandung Zeichnet einen Rahmen um die einzelnen Geschenke in der Auswahl. Ob das gut aussieht, hängt von Ihrem Design ab - probieren Sie beides aus.
(Standard: Umrandung nicht anzeigen)
Späte Anzeige Eingeschaltet erscheint die Auswahl der Geschenke erst dann, wenn der Kunde die Schwelle erreicht hat. Ausgeschaltet sieht er die Geschenke schon vorher - als Anreiz, den Warenkorb noch etwas zu füllen. Auswählen kann er sie in beiden Fällen erst ab der Schwelle.
(Standard: Nein, direkt anzeigen)

3.6 Kundengruppen ausschließen

Einstellung Bedeutung
Kundengruppen Die Nummern der Kundengruppen, die keine Geschenke erhalten sollen - kommagetrennt. Diese Gruppen bekommen im Warenkorb überhaupt keine Gratisauswahl angezeigt.
(Standard: leer, also alle Gruppen erhalten Geschenke)

Die Nummer einer Kundengruppe finden Sie in der Kundengruppenverwaltung Ihres Shops in Klammern hinter dem Gruppennamen. Möchten Sie zum Beispiel die Gruppe „Händler“ mit der Nummer 3 ausschließen, tragen Sie eine 3 ein. Mehrere Gruppen trennen Sie mit Komma:

3
3,4,7
Schalten Sie in diesem Fall am besten auch „Gratis-Artikel Anzeige“ aus. Sonst sieht der Händler die Geschenke, solange er nicht angemeldet ist, und sie verschwinden nach seiner Anmeldung wieder - das führt erfahrungsgemäß zu Rückfragen.

Diese Einstellung gilt für das gesamte Modul. Wenn Sie stattdessen einzelne Geschenke für bestimmte Gruppen reservieren möchten, nutzen Sie die Einstellung am Artikel selbst - siehe Kapitel 7. Beide Angaben arbeiten zusammen, wobei der Ausschluss hier im Setup schwerer wiegt.

3.7 Artikelpflege und Downloads

Einstellung Bedeutung
Preis-Status-Kontrolle Setzt den Preisstatus eines Artikels automatisch auf „Nicht käuflich“, sobald Sie ihm eine Artikelnummer geben, die mit GRATIS_ beginnt. Das schützt vor dem Stammdatenfehler, dass ein Geschenk versehentlich frei kaufbar wird und Kunden es an der Gratisregelung vorbei mitnehmen.
(Standard: Preisstatuskontrolle aktiv - so empfohlen)
Download-Artikel Lässt Download-Artikel als Geschenk zu. Da Download-Artikel üblicherweise keinen Lagerbestand führen, werden sie eingeschaltet auch ohne Bestand angeboten und beim Hinzufügen automatisch mit ihrer hinterlegten Downloaddatei verknüpft. Ausgeschaltet gilt für alle Geschenke ausnahmslos die Bestandsregel.
(Standard: Ja, Download-Artikel zulassen)
Mehr dazu in Kapitel 5.

4. Gratisartikel anlegen

Damit das Modul etwas zu verschenken hat, legen Sie ganz normale Artikel in Ihrem Shop an und kennzeichnen sie als Gratisartikel. Die Kennzeichnung erfolgt - genau wie bei den Gutscheinen Ihres Shops - über die Artikelnummer.



4.1 Die Artikelnummer

Ein Artikel, der als Gratisartikel dienen soll, bekommt eine Artikelnummer, die mit GRATIS_ beginnt. Alles danach ist Ihnen überlassen, die Nummer sollte nur eindeutig sein:

GRATIS_01
GRATIS_02
GRATIS_LAMPE
GRATIS_HANDSCHUHE
GRATIS_SCHRAUBENDREHER

Das Modul erkennt an dieser Artikelnummer, dass es sich um einen Gratisartikel handelt. Umgekehrt gilt: Ein Artikel ohne dieses Kennzeichen wird nie verschenkt.

4.2 Preis, Status und Bestand

  • Der Preis des Artikels muss auf 0,00 Euro stehen.
  • Der Status muss auf aktiv stehen - inaktive Artikel werden nicht angeboten.
  • Der Bestand muss größer als null sein. Tragen Sie entweder den echten Bestand ein oder einen großzügigen Wert wie 9999, wenn Sie keine Bestandsführung wünschen. Geht der Bestand auf null, verschwindet der Artikel aus dem Angebot. Eine Ausnahme sind Download-Artikel, dazu gleich mehr.
  • Der Artikel braucht ein Bild. Weitere Bilder werden in der Gratisauswahl nicht verwendet.
  • Im Bereich „Gratisartikel“ des Artikels legen Sie optional fest, in welchem Zeitraum und für welche Kundengruppen er gilt und ab welcher Staffelstufe er zur Auswahl steht - siehe Kapitel 6 und 7.
Ist überhaupt kein gültiger Gratisartikel vorhanden, verhält sich das Modul still: Im Warenkorb erscheint dann keinerlei Anzeige. Sorgen Sie deshalb immer für mindestens einen aktiven Gratisartikel.

Verwenden Sie als Geschenk einen konkreten Artikel in einer konkreten Ausführung. Artikel, bei denen der Kunde erst noch eine Variante oder eine Eigenschaft auswählen müsste, eignen sich nicht: Diese Auswahl wird ihm in der Gratisauswahl nicht angeboten. Die einzige Ausnahme sind Download-Artikel - dort löst das Modul die nötige Auswahl selbst auf, siehe Kapitel 5.

4.3 Wo die Gratisartikel liegen sollten

Legen Sie Ihre Gratisartikel am besten in einer eigenen Kategorie an, zum Beispiel „Gratisartikel“, und stellen Sie diese Kategorie über die Kundengruppenprüfung Ihres Shops so ein, dass sie nur der Administratorgruppe angezeigt wird. So stolpert kein Kunde beim Stöbern über die Geschenke.

Ordnen Sie ein Geschenk außerdem möglichst nur dieser einen Kategorie zu. Mehrfach verlinkte Artikel tauchen sonst an Stellen auf, an denen Sie sie nicht erwarten - und bei Serienänderungen über die Kategorie (Abschnitt 9.2) wirken alle Kategorien, in denen der Artikel hängt.

Setzen Sie zusätzlich den Preisstatus des Artikels auf „Nicht käuflich“. Damit kann niemand den Artikel an der Gratisregelung vorbei einfach so in den Warenkorb legen. Auf Wunsch übernimmt das Modul das für Sie automatisch - siehe Abschnitt 3.7.

5. Download-Artikel verschenken

Sie können nicht nur greifbare Ware verschenken, sondern auch Download-Artikel - ein E-Book, ein Schnittmuster, eine Anleitung, eine Rezeptsammlung oder eine Software-Lizenz. Für den Kunden läuft das genauso ab wie bei jedem anderen Geschenk: Er wählt es im Warenkorb aus, und nach der Bestellung findet er den Download in seinem Kundenkonto.

5.1 Warum Download-Artikel eine Besonderheit sind

In Ihrem Shop hängt eine Downloaddatei nicht am Artikel selbst, sondern an einem Artikelattribut. Beim Kauf über den normalen Weg wählt der Kunde dieses Attribut aus, und daraus entsteht sein Downloadlink.

Bei einem Geschenk gibt es diesen Schritt nicht - der Kunde klickt nur auf „Gratis hinzufügen“. Das Modul erledigt deshalb beides für ihn: Es sucht das Attribut mit der hinterlegten Downloaddatei heraus und legt das Geschenk gleich damit in den Warenkorb. Dazu kommt, dass Download-Artikel üblicherweise keinen Lagerbestand führen - solche Artikel werden daher auch ohne Bestand angeboten.

Beides ist an die Einstellung „Download-Artikel“ im Setup gekoppelt (Abschnitt 3.7). Sie steht im Auslieferungszustand auf „Ja“.

5.2 So legen Sie ein Download-Geschenk an

Sie legen den Artikel genauso an, wie Sie es von Ihren verkäuflichen Download-Artikeln gewohnt sind - mit einer einzigen Ergänzung bei der Artikelnummer:

  • Legen Sie den Artikel im Adminbereich an und geben Sie ihm eine Artikelnummer, die mit GRATIS_ beginnt, zum Beispiel GRATIS_EBOOK.
  • Setzen Sie den Preis auf 0,00 Euro und den Artikel auf aktiv.
  • Hinterlegen Sie die Downloaddatei wie gewohnt am Artikelattribut - über die Artikelmerkmale Ihres Shops, wo Sie Datei und Gültigkeitsdauer des Downloads angeben.
  • Einen Bestand müssen Sie nicht pflegen. Er darf auf null stehen, der Artikel wird trotzdem angeboten.
  • Der Artikel braucht wie jedes Geschenk ein Bild für die Auswahl im Warenkorb.
Hat Ihr Download-Artikel mehrere Attributwerte - etwa verschiedene Dateiformate -, wählt das Modul automatisch den Wert aus, an dem eine Downloaddatei hängt. Gibt es mehrere solcher Werte, nimmt es den ersten ohne Preisaufschlag. Wenn Ihr Kunde die Wahl haben soll, legen Sie besser je Format einen eigenen Gratisartikel an.

5.3 Prüfen, ob alles sitzt

Ob ein Download-Geschenk richtig eingerichtet ist, sehen Sie am schnellsten in der Auswertung (Kapitel 10). In der Übersicht Ihrer Gratisartikel trägt der Artikel dann die Kennzeichnung „Download“, und in der Bestandsspalte steht ein Strich statt einer Null - das ist das Zeichen dafür, dass das Modul den Artikel als Download erkannt hat und die Bestandsregel für ihn nicht anwendet.

Fehlt diese Kennzeichnung, ist am Artikel keine Downloaddatei hinterlegt. Der Artikel wird dann wie ein gewöhnlicher Gratisartikel behandelt - und mit Bestand null gar nicht angeboten.

Machen Sie vor dem Scharfschalten einer Aktion eine Testbestellung. Nur so sehen Sie sicher, dass der Downloadlink im Kundenkonto ankommt und die richtige Datei liefert.

5.4 Gemischte Warenkörbe

Ein Download-Geschenk lässt sich mit gewöhnlicher Ware im selben Warenkorb kombinieren. Der Kunde erhält dann seine Lieferung wie immer und zusätzlich den Downloadlink in seinem Konto. Auch die Versandkostenberechnung Ihres Shops verhält sich dabei so, wie Sie sie eingerichtet haben - das Geschenk selbst hat den Wert 0,00 Euro und kein Gewicht.

Umgekehrt gilt: Besteht der Warenkorb nur aus einem Download-Geschenk, kommt es gar nicht erst zustande - denn ohne gekaufte Ware wird die Werte-Schwelle nie erreicht.

6. Geschenkstaffeln

Sie müssen es nicht bei einem Geschenk belassen. Mit den Staffeln belohnen Sie größere Warenkörbe stärker: Wer mehr kauft, darf mehr Geschenke wählen - und auf Wunsch auch hochwertigere.

6.1 Die Stufen einrichten

Es stehen drei Stufen zur Verfügung. Stufe 1 ist Ihre bisherige Werte-Schwelle; neu ist lediglich, dass Sie auch dort die Anzahl der Geschenke festlegen können. Stufe 2 und Stufe 3 sind optional - lassen Sie deren Schwelle leer, sind sie nicht in Betrieb, und alles verhält sich wie zuvor.

Einstellung Bedeutung
Werte-Schwelle Die Schwelle der ersten Stufe.
Stufe 1 - Anzahl Geschenke Wie viele Geschenke es ab der ersten Schwelle gibt. Standard ist 1.
Stufe 2 - Schwelle / Anzahl Die zweite Schwelle und die Anzahl der Geschenke ab dort. Leere Schwelle = Stufe aus.
Stufe 3 - Schwelle / Anzahl Die dritte Schwelle und die Anzahl der Geschenke ab dort. Leere Schwelle = Stufe aus.

Ein typisches Beispiel:

Werte-Schwelle:            50      ->  1 Geschenk
Stufe 2 - Schwelle:       100      ->  2 Geschenke
Stufe 3 - Schwelle:       200      ->  3 Geschenke

Die Stufen gelten für beide Auswertungsregeln. Rechnen Sie nach der Anzahl verschiedener Artikel, tragen Sie bei den Schwellen entsprechend Stückzahlen ein.

Der Kunde muss bei mehreren Geschenken verschiedene Artikel wählen. Ein bereits gewähltes Geschenk verschwindet aus der Auswahl - so wird nicht dreimal derselbe Artikel abgeräumt.

6.2 Hochwertige Geschenke erst ab einer Stufe

Sie können jedem Gratisartikel eine Mindeststufe mitgeben. Der Artikel erscheint dann erst in der Auswahl, wenn der Kunde diese Stufe erreicht hat. So schonen Sie Ihre Marge und machen die höheren Stufen gleichzeitig attraktiver.

Öffnen Sie dazu den Gratisartikel im Adminbereich. Im Bereich „Gratisartikel“ finden Sie das Feld „Erst ab Staffelstufe“. Ohne Angabe steht der Artikel in jeder Stufe zur Verfügung.

GRATIS_KUGELSCHREIBER    Erst ab Staffelstufe: (keine Angabe)
GRATIS_TASSE             Erst ab Staffelstufe: 2
GRATIS_RUCKSACK          Erst ab Staffelstufe: 3
Achten Sie darauf, dass in jeder Stufe genügend Geschenke zur Auswahl stehen. Erlauben Sie in Stufe 3 drei Geschenke, geben aber nur zwei Artikeln die passende Mindeststufe, kann der Kunde das dritte Geschenk nicht auswählen.

6.3 Was der Kunde davon sieht

Die Auswahl bleibt geöffnet, solange dem Kunden noch ein Geschenk zusteht. Erst wenn er alle Geschenke seiner Stufe gewählt hat, wechselt der Hinweistext auf den dritten Text.

Fällt der Warenkorb wieder unter eine Schwelle, nimmt das Modul genau so viele Geschenke heraus, wie nun zu viel sind - der Kunde behält also seine zuerst getroffene Wahl. Fällt er ganz unter die erste Schwelle, verschwinden alle Geschenke.

Für die Hinweistexte stehen Ihnen zusätzliche Platzhalter zur Verfügung, mit denen Sie den Kunden gezielt zur nächsten Stufe führen - siehe Abschnitt 8.2.

7. Aktionszeitraum und Kundengruppe je Geschenk

Beide Angaben pflegen Sie direkt am Gratisartikel im Adminbereich, im Bereich „Gratisartikel“. Leer gelassene Felder bedeuten immer „keine Einschränkung“.

7.1 Der Aktionszeitraum

Tragen Sie ein Von- und ein Bis-Datum ein, wird der Artikel nur innerhalb dieses Zeitraums als Geschenk angeboten. Davor und danach taucht er in der Auswahl nicht auf - ohne dass Sie etwas ein- oder ausschalten müssten.

So bereiten Sie Ihre Weihnachts-, Oster- oder Sommeraktion in Ruhe vor und lassen sie pünktlich von allein anlaufen. Sie können auch nur eines der beiden Felder füllen: nur ein Startdatum bedeutet „ab dann dauerhaft“, nur ein Enddatum „bis dahin“.

Der Zeitraum wirkt tagesgenau. Ein Artikel mit dem Enddatum 31.12. wird an diesem Tag noch angeboten und ab dem 01.01. nicht mehr.

7.2 Nur für bestimmte Kundengruppen

Haken Sie eine oder mehrere Kundengruppen an, wird der Artikel nur diesen Gruppen angeboten. So geben Sie zum Beispiel Stammkunden ein anderes Geschenk als Neukunden, ohne zwei Aktionen pflegen zu müssen.

Ohne Auswahl steht der Artikel allen Gruppen zur Verfügung - mit Ausnahme der Gruppen, die Sie im Setup generell ausgeschlossen haben (Abschnitt 3.6). Die beiden Einstellungen arbeiten zusammen: Der generelle Ausschluss im Setup wiegt schwerer.

8. Die drei Hinweistexte im Warenkorb

Das Modul zeigt im Warenkorb je nach Situation einen von drei Texten an. Diese Texte gestalten Sie selbst über den Content-Manager Ihres Shops - mit Bildern, Farben und allen gewohnten Formatierungen.

Bei der Installation legt das Modul unter den Nummern 7777, 7778 und 7779 Standardvorlagen an, sofern diese Nummern noch frei sind. Im Setup hinterlegen Sie, welche Nummer für welche Situation gilt - so können Sie auch mit ganz anderen Nummern arbeiten.

8.1 Welcher Text wann erscheint

Situation Einstellung
Der Kunde liegt noch unter der Schwelle. Content - Unter Wert
Der Kunde hat die Schwelle erreicht, aber noch nichts ausgewählt. Content - Gratisauswahl
Der Kunde hat bereits ein Geschenk gewählt und dürfte es noch tauschen. Content - Neuauswahl

8.2 Platzhalter für die Texte

In den Texten können Sie Platzhalter verwenden, die das Modul beim Anzeigen durch die tatsächlichen Werte ersetzt. Welche Platzhalter sinnvoll sind, hängt von Ihrer Auswertungsregel ab.

Bei der Auswertungsregel Als Warenwert:

{@GRATIS_IN_CART@}         aktueller Warenwert des Warenkorbs
{@GRATIS_VALUE@}           Ihre eingestellte Werte-Schwelle
{@GRATIS_MISSING_VALUE@}   Betrag, der bis zum Geschenk noch fehlt

Bei der Auswertungsregel Als Anzahl verschiedener Produkte:

{@GRATIS_PRODUCTS_IN_CART@}          Anzahl verschiedener Artikel im Warenkorb
{@GRATIS_NEEDED_PRODUCTS_IN_CART@}   benötigte Anzahl verschiedener Artikel
{@GRATIS_MISSING_COUNT@}             Anzahl, die noch fehlt

Für die Geschenkstaffel (Kapitel 6) stehen zusätzlich diese Platzhalter bereit - sie funktionieren mit beiden Auswertungsregeln:

{@GRATIS_TIER@}                erreichte Stufe (0 = Schwelle noch nicht erreicht)
{@GRATIS_ALLOWED_COUNT@}       Geschenke, die dem Kunden zustehen
{@GRATIS_SELECTED_COUNT@}      Geschenke, die er bereits gewählt hat
{@GRATIS_OPEN_COUNT@}          Geschenke, die er noch wählen darf
{@GRATIS_NEXT_TIER_MISSING@}   was bis zur nächsten Stufe noch fehlt

Damit führen Sie den Kunden gezielt weiter, zum Beispiel im Text der Gratisauswahl:

Sie dürfen {@GRATIS_OPEN_COUNT@} Geschenk(e) aussuchen.
Nur noch {@GRATIS_NEXT_TIER_MISSING@} bis zum nächsten Geschenk!
Ist die höchste Stufe erreicht, liefert {@GRATIS_NEXT_TIER_MISSING@} den Wert null. Formulieren Sie den Satz deshalb so, dass er auch dann noch stimmig ist - oder setzen Sie ihn in den dritten Hinweistext, der erst erscheint, wenn alles gewählt wurde.

9. Nur bestimmte Artikel sollen zählen

Standardmäßig zählt der gesamte Warenkorb auf die Schwelle ein. Manchmal ist das nicht gewünscht - etwa wenn stark rabattierte Ware oder eine bestimmte Warengruppe kein Geschenk auslösen soll.

Schalten Sie dafür im Setup die Einstellung Nutze Markerdaten ein. Ab dann zählen nur noch die Artikel, die Sie ausdrücklich markiert haben.

Die Markierung wirkt nur zusammen mit der Auswertungsregel „Als Warenwert“.

9.1 Markierung am einzelnen Artikel

Öffnen Sie den Artikel im Adminbereich. Im Bereich „Gratisartikel“ finden Sie ein Auswahlkästchen, mit dem Sie den Artikel für die Schwelle berücksichtigen.

9.2 Serienänderung über die Kategorie

Sie müssen nicht jeden Artikel einzeln anfassen. Öffnen Sie stattdessen eine Kategorie im Adminbereich; ganz unten finden Sie den Bereich „Gratisprodukte“. Dort setzen oder entfernen Sie die Markierung für alle Artikel dieser Kategorie in einem Schritt - wahlweise nur für diese Kategorie oder zusätzlich für alle Unterkategorien.

Denken Sie an Überschneidungen: Ist ein Artikel mehreren Kategorien zugeordnet, wirkt jede Serienänderung, die eine dieser Kategorien betrifft, auch auf diesen Artikel.

9.3 Markierung per CSV pflegen

Die Markierung lässt sich auch über den Artikel-Im- und -Export Ihres Shops pflegen. Legen Sie dazu in Ihrer CSV-Konfiguration eine neue Spalte an:

Name:          p_free_product_marker
Spalteninhalt: {p_free_product_marker}

Speichern Sie die Konfiguration. Beim Export erscheint die Markierung nun als eigene Spalte und kann dort bearbeitet und anschließend wieder importiert werden. Dabei gilt:

0 = Artikel zählt nicht auf die Schwelle
1 = Artikel zählt auf die Schwelle

10. Die Auswertung

Welche Geschenke ziehen wirklich, und welche bleiben liegen? Das sehen Sie im Adminbereich Ihres Shops unter „Statistiken“ im Eintrag „Gratisartikel - Auswertung“.

Die Seite zeigt Ihnen wahlweise die letzten 7, 30, 90 oder 365 Tage oder den gesamten Zeitraum:

  • Kennzahlen - wie oft ein Geschenk gewählt wurde, wie viele verschiedene Geschenke im Umlauf sind, wie viele Kunden zugegriffen haben und wie hoch der Warenkorb dabei im Schnitt war.
  • Ihre Geschenkstaffel - welche Stufen eingerichtet sind und wie oft in jeder Stufe zugegriffen wurde. Daran sehen Sie, ob Ihre höheren Stufen überhaupt erreicht werden.
  • Rangliste der Geschenke - welcher Artikel wie oft gewählt wurde, mit Anteil, Kundenzahl, durchschnittlichem Warenkorb und dem Datum der letzten Wahl.
  • Verlauf nach Monaten - wie sich die Nutzung über die Zeit entwickelt.
  • Ihre Gratisartikel - alle angelegten Geschenke mit ihrem aktuellen Zustand und ihren Einstellungen.

Besonders nützlich ist die letzte Tabelle: Sie zeigt farbig, welche Artikel gerade tatsächlich angeboten werden und welche nicht - weil sie inaktiv sind, weil ihr Aktionszeitraum abgelaufen ist oder weil kein Bestand mehr da ist. Artikel, die noch nie gewählt wurden, erkennen Sie an der Null in der letzten Spalte.

Gezählt wird der Moment, in dem der Kunde ein Geschenk auswählt. Bricht er den Kauf später ab, bleibt die Auswahl in der Statistik stehen - die Zahlen zeigen also die Attraktivität Ihrer Geschenke, nicht die Zahl der Bestellungen.

11. So erlebt der Kunde den Ablauf

  • Der Kunde legt Ware in den Warenkorb. Solange die Schwelle nicht erreicht ist, sieht er Ihren Hinweistext mit dem noch fehlenden Betrag beziehungsweise der noch fehlenden Anzahl.
  • Sobald die Schwelle erreicht ist, erscheint die Auswahl der Gratisartikel mit einer Schaltfläche je Artikel.
  • Mit einem Klick wandert das Geschenk zum Preis von 0,00 Euro in den Warenkorb. Die Menge lässt sich nicht verändern, es bleibt bei einem Stück.
  • Stehen ihm mehrere Geschenke zu, bleibt die Auswahl geöffnet, bis er alle gewählt hat. Bereits gewählte Geschenke verschwinden dabei aus der Auswahl.
  • Der Kunde kann sein Geschenk jederzeit wieder entfernen und ein anderes wählen, solange er über der Schwelle bleibt.
  • Fällt der Warenkorb unter eine Schwelle, nimmt das Modul genau so viele Geschenke heraus, wie nun zu viel sind. Unterhalb der ersten Schwelle verschwinden alle Geschenke und der erste Hinweistext erscheint wieder.
  • Meldet sich der Kunde erst später an oder legt er im Verlauf ein Konto an, bleibt sein ausgewähltes Geschenk erhalten.

12. Modultexte ändern

Alle Texte, die das Modul im Shop anzeigt, lassen sich anpassen. Nutzen Sie dafür die Shopfunktion „Texte ändern“ im Adminbereich Ihres Shops. Dort finden Sie unter anderem die Beschriftung der Schaltfläche zum Hinzufügen eines Geschenks und den Hinweis, der im Warenkorb neben dem Gratisartikel steht.

Ihre Anpassungen bleiben bei einem Modulupdate erhalten.

13. Eigenes Aussehen über CSS

Die Gestaltungsanweisungen des Moduls liegen in dieser Datei:

/GXModules/Xycons/M0085/Shop/Themes/All/Css/M0085.css

Sie können darüber die Anordnung und das Erscheinungsbild der Gratisauswahl anpassen.

Nehmen Sie Ihre Änderungen bitte nicht in dieser Datei vor, sondern über „Eigenes CSS hinzufügen“ im Templatemanager Ihres Designs. Die Datei des Moduls wird bei einem Update überschrieben - Ihre Anpassungen wären dann verloren.

14. Shopupdate und Modulpflege

Planen Sie ein Service Pack oder ein Masterupdate Ihres Shops, prüfen Sie bitte vorher, ob das Modul für die neue Shopversion bereits freigegeben ist. Das gilt für die Modulumgebung genauso wie für jedes einzelne eingesetzte Modul.

Installieren Sie bei einem Shopupdate immer die neueste Modulversion und die neueste Version der Modulumgebung mit. Beide gehören zusammen; eine ältere Modulumgebung kann eine neuere Modulversion nicht vollständig bedienen.

Lassen Sie das Shopupdate durch uns durchführen, aktualisieren wir Ihre Xycons-Module und die Modulumgebung immer mit, sofern für die Ziel-Shopversion verfügbar.

15. Wenn etwas nicht wie erwartet läuft

Beobachtung Woran es meistens liegt
Im Warenkorb erscheint gar nichts. Das Modul ist ausgeschaltet, oder es gibt keinen gültigen Gratisartikel: Artikelnummer beginnt nicht mit GRATIS_, Artikel ist inaktiv, oder der Bestand steht auf null.
Ein bestimmter Gratisartikel fehlt in der Auswahl. Bestand auf null, Artikel inaktiv, oder der Artikel ist über die Kundengruppenprüfung für die Gruppe des Kunden gesperrt.
Ein Download-Artikel erscheint nicht. Die Einstellung „Download-Artikel“ steht auf aus, oder am Artikel ist keine Downloaddatei hinterlegt.
Der Kunde bekommt seinen Download nicht. Prüfen Sie, ob die Downloaddatei tatsächlich am Artikelattribut hängt und die Datei im Downloadordner des Shops liegt.
Der Hinweistext nennt Beträge, obwohl nach Artikelanzahl gerechnet wird. Die drei Contenttexte wurden nach dem Umschalten der Auswertungsregel nicht angepasst, siehe Kapitel 8.
Ein Kunde konnte ein Geschenk kaufen, ohne die Schwelle zu erreichen. Der Preisstatus des Artikels steht nicht auf „Nicht käuflich“. Schalten Sie die Preis-Status-Kontrolle ein.
Eine Kundengruppe erhält trotz Ausschluss ein Angebot. Prüfen Sie die eingetragenen Gruppennummern und schalten Sie die Anzeige für nicht angemeldete Besucher aus.
Der Kunde kann sein letztes Geschenk nicht auswählen. In dieser Stufe stehen weniger Artikel zur Verfügung, als Geschenke erlaubt sind. Prüfen Sie in der Auswertung, wie viele Artikel die Stufe erreichen.
Ein Geschenk erscheint trotz Aktionszeitraum nicht. Prüfen Sie in der Auswertung die Spalte Zeitraum - der Artikel wird dort als „außerhalb des Zeitraums“ ausgewiesen.
Die zweite oder dritte Stufe greift nicht. Die Schwelle der Stufe ist leer - dann ist die Stufe nicht in Betrieb. Die Auswertung zeigt Ihnen alle eingerichteten Stufen.
Die Auswertung ist im Menü nicht zu finden. Nach der Installation müssen der Klassen- und der Textcache des Shops geleert werden; lassen Sie den Shopcache einmal leeren.

Kommen Sie mit einer Beobachtung nicht weiter, melden Sie sich gerne bei uns.

Wir wünschen Ihnen viel Erfolg beim Einsatz dieses Moduls!

PDF herunterladen
Stand: 2026-08-27 20:59:41