KI-gestützter Warenkorbwiederherstellungs-Assistent für Magento 2

Magento 2-Modul zur Wiederherstellung abgebrochener Warenkörbe mit folgenden Funktionen:

• Erkennung abgebrochener Warenkörbe
• Warenkorb-Scoring mit AI oder Heuristik
• Generierung von E-Mails zur Warenkorbwiederherstellung
• optionale Generierung von Gutscheinen
• Unterhaltungen mit einem AI-Einkaufsassistenten
• Admin-Panel und Analytics
• REST API-Endpunkte sowie CLI-Befehle

Übersicht

Das Modul hilft dabei, abgebrochene Warenkörbe in Magento 2 wiederherzustellen, indem es inaktive Warenkörbe erkennt, die Kaufabsicht bewertet und E-Mails mit einem sicheren Link zur Wiederherstellung des Warenkorbs versendet. Je nach Konfiguration kann es in zwei Modi arbeiten:

• Modusheuristic, ohne externe AI
• ModusOpenAI, mit AI-Analyse, Generierung von E-Mail-Inhalten und Unterhaltungen mit dem Assistenten

Typischer Ablauf:

1. Der Kunde legt Produkte in den Warenkorb.
2. Der Kunde verlässt den Shop, ohne eine Bestellung aufzugeben.
3. Nach Ablauf der konfigurierten Inaktivitätszeit wird der Warenkorb als abgebrochen markiert.
4. Das Modul weist dem Warenkorb ein Scoring zu.
5. Wenn das Ergebnis hoch genug ist, wird eine Wiederherstellungs-E-Mail gesendet.
6. Die E-Mail kann einen Rabattgutschein sowie einen Link zur Seite des AI-Assistenten enthalten.
7. 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 Zugriff auf CLI
• korrekt funktionierender Magento-Cron
• konfigurierter Versand transaktionaler E-Mails in Magento
• aktiviertes HTTPS im Storefront
• wenn der AI-Modus verwendet wird: OpenAI API-Konto mit aktivem Billing und API-Schlüssel

Betriebliche Empfehlungen:

• Produktionsmodus für den Live-Shop
• getestete E-Mail-Vorlage und korrekt eingerichteter Absender
• Datenschutzerklärung, die die Nutzung von AI-Diensten berücksichtigt, wenn der OpenAI-Modus aktiviert ist

Installation

* = in der Produktion verwenden Sie die Option--keep-generated

Typ: Composer

1. Fügen Sie das Composer-Repository zur Konfiguration hinzu:

   Die Zugangsdaten zum Composer-Repository, also die E-Mail-Adresse des Kunden und das Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind außerdem nach dem Login im Kundenpanel unter kowal.storeauch im Kundenkonto verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch den erhaltenen Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.

   composer config repositories.kowal composer https://repo.kowal.store
   

2. Konfiguriere den Zugang zum Kowal-Composer-Repository:

   composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
   

3. Installieren Sie das Modul über Composer:

   <img src="http://localhost:63342/markdownPreview/1398454286/commandRunner/runrun.png">
   composer require kowal/module-ai-abandoned-cart
   

Führen Sie anschließend Folgendes aus:

bin/magento module:enable Kowal_AiAbandonedCart
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Checkliste nach der Installation

Prüfen Sie nach der Installation:

• ob das Modul in Magento aktiviert ist
• ob das Datenbankschema installiert wurde durchsetup:upgrade
• ob Magento-Cron korrekt funktioniert
• ob der Shop Transaktions-E-Mails sendet
• ob das Storefront korrekte HTTPS-Adressen verwendet

Hilfreiche Prüfbefehle:

bin/magento module:status Kowal_AiAbandonedCart
bin/magento cron:run
bin/magento cache:flush

Konfiguration

Magento Admin:

Stores -> Configuration -> Kowal -> AI Abandoned Cart

Admin-Seiten:

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 gelten soll.

• AI ProviderVerfügbare Werte:

  • Heuristic Fallback
  • OpenAI

• OpenAI API KeyNur erforderlich, wennAI ProvideraufOpenAIein.

• Minimum Intent ScoreNur Warenkörbe mit einem Ergebnis, das diesem Wert entspricht oder höher ist, qualifizieren sich für den Versand einer Wiederherstellungs-E-Mail.

• Enable Dynamic CouponsAktiviert die Generierung einmaliger Gutscheine für ausgewählte abgebrochene Warenkörbe.

• Maximum Coupon DiscountLegt die Obergrenze des automatisch generierten prozentualen Rabatts fest.

• Maximum Failed Email AttemptsLegt fest, wie viele fehlgeschlagene Versandversuche zulässig 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 AI-Assistenten.

• Conversation Expiration Time (minutes)Legt fest, wie lange der Link zum AI-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 AI-Scoring aktiv ist.

• Email Generation PromptWird zur Generierung von E-Mail-Inhalten im AI-Modus verwendet.

• Conversation PromptWird vom AI-Assistenten während der Unterhaltung mit dem Kunden verwendet.

Empfohlene Anfangskonfiguration

Für den Start ist folgende Einstellungskombination sicher:

• Enable Module:Yes
• Cart Inactivity Threshold (minutes):30
• AI Provider:Heuristic FallbackoderOpenAI
• Minimum Intent Score:0.45
• Enable Dynamic Coupons:Yes
• Maximum Coupon Discount:5
• Maximum Failed Email Attempts:3
• Enable AI Assistant Link:Yes
• Conversation Expiration Time (minutes):1440
• Batch Size:100

Modus Heuristic vs. Modus OpenAI

Modus Heuristic

Verwenden Sie diesen Modus, wenn Sie ohne Integration mit externer AI starten möchten.

In diesem Modus führt das Modul Folgendes aus:

• erkennt abgebrochene Warenkörbe
• berechnet den Intent Score auf Basis integrierter Geschäftsregeln
• versendet Wiederherstellungs-E-Mails
• kann Gutscheine generieren
• kann weiterhin die Assistentenseite bereitstellen, die Antworten basieren jedoch auf integrierter Logik statt auf OpenAI

Modus OpenAI

Verwenden Sie diesen Modus, wenn Ihnen eine stärkere Personalisierung wichtig ist.

In diesem Modus kann das Modul zusätzlich:

• den Kontext des Warenkorbs mit OpenAI analysieren
• stärker personalisierte E-Mail-Inhalte generieren
• Unterhaltungen mit dem AI-Assistenten über Produkte aus dem Warenkorb unterstützen
• Produktbeschreibungen, verknüpfte Produkte, Up-Sell und Cross-Sell in Antworten nutzen

OpenAI-Konfiguration

So aktivieren Sie den OpenAI-Modus:

1. Erstellen Sie einen API-Schlüssel im OpenAI Platform-Konto.
2. Gehen Sie im Magento Admin zuStores -> Configuration -> Kowal -> AI Abandoned Cartein.
3. Setzen SieAI ProvideraufOpenAIein.
4. Fügen Sie den Schlüssel in das FeldOpenAI API Keyein.
5. Speichern Sie die Konfiguration.
6. 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 AI-Modus werden Prompt und Warenkorbkontext an OpenAI gesendet

Cron Jobs

Das Modul verwendet Magento-Crons für die automatische Verarbeitung.

Konfigurierte Cron-Jobs:

• kowal_ai_abandoned_cart_detect
• kowal_ai_abandoned_cart_score
• kowal_ai_abandoned_cart_email

Ihre Funktion:

• detect: sucht nach inaktiven Warenkörben, die sich als abgebrochen qualifizieren
• score: berechnet Intent Score und Reason Code
• email: 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:

1. Öffnen Sie den Storefront als nicht eingeloggter Kunde.
2. Legen Sie ein oder mehrere Produkte in den Warenkorb.
3. Starten Sie den Checkout und geben Sie die E-Mail-Adresse ein.
4. Verlassen Sie den Checkout, ohne eine Bestellung aufzugeben.
5. Warten Sie, bis der konfigurierte Inaktivitätsschwellenwert überschritten ist.
6. Führen Sie den Cron oder die CLI-Befehle manuell aus.
7. Bestätigen Sie, dass der Warenkorb im Admin-Panel angezeigt wird.
8. Bestätigen Sie, dass die Wiederherstellungs-E-Mail gesendet wurde.
9. Öffnen Sie den Link zur Wiederherstellung des Warenkorbs aus der Nachricht.
10. Wenn die Option aktiviert ist, öffnen Sie den Link zum AI-Assistenten und senden Sie eine Testnachricht.

Manuelle CLI-Sequenz:

bin/magento kowal:ai:cart:detect
bin/magento kowal:ai:cart:score
bin/magento kowal:ai:cart:send-emails

Admin-Seiten

Das Modul fügt dedizierte Admin-Seiten hinzu unter:

Marketing -> AI Abandoned Cart

Verfügbare Bereiche:

• DashboardÜbersicht der erkannten und wiederhergestellten Warenkörbe.

• Recovery AnalyticsStatistiken zur Wiederherstellungsleistung und operative Metriken.

• ConversationsVerlauf der Unterhaltungen mit dem AI-Assistenten, die mit abgebrochenen Warenkörben verknüpft sind.

• Email LogsRegister gesendeter und fehlgeschlagener Wiederherstellungsnachrichten.

Diese Seiten sind während der Implementierung besonders 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:

• einen personalisierten Betreff
• eigenen Nachrichtentext
• eine Zusammenfassung der Produkte aus dem Warenkorb
• den Warenkorbwert
• einen sicheren Link zur Wiederherstellung des Warenkorbs
• einen optionalen einmaligen Rabattgutschein
• einen optionalen Link zum AI-Assistenten

Kundenpfad:

1. Der Kunde erhält eine E-Mail.
2. Der Kunde klickt auf den Wiederherstellungslink und kehrt zum gespeicherten Warenkorb zurück.
3. Der Kunde kann optional die Assistentenseite aus der Nachricht öffnen.
4. Der Assistent kann Fragen zu Produkten beantworten, Optionen vergleichen und den Kunden zurück zum Checkout führen.

So funktionieren Gutscheine

Wenn dynamische Gutscheine aktiviert sind, kann das Modul einen Gutschein generieren, wenn:

• der Warenkorbwert ausreichend hoch ist
• der Intent Score darauf hindeutet, 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 niedrigerer Intention können einen Rabatt erhalten, in der Regel 3% oder 5%, begrenzt durch die Konfiguration

Generierte Gutscheine sind:

• einmalig
• pro Kunde begrenzt
• mit einer gemeinsamen Magento-Warenkorbregel für die jeweilige Rabattstufe und den Shop verknüpft

CLI

Sie können das Modul manuell über die CLI ausführen, besonders bei Tests und Diagnose.

bin/magento kowal:ai:cart:detect
bin/magento kowal:ai:cart:score
bin/magento kowal:ai:cart:send-emails

Bedeutung der Befehle:

• kowal:ai:cart:detectErkennt verlassene Warenkörbe.

• kowal:ai:cart:scoreWeist Warenkörben einen Score und Reason Code zu.

• kowal:ai:cart:send-emailsSendet Wiederherstellungsnachrichten für qualifizierte Warenkörbe.

Sicherheit

Links zur Warenkorbwiederherstellung und zum Assistenten verwenden signierte Token.

Der Token-Payload enthält:

• quote_id
• email
• store_id
• expires_at

Die Token-Validierung umfasst:

1. Prüfung der Signatur
2. Prüfung des Ablaufdatums
3. Prüfung der Warenkorbeigentümerschaft

Der Kunde erhält dadurch einen sicheren, zeitlich begrenzten Link zu einem bestimmten Warenkorb.

Fehlerbehebung

Warenkörbe werden nicht erkannt

Prüfen Sie:

• ob die Quote weiterhin aktiv ist
• ob der Warenkorb Produkte enthält
• ob die Quote keine verknüpfte abgeschlossene Bestellung besitzt
• ob die Kunden-E-Mail-Adresse erfasst wurde
• ob die Inaktivitätsschwelle überschritten wurde
• ob Magento-Cron funktioniert

Warenkörbe werden erkannt, aber E-Mails nicht gesendet

Prüfen Sie:

• obEnable Moduleaktiviert ist
• obMinimum Intent Scorenicht zu hoch eingestellt ist
• ob der E-Mail-Versand in Magento funktioniert
• ob das Limit noch nicht erreicht wurde fürMaximum Failed Email Attempts
• ob die dem Warenkorb zugeordnete E-Mail-Adresse korrekt ist

OpenAI-Modus ist aktiv, aber das KI-Ergebnis wird nicht verwendet

Prüfen Sie:

• obAI ProvideraufOpenAI
• obOpenAI API Keykorrekt ausgefüllt ist
• ob der Server ausgehende Verbindungen zur OpenAI-API erlaubt
• ob im OpenAI-Konto die Abrechnung aktiv ist

Schlägt der OpenAI-Aufruf fehl, wechselt das Modul zum integrierten heuristischen Verhalten.

Der KI-Assistentenlink öffnet sich, aber die Antworten sind allgemein

Prüfen Sie:

• ob der OpenAI-Modus aktiv ist
• ob der Gesprächsprompt korrekt konfiguriert ist
• ob der Link noch gültig und nicht abgelaufen ist

Hinweise zum Produktivbetrieb

Vor dem Produktivstart empfiehlt sich:

• E-Mail-Inhalte und Branding prüfen
• Gutscheinrichtlinie mit realen Geschäftsregeln testen
• Datenschutz- und Compliance-Anforderungen prüfen
• KI-Prompts anhand des Katalogs und der Shop-Tonalität testen
• die ersten Betriebstage überwachen unterDashboard,ConversationsundEmail Logs

Benötigte Informationen für Supportanfragen

Bereiten Sie bei einer Problemmeldung Folgendes vor:

• Magento-Version
• PHP-Version
• Shopmodus: developer oder production
• Angabe, ob Cron funktioniert
• Angabe, ob das Problem im folgenden Modus auftritt:heuristicobOpenAI
• beispielhafte Quote-ID oder E-Mail-Adresse des betroffenen Kunden
• relevante Einträge aus den Magento-Exception- oder Systemprotokollen