Magento-2-Modul zur Wiederherstellung abgebrochener Warenkörbe mit folgenden Funktionen:
- Erkennung abgebrochener Warenkörbe
- Warenkorb-Scoring mithilfe von KI oder Heuristik
- Generierung von E-Mail-Nachrichten zur Warenkorbwiederherstellung
- optionale Generierung von Gutscheinen
- Gespräche mit einem KI-Einkaufsassistenten
- Adminbereich und Analytics
- REST API-Endpunkte und CLI-Kommandos
Übersicht
Das Modul hilft bei der Wiederherstellung abgebrochener Warenkörbe in Magento 2, indem es inaktive Warenkörbe erkennt, die Kaufabsicht bewertet und E-Mail-Nachrichten mit einem sicheren Link zur Wiederherstellung des Warenkorbs versendet. Je nach Konfiguration kann es in zwei Modi arbeiten:
- Modus
heuristic, ohne externe KI - Modus
OpenAI, mit KI-Analyse, Generierung von E-Mail-Inhalten und Gesprächen mit dem Assistenten
Typischer Ablauf:
- Der Kunde legt Produkte in den Warenkorb.
- Der Kunde verlässt den Shop, ohne eine Bestellung aufzugeben.
- Nach Ablauf der konfigurierten Inaktivitätszeit wird der Warenkorb als abgebrochen markiert.
- Das Modul vergibt ein Scoring für den Warenkorb.
- Wenn das Ergebnis hoch genug ist, wird eine Wiederherstellungs-E-Mail versendet.
- Die E-Mail kann einen Rabattgutschein und einen Link zur Seite des KI-Assistenten enthalten.
- Wenn der Kunde zurückkehrt und eine Bestellung aufgibt, wird der Warenkorb als wiederhergestellt markiert.
Anforderungen
Stellen Sie vor der Installation sicher, dass der Shop die folgenden Anforderungen erfüllt:
- Magento 2 mit CLI-Zugriff
- korrekt funktionierender Magento-Cron
- konfigurierter Versand transaktionaler E-Mails in Magento
- aktiviertes HTTPS im Storefront
- wenn der KI-Modus verwendet wird: OpenAI API-Konto mit aktivem Billing und API-Schlüssel
Operative Empfehlungen:
- Produktionsmodus für den Live-Shop
- getestete E-Mail-Vorlage und korrekt eingestellter Absender
- Datenschutzerklärung, die die Nutzung von KI-Diensten berücksichtigt, wenn der OpenAI-Modus aktiviert ist
Installation
* = Verwenden Sie in der Produktion die Option --keep-generated
Typ: Composer
Fügen Sie das Composer-Repository zur Konfiguration hinzu:
composer config repositories.ai.abandoned.cart vcs https://github.com/kowalco/ai-abandoned-cartFügen Sie ein Zugriffstoken für das private GitHub-Repository hinzu:
composer config --global --auth github-oauth.github.com Installieren Sie das Modul über Composer:
composer require kowal/module-ai-abandoned-cart
Führen Sie anschließend aus:
bin/magento module:enable Kowal_AiAbandonedCartbin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flushCheckliste nach der Installation
Prüfen Sie nach der Installation:
- ob das Modul in Magento aktiviert ist
- ob das Datenbankschema durch
setup:upgradeinstalliert wurde - ob der Magento-Cron korrekt funktioniert
- ob der Shop transaktionale E-Mails versendet
- ob das Storefront korrekte HTTPS-Adressen verwendet
Nützliche Verifizierungskommandos:
bin/magento module:status Kowal_AiAbandonedCartbin/magento cron:runbin/magento cache:flushKonfiguration
Magento Admin:
Stores -> Configuration -> Kowal -> AI Abandoned Cart
Administrationsseiten:
Marketing -> AI Abandoned Cart
Konfigurationsfelder
Die wichtigsten Einstellungen:
Enable ModuleAktiviert oder deaktiviert das gesamte Modul.Cart Inactivity Threshold (minutes)Legt fest, nach wie vielen Minuten Inaktivität ein aktiver Warenkorb als abgebrochen eingestuft werden soll.AI ProviderVerfügbare Werte:Heuristic FallbackOpenAI
OpenAI API KeyNur erforderlich, wennAI ProvideraufOpenAIgesetzt ist.Minimum Intent ScoreNur Warenkörbe mit einem Ergebnis, das diesem Wert entspricht oder darüber liegt, qualifizieren sich für den Versand einer Wiederherstellungs-E-Mail.Enable Dynamic CouponsAktiviert die Generierung einmalig verwendbarer Gutscheine für ausgewählte abgebrochene Warenkörbe.Maximum Coupon DiscountLegt die Obergrenze für den automatisch generierten prozentualen Rabatt fest.Maximum Failed Email AttemptsLegt fest, wie viele fehlgeschlagene Versandversuche erlaubt sind, bevor das Modul den erneuten Versand einstellt.Email Address for Message CopiesOptionaler BCC-Empfänger für Wiederherstellungsnachrichten.Enable AI Assistant LinkWenn diese Option aktiviert ist, enthält die Wiederherstellungs-E-Mail einen sicheren Link zur Seite des KI-Assistenten.Conversation Expiration Time (minutes)Legt fest, wie lange der Link zum KI-Assistenten gültig bleibt.Batch SizeDefiniert, wie viele Warenkörbe in einem Durchlauf für Erkennung, Scoring und E-Mail-Versand verarbeitet werden.Cart Analysis PromptWird verwendet, wenn das KI-Scoring aktiv ist.Email Generation PromptWird zur Generierung des Inhalts von E-Mail-Nachrichten im KI-Modus verwendet.Conversation PromptWird vom KI-Assistenten während des Gesprächs mit dem Kunden verwendet.
Empfohlene Anfangskonfiguration
Für den Start ist folgende sichere Einstellungskombination geeignet:
Enable Module:YesCart Inactivity Threshold (minutes):30AI Provider:Heuristic FallbackoderOpenAIMinimum Intent Score:0.45Enable Dynamic Coupons:YesMaximum Coupon Discount:5Maximum Failed Email Attempts:3Enable AI Assistant Link:YesConversation Expiration Time (minutes):1440Batch Size:100
Modus Heuristic vs. Modus OpenAI
Modus Heuristic
Verwenden Sie diesen Modus, wenn Sie ohne Integration mit externer KI starten möchten.
In diesem Modus kann das Modul:
- abgebrochene Warenkörbe erkennen
- den Intent Score auf Basis integrierter Geschäftsregeln berechnen
- Wiederherstellungs-E-Mails versenden
- Gutscheine generieren
- weiterhin die Assistentenseite bereitstellen, wobei die Antworten jedoch auf integrierter Logik statt auf OpenAI basieren
Modus OpenAI
Verwenden Sie diesen Modus, wenn Ihnen eine stärkere Personalisierung wichtig ist.
In diesem Modus kann das Modul zusätzlich:
- den Warenkorbkontext mithilfe von OpenAI analysieren
- stärker personalisierte E-Mail-Inhalte generieren
- Gespräche mit dem KI-Assistenten zu Produkten aus dem Warenkorb unterstützen
- Produktbeschreibungen, verwandte Produkte, Up-Sell und Cross-Sell in den Antworten nutzen
OpenAI-Konfiguration
So aktivieren Sie den OpenAI-Modus:
- Erstellen Sie einen API-Schlüssel in Ihrem OpenAI Platform-Konto.
- Gehen Sie im Magento Admin zu
Stores -> Configuration -> Kowal -> AI Abandoned Cart. - Setzen Sie
AI ProvideraufOpenAI. - Fügen Sie den Schlüssel in das Feld
OpenAI API Keyein. - Speichern Sie die Konfiguration.
- Leeren Sie den Magento-Cache.
Wichtige Informationen:
- ChatGPT-Abonnements und API-Billing sind getrennte Dinge
- die API-Nutzung wird unabhängig von OpenAI abgerechnet
- im KI-Modus werden Prompt und Warenkorbkontext an OpenAI gesendet
Cron Jobs
Das Modul nutzt Magento-Crons zur automatischen Verarbeitung.
Konfigurierte Cron-Aufgaben:
kowal_ai_abandoned_cart_detectkowal_ai_abandoned_cart_scorekowal_ai_abandoned_cart_email
Ihre Funktion:
detect: sucht inaktive Warenkörbe, die als abgebrochen qualifiziert sindscore: berechnet Intent Score und Reason Codeemail: versendet Wiederherstellungs-E-Mails und speichert Logs
Wenn der Magento-Cron nicht funktioniert, verarbeitet das Modul Warenkörbe nicht automatisch.
Erster Test nach der Konfiguration
Führen Sie nach Installation und Konfiguration einen vollständigen End-to-End-Test durch:
- Öffnen Sie das Storefront als nicht angemeldeter Kunde.
- Legen Sie ein oder mehrere Produkte in den Warenkorb.
- Starten Sie den Checkout und geben Sie eine E-Mail-Adresse ein.
- Verlassen Sie den Checkout, ohne eine Bestellung aufzugeben.
- Warten Sie, bis die konfigurierte Inaktivitätsschwelle überschritten ist.
- Starten Sie Cron oder CLI-Kommandos manuell.
- Bestätigen Sie, dass der Warenkorb im Adminbereich erscheint.
- Bestätigen Sie, dass die Wiederherstellungs-E-Mail versendet wurde.
- Öffnen Sie den Link zur Wiederherstellung des Warenkorbs aus der Nachricht.
- Wenn die Option aktiviert ist, öffnen Sie den Link zum KI-Assistenten und senden Sie eine Testnachricht.
Manuelle CLI-Sequenz:
bin/magento kowal:ai:cart:detectbin/magento kowal:ai:cart:scorebin/magento kowal:ai:cart:send-emailsAdministrationsseiten
Das Modul fügt dedizierte Administrationsseiten hinzu unter:
Marketing -> AI Abandoned Cart
Verfügbare Bereiche:
DashboardÜbersicht über erkannte und wiederhergestellte Warenkörbe.Recovery AnalyticsStatistiken zur Effektivität der Wiederherstellung und operative Kennzahlen.ConversationsVerlauf der Gespräche mit dem KI-Assistenten, die mit abgebrochenen Warenkörben verknüpft sind.Email LogsRegister versendeter und fehlgeschlagener Wiederherstellungsnachrichten.
Diese Seiten sind besonders während der Implementierung nützlich, da sie prüfen lassen, ob Erkennung, Scoring, E-Mail-Versand und Tracking wiederhergestellter Warenkörbe korrekt funktionieren.
E-Mail-Inhalte und Kundenerlebnis
Jede Wiederherstellungs-E-Mail kann enthalten:
- eine personalisierte Betreffzeile
- eigenen Nachrichtentext
- eine Zusammenfassung der Produkte aus dem Warenkorb
- den Warenkorbwert
- einen sicheren Link zur Wiederherstellung des Warenkorbs
- einen optionalen einmalig verwendbaren Rabattgutschein
- einen optionalen Link zum KI-Assistenten
Kundenpfad:
- Der Kunde erhält eine E-Mail.
- Der Kunde klickt auf den Wiederherstellungslink und kehrt zum gespeicherten Warenkorb zurück.
- Der Kunde kann optional die Assistentenseite aus der Nachricht öffnen.
- Der Assistent kann Fragen zu Produkten beantworten, Optionen vergleichen und den Kunden zurück zum Checkout führen.
Wie Gutscheine funktionieren
Wenn dynamische Gutscheine aktiviert sind, kann das Modul einen Gutschein generieren, wenn:
- der Warenkorbwert ausreichend hoch ist
- der Intent Score darauf hinweist, dass ein Rabatt helfen kann
- der berechnete Rabatt das konfigurierte Maximum nicht überschreitet
Aktuelle integrierte Regeln:
- Warenkörbe unter 100 Einheiten der Shop-Währung erhalten keinen Gutschein
- Warenkörbe mit hohem Intent Score erhalten keinen Gutschein
- Warenkörbe mit geringerer Kaufabsicht können einen Rabatt erhalten, in der Regel 3% oder 5%, begrenzt durch die Konfiguration
Generierte Gutscheine sind:
- einmalig verwendbar
- pro Kunde begrenzt
- mit einer gemeinsamen Magento-Warenkorbregel für die jeweilige Rabattstufe und den jeweiligen Shop verknüpft
CLI
Sie können das Modul manuell über CLI ausführen, insbesondere bei Tests und Diagnose.
bin/magento kowal:ai:cart:detectbin/magento kowal:ai:cart:scorebin/magento kowal:ai:cart:send-emailsBedeutung der Kommandos:
kowal:ai:cart:detectErkennt abgebrochene Warenkörbe.kowal:ai:cart:scoreVergibt Scoring und Reason Code für Warenkörbe.kowal:ai:cart:send-emailsVersendet Wiederherstellungsnachrichten für qualifizierte Warenkörbe.
Sicherheit
Links zur Wiederherstellung des Warenkorbs und zum Assistenten verwenden signierte Tokens.
Der Token-Payload enthält:
quote_idemailstore_idexpires_at
Der Token wird validiert durch:
- Verifizierung der Signatur
- Prüfung des Ablaufdatums
- Verifizierung der Warenkorbzugehörigkeit
Dadurch erhält der Kunde einen sicheren Link, der mit einem konkreten Warenkorb verknüpft und zeitlich begrenzt ist.
Fehlerbehebung
Warenkörbe werden nicht erkannt
Prüfen Sie:
- ob das Quote weiterhin aktiv ist
- ob der Warenkorb Produkte enthält
- ob dem Quote keine abgeschlossene Bestellung zugeordnet ist
- ob die E-Mail-Adresse des Kunden erfasst wurde
- ob die Inaktivitätsschwelle überschritten wurde
- ob der Magento-Cron funktioniert
Warenkörbe werden erkannt, aber E-Mails werden nicht versendet
Prüfen Sie:
- ob
Enable Moduleaktiviert ist - ob
Minimum Intent Scorenicht zu hoch eingestellt ist - ob der E-Mail-Versand in Magento funktioniert
- ob das Limit
Maximum Failed Email Attemptsnicht erreicht wurde - ob die dem Warenkorb zugeordnete E-Mail-Adresse korrekt ist
Der OpenAI-Modus ist aktiviert, aber das KI-Ergebnis wird nicht verwendet
Prüfen Sie:
- ob
AI ProvideraufOpenAIgesetzt ist - ob
OpenAI API Keykorrekt ausgefüllt ist - ob der Server ausgehende Verbindungen zur OpenAI API zulässt
- ob das OpenAI-Konto aktives Billing hat
Wenn der OpenAI-Aufruf fehlschlägt, wechselt das Modul zum integrierten heuristischen Verhalten.
Der Link zum KI-Assistenten öffnet sich, aber die Antworten sind allgemein
Prüfen Sie:
- ob der OpenAI-Modus aktiv ist
- ob der Gesprächs-Prompt korrekt konfiguriert ist
- ob der Link weiterhin gültig und nicht abgelaufen ist
Hinweise für den Produktionseinsatz
Vor dem Start in der Produktion empfiehlt es sich:
- Inhalt der E-Mail-Nachrichten und Branding zu prüfen
- die Gutscheinpolitik mit realen Geschäftsregeln zu testen
- Datenschutz- und Compliance-Anforderungen zu verifizieren
- KI-Prompts anhand des Katalogs und des Kommunikationsstils des Shops zu testen
- die ersten Betriebstage in
Dashboard,ConversationsundEmail Logszu überwachen
Erforderliche Informationen bei einer Support-Anfrage
Bereiten Sie bei einer Problemmeldung Folgendes vor:
- Magento-Version
- PHP-Version
- Shop-Modus: developer oder production
- Information, ob Cron funktioniert
- Information, ob das Problem im Modus
heuristicoderOpenAIauftritt - beispielhafte Quote ID oder E-Mail-Adresse des betroffenen Kunden
- relevante Einträge aus Magento-Ausnahme- oder Systemlogs






















