AI Size & Fit Advisor — Complete handleiding

AI Size & Fit Advisor vervangt uw statische maattabel door een echte adviseur: de klant voert zijn lichaamsmaten in op de productpagina en ontvangt de best passende maat, met een betrouwbaarheidsindex, een alternatief en het detail per lichaamsmaat. Deze handleiding behandelt de installatie, de configuratie, het aanmaken van maattabellen en de werking van de aanbevelingsengine.

Installatie

1. Download het archief dfsizefit.zip via uw DataFirefly-account.
2. PrestaShop-backoffice → Modules → Een module uploaden → verstuur de ZIP.
3. De module maakt haar tabellen aan, registreert haar hooks en voegt het tabblad Catalogus → Size & Fit Charts toe.

Algemene configuratie

Ga naar Modules → AI Size & Fit Advisor → Configureren.

AI-laag

De module werkt zonder AI dankzij haar deterministische engine. U kunt een optionele AI-laag inschakelen om de beslissing te verfijnen op basis van de lichaamsbouw en een uitleg te genereren in de taal van de klant.

• AI-laag inschakelen: indien uitgeschakeld wordt geen enkele externe aanroep gedaan.
• Provider: Mistral, OpenAI of Anthropic.
• API-sleutel: aan serverzijde opgeslagen, nooit blootgesteld aan de frontoffice.
• Model: bijvoorbeeld mistral-small-latest, gpt-4o-mini of claude-haiku-4-5.

Pasvoorkeur

Schakel deze optie in om de klant de keuzes Getailleerd / Klassiek / Ruim aan te bieden. De module past een bias van ±3% toe op de lichaamsmaten om de maat naar boven of beneden te sturen volgens de gewenste pasvorm.

Fit-learning

Indien ingeschakeld, logt de module de profielen en aanbevelingen geanonimiseerd in de daarvoor bestemde tabel, om de relevantie te analyseren en de referenties op te sporen die klein of groot vallen.

Eenheid en weergavehook

• Standaardeenheid: centimeters of inches.
• Weergavehook: displayProductActions (bij de winkelwagenknop) of displayProductAdditionalInfo (onder de productinformatie).
• Knoplabel: laat leeg om de standaardvertaling “Vind mijn maat” te gebruiken.

Een maattabel aanmaken

Open Catalogus → Size & Fit Charts → Toevoegen.

Bereik

Elke tabel heeft een bereik dat bepaalt op welke producten ze van toepassing is:

• Globaal: geldt voor alle producten (referentie op 0 laten).
• Categorie: vul het id van de categorie in.
• Product: vul het id van het product in.

De resolutie verloopt in cascade: de module zoekt eerst een tabel op productniveau, vervolgens op de categorieën ervan, en dan de globale tabel. De eerst gevonden tabel wordt gebruikt.

De tabeleditor

De visuele editor werkt als een tabel: één regel per maat, één kolom per lichaamsmaat.

• Voeg een lichaamsmaatkolom toe (borstomvang, taille, heupen, binnenbeenlengte, voetlengte, enz.) via de selector en de knop “Kolom toevoegen”.
• Voeg een maatregel toe met “Maat toevoegen” en geef haar een naam (S, M, L, 38, 40…).
• Geef voor elke cel een bereik minimum / maximum op in de geconfigureerde eenheid.
• Kies het geslacht (vrouw, man, unisex, kind) en activeer de tabel.

Hoe de aanbeveling werkt

De aanbeveling verloopt in meerdere stappen:

1. Deterministische matching: de engine scoort elke maat door de lichaamsmaten van de klant te vergelijken met de bereiken van de tabel (afstand tot het midden van elk bereik, penalty bij buiten bereik), en past vervolgens de pasvormbias toe.
2. AI-verfijning (optioneel): als de AI-laag actief is, bevestigt of corrigeert de provider de maat op basis van de lichaamsbouw (lengte, gewicht) en schrijft een korte uitleg.
3. Fallback: als de AI faalt, blijft het deterministische resultaat behouden.

De klant ontvangt de aanbevolen maat, een betrouwbaarheidsindex, een alternatieve maat en het detail per lichaamsmaat (binnen het bereik, strak of ruim).

Weergave aan klantzijde

Op de productpagina opent een knop “Vind mijn maat” een modaal venster. De klant voert zijn lichaamsmaten in, eventueel zijn lengte, gewicht en pasvoorkeur, en bevestigt. Het resultaat verschijnt in hetzelfde venster, met een betrouwbaarheidsbalk en de uitsplitsing per lichaamsmaat.

Fit-learning en retouranalyse

Elke aanbeveling kan worden gelogd met het geanonimiseerde profiel, de gebruikte engine en de betrouwbaarheidsindex. De retourstatus (gehouden, geretourneerd te klein, geretourneerd te groot) maakt het op termijn mogelijk om problematische pasvormen te identificeren en uw tabellen bij te sturen.

Compatibiliteit en technische notities

• PrestaShop 8.x en 9.x, multistore en meertalig.
• Legacy-admincontroller (geen Symfony-controller) voor PS8/PS9-compatibiliteit.
• Front AJAX-endpoint via de modulelink; JSON-rendering via een aparte methode.
• Klantgegevens worden op uw winkel opgeslagen; alleen het voor de berekening noodzakelijke deel wordt naar de gekozen AI-provider verstuurd.

FAQ en probleemoplossing

De knop verschijnt niet op de productpagina. Controleer of een actieve tabel op het product van toepassing is (bereik product, categorie of globaal) en of de gekozen weergavehook daadwerkelijk aan uw thema is gekoppeld.

De aanbeveling meldt een gebrek aan gegevens. De klant heeft geen lichaamsmaat ingevuld die overeenkomt met de kolommen van de tabel. Voeg gangbare kolommen toe (borstomvang, taille, heupen) of nodig de klant uit om meer velden in te vullen.

De AI geeft niets terug. Controleer de API-sleutel en de modelnaam. De module valt hoe dan ook terug op de deterministische engine; er gaat geen enkele aanbeveling verloren.