PrestaShop KI-Analytics: Dokumentation

Dokumentationsstand: 11.08.2026. Die Angaben basieren auf dem aktuellen Produktpaket und dem installierten Modulcode. Vor Updates immer Backup und Staging-Test durchführen.

Version und Kompatibilität

Modulansicht und Datenfluss

Aus getrennten Reports wird ein täglicher Maßnahmenplan

Shopbetreiber finden Bestelldaten in PrestaShop und Besucherdaten in Google Analytics 4, haben aber selten Zeit, mehrere Reports zu vergleichen und daraus konkrete Prioritäten abzuleiten. Kennzahlen zeigen, was passiert ist, aber nicht automatisch, was heute zu tun ist.

PrestaShop KI-Analytics & tägliche Business-Insights löst dieses Problem, indem das Modul aggregierte GA4-Kennzahlen von gestern mit relevanten PrestaShop-Daten zu Verkauf, Warenkörben, Katalog, Lager und Produkten kombiniert. OpenAI erstellt daraus direkt im Backoffice 3–5 praktische Empfehlungen. Jeder Insight enthält Priorität, Kategorie, Beobachtung, empfohlene Maßnahme, Datennachweis und Konfidenzwert.

Funktionsumfang

• Täglich 3–5 KI-gestützte E-Commerce-Insights.
• Anzeige der neuesten Empfehlungen als Widget im Backoffice-Dashboard.
• Kategorien: Traffic, Conversion, Umsatz, Kaufabbrüche, Lager, Produkte, SEO und Marketing.
• Vergleich von gestern mit den vorherigen 7 und 30 Tagen sowie Tagesdurchschnitten.
• Google Analytics 4 über eine schreibgeschützte Google-OAuth-Verbindung.
• Service-Account-JSON als Alternative für fortgeschrittene Nutzer.
• Auswahl der GA4-Property aus dem verbundenen Google-Konto.
• OpenAI Responses API mit strikt strukturiertem JSON-Output.
• Modellauswahl: gpt-5-mini, gpt-4.1-mini und gpt-4o-mini; Standard ist gpt-5-mini.
• Ausgabesprache aus den aktiven Sprachen des Shops.
• Cache nach Datum, Shop und Sprache, damit das Dashboard nicht bei jedem Aufruf neue API-Anfragen ausführt.
• Manuelle Neuerstellung über Modulkonfiguration oder Dashboard.
• Token-geschützte HTTP-Cron-URL und Symfony-Befehl php bin/console aidailyinsights:generate.
• Status- und Fehlerprotokolle für die letzten Generierungen.

Analysierte Daten

Aus PrestaShop

• Gültige Bestellungen, Umsatz und durchschnittlicher Bestellwert von gestern.
• Bestell- und Umsatzsummen der vorherigen 7 und 30 Tage.
• Bestseller und schwach verkaufte aktive Produkte der letzten 30 Tage.
• Anzahl aktiver Produkte, Niedrigbestand und ausgewählte Bestandsbeispiele.
• Anzahl, geschätzter Wert und Durchschnittswert abgebrochener Warenkörbe.

Aus Google Analytics 4

• Nutzer, Sitzungen, Interaktion, Absprungrate, Sitzungsdauer, Seitenaufrufe und Events.
• Schlüsselereignisse, Add-to-Cart, Checkouts, Käufe und Kaufumsatz.
• Kanäle, Quelle/Medium, Geräte, Landingpages, Top-Seiten und Länder.
• Top-Events und aggregierte E-Commerce-Produktleistung.

Kompatibilität

• PrestaShop 8.x: kompatibel und unterstützt ab PrestaShop 8.0.0.
• PrestaShop 9.x: kompatibel und unterstützt.
• PHP für PrestaShop 8: PHP 7.2.5–8.1, abhängig vom genauen PrestaShop-8-Release.
• PHP für PrestaShop 9: PHP 8.1–8.5, abhängig vom genauen PrestaShop-9-Release.
• Benötigte PHP-Funktionen: cURL, JSON, OpenSSL und mbstring zusätzlich zu den üblichen PrestaShop-Anforderungen.

Status für PrestaShop 8 und 9: Modulversion 1.0.0 unterstützt beide Hauptversionen. Sichern Sie den Shop und testen Sie Verbindung, Cron und Dashboard vor dem Produktiveinsatz in einer Staging-Umgebung.

Multistore und Mehrsprachigkeit

Multistore: unterstützt. Insights, Logs und Cache-Abfragen werden über die Shop-ID getrennt. Cron und CLI können alle Shops oder gezielt einen Shop verarbeiten. Zugangsdaten und Sprache sollten im vorgesehenen Shop-Kontext konfiguriert und geprüft werden.

Mehrsprachige Insights: unterstützt. Die Ausgabesprache wird aus den aktiven Sprachen des aktuellen Shops gewählt; Cache-Ergebnisse werden zusätzlich nach Sprache getrennt. Die Quelloberfläche des Backoffice ist Englisch, eine deutsche Übersetzungsdatei ist enthalten.

Screenshots und Demo

Die Produktgalerie zeigt die Insight-Karten mit Priorität und Nachweis, OpenAI-Einstellungen, Google-OAuth- und GA4-Property-Auswahl, Cron-Konfiguration, manuelle Neuerstellung und die letzten Generierungsprotokolle.

Da dieses Backoffice-Modul eine eigene GA4-Property und persönliche API-Zugangsdaten benötigt, ist keine öffentliche Live-Demo enthalten.

Installation und Konfiguration

1. Shopdateien und Datenbank sichern.
2. Im Backoffice Module > Modulmanager > Modul hochladen öffnen, ZIP-Datei hochladen und installieren.
3. Modulkonfiguration öffnen und den eigenen OpenAI-API-Schlüssel eintragen.
4. OpenAI-Modell, Ausgabesprache und 3–5 Insights pro Tag wählen.
5. Google-OAuth-Client anlegen, Client-ID und Secret eintragen und die im Modul angezeigte Redirect-URI beim Google-Client hinterlegen.
6. Google-Konto mit schreibgeschütztem Analytics-Zugriff verbinden und GA4-Property auswählen. Alternativ kann ein Service-Account-JSON verwendet werden.
7. Einstellungen speichern und einmal manuell einen Test-Insight erzeugen.
8. Gesicherte Cron-URL täglich aufrufen oder php bin/console aidailyinsights:generate ausführen.
9. Dashboard, Cache-Ergebnis und Generierungslogs prüfen.

Eine englische README.md mit Installation, OAuth, HTTP-Cron, CLI-Optionen, Sicherheitshinweisen und Datenmodell ist im Modulpaket enthalten.

Version und Changelog

Aktuelle Version: 1.0.0

• 1.0.0 – Erstveröffentlichung: strukturierte tägliche KI-Insights; PrestaShop- und GA4-Kennzahlen; Dashboard-Widget; OAuth und Service Account; Shop-/Sprach-Cache; gesicherter Cron; Symfony-CLI; manuelle Neuerstellung und Logs.

Voraussetzungen und separate Kosten

• Google-Analytics-4-Property mit verwendbaren Shop- und E-Commerce-Daten.
• Eigener Google-OAuth-Client oder Service Account mit schreibgeschütztem Analytics-Zugriff.
• Eigener OpenAI-API-Schlüssel mit Zugriff auf das gewählte Modell.
• Die OpenAI-API-Nutzung wird separat durch OpenAI berechnet und ist nicht im Modulpreis enthalten. Google-Bedingungen und gegebenenfalls Google-Kosten gelten ebenfalls separat.
• Der Shopserver muss ausgehende HTTPS-Verbindungen zu Google und OpenAI erlauben.

Lizenz, Support und Updates

• Enthaltene Shoplizenzen: eine produktive PrestaShop-Installation einschließlich ihrer Shops, wenn sie als eine Multistore-Installation betrieben werden.
• Lizenzart: nicht ausschließliches, nicht übertragbares Nutzungsrecht. Weitergabe, Weiterverkauf, Unterlizenzierung oder Veröffentlichung der Moduldateien sind nicht erlaubt.
• Enthaltener Support: Download-Zugriff, Fragen zu Installation/Konfiguration und Prüfung reproduzierbarer Modulfehler in einer aufgeführten Standardumgebung.
• Nicht enthalten: Einrichtung von Google Cloud, GA4 oder OpenAI als Dienstleistung; Analytics-Implementierung oder Datenkorrektur; API-Gebühren; individuelle Prompts/Reports; Individualentwicklung; Theme-Anpassung; Drittmodulkonflikte oder Server-/Cron-Administration. Diese Leistungen können separat angeboten werden.
• Updates und Verlängerung: Das aktuelle Paket 1.0.0 ist enthalten. Ein fester Zeitraum kostenloser zukünftiger Updates wird nicht zugesagt. Es gibt kein Abonnement und keine automatische Verlängerung; ein späteres kostenpflichtiges Major-Upgrade kann separat angeboten werden.

Daten und externe Dienste

Das Modul enthält keine Waldbyte-Telemetrie und keinen Lizenzserver-Aufruf. Externe Dienste werden ausschließlich für die konfigurierten Analytics- und KI-Funktionen kontaktiert.

• Google: Google Accounts, OAuth-Token-, Google Analytics Admin- und Google Analytics Data-APIs werden mit dem schreibgeschützten Scope analytics.readonly kontaktiert. Abgerufen werden GA4-Property-Metadaten und aggregierte Reports.
• OpenAI: Die OpenAI Responses API erzeugt die Empfehlungen. Die Nutzlast kann Shop-ID, Datum, Währung, aggregierte Bestell-/Warenkorb-/Katalog-/Lagerkennzahlen, Produktnamen sowie aggregierte GA4-Dimensionen wie Seitenpfade/-titel, Quelle/Medium, Land, Eventnamen und Produktleistung enthalten. Kundennamen, E-Mail-Adressen, Postanschriften oder kundenbezogene Bestell-IDs werden nicht absichtlich gesendet.
• Lokal gespeichert: API-Einstellungen, Google-Zugangsdaten oder OAuth-Refresh-Token, gewählte Property/Modell/Sprache, Sicherheitstoken, aggregierte Rohmetriken, generiertes Insight-JSON und Logs. OAuth-Diagnosen können im Shop-Logverzeichnis gespeichert werden.

Der Händler ist für Datenschutzhinweise, Zugriffsrechte und Aufbewahrung gemäß geltendem Recht und den gewählten Google-/OpenAI-Bedingungen verantwortlich. Bei Deinstallation werden Modulkonfiguration sowie Insight- und Logtabellen gelöscht; benötigte Ergebnisse vorher exportieren.

Fehlerbehebung

• Google-Verbindung scheitert: Redirect-URI exakt vergleichen und sicherstellen, dass das Google-Konto Zugriff auf die gewählte GA4-Property besitzt.
• Keine Insights: API-Schlüssel, Modellzugriff, GA4-Daten, Cron-Status sowie Modulprotokolle prüfen.
• Tägliche Generierung läuft mehrfach: Cache-Datum, Shop-/Sprachkontext und Cron-Frequenz prüfen; force nur bewusst verwenden.
• Kennzahlen wirken unvollständig: GA4-E-Commerce-Events und PrestaShop-Bestellstatus vor der KI-Auswertung fachlich validieren.

Bei einem Fehler zuerst PrestaShop- und PHP-Logs sichern, den genauen Ablauf dokumentieren und das Verhalten ohne Cache in einer Staging-Umgebung reproduzieren.

Weiterführende Seiten

• Alle PrestaShop-Moduldokumentationen
• WALDBYTE Modulkatalog
• Individuelle PrestaShop Module und Schnittstellen