# AI Size & Fit Advisor: vollständige Anleitung

> AI Size & Fit Advisor empfiehlt die richtige Größe anhand von Körpergröße und Gewicht des Kunden oder seiner mit dem Maßband gemessenen Maße. Diese Anleitung behandelt Installation, Konfiguration, Größentabellen, den…

- Seite: <https://www.datafirefly.com/de/documentation/ai-size-fit-advisor/>
- Sprache: de
- Aktualisiert am: 2026-09-29
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/ai-size-fit-advisor/index.md), [en](https://www.datafirefly.com/en/documentation/ai-size-fit-advisor/index.md), [es](https://www.datafirefly.com/es/documentation/ai-size-fit-advisor/index.md), [it](https://www.datafirefly.com/it/documentation/ai-size-fit-advisor/index.md), [pl](https://www.datafirefly.com/pl/documentation/ai-size-fit-advisor/index.md), [nl](https://www.datafirefly.com/nl/documentation/ai-size-fit-advisor/index.md), [pt](https://www.datafirefly.com/pt/documentation/ai-size-fit-advisor/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

AI Size & Fit Advisor empfiehlt die richtige Größe anhand von Körpergröße und Gewicht des Kunden oder seiner mit dem Maßband gemessenen Maße. Diese Anleitung behandelt Installation, Konfiguration, Größentabellen, den Weg des Kunden, die Auswertung der Retouren und die optionale KI-Schicht. Sie beschreibt Version 1.2.0.

## Installation und Update

1. Laden Sie das Modularchiv aus Ihrem DataFirefly-Konto herunter.
2. PrestaShop-Back-Office, **Module**, **Modul hochladen**: ZIP senden.
3. Das Modul legt seine Tabellen an, registriert seine Hooks und fügt den Reiter **Katalog > Größentabellen** hinzu.
4. Leeren Sie den Cache unter **Erweiterte Einstellungen > Leistung**.

Für ein Update von 1.0 installieren Sie das neue Archiv einfach über das alte. Die Update-Skripte legen die neuen Tabellen an, übernehmen die Zuordnung jeder bestehenden Tabelle und registrieren die neuen Hooks.

Kompatibel mit PrestaShop 8.0 bis 9.x, PHP 7.2.5+ (PS8) und 8.1+ (PS9). Kein Override, keine externen Abhängigkeiten. Enthaltene Übersetzungen: Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch, Portugiesisch.

## Konfiguration

Öffnen Sie **Module > AI Size & Fit Advisor > Konfigurieren**. Die Seite zeigt das Leistungs-Panel und zwei Einstellungsblöcke.

### Leistungs-Panel

Es fasst die letzten 30 Tage zusammen: Empfehlungen und Kunden, Bestellungen nach einer Empfehlung, Anteil der Bestellungen in der empfohlenen Größe, Retourenquote in der empfohlenen und in einer anderen Größe, Anteil der Empfehlungen nur aus Größe und Gewicht, Anteil der KI-Antworten und die am häufigsten beratenen Produkte.

### Größenberater

- **Anzeige-Hook**: `displayProductActions` (neben dem Warenkorb-Button), `displayProductAdditionalInfo` oder der eigene Hook `displayDfSizeFit`, den Sie mit `{hook h='displayDfSizeFit' product=$product}` an beliebiger Stelle im Produkt-Template platzieren.
- **Button-Beschriftung**: eine pro Sprache. Leer lassen für „Meine Größe finden“.
- **Button-Stil**: umrandet, gefüllt oder Textlink. **Akzentfarbe**: für den Button, die empfohlene Größe und die aktiven Auswahlen.
- **Einheit Ihrer Größentabellen**: Zentimeter oder Zoll. Kunden können im Berater trotzdem zwischen cm/kg und in/lb wechseln.
- **Passform-Präferenz abfragen**: fügt die Wahl eng, normal oder weit hinzu.
- **Kundenprofil speichern**: füllt den Berater vor und zeigt bei späteren Besuchen „Ihre Größe: M“ auf der Produktseite. Gespeichert im Browser und, bei Anmeldung, im Kundenkonto.
- **Reiter Größentabelle anzeigen** und **Button zur Auswahl der empfohlenen Größe**.
- **Empfehlungen speichern (Statistiken)**: nötig für das Leistungs-Panel und die Auswertung der Retouren.

### KI-Schicht

- **KI-Schicht aktivieren**: deaktiviert erfolgt kein externer Aufruf.
- **KI-Anbieter**: Mistral, OpenAI oder Anthropic. **Modell**: zum Beispiel `mistral-small-latest`, `gpt-4o-mini` oder `claude-haiku-4-5`.
- **API-Schlüssel**: verdecktes Feld, serverseitig gespeichert. Leer lassen, um den gespeicherten Schlüssel zu behalten.
- **KI-Aufrufe pro Besucher und Stunde**: darüber antwortet allein die deterministische Engine. 0 hebt das Limit auf.
- **Speichern und Verbindung testen**: prüft Schlüssel und Modell und zeigt gegebenenfalls den Fehler des Anbieters.

Antwortet die KI nicht, überschreitet sie das Zeitlimit oder schlägt sie eine Größe vor, die nicht in der Tabelle steht, wird ihre Antwort ignoriert und die deterministische Engine antwortet. Eine Empfehlung ist immer verfügbar.

## Eine Größentabelle anlegen

Öffnen Sie **Katalog > Größentabellen > Neu hinzufügen**.

### Mit einer Vorlage beginnen

Sechs Vorlagen füllen Raster und Geschlecht: Damenbekleidung (Oberweite, Taille, Hüfte), Herren-Oberteile (Brust, Taille), Herren-Jeans (Taille), Schuhe EU (Fußlänge), Kinder nach Körpergröße, Hüte (Kopfumfang). Passen Sie die Werte anschließend an Ihre Marke an. Arbeitet Ihr Shop in Zoll, werden die Vorlagen umgerechnet.

### Gilt für

- **Alle Produkte**: Standardtabelle.
- **Kategorien**: eine oder mehrere Kategorien im Baum anhaken.
- **Marken**: eine oder mehrere Marken auswählen.
- **Produkte**: Produkte nach Name, Referenz oder ID suchen.

Passen mehrere Tabellen zu einem Produkt, nimmt das Modul in dieser Reihenfolge: die Tabelle des Produkts, die seiner Marke, die seiner Kategorie (zuerst die Standardkategorie, dann die tiefste) und zuletzt die Tabelle „Alle Produkte“.

### Geschlecht und Passform des Modells

- **Damen** oder **Herren**: Das Modul schätzt die Maße für diesen Körpertyp.
- **Alle** oder **Unisex**: Der Kunde wählt im Berater „Damen“ oder „Herren“.
- **Kinder**: keine Schätzung nach Körpertyp. Verwenden Sie eine Spalte Körpergröße oder Gewicht.

Die **Passform des Modells** gibt an, ob der Artikel normal, klein oder groß ausfällt. Die Engine verschiebt die Empfehlung dann um etwa 3,5 % und der Kunde liest „Dieses Modell fällt klein aus: Die Empfehlung berücksichtigt das“.

### Das Raster

- Fügen Sie eine Spalte pro Maß hinzu: Brustumfang, Oberweite, Taillenumfang, Hüftumfang, Schulterbreite, Ärmellänge, Schrittlänge, Halsumfang, Oberschenkelumfang, Fußlänge, Kopfumfang, Körpergröße oder Gewicht.
- Fügen Sie eine Zeile pro Größe hinzu (S, M, L, 38, 40...) und tragen Sie in jede Zelle einen Bereich Minimum / Maximum ein.
- Geben Sie Körpermaße ein, keine Kleidungsmaße.

Ein Bereich, dessen Minimum über dem Maximum liegt, wird rot markiert und beim Speichern vertauscht. Vermeiden Sie Lücken zwischen zwei aufeinanderfolgenden Größen.

### Die Tabelle testen

Unter dem Raster führt der Block **Diese Tabelle testen** die echte Engine auf dem gerade bearbeiteten Raster aus, auch vor dem Speichern. Geben Sie Geschlecht, Körpergröße und Gewicht ein: Sie erhalten die empfohlene Größe, den Übereinstimmungswert, die Nachbargröße und die geschätzten Maße (mit Sternchen markiert).

In der Tabellenliste erstellt die Aktion **Duplizieren** eine deaktivierte Kopie mit denselben Zuordnungen, um eine Tabelle pro Marke oder Passform abzuleiten.

## Der Weg des Kunden

Auf der Produktseite öffnet der Button „Meine Größe finden“ ein Fenster mit zwei Reitern, „Meine Größe“ und „Größentabelle“. Auf dem Smartphone öffnet es sich als Panel vom unteren Bildschirmrand.

### Körpergröße und Gewicht

Standardweg. Der Kunde gibt Körpergröße, Gewicht, Statur (schlank, mittel oder kräftig) und bei Unisex-Tabellen an, ob er für Damen oder Herren kauft. Ein Maßband wird nicht benötigt.

### Meine Maße

Der Kunde gibt seine mit dem Maßband gemessenen Maße ein. Eine Silhouette hebt das aktuelle Maß hervor und zeigt den passenden Messhinweis. Körpergröße und Gewicht bleiben optional: Sie ergänzen die leer gelassenen Maße.

### Das Ergebnis

Der Kunde sieht die empfohlene Größe, den Übereinstimmungswert, die Nachbargröße, eine Erklärung und die Auswertung pro Maß (passt gut, eng oder weit, mit dem Vermerk „geschätzt“, wenn der Wert aus Körpergröße und Gewicht stammt). Der Button „Größe M wählen“ wählt die passende Kombination auf der Produktseite. Der Reiter „Größentabelle“ zeigt das Raster mit hervorgehobener Empfehlung in der vom Kunden gewählten Einheit.

### Gespeichertes Profil

Bei späteren Besuchen zeigt der Button auf der Produktseite direkt „Ihre Größe: M“. Der Link „Meine Maße vergessen“ löscht das Profil aus Browser und Kundenkonto.

## Wie die Größe berechnet wird

1. **Schätzung**: Ohne Maßband-Werte werden die Umfänge (Oberweite, Brust, Taille, Hüfte, Hals, Oberschenkel) per Regression auf den Body-Mass-Index nach Geschlecht geschätzt und nach Statur angepasst. Längen sind proportional zur Körpergröße.
2. **Abgleich**: Jede Größe erhält eine Bewertung nach dem Abstand der Maße zur Mitte jedes Bereichs, mit einem Abzug außerhalb des Bereichs. Gewünschte Passform und Passform des Modells verschieben die Maße vor dem Vergleich.
3. **Übereinstimmung**: Maß für Maß berechnet und gesenkt, wenn Werte geschätzt sind.
4. **Nachbargröße**: die Größe direkt darüber oder darunter im Raster, auf der Seite, auf der die Körpermaße liegen.
5. **KI (optional)**: Der Anbieter bestätigt oder korrigiert die Größe und schreibt die Erklärung in der Sprache des Kunden.

## Lagerbestand, Bestellungen und Retouren

Bei aktiver Lagerverwaltung prüft das Modul die Kombinationen, deren Name einer Größe der Tabelle entspricht. Ist die empfohlene Größe in allen Kombinationen ausverkauft, sieht der Kunde „Größe M ist derzeit ausverkauft“, der Button bietet die Nachbargröße an, sofern verfügbar, und die Produktseite zeigt „Ihre Größe: M (ausverkauft)“.

Bei der Bestellbestätigung wird die letzte Empfehlung des Kunden (30 Tage) für jedes Produkt mit der Bestellung verknüpft, samt tatsächlich bestellter Größe. Vom Kunden beantragte Warenrücksendungen und im Back Office erstellte Gutschriften markieren die Empfehlung anschließend als retourniert. Daraus entsteht die Retourenquote im Leistungs-Panel.

## DSGVO und Daten

- Profile und Empfehlungen werden in Ihrem Shop gespeichert.
- Mit dem Modul psgdpr umfassen Export und Löschung der Kundendaten auch Profil und Empfehlungen.
- Mit der KI-Schicht werden nur die für die Berechnung nötigen Maße an den Anbieter übertragen, ohne Name und E-Mail.

## FAQ und Fehlerbehebung

**Der Button erscheint nicht auf der Produktseite.** Prüfen Sie, ob eine aktive Tabelle für das Produkt gilt und der gewählte Hook in Ihrem Theme vorhanden ist. Bei `displayDfSizeFit` fügen Sie den Hook-Aufruf ins Produkt-Template ein.

**Der Button „Größe wählen“ erscheint nicht.** Der Name des Attributwerts muss dem Größennamen in der Tabelle entsprechen (zum Beispiel „M“ auf beiden Seiten).

**Der Berater verlangt weitere Maße.** Im Modus „Meine Maße“ ist mindestens ein Maß nötig, das einer Spalte der Tabelle entspricht. Im Modus „Körpergröße und Gewicht“ sind Körpergröße, Gewicht und Geschlecht erforderlich.

**Die Retourenquote bleibt leer.** Aktivieren Sie „Empfehlungen speichern“. Die Quote erscheint nach den ersten Bestellungen mit Empfehlung.

**Die KI antwortet nicht.** Nutzen Sie „Speichern und Verbindung testen“, um den Fehler des Anbieters zu lesen. Bis dahin antwortet die deterministische Engine.