Smart Content: volledige gids

Overzicht

DataFirefly Smart Content personaliseert de inhoud van uw PrestaShop-winkel op basis van het profiel, het gedrag, de winkelwagen en de context van elke bezoeker. Het principe is eenvoudig: u definieert segmenten (doelgroepen) en vervolgens campagnes die een segment koppelen aan HTML-inhoud die in een zone van het thema wordt getoond. Bij elke pagina evalueert de module de bezoeker en toont ze de inhoud van de campagne met de hoogste prioriteit waarvan het segment overeenkomt.

De module dekt de volledige cyclus: gedragssegmentatie, multi-zone weergave, A/B-tests, conversiestatistieken en twee AI-assistenten (inhoudsgeneratie en segmentsuggesties).

Installatie

1. Plaats de map dfsmartcontent in de map /modules/ van uw winkel, of installeer de ZIP via Modules → Module Manager → Een module installeren.
2. Klik op Installeren. De tabellen en beheertabbladen worden automatisch aangemaakt.
3. Er verschijnt een nieuw menu Smart Content, met vier subsecties: Dashboard, Campagnes, Segmenten en Instellingen.

Instellingen configureren

Ga naar Smart Content → Instellingen. Er zijn twee groepen parameters beschikbaar.

AI-parameters

• URL van het AI-endpoint: het chat-completion-endpoint (compatibel met OpenAI / Mistral). Standaardwaarde: https://api.mistral.ai/v1/chat/completions.
• AI-model: bijvoorbeeld mistral-large-latest of gpt-4o-mini.
• AI-API-sleutel: uw sleutel, server-side opgeslagen en nooit blootgesteld aan de front. Zolang ze leeg is, zijn de AI-functies uitgeschakeld maar werkt de rest van de module normaal.

Privacy

• Cookietoestemming respecteren: standaard ingeschakeld. De trackingtags (impressies / kliks) worden pas geactiveerd zodra de toestemming is gedetecteerd.

Een segment aanmaken

Een segment is een doelgroep die door een of meerdere regels wordt gedefinieerd. Ga naar Smart Content → Segmenten → Een segment toevoegen.

• Naam: een intern label (bijv. “VIP-klanten”).
• Matchinglogica: Alle regels (EN) vereist dat elke regel waar is; bij Minstens één regel (OF) volstaat één ware regel.
• Prioriteit: segmenten met een hogere prioriteit worden eerst geëvalueerd.
• Regels: voeg uw voorwaarden regel per regel toe via de visuele builder.

Regelreferentie

Elke regel bestaat uit een attribuut, een operator en een waarde. Scheid bij lijsten de waarden met komma’s. Geef bij bereiken (operator between) twee waarden op, gescheiden door een komma.

• customer_group — klantgroep (ID’s). Operatoren: in / not_in.
• logged_in — ingelogde bezoeker (1 of 0). Operator: eq.
• new_returning — new of returning volgens de bestelgeschiedenis. Operator: eq.
• country — land (ID’s). Operatoren: in / not_in.
• language — taal (ID’s). Operatoren: in / not_in.
• currency — valuta (ID’s). Operatoren: in / not_in.
• device — desktop, tablet of mobile. Operator: in.
• orders_count — aantal geldige bestellingen. Operatoren: gte / lte / eq / between.
• total_spent — totaal besteed. Operatoren: gte / lte / between.
• days_since_order — dagen sinds de laatste bestelling. Operatoren: gte / lte / between.
• cart_total — totaal van de huidige winkelwagen. Operatoren: gte / lte / between.
• cart_has_category — categorie aanwezig in de winkelwagen (ID’s). Operator: in.
• cart_has_product — product aanwezig in de winkelwagen (ID’s). Operator: in.
• newsletter — nieuwsbriefabonnee (1 of 0). Operator: eq.
• source_utm — UTM-bron van de sessie. Operatoren: eq / contains.
• referrer — verwijzende site. Operatoren: contains / not_contains.
• hour_range — tijdvak (bijv. 9,18). Operator: between.
• weekday — weekdag (1 = maandag … 7 = zondag). Operator: in.
• visits — aantal bezoeken van de bezoeker. Operatoren: gte / lte / eq.

Voorbeeld — segment “Grote klanten om te heractiveren”, EN-logica: total_spent gte 200 + days_since_order gte 60.

Een campagne aanmaken

Een campagne toont inhoud aan een of meerdere segmenten in een zone van het thema. Ga naar Smart Content → Campagnes → Een campagne toevoegen.

• Naam: intern label.
• Weergavezone: de hook waar de inhoud verschijnt (zie de lijst hieronder).
• Doelsegmenten: een of meerdere segmenten. Laat leeg om alle bezoekers te targeten.
• Prioriteit: als meerdere campagnes dezelfde zone targeten, wint de overeenkomende campagne met de hoogste prioriteit.
• A/B-tests: schakel in om meerdere varianten te tonen (zie de aparte sectie).
• Frequentieplafond: maximumaantal impressies per bezoeker (0 = onbeperkt), over een venster uitgedrukt in dagen.
• Begin-/einddatum: optionele planning van de campagne.
• Inhoudsvarianten: de HTML-inhoud, per taal te bewerken.

Beschikbare weergavezones

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

A/B-tests

Schakel de optie A/B-tests op de campagne in en voeg meerdere varianten toe. Elke variant heeft een label (A, B, …) en een gewicht. De module loot bij elke weergave een variant, evenredig met de gewichten. Zonder A/B-tests wordt de eerste actieve variant gebruikt.

De inhoud van elke variant wordt per taal ingevoerd. Het dashboard vergelijkt vervolgens de prestaties van elke variant (impressies, CTR, CVR, omzet).

AI-inhoudsgenerator

In de campagne-editor schrijft het paneel AI-inhoudsgenerator een conversiegericht HTML-blok. Vul de naam van het segment in, een beschrijving van de doelgroep, het doel van de boodschap en de toon, kies de taal en klik op Genereren. De geproduceerde inhoud wordt ingevoegd in het tekstveld van de actieve variant / taal.

AI-segmentsuggesties

Vanuit Smart Content → Segmenten opent de knop AI-segmentsuggesties een pagina die de werkelijke statistieken van uw winkel samenvat (actieve klanten, bestellingen, terugkerende kopers, nieuwsbriefabonnees…). Klik op Suggesties genereren: de AI stelt 3 tot 5 segmenten met hoge waarde voor, elk met een beschrijving, een onderbouwing en een set regels die klaar zijn om in het aanmaakformulier over te nemen.

Dashboard en statistieken

Smart Content → Dashboard aggregeert de prestaties over de gekozen periode: impressies, kliks en klikpercentage (CTR), conversies en conversiepercentage (CVR), en toegekende omzet. Een tabel toont de resultaten per campagne, en een tweede de vergelijking van de A/B-varianten.

Hoe conversies worden toegekend

Bij een klik op een gepersonaliseerd blok wordt de laatste interactie (campagne, variant, segment) in de sessiecookie onthouden. Bij het valideren van een bestelling kent de module de conversie en de omzet toe aan die campagne, en wist ze de toekenning om dubbele telling te voorkomen.

Privacy en AVG

• Er worden geen persoonsgegevens opgeslagen: de tracking steunt op een anonieme bezoekersidentifier (een hash), gebruikt voor het frequentieplafond en de deduplicatie.
• De optie Cookietoestemming respecteren bepaalt het activeren van de metingen. Herkende signalen: window.dfscConsentGranted = true, of de cookies hideBanner=1, axeptio_authorized, cookieconsent_status=allow.
• Zet, om uw eigen CMP aan te sluiten, window.dfscConsentGranted op true zodra de toestemming is verkregen.

Invoegen via widget

De module implementeert de widgetinterface van PrestaShop. U kunt een blok dus direct in een template invoegen:

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

De parameter hook geeft aan welke zone moet worden geëvalueerd.

FAQ en probleemoplossing

Mijn blok wordt niet getoond

Controleer of de campagne actief is, of haar zone overeenkomt met een hook die in uw thema aanwezig is, of minstens één variant inhoud heeft voor de huidige taal, en of de bezoeker overeenkomt met een getarget segment. Als een frequentieplafond is bereikt, wordt het blok binnen het gedefinieerde venster niet meer aan die bezoeker getoond.

De statistieken blijven op nul

Als de toestemmingsoptie actief is, worden de tags pas na akkoord geactiveerd. Controleer of uw cookiebanner een van de herkende signalen afgeeft, of zet window.dfscConsentGranted.

De AI-functies geven een fout terug

Controleer of de API-sleutel, de URL en het model correct zijn in de Instellingen, en of uw server het endpoint uitgaand kan bereiken.