AI Size & Fit Advisor: kompletny przewodnik

AI Size & Fit Advisor poleca właściwy rozmiar na podstawie wzrostu i wagi klienta albo wymiarów zmierzonych taśmą krawiecką. Ten przewodnik opisuje instalację, konfigurację, tabele rozmiarów, ścieżkę klienta, śledzenie zwrotów i opcjonalną warstwę AI. Dotyczy wersji 1.2.0.

Instalacja i aktualizacja

1. Pobierz archiwum modułu ze swojego konta DataFirefly.
2. Panel PrestaShop, Moduły, Załaduj moduł: wyślij plik ZIP.
3. Moduł tworzy swoje tabele, rejestruje hooki i dodaje zakładkę Katalog > Tabele rozmiarów.
4. Wyczyść pamięć podręczną w Zaawansowane > Wydajność.

Aby zaktualizować z wersji 1.0, zainstaluj nowe archiwum na poprzednim. Skrypty aktualizacji tworzą nowe tabele, przenoszą przypisanie każdej istniejącej tabeli rozmiarów i rejestrują nowe hooki.

Konfiguracja

Otwórz Moduły > AI Size & Fit Advisor > Konfiguruj. Strona pokazuje panel wyników i dwa bloki ustawień.

Panel wyników

Podsumowuje ostatnie 30 dni: rekomendacje i klientów, zamówienia po rekomendacji, udział zamówień w polecanym rozmiarze, wskaźnik zwrotów w polecanym i w innym rozmiarze, udział rekomendacji opartych tylko na wzroście i wadze, udział odpowiedzi AI oraz najczęściej doradzane produkty.

Doradca rozmiaru

• Hook wyświetlania: displayProductActions (obok przycisku dodania do koszyka), displayProductAdditionalInfo lub własny hook displayDfSizeFit, który umieszczasz w dowolnym miejscu szablonu produktu za pomocą {hook h='displayDfSizeFit' product=$product}.
• Etykieta przycisku: osobna dla każdego języka. Pozostaw pustą, aby użyć „Znajdź mój rozmiar”.
• Styl przycisku: obramowany, wypełniony lub link tekstowy. Kolor akcentu: dla przycisku, polecanego rozmiaru i aktywnych wyborów.
• Jednostka tabel rozmiarów: centymetry lub cale. Klient może w doradcy przełączać się między cm/kg a in/lb.
• Pytaj o preferowany krój: dodaje wybór dopasowany, klasyczny lub luźny.
• Zapamiętaj profil klienta: wypełnia doradcę i przy kolejnych wizytach pokazuje „Twój rozmiar: M” na stronie produktu. Zapisywane w przeglądarce, a po zalogowaniu na koncie klienta.
• Pokaż zakładkę tabeli rozmiarów i Przycisk wyboru polecanego rozmiaru.
• Zapisuj rekomendacje (statystyki): wymagane dla panelu wyników i śledzenia zwrotów.

Warstwa AI

• Włącz warstwę AI: gdy wyłączona, nie ma żadnych wywołań zewnętrznych.
• Dostawca AI: Mistral, OpenAI lub Anthropic. Model: na przykład mistral-small-latest, gpt-4o-mini lub claude-haiku-4-5.
• Klucz API: pole ukryte, przechowywany po stronie serwera. Pozostaw puste, aby zachować zapisany klucz.
• Wywołania AI na odwiedzającego na godzinę: powyżej limitu odpowiada tylko silnik deterministyczny. 0 oznacza brak limitu.
• Zapisz i przetestuj połączenie: sprawdza klucz i model oraz pokazuje ewentualny błąd dostawcy.

Tworzenie tabeli rozmiarów

Otwórz Katalog > Tabele rozmiarów > Dodaj.

Zacznij od szablonu

Sześć szablonów wypełnia tabelę i płeć: odzież damska (biust, talia, biodra), góry męskie (klatka, talia), jeansy męskie (talia), obuwie EU (długość stopy), dzieci według wzrostu, czapki (obwód głowy). Następnie dostosuj wartości do swojej marki. Jeśli sklep pracuje w calach, szablony są przeliczane.

Dotyczy

• Wszystkie produkty: tabela domyślna.
• Kategorie: zaznacz jedną lub kilka kategorii w drzewie.
• Marki: wybierz jedną lub kilka marek.
• Produkty: wyszukaj produkty po nazwie, indeksie lub ID.

Gdy produktowi odpowiada kilka tabel, moduł wybiera w tej kolejności: tabelę produktu, tabelę jego marki, tabelę jego kategorii (najpierw domyślnej, potem najgłębszej), a na końcu tabelę „Wszystkie produkty”.

Płeć i krój modelu

• Damskie lub Męskie: moduł szacuje wymiary dla tej sylwetki.
• Wszyscy lub Unisex: klient wybiera w doradcy „Damskie” lub „Męskie”.
• Dziecięce: bez szacowania według sylwetki. Użyj kolumny wzrostu lub wagi.

Krój modelu określa, czy artykuł ma rozmiar standardowy, wypada mało lub wypada duże. Silnik przesuwa wtedy rekomendację o około 3,5%, a klient widzi „Ten model wypada mało: rekomendacja to uwzględnia”.

Tabela

• Dodaj kolumnę dla każdego wymiaru: klatka piersiowa, biust, talia, biodra, szerokość ramion, długość rękawa, długość nogawki, szyja, udo, długość stopy, obwód głowy, wzrost lub waga.
• Dodaj wiersz dla każdego rozmiaru (S, M, L, 38, 40…) i wpisz zakres minimum / maksimum w każdej komórce.
• Wpisuj wymiary ciała, nie ubrania.

Test tabeli

Pod tabelą blok Przetestuj tę tabelę uruchamia prawdziwy silnik na edytowanej tabeli, nawet przed zapisaniem. Podaj płeć, wzrost i wagę: otrzymasz polecany rozmiar, wskaźnik dopasowania, sąsiedni rozmiar i szacowane wymiary (oznaczone gwiazdką).

Na liście tabel akcja Duplikuj tworzy wyłączoną kopię z tymi samymi przypisaniami, aby przygotować tabelę dla innej marki lub kroju.

Ścieżka klienta

Na stronie produktu przycisk „Znajdź mój rozmiar” otwiera okno z dwiema zakładkami, „Mój rozmiar” i „Tabela rozmiarów”. Na telefonie otwiera się jako panel od dołu ekranu.

Wzrost i waga

Ścieżka domyślna. Klient podaje wzrost, wagę, budowę ciała (szczupła, przeciętna lub pełniejsza) oraz, przy tabeli uniwersalnej, czy kupuje dla kobiety czy mężczyzny. Taśma krawiecka nie jest potrzebna.

Moje wymiary

Klient wpisuje wymiary zmierzone taśmą. Sylwetka podświetla bieżący wymiar i pokazuje odpowiednią wskazówkę. Wzrost i waga pozostają opcjonalne: uzupełniają puste wymiary.

Wynik

Klient widzi polecany rozmiar, wskaźnik dopasowania, sąsiedni rozmiar, wyjaśnienie i szczegóły każdego wymiaru (dobrze pasuje, dopasowany lub luźny, z oznaczeniem „szacunkowo”, gdy wartość pochodzi ze wzrostu i wagi). Przycisk „Wybierz rozmiar M” zaznacza odpowiednią kombinację na stronie produktu. Zakładka „Tabela rozmiarów” pokazuje tabelę z podświetlonym polecanym rozmiarem w jednostce wybranej przez klienta.

Zapamiętany profil

Przy kolejnych wizytach przycisk na stronie produktu od razu pokazuje „Twój rozmiar: M”. Link „Zapomnij moje wymiary” usuwa profil z przeglądarki i z konta klienta.

Jak obliczany jest rozmiar

1. Szacowanie: bez pomiarów taśmą obwody (biust, klatka, talia, biodra, szyja, udo) są szacowane regresją opartą na wskaźniku masy ciała według płci i korygowane budową ciała, a długości są proporcjonalne do wzrostu.
2. Dopasowanie: każdy rozmiar otrzymuje ocenę według odległości wymiarów od środka każdego zakresu, z karą poza zakresem. Preferowany krój i krój modelu przesuwają wymiary przed porównaniem.
3. Wskaźnik dopasowania: liczony dla każdego wymiaru i obniżany, gdy wartości są szacowane.
4. Sąsiedni rozmiar: rozmiar tuż powyżej lub poniżej w tabeli, po stronie, po której są wymiary klienta.
5. AI (opcjonalnie): dostawca potwierdza lub koryguje rozmiar i pisze wyjaśnienie w języku klienta.

Stany, zamówienia i zwroty

Przy włączonym zarządzaniu stanami moduł sprawdza kombinacje, których nazwa odpowiada rozmiarom z tabeli. Jeśli polecany rozmiar jest niedostępny we wszystkich kombinacjach, klient widzi „Rozmiar M jest obecnie niedostępny”, przycisk proponuje sąsiedni rozmiar, jeśli jest dostępny, a strona produktu pokazuje „Twój rozmiar: M (niedostępny)”.

Przy zatwierdzeniu zamówienia ostatnia rekomendacja klienta (30 dni) dla każdego produktu jest łączona z zamówieniem i faktycznie zamówionym rozmiarem. Zwroty towarów zgłoszone przez klienta oraz korekty utworzone w panelu oznaczają następnie rekomendację jako zwróconą. Na tej podstawie powstaje wskaźnik zwrotów w panelu wyników.

RODO i dane

• Profile i rekomendacje są przechowywane w Twoim sklepie.
• Z modułem psgdpr eksport i usuwanie danych klienta obejmują jego profil i rekomendacje.
• Przy warstwie AI do dostawcy trafiają tylko wymiary potrzebne do obliczeń, bez imienia i e-maila.

FAQ i rozwiązywanie problemów

Przycisk nie pojawia się na stronie produktu. Sprawdź, czy do produktu przypisana jest aktywna tabela i czy wybrany hook istnieje w Twoim motywie. Przy displayDfSizeFit dodaj wywołanie hooka w szablonie produktu.

Przycisk „Wybierz rozmiar” się nie pojawia. Nazwa wartości atrybutu musi być taka sama jak nazwa rozmiaru w tabeli (na przykład „M” po obu stronach).

Doradca prosi o więcej wymiarów. W trybie „Moje wymiary” potrzebny jest co najmniej jeden wymiar odpowiadający kolumnom tabeli. W trybie „Wzrost i waga” wymagane są wzrost, waga i płeć.

Wskaźnik zwrotów jest pusty. Włącz „Zapisuj rekomendacje”. Wskaźnik pojawi się po pierwszych zamówieniach powiązanych z rekomendacją.

AI nie odpowiada. Użyj „Zapisz i przetestuj połączenie”, aby odczytać błąd dostawcy. W tym czasie odpowiada silnik deterministyczny.