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 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:

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 vergibt ein Scoring für den Warenkorb.
5. Wenn das Ergebnis hoch genug ist, wird eine Wiederherstellungs-E-Mail versendet.
6. Die E-Mail kann einen Rabattgutschein und einen Link zur Seite des KI-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 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

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

   

   composer config repositories.ai.abandoned.cart vcs https://github.com/kowalco/ai-abandoned-cart

2. Fügen Sie ein Zugriffstoken für das private GitHub-Repository hinzu:

   

   composer config --global --auth github-oauth.github.com 

3. 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:flush

Checkliste nach der Installation

Prüfen Sie nach der Installation:

• ob das Modul in Magento aktiviert ist
• ob das Datenbankschema durch setup:upgrade installiert 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:flush

Konfiguration

Magento Admin:

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

Administrationsseiten:

Marketing -> AI Abandoned Cart

Konfigurationsfelder

Die wichtigsten Einstellungen:

• Enable Module Aktiviert 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 Provider Verfügbare Werte:

  • Heuristic Fallback
  • OpenAI

• OpenAI API Key Nur erforderlich, wenn AI Provider auf OpenAI gesetzt ist.

• Minimum Intent Score Nur 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 Coupons Aktiviert die Generierung einmalig verwendbarer Gutscheine für ausgewählte abgebrochene Warenkörbe.

• Maximum Coupon Discount Legt die Obergrenze für den automatisch generierten prozentualen Rabatt fest.

• Maximum Failed Email Attempts Legt fest, wie viele fehlgeschlagene Versandversuche erlaubt sind, bevor das Modul den erneuten Versand einstellt.

• Email Address for Message Copies Optionaler BCC-Empfänger für Wiederherstellungsnachrichten.

• Enable AI Assistant Link Wenn 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 Size Definiert, wie viele Warenkörbe in einem Durchlauf für Erkennung, Scoring und E-Mail-Versand verarbeitet werden.

• Cart Analysis Prompt Wird verwendet, wenn das KI-Scoring aktiv ist.

• Email Generation Prompt Wird zur Generierung des Inhalts von E-Mail-Nachrichten im KI-Modus verwendet.

• Conversation Prompt Wird 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: Yes
• Cart Inactivity Threshold (minutes): 30
• AI Provider: Heuristic Fallback oder OpenAI
• 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 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:

1. Erstellen Sie einen API-Schlüssel in Ihrem OpenAI Platform-Konto.
2. Gehen Sie im Magento Admin zu Stores -> Configuration -> Kowal -> AI Abandoned Cart.
3. Setzen Sie AI Provider auf OpenAI.
4. Fügen Sie den Schlüssel in das Feld OpenAI API Key ein.
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 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_detect
• kowal_ai_abandoned_cart_score
• kowal_ai_abandoned_cart_email

Ihre Funktion:

• detect: sucht inaktive Warenkörbe, die als abgebrochen qualifiziert sind
• 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 das Storefront als nicht angemeldeter Kunde.
2. Legen Sie ein oder mehrere Produkte in den Warenkorb.
3. Starten Sie den Checkout und geben Sie eine E-Mail-Adresse ein.
4. Verlassen Sie den Checkout, ohne eine Bestellung aufzugeben.
5. Warten Sie, bis die konfigurierte Inaktivitätsschwelle überschritten ist.
6. Starten Sie Cron oder CLI-Kommandos manuell.
7. Bestätigen Sie, dass der Warenkorb im Adminbereich erscheint.
8. Bestätigen Sie, dass die Wiederherstellungs-E-Mail versendet wurde.
9. Öffnen Sie den Link zur Wiederherstellung des Warenkorbs aus der Nachricht.
10. 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-emails

Administrationsseiten

Das Modul fügt dedizierte Administrationsseiten hinzu unter:

Marketing -> AI Abandoned Cart

Verfügbare Bereiche:

• Dashboard Übersicht über erkannte und wiederhergestellte Warenkörbe.

• Recovery Analytics Statistiken zur Effektivität der Wiederherstellung und operative Kennzahlen.

• Conversations Verlauf der Gespräche mit dem KI-Assistenten, die mit abgebrochenen Warenkörben verknüpft sind.

• Email Logs Register 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:

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.

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-emails

Bedeutung der Kommandos:

• kowal:ai:cart:detect Erkennt abgebrochene Warenkörbe.

• kowal:ai:cart:score Vergibt Scoring und Reason Code für Warenkörbe.

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

Sicherheit

Links zur Wiederherstellung des Warenkorbs und zum Assistenten verwenden signierte Tokens.

Der Token-Payload enthält:

• quote_id
• email
• store_id
• expires_at

Der Token wird validiert durch:

1. Verifizierung der Signatur
2. Prüfung des Ablaufdatums
3. 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 Module aktiviert ist
• ob Minimum Intent Score nicht zu hoch eingestellt ist
• ob der E-Mail-Versand in Magento funktioniert
• ob das Limit Maximum Failed Email Attempts nicht 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 Provider auf OpenAI gesetzt ist
• ob OpenAI API Key korrekt 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, Conversations und Email Logs zu ü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 heuristic oder OpenAI auftritt
• beispielhafte Quote ID oder E-Mail-Adresse des betroffenen Kunden
• relevante Einträge aus Magento-Ausnahme- oder Systemlogs