Smart Content – Dokumentation

Überblick

DataFirefly Smart Content personalisiert die Inhalte Ihres PrestaShop-Shops nach Profil, Verhalten, Warenkorb und Kontext jedes Besuchers. Das Prinzip ist einfach: Sie definieren Segmente (Zielgruppen) und dann Kampagnen, die ein Segment mit einem HTML-Inhalt in einer Theme-Zone verknüpfen. Auf jeder Seite bewertet das Modul den Besucher und zeigt den Inhalt der Kampagne mit der höchsten Priorität an, deren Segment passt.

Das Modul deckt den gesamten Zyklus ab: verhaltensbasierte Segmentierung, Multizonen-Auslieferung, A/B-Testing, Conversion-Statistiken und zwei KI-Assistenten (Inhaltserstellung und Segmentvorschläge).

Installation

1. Legen Sie den Ordner dfsmartcontent in das Verzeichnis /modules/ Ihres Shops, oder installieren Sie das ZIP über Module → Modulmanager → Modul hochladen.
2. Klicken Sie auf Installieren. Die Tabellen und Admin-Tabs werden automatisch erstellt.
3. Ein neues Menü Smart Content erscheint mit vier Unterbereichen: Dashboard, Kampagnen, Segmente und Einstellungen.

Einstellungen konfigurieren

Gehen Sie zu Smart Content → Einstellungen. Dort stehen zwei Parametergruppen zur Verfügung.

KI-Parameter

• KI-Endpoint-URL: der Chat-Completions-Endpoint (OpenAI / Mistral kompatibel). Standard: https://api.mistral.ai/v1/chat/completions.
• KI-Modell: zum Beispiel mistral-large-latest oder gpt-4o-mini.
• KI-API-Schlüssel: Ihr Schlüssel, serverseitig gespeichert und niemals im Frontend offengelegt. Solange er leer ist, sind die KI-Funktionen deaktiviert, der Rest des Moduls funktioniert jedoch normal.

Datenschutz

• Cookie-Einwilligung berücksichtigen: standardmäßig aktiviert. Tracking-Beacons (Impressionen / Klicks) werden erst ausgelöst, sobald die Einwilligung erkannt wird.

Ein Segment erstellen

Ein Segment ist eine Zielgruppe, die durch eine oder mehrere Regeln definiert wird. Gehen Sie zu Smart Content → Segmente → Segment hinzufügen.

• Name: eine interne Bezeichnung (z. B. „VIP-Kunden“).
• Übereinstimmungslogik: ALLE Regeln (UND) verlangt, dass jede Regel wahr ist; BELIEBIGE Regel (ODER) genügt, wenn eine wahr ist.
• Priorität: Segmente mit höherer Priorität werden zuerst ausgewertet.
• Regeln: Fügen Sie Ihre Bedingungen Zeile für Zeile mit dem visuellen Builder hinzu.

Regelreferenz

Jede Regel besteht aus einem Attribut, einem Operator und einem Wert. Bei Listen trennen Sie die Werte mit Kommas. Bei Bereichen (Operator between) geben Sie zwei kommagetrennte Werte an.

• customer_group — Kundengruppe (IDs). Operatoren: in / not_in.
• logged_in — angemeldeter Besucher (1 oder 0). Operator: eq.
• new_returning — new oder returning nach Bestellhistorie. Operator: eq.
• country — Land (IDs). Operatoren: in / not_in.
• language — Sprache (IDs). Operatoren: in / not_in.
• currency — Währung (IDs). Operatoren: in / not_in.
• device — desktop, tablet oder mobile. Operator: in.
• orders_count — Anzahl gültiger Bestellungen. Operatoren: gte / lte / eq / between.
• total_spent — Gesamtausgaben. Operatoren: gte / lte / between.
• days_since_order — Tage seit der letzten Bestellung. Operatoren: gte / lte / between.
• cart_total — aktuelle Warenkorbsumme. Operatoren: gte / lte / between.
• cart_has_category — Kategorie im Warenkorb (IDs). Operator: in.
• cart_has_product — Produkt im Warenkorb (IDs). Operator: in.
• newsletter — Newsletter-Abonnent (1 oder 0). Operator: eq.
• source_utm — UTM-Quelle der Sitzung. Operatoren: eq / contains.
• referrer — verweisende Website. Operatoren: contains / not_contains.
• hour_range — Zeitfenster (z. B. 9,18). Operator: between.
• weekday — Wochentag (1 = Montag … 7 = Sonntag). Operator: in.
• visits — Anzahl der Besuche des Besuchers. Operatoren: gte / lte / eq.

Beispiel — Segment „Großkunden reaktivieren“, UND-Logik: total_spent gte 200 + days_since_order gte 60.

Eine Kampagne erstellen

Eine Kampagne liefert einen Inhalt an ein oder mehrere Segmente in einer Theme-Zone aus. Gehen Sie zu Smart Content → Kampagnen → Kampagne hinzufügen.

• Name: interne Bezeichnung.
• Anzeigezone: der Hook, in dem der Inhalt erscheint (siehe Liste unten).
• Zielsegmente: ein oder mehrere Segmente. Leer lassen, um alle Besucher anzusprechen.
• Priorität: Zielen mehrere Kampagnen auf dieselbe Zone, gewinnt die passende mit der höchsten Priorität.
• A/B-Testing: aktivieren, um mehrere Varianten auszuliefern (siehe eigener Abschnitt).
• Frequenzbegrenzung: maximale Impressionen pro Besucher (0 = unbegrenzt), über ein in Tagen angegebenes Fenster.
• Start- / Enddatum: optionale Kampagnenplanung.
• Inhaltsvarianten: der HTML-Inhalt, pro Sprache bearbeitbar.

Verfügbare Anzeigezonen

displayHome, displayTop, displayNav1, displayBanner, displayWrapperTop, displayWrapperBottom, displayLeftColumn, displayRightColumn, displayFooter, displayProductAdditionalInfo, displayShoppingCartFooter.

A/B-Testing

Aktivieren Sie die Option A/B-Testing für die Kampagne und fügen Sie dann mehrere Varianten hinzu. Jede Variante hat eine Bezeichnung (A, B, …) und ein Gewicht. Das Modul wählt bei jeder Anzeige zufällig eine Variante, proportional zu den Gewichten. Ohne A/B-Testing wird die erste aktive Variante verwendet.

Der Inhalt jeder Variante wird pro Sprache eingegeben. Das Dashboard vergleicht anschließend die Leistung jeder Variante (Impressionen, CTR, CVR, Umsatz).

KI-Inhaltsgenerator

Im Kampagnen-Editor schreibt das Panel KI-Inhaltsgenerator einen conversion-orientierten HTML-Block. Geben Sie den Segmentnamen, eine Zielgruppenbeschreibung, das Ziel der Botschaft und den Tonfall ein, wählen Sie die Sprache und klicken Sie auf Generieren. Der erzeugte Inhalt wird in das Textfeld der aktiven Variante / Sprache eingefügt.

KI-Segmentvorschläge

Über Smart Content → Segmente öffnet die Schaltfläche KI-Segmentvorschläge eine Seite, die die echten Statistiken Ihres Shops zusammenfasst (aktive Kunden, Bestellungen, Wiederkäufer, Newsletter-Abonnenten…). Klicken Sie auf Vorschläge generieren: Die KI schlägt 3 bis 5 hochwertige Segmente vor, jeweils mit einer Beschreibung, einer Begründung und einem Regelsatz, der bereit zum Übernehmen in das Erstellungsformular ist.

Dashboard und Statistiken

Smart Content → Dashboard aggregiert die Leistung über den gewählten Zeitraum: Impressionen, Klicks und Klickrate (CTR), Conversions und Conversion-Rate (CVR) sowie zugeordneter Umsatz. Eine Tabelle schlüsselt die Ergebnisse pro Kampagne auf, eine zweite vergleicht die A/B-Varianten.

Wie Conversions zugeordnet werden

Beim Klick auf einen personalisierten Block wird die letzte Interaktion (Kampagne, Variante, Segment) im Sitzungs-Cookie gespeichert. Bei der Bestellbestätigung schreibt das Modul die Conversion und deren Umsatz dieser Kampagne gut und löscht dann die Zuordnung, um Doppelzählungen zu vermeiden.

Datenschutz und DSGVO

• Es werden keine personenbezogenen Daten gespeichert: Das Tracking basiert auf einer anonymen Besucherkennung (einem Hash), die für die Frequenzbegrenzung und die Entduplizierung verwendet wird.
• Die Option Cookie-Einwilligung berücksichtigen steuert, wann die Messung ausgelöst wird. Erkannte Signale: window.dfscConsentGranted = true, oder die Cookies hideBanner=1, axeptio_authorized, cookieconsent_status=allow.
• Um Ihre eigene CMP anzubinden, setzen Sie window.dfscConsentGranted auf true, sobald die Einwilligung vorliegt.

Einfügen per Widget

Das Modul implementiert die Widget-Schnittstelle von PrestaShop. Sie können einen Block daher direkt in ein Template einfügen:

{widget name='dfsmartcontent' hook='displayHome'}

Der Parameter hook gibt an, welche Zone ausgewertet wird.

FAQ und Fehlerbehebung

Mein Block wird nicht angezeigt

Prüfen Sie, ob die Kampagne aktiv ist, ob ihre Zone einem in Ihrem Theme vorhandenen Hook entspricht, ob mindestens eine Variante Inhalt für die aktuelle Sprache hat und ob der Besucher tatsächlich einem Zielsegment entspricht. Ist eine Frequenzbegrenzung erreicht, wird der Block diesem Besucher innerhalb des definierten Fensters nicht mehr angezeigt.

Die Statistiken bleiben bei null

Ist die Einwilligungsoption aktiv, werden Beacons erst nach Zustimmung ausgelöst. Prüfen Sie, ob Ihr Cookie-Banner eines der erkannten Signale sendet, oder setzen Sie window.dfscConsentGranted.

Die KI-Funktionen geben einen Fehler zurück

Stellen Sie sicher, dass API-Schlüssel, URL und Modell in den Einstellungen korrekt sind und dass Ihr Server den Endpoint ausgehend erreichen kann.