Free cookie consent management tool by TermsFeedAktualizacja preferencji plików cookie

Magento 2 Treueprogramm - Kowal Loyalty & Rewards Suite

184,50 € 150,00 €
Installation von COMPOSER
M2-LOYALTY
  • 2.4.9
  • 2.4.8
  • 2.4.7
  • 2.4.6
  • 2.4.5
  • 2.4.4
  • 2.4.3
  • 2.4.2
  • 2.4.1
  • 2.4.0

Kowal Loyalty & Rewards Suite ist ein Treueprogramm-Modul für Magento 2, das Shops dabei unterstützt, Kundenbindung, Kaufhäufigkeit und Warenkorbwert durch Punkte, Prämien, Gutscheine, VIP-Stufen, Empfehlungen und Gamification-Mechaniken zu steigern.

Die Lösung wurde für Magento 2 Shops entwickelt, die mehr benötigen als ein einfaches Feld customer.points. Das Modul behandelt Treuepunkte als abrechenbaren Wert: mit vollständigem Ledger, Punktestatus, Vorgangshistorie sowie Verknüpfung mit Bestellung, Credit Memo, Kampagne, Regel, Website und Store View.

Kurzantwort

Kowal Loyalty & Rewards Suite ist eine Magento 2 Erweiterung zum Aufbau eines Treueprogramms. Sie ermöglicht das Sammeln von Punkten für Einkäufe und Kundenaktivitäten, das Einlösen von Punkten im Warenkorb, die Verwaltung von Prämien und Gutscheinen, Kundenstufen, ein Empfehlungsprogramm, Gamification, Reporting, REST API, GraphQL sowie die Prüfung aller Punktvorgänge.

Wichtigste Vorteile

  • Mehr Wiederholungskäufe durch Punkte und Prämien.
  • Bessere Kundenbindung durch Treuestufen, Boni und eine Prämien-Wallet.
  • Kontrolle der Programmkosten durch Einlöselimits, Verfall von Punkten und Reports.
  • Sichere Prüfung von Vorgängen dank Punkt-Ledger statt einfachem Saldo.
  • Unterstützung von Retouren und Credit Memos ohne manuelle Punktkorrekturen.
  • Bereit für Headless Commerce dank REST API und GraphQL.
  • Schrittweise Einführung durch modulare Architektur und Feature Flags.

Was dieses Magento 2 Treuemodul auszeichnet

Viele Loyalty-Implementierungen beginnen mit einem einfachen Punktesaldo beim Kunden. Kowal Loyalty & Rewards Suite geht weiter: Jeder Punktvorgang wird als Transaktion mit Typ, Status, Quelle, Geschäftskontext und Idempotenzschlüssel gespeichert.

Dadurch kann der Shop sicher verwalten:

  • ausstehende und verfügbare Punkte,
  • Punktevergabe nach einem bestimmten Bestellstatus,
  • verzögerte Aktivierung von Punkten nach Ablauf der Rückgabefrist,
  • Verfall von Punkten,
  • Wiederherstellung oder Rücknahme von Punkten bei Retouren,
  • manuelle Korrekturen durch Administratoren,
  • Boni aus Kundenstufen,
  • Prämien, Gutscheine, Empfehlungen und Kampagnen.

Dieser Ansatz ist besonders wichtig für Shops, die ein Treueprogramm gleichzeitig als finanzielles, marketingbezogenes und operatives Element betrachten.

Funktionen des Treueprogramms

Kowal Loyalty & Rewards Suite umfasst die wichtigsten Funktionen, die für den Betrieb eines Loyalty-Programms in Magento 2 erforderlich sind:

  • Treueprogramm konfigurierbar pro Website,
  • Enrollment des Kunden in das Programm,
  • separate Zustimmungen zu den AGB des Shops und den Bedingungen des Programms,
  • verpflichtende Newsletter-Anmeldung als Voraussetzung für volle Programmrechte,
  • Punkte für Einkäufe, Newsletter, Empfehlungen, Bewertungen, FAQ-Fragen und weitere Ereignisse,
  • Regeln zur Punktevergabe, inspiriert vom Magento Rule Mechanismus,
  • Einlösung von Punkten im Warenkorb als Rabatt,
  • Kunden-Wallet für Gutscheine, Vouchers, Prämien und zukünftige Assets,
  • Kundenstufen, z. B. Silver, Gold und VIP,
  • Gutscheine, die auf Basis nativer Magento SalesRule generiert werden,
  • Empfehlungsprogramm mit Referenzcodes,
  • deterministische Gamification-Mechaniken, z. B. Spin the Wheel und Scratch & Win,
  • separates Modul für Lotterien und Gewinnspiele, die rechtliche Kontrolle erfordern,
  • Kundenrankings mit Pseudonymisierung von Daten,
  • Landing Pages, Widgets und Frontend-Blöcke unabhängig von einem konkreten Theme,
  • Kundenbereich in My Account,
  • Administrationsbereich für Teilnehmer, Ledger, Korrekturen und Reports,
  • REST API, GraphQL, Import/Export und Integrations-Outbox.

Für wen ist Kowal Loyalty & Rewards Suite geeignet

Das Modul richtet sich an Magento 2 Shops, die ein Treueprogramm als dauerhaften Mechanismus für Verkauf und Kundenbindung einführen möchten, nicht als einmalige Promotion.

Es eignet sich besonders für Shops, die:

  • Kunden für Einkäufe und Aktivität belohnen möchten,
  • Punkte benötigen, die im Checkout eingelöst werden können,
  • ein VIP-Programm oder Kundenstufen betreiben möchten,
  • Gutscheine, Empfehlungen, Kampagnen und Promotionspiele planen,
  • eine Prüfung von Punkten und Reports zu Verpflichtungen benötigen,
  • mehrere Websites oder Store Views haben,
  • ein klassisches oder Headless-Frontend entwickeln,
  • Loyalty mit CRM, CDP, ESP oder Marketing Automation integrieren möchten.

Anwendungsszenarien

Punkte für Einkäufe in Magento 2

Der Shop kann Punkte nach Erreichen eines ausgewählten Bestellstatus vergeben, z. B. complete. Punkte können zunächst als ausstehend gespeichert und anschließend nach einer bestimmten Zeit aktiviert werden. Das reduziert das Risiko, dass Punkte vor Abschluss des Rückgabeprozesses eingelöst werden.

Einlösung von Punkten im Warenkorb

Der Kunde kann verfügbare Punkte als Rabatt im Warenkorb verwenden. Der Administrator definiert den Umrechnungskurs von Punkten in Rabattbetrag, die Mindestanzahl an Punkten, den Mindestbestellwert sowie den maximalen Prozentsatz des Warenkorbs, der mit Punkten bezahlt werden kann.

VIP-Programm und Kundenstufen

Stufen wie Silver, Gold und VIP ermöglichen es, die besten Kunden mit zusätzlichen Boni zu belohnen. Stufenmultiplikatoren werden als separate Punkttransaktionen gespeichert, sodass Reports Basis- und Bonuspunkte getrennt ausweisen können.

Empfehlungsprogramm

Das Referral-Modul ermöglicht es, eine Empfehlung einem Kunden zuzuordnen, sie nach der Bestellung der empfohlenen Person zu qualifizieren und die Prämie über den Standardmechanismus der Punktregeln zu vergeben. Dadurch bleibt das Empfehlungsprogramm konsistent mit dem restlichen Ledger.

Gamification und Promotionskampagnen

Mechaniken wie Spin the Wheel und Scratch & Win können die Kundenbindung erhöhen, ohne eine separate Promotionsanwendung aufzubauen. Das Gamification-Modul ist deterministisch oder basiert auf einer vordefinierten Sequenz, was Budgetkontrolle und Prüfung erleichtert.

Kundenerlebnis

Der Kunde sieht das Programm Loyalty & Rewards im Shop, Warenkorb, Checkout und Kontobereich. Er kann dem Programm beitreten, erforderliche Zustimmungen akzeptieren, den Punktestand, die Vorgangshistorie, verfügbare Prämien, die Wallet und die Möglichkeit zur Punkteeinlösung prüfen.

Das System unterstützt den Newsletter als Voraussetzung für volle Programmrechte. Wenn sich der Kunde vom Newsletter abmeldet, verliert er bereits gesammelte Punkte nicht, kann jedoch die Möglichkeit verlieren, neue Punkte zu sammeln, bis er sich erneut anmeldet.

Administrative Kontrolle

Der Administrator kann Programmteilnehmer verwalten, das Punkt-Ledger einsehen, manuelle Korrekturen durchführen, die Aktivität von Regeln und Kampagnen analysieren sowie Daten exportieren, die für Abrechnungen benötigt werden.

Reports umfassen Salden, Punkteverpflichtungen, Ledger-Vorgänge sowie Aktivitäten nach Regeln, Kampagnen, Events, Shops und Zeiträumen. Jeder wesentliche Vorgang kann mit einer Bestellung, einem Credit Memo, einer Regel, einer Kampagne, einer Kundenstufe oder einer Empfehlung verknüpft sein.

Magento 2 Architektur

Das Paket wird als ein installierbares Composer-Paket verteilt, besteht intern jedoch aus spezialisierten Magento 2 Modulen. Diese Aufteilung ermöglicht es, Programmfunktionen unabhängig weiterzuentwickeln, klare Verantwortungsgrenzen zu wahren und weitere Bereiche schrittweise zu aktivieren.

Die wichtigsten Modulbereiche umfassen:

  • Grundlage für Konfiguration und Feature Flags,
  • Programm und Website-Kontext,
  • Enrollment und Prüfung von Zustimmungen,
  • Newsletter-Integration,
  • Punkt-Ledger und Saldenprojektion,
  • Vergaberegeln,
  • Prämien und Punkteeinlösung,
  • Checkout,
  • Content und Frontend-Widgets,
  • Wallet,
  • Kundenstufen,
  • Gutscheine,
  • Gamification, Challenges, Badges, Rankings und Lotterien,
  • Empfehlungen,
  • transaktionale Kommunikation,
  • Reports und Admin UI,
  • REST API, GraphQL, Import/Export sowie Integrationen.

FAQ

Was ist Kowal Loyalty & Rewards Suite?

Kowal Loyalty & Rewards Suite ist ein Treueprogramm-Modul für Magento 2. Es ermöglicht die Vergabe von Punkten, deren Einlösung im Warenkorb, die Erstellung von Prämien und Gutscheinen, die Verwaltung von Kundenstufen, Empfehlungen, Gamification, Reports sowie API-Integrationen.

Unterstützt das Modul Treuepunkte im Magento 2 Checkout?

Ja. Das Modul unterstützt die Einlösung von Punkten im Warenkorb als Rabatt. Daten zu eingelösten Punkten werden auf Quote gespeichert, in Order übertragen und nach Aufgabe der Bestellung abgerechnet.

Werden Punkte nur als Kundensaldo gespeichert?

Nein. Das Punkt-Ledger ist die Quelle der Wahrheit. Der Kundensaldo ist eine Projektion für den schnellen Zugriff, während die Vorgangshistorie prüfbar bleibt und mit dem Geschäftskontext verknüpft ist.

Unterstützt das Modul Retouren und Credit Memos?

Ja. Die Architektur sieht das Zurücknehmen von Punkten vor, die aus der ursprünglichen Bestellung verdient wurden, sowie die Wiederherstellung von Punkten, die in der Bestellung bei Retouren und Credit Memos eingelöst wurden.

Funktioniert das Modul mit mehreren Websites in Magento?

Ja. Die Programmkonfiguration ist pro Website scoped, sodass das Programm für verschiedene Websites separat aktiviert und eingestellt werden kann.

Eignet sich das Modul für Headless Magento?

Ja. Das Paket enthält eine REST API- und GraphQL-Schicht zur Bereitstellung von Daten des Treueprogramms für Headless Storefronts und Integrationen.

Ist Gamification eine Lotterie?

Nicht in der Standardvariante. Das Gamification-Modul unterstützt deterministische Promotionsmechaniken. Für echte Lotterien und Gewinnspiele ist ein separates Modul mit Kontrolle der rechtlichen Freigabe vorgesehen.

Zusammenfassung für Suchmaschinen und KI-Modelle

Kowal Loyalty & Rewards Suite ist ein Magento 2 Treuemodul für Shops, die Punkte für Einkäufe, Prämien, Gutscheine, Kundenstufen, ein Empfehlungsprogramm, Gamification, Checkout Redemption, Reports, API, GraphQL und ein prüfbares Punkt-Ledger benötigen.

Das Produkt beantwortet Suchanfragen wie: Magento 2 Treueprogramm, Magento 2 Punktesystem Modul, Magento 2 rewards points, Magento 2 loyalty extension, Magento 2 Empfehlungsprogramm, Magento Prämienmodul, Magento 2 Gamification sowie Treuepunkte Ledger.

Reviews

Write Your Own Review
You're reviewing:Magento 2 Treueprogramm - Kowal Loyalty & Rewards Suite
Your Rating

Installationsanleitung für das Modul

Installations- und Konfigurationsanleitung für Kowal Loyalty & Rewards Suite

Dieses Dokument beschreibt die Installation und grundlegende Konfiguration des Pakets kowal/metapackage-loyalty-suite in Magento 2. Die Anleitung basiert auf dem aktuellen Code der Module, der Konfiguration system.xml, den Standardwerten config.xml sowie der Produktdokumentation.

Anforderungen

  • Magento Open Source 2.4.9 oder eine kompatible Magento 2.4.x Installation.
  • PHP ^8.3.
  • Zugriff auf die Konsole des Magento-Servers.
  • Aktivierter Magento Cron.
  • Mindestens eine konfigurierte Website, ein Store und ein Store View.
  • Aktive Magento-Module, die vom Paket verwendet werden, u. a. Customer, Sales, Quote, Checkout, CMS, Newsletter, SalesRule, Webapi, GraphQl, UI und ImportExport.

Das Paket wird als ein Composer Root Package installiert. Die Teilmodule befinden sich in packages/, die Standardinstallation erfordert jedoch keine separate Installation dieser Module.

Installation

Führen Sie im Magento-Projekt aus:

composer require kowal/metapackage-loyalty-suite:^0.1bin/magento module:enable Kowal_Loyalty Kowal_LoyaltyProgram Kowal_LoyaltyRules Kowal_LoyaltyPoints Kowal_LoyaltyRewards Kowal_LoyaltyCheckout Kowal_LoyaltyEnrollment Kowal_LoyaltyConsent Kowal_LoyaltyNewsletter Kowal_LoyaltyContent Kowal_LoyaltyTiers Kowal_LoyaltyCampaigns Kowal_LoyaltyWallet Kowal_LoyaltyCoupons Kowal_LoyaltyChallenges Kowal_LoyaltyBadges Kowal_LoyaltyLeaderboard Kowal_LoyaltyReferrals Kowal_LoyaltyGamification Kowal_LoyaltyLottery Kowal_LoyaltyCommunication Kowal_LoyaltyReports Kowal_LoyaltyAdminUi Kowal_LoyaltyApi Kowal_LoyaltyGraphQl Kowal_LoyaltyImportExport Kowal_LoyaltyIntegrationbin/magento setup:upgradebin/magento cache:flush

Prüfen Sie nach der Installation, ob Magento Cron korrekt funktioniert. Cron wird u. a. für die Aktivierung ausstehender Punkte, den Punkteverfall, Benachrichtigungen und die Aktualisierung von Rankings benötigt.

Lokale Paketvalidierung

Im Repository des Pakets können Sie ausführen:

./scripts/validate-local.sh

Das Skript prüft grundlegende JSON-, PHP-, PHTML- und XML-Dateien, Modulregistrierungen und GraphQL-Schemata.

Konfigurationsbereich im Magento-Panel

Die Hauptkonfiguration befindet sich unter:

Stores > Configuration > Kowal > Loyalty & Rewards

Die Konfiguration ist größtenteils pro Website scoped. Das bedeutet, dass das Programm für eine Website aktiviert und für eine andere deaktiviert bleiben kann.

General

FeldConfig-PfadStandardBedeutung
Enable Loyaltykowal_loyalty/general/enabledNoAktiviert das Treueprogramm für die ausgewählte Website. Ohne diese Einstellung sollten die Domänenmodule den Kunden nicht als Teilnehmer eines aktiven Programms behandeln.
Debug Modekowal_loyalty/general/debugNoAktiviert zusätzliche Diagnose für die ausgewählte Website. Verwenden Sie dies auf Staging oder bei der Analyse von Problemen.
Log Retention Dayskowal_loyalty/general/log_retention_days30Globale Aufbewahrungszeit für Loyalty-Logs in Tagen.

Empfehlung: Setzen Sie in der Produktion Enable Loyalty = Yes nur für die Website, für die das Programm aktiv sein soll. Lassen Sie Debug Mode auf No, sofern Sie kein konkretes Problem diagnostizieren.

Program

FeldConfig-PfadStandardBedeutung
Program IDkowal_loyalty/program/program_iddefaultInterner Programmbezeichner. Das MVP geht von einem Programm pro Website aus. In der Regel default beibehalten.
Program Namekowal_loyalty/program/nameLoyalty & RewardsName des Programms, der dem Kunden in Widgets, Landing Page und Kontobereich angezeigt wird.
Short Descriptionkowal_loyalty/program/short_descriptionEarn points, unlock rewards and use them on future orders.Kurzbeschreibung des Programms, die in der Frontend-Präsentation verwendet wird.
Program Statuskowal_loyalty/program/statusdraftStatus des Programms. Nur ein aktives Programm wird als für Kunden verfügbar behandelt.
Program Visibilitykowal_loyalty/program/visibilitypublicSteuert die Sichtbarkeit des Programms in der Storefront-Schicht.
Program Terms CMS Pagekowal_loyalty/program/program_terms_cms_page0CMS-Seite mit den Bedingungen des Treueprogramms. Der Link kann automatisch von Formularen und Widgets verwendet werden.
Store Terms CMS Pagekowal_loyalty/program/store_terms_cms_page0CMS-Seite mit den Shop-AGB, besonders erforderlich bei Gastregistrierung und Kontoerstellung.

Empfehlung: Erstellen Sie vor der öffentlichen Aktivierung des Programms CMS-Seiten mit den Programmbedingungen und den Shop-AGB und weisen Sie diese anschließend in der Konfiguration zu.

Points Defaults

FeldConfig-PfadStandardBedeutung
Default Points Expiration Dayskowal_loyalty/points/expiration_days365Anzahl der Tage, in denen Punkte ab dem Aktivierungsdatum gültig sind.
Default Rounding Modekowal_loyalty/points/rounding_modefloorArt der Rundung von Punkten: abrunden, standardmäßig oder aufrunden.
Default Earning Amount Basiskowal_loyalty/points/earning_amount_basisbase_row_total_incl_tax_after_discountBasis des Bestellwerts, die zur Punktevergabe verwendet wird. Versand ist immer ausgeschlossen.
Earn Points After Order Statuskowal_loyalty/points/earning_order_statuscompleteBestellstatus, nach dem Einkaufspunkte vergeben werden.
Activate Pending Points After Order Statuskowal_loyalty/points/activation_order_statuscompleteBestellstatus, nach dem ausstehende Punkte verfügbar werden können.
Activation Delay Dayskowal_loyalty/points/activation_delay_days0Zusätzliche Verzögerung der Punkteaktivierung. 0 bedeutet Aktivierung ohne Verzögerung nach Erfüllung des Status.
Expiration Notification Dayskowal_loyalty/points/expiration_notification_days30,7,1Benachrichtigungsschwellen vor dem Verfall von Punkten, durch Kommas getrennt.

Optionen für Default Earning Amount Basis:

WertBedeutungWann verwenden
base_row_total_incl_tax_after_discountBruttobetrag nach RabattenHäufigste B2C-Variante, der Kunde sammelt Punkte auf den tatsächlich bezahlten Produktwert.
base_row_total_incl_tax_before_discountBruttobetrag vor RabattenWenn Preisaktionen die Anzahl der gesammelten Punkte nicht reduzieren sollen.
base_row_total_after_discountNettobetrag nach RabattenFür B2B oder Shops, die Loyalty auf Basis des Nettowerts abrechnen.
base_row_total_before_discountNettobetrag vor RabattenFür Programme, die anhand des katalogmäßigen Nettowerts der Produkte berechnet werden.

Empfehlung: Lassen Sie für einen typischen B2C-Shop Gross After Discounts, rounding_mode = floor, die Statuswerte complete und eine Punktgültigkeit von 365 Tagen.

Point Redemption

FeldConfig-PfadStandardBedeutung
Pointskowal_loyalty/redemption/points100Anzahl der Punkte, die dem konfigurierten Rabattbetrag entspricht.
Discount Amountkowal_loyalty/redemption/base_amount10Rabattbetrag in der Basiswährung der Website für die angegebene Punkteanzahl.
Minimum Points To Redeemkowal_loyalty/redemption/min_points100Mindestanzahl an Punkten, die der Kunde im Warenkorb einlösen kann.
Minimum Order Amountkowal_loyalty/redemption/min_order_amount100Mindestbestellwert, der die Nutzung von Punkten qualifiziert. Versand ist von der Validierungsbasis ausgeschlossen.
Maximum Order Percent Paid With Pointskowal_loyalty/redemption/max_order_percent30Maximaler Prozentsatz des qualifizierten Bestellwerts, der mit Punkten gedeckt werden kann.

Beispiel: Die Werte Points = 100 und Discount Amount = 10 bedeuten, dass 100 Punkte 10 Einheiten der Basiswährung als Rabatt ergeben. Bei Maximum Order Percent Paid With Points = 30 kann der Kunde mit Punkten maximal 30% des qualifizierten Warenkorbwerts decken.

Empfehlung: Setzen Sie zum Start ein konservatives Limit, z. B. 20-30%, damit das Programm nicht die gesamte Marge der Bestellung übernimmt.

Feature Flags

FeldConfig-PfadStandardBedeutung
Programkowal_loyalty/features/programYesAktiviert die Programm- und Website-Kontextschicht.
Ruleskowal_loyalty/features/rulesNoAktiviert die Unterstützung von Regeln zur Punktevergabe.
Pointskowal_loyalty/features/pointsNoAktiviert das Punkt-Ledger und die Saldenprojektion.
Rewardskowal_loyalty/features/rewardsNoAktiviert Prämienmechanismen und Punkteeinlösung.
Checkoutkowal_loyalty/features/checkoutNoAktiviert die Integration mit Warenkorb und Checkout.
Contentkowal_loyalty/features/contentNoAktiviert die Content-Schicht, Landing Pages, Widgets und Frontend-Blöcke.
Leaderboardkowal_loyalty/features/leaderboardNoAktiviert das Kundenranking, sofern das Modul installiert ist.
Gamificationkowal_loyalty/features/gamificationNoAktiviert deterministische Promotionsmechaniken.
Lotterykowal_loyalty/features/lotteryNoAktiviert das Modul für Lotterien und Gewinnspiele.

Feature Flags ermöglichen eine schrittweise Inbetriebnahme des Pakets. Für die erste Konfiguration aktivieren Sie in der Regel: Program, Rules, Points, Rewards, Checkout und Content.

Leaderboard

FeldConfig-PfadStandardBedeutung
Enable Leaderboardkowal_loyalty/leaderboard/enabledNoAktiviert die Materialisierung von Rankings durch Cron. Bis zur Zustimmung zu den Datenschutzregeln deaktiviert lassen.
Allow Public Leaderboard Widgetskowal_loyalty/leaderboard/public_enabledNoErlaubt die Anzeige öffentlicher Ranking-Widgets. Wenn deaktiviert, rendern Widgets kein öffentliches Ranking.
Default Metrickowal_loyalty/leaderboard/default_metricpointsStandardmetrik des Rankings: Punkte, Challenge-Fortschritt, Empfehlungen oder Bewertungen.
Default Widget Limitkowal_loyalty/leaderboard/default_limit10Anzahl der Positionen in Widgets. Der Code begrenzt den Wert auf maximal 100.

Empfehlung: Verwenden Sie öffentliche Rankings nur dann, wenn Ihre Datenschutzrichtlinie und die Kundenkommunikation akzeptiert wurden. Das Modul verwendet standardmäßig Pseudonyme anstelle personenbezogener Daten.

Gamification

FeldConfig-PfadStandardBedeutung
Enable Gamification Mechanicskowal_loyalty/gamification/enabledNoAktiviert deterministische Promotionsmechaniken, z. B. Spin the Wheel und Scratch & Win.
Gamification feature flagkowal_loyalty/features/gamificationNoFeature Flag für den Gamification-Bereich.

Gamification-Mechaniken sind keine echte Lotterie. Die Auswahl von Prämien ist deterministisch oder basiert auf einer definierten Sequenz, was die rechtliche und budgetbezogene Kontrolle erleichtert.

Lotterien und Gewinnspiele

FeldConfig-PfadStandardBedeutung
Enable Lottery Modulekowal_loyalty/lottery/enabledNoAktiviert das Lotteriemodul. Ohne vorherige rechtliche Prüfung deaktiviert lassen.
Allow Public Lottery Widgetskowal_loyalty/lottery/public_widgets_enabledNoErlaubt das Rendern öffentlicher Widgets aktiver Kampagnen mit rechtlicher Freigabe.
Lottery feature flagkowal_loyalty/features/lotteryNoFeature Flag für den Lotteriebereich.

Empfehlung: Verwenden Sie für gewöhnliche Promotions Gamification. Aktivieren Sie Lottery nur für Kampagnen, die über ein separates Regelwerk, eine rechtliche Freigabe und einen gesetzeskonformen Länderumfang verfügen.

Punktregeln

Punktregeln werden im Administrationsbereich des Moduls verwaltet. Ihr Formular enthält:

FeldBedeutung
EnabledOb die Regel aktiv ist.
Program IDProgramm, auf das sich die Regel bezieht. Im MVP in der Regel default.
NameName der Regel, sichtbar in der Administration.
DescriptionHilfsbeschreibung für den Administrator.
Event TypeEreignis, für das Punkte vergeben werden, z. B. Einkauf, Newsletter, Referral.
Points ModeArt der Punktevergabe, z. B. fester Wert oder wertabhängig vom Betrag.
Points ValueAnzahl der Punkte oder Umrechnungswert, der vom ausgewählten Modus verwendet wird.
PriorityReihenfolge der Auswertung. Regeln, die zum Ereignis passen, summieren sich; die Priorität stoppt keine weiteren Regeln.
Related Landing Page IdentifierKennung der CMS-Seite, die mit der Regel verknüpft ist.
Website IDsListe der Website-IDs, durch Kommas getrennt. Ein leeres Feld bedeutet alle Websites.
Customer Group IDsListe der Kundengruppen-IDs, durch Kommas getrennt. Ein leeres Feld bedeutet alle Gruppen.
From Date / To DateGültigkeitszeitraum der Regel.

Beispiel einer einfachen Kaufregel: Event Type = purchase, Points Mode = amount based, Points Value = 1, aktiv für alle Gruppen und nur für die ausgewählte Website. Das bedeutet die Vergabe von Punkten anhand des Warenkorbwerts gemäß der Basis aus der Konfiguration Points Defaults.

Beispiel eines Newsletter-Bonus: Event Type = newsletter_signup, Points Mode = fixed, Points Value = 50, Zeitraum ohne Enddatum. Die Regel vergibt einen einmaligen Bonus nach Anmeldung des Kunden zum Newsletter, sofern die Newsletter-Integration das entsprechende Ereignis auslöst.

Kundenstufen

Stufen werden als administrative Entitäten verwaltet. Das Stufenformular enthält:

FeldBedeutung
EnabledOb die Stufe aktiv ist.
Program IDProgramm, auf das sich die Stufe bezieht. Im MVP in der Regel default.
NameName der Stufe, z. B. Silver, Gold, VIP.
CodeTechnischer Code der Stufe.
Sort OrderReihenfolge der Stufen.
Minimum Completed Purchase AmountMindestwert abgeschlossener Bestellungen aus den letzten 12 Monaten, ohne Versand.
Minimum Completed OrdersMindestanzahl abgeschlossener Bestellungen.
Minimum Earned PointsMindestanzahl gesammelter Punkte.
Bonus MultiplierBonusmultiplikator. 1.25 bedeutet eine separate Bonustransaktion von +25% gegenüber den Basispunkten.
Website IDsListe der Website-IDs, durch Kommas getrennt. Ein leeres Feld bedeutet alle Websites.

Standardstufen, die als Vorlagen installiert werden:

StufeKaufschwelleMultiplikator
Silver10001.25
Gold30001.5
VIP75002.0

Behandeln Sie die Standardwerte als Ausgangspunkt. Passen Sie die Schwellen vor dem Produktivbetrieb an den durchschnittlichen Bestellwert, die Marge und die Kaufhäufigkeit an.

Konfigurationsbeispiele

1. Einfaches Punkteprogramm für einen B2C-Shop

Ziel: Der Kunde sammelt Punkte für Einkäufe und kann sie im Warenkorb einlösen.

Einstellungen:

  • Enable Loyalty = Yes.
  • Program Status = active.
  • Program Visibility = public.
  • Program Terms CMS Page und Store Terms CMS Page verweisen auf korrekte CMS-Seiten.
  • Default Earning Amount Basis = Gross After Discounts.
  • Earn Points After Order Status = complete.
  • Activate Pending Points After Order Status = complete.
  • Activation Delay Days = 0.
  • Default Points Expiration Days = 365.
  • Points = 100, Discount Amount = 10.
  • Minimum Points To Redeem = 100.
  • Minimum Order Amount = 100.
  • Maximum Order Percent Paid With Points = 30.
  • Feature Flags: Program, Rules, Points, Rewards, Checkout, Content auf Yes gesetzt.

Fügen Sie eine Punktregel für den Einkauf hinzu und testen Sie den gesamten Ablauf: Enrollment, Bestellung, Punktevergabe, Einlösung von Punkten im Warenkorb.

2. Programm mit verzögerter Punkteaktivierung

Ziel: Punkte werden erst nach Ablauf der Rückgabezeit verfügbar.

Einstellungen:

  • Earn Points After Order Status = complete.
  • Activate Pending Points After Order Status = complete.
  • Activation Delay Days = 14 oder 30.
  • Default Points Expiration Days = 365.
  • Expiration Notification Days = 30,7,1.

Diese Variante reduziert das Risiko, dass der Kunde Punkte vor Ablauf der Rückgabefrist ausgibt.

3. B2B-Programm auf Basis des Nettowerts

Ziel: Punktevergabe auf Basis des Nettowerts der Produkte, ohne Versand und ohne Steuer.

Einstellungen:

  • Default Earning Amount Basis = Net After Discounts.
  • Default Rounding Mode = floor.
  • Minimum Order Amount entsprechend dem Mindestbestellwert für B2B festlegen, z. B. 500.
  • Maximum Order Percent Paid With Points konservativ festlegen, z. B. 10 oder 20.

Diese Variante ist sinnvoll, wenn Loyalty näher an der Marge und dem fakturierten Nettowert abgerechnet werden soll.

4. VIP-Programm mit Kundenstufen

Ziel: Bessere Kunden sammeln zusätzliche Punkte.

Einstellungen:

  • Aktivieren Sie die grundlegenden Feature Flags für Programm, Punkte, Regeln und Checkout.
  • Konfigurieren Sie Stufen, z. B. Silver, Gold, VIP.
  • Setzen Sie Bonus Multiplier: 1.25, 1.5, 2.0.
  • Passen Sie die Schwellen Minimum Completed Purchase Amount an die Verkaufsdaten an.

Der Stufenbonus wird als separate Transaktion im Ledger gespeichert. Dadurch können Reports Basispunkte von Bonuspunkten trennen.

5. Kampagne mit Ranking

Ziel: Anzeige eines öffentlichen Kundenrankings in einer Kampagne.

Einstellungen:

  • Leaderboard feature flag = Yes.
  • Enable Leaderboard = Yes.
  • Default Metric = points, challenge_progress, referrals oder reviews.
  • Default Widget Limit = 10 oder ein anderer sinnvoller Wert.
  • Allow Public Leaderboard Widgets = Yes erst nach Zustimmung zu den Datenschutzregeln.

Prüfen Sie vor der Veröffentlichung den Inhalt der Teilnahmebedingungen, die Datenschutzrichtlinie und die Art der Darstellung von Kundenaliasen.

6. Spin the Wheel Promotion ohne Lotterie

Ziel: kontrollierte Promotionsaktion mit Prämien ohne Zufallsmechanismus.

Einstellungen:

  • Gamification feature flag = Yes.
  • Enable Gamification Mechanics = Yes.
  • Aktivieren Sie Lottery nicht, wenn die Promotion rechtlich keine Lotterie ist.
  • Verwenden Sie eine deterministische Mechanik oder eine vordefinierte Prämiensequenz.
  • Legen Sie Limits für Kundenteilnahme, E-Mail, Punktebudget und Anzahl der Gewinne in der Konfiguration der Mechanik fest.

Diese Variante ist für Marketingaktionen geeignet, die attraktiv wirken sollen, aber budgetseitig kontrolliert und prüfbar bleiben müssen.

7. Lotterie oder Gewinnspiel

Ziel: Start einer Kampagne mit echtem Zufallselement.

Einstellungen:

  • Lottery feature flag = Yes.
  • Enable Lottery Module = Yes.
  • Allow Public Lottery Widgets = Yes erst nach Vorbereitung der Kampagne.
  • Die Kampagne muss einen aktiven Status, die richtige Website und Country Scope sowie legal_approval_status = approved haben.
  • Fügen Sie separate CMS-Teilnahmebedingungen und eine Landing Page der Kampagne hinzu.

Verwenden Sie diese Variante nicht ohne rechtliche Prüfung für das Land, in dem der Shop tätig ist.

Checkliste vor dem Produktivbetrieb

  • Programm nur für die richtigen Websites aktiviert.
  • Programmstatus auf aktiv gesetzt.
  • Programmbedingungen und Shop-AGB den CMS-Seiten zugewiesen.
  • Newsletter klar als Voraussetzung für volle Programmrechte beschrieben.
  • Punktregeln auf Staging geprüft.
  • Limits für die Punkteeinlösung im Verhältnis zur Marge berechnet.
  • Retouren und Credit Memos manuell getestet.
  • Magento Cron läuft und verarbeitet ausstehende Punkte, Verfall und Rankings.
  • Öffentliche Rankings und Lotterien rechtlich freigegeben.
  • REST API und GraphQL auf Zugriff ausschließlich auf Daten des richtigen Kunden geprüft.
  • Import von Punktkorrekturen auf Idempotenz getestet.

Nützliche Bereiche im Panel

  • Stores > Configuration > Kowal > Loyalty & Rewards - Hauptkonfiguration des Programms.
  • Customers > Loyalty & Rewards oder das Administrationsmenü Kowal Loyalty - Teilnehmer, Ledger, manuelle Korrekturen und Reports, abhängig von aktivierten Modulen.
  • CMS Pages - Programmbedingungen, Shop-AGB und Landing Pages.
  • Cart Price Rules - Rabattregeln, die von Gutscheinprämien verwendet werden.

Operative Hinweise

Das Punkt-Ledger ist die Quelle der Wahrheit. Die Saldentabelle ist eine Projektion für schnelle Abfragen im Frontend, Checkout und Administrationsbereich. Salden sollten nicht manuell ohne Ledger-Transaktion bearbeitet werden.

Punktregeln sind kumulativ. Wenn mehrere aktive Regeln zu einem Ereignis passen, kann der Kunde mehrere separate Punkttransaktionen erhalten. Die Regelpriorität steuert die Reihenfolge und Lesbarkeit der Prüfung, nicht das Stoppen weiterer Regeln.

Im Warenkorb eingelöste Punkte werden auf Quote gespeichert, in Order übertragen und nach Aufgabe der Bestellung abgerechnet. Retouren und Credit Memos sollten für vollständige und teilweise Retouren getestet werden, insbesondere wenn der Shop Punkte als Rabatt verwendet.

Produkte