AI Size & Fit Advisor: guía completa

AI Size & Fit Advisor recomienda la talla correcta a partir de la estatura y el peso del cliente, o de sus medidas con cinta métrica. Esta guía cubre la instalación, la configuración, las tablas de tallas, el recorrido del cliente, el seguimiento de devoluciones y la capa de IA opcional. Documenta la versión 1.2.0.

Instalación y actualización

1. Descarga el archivo del módulo desde tu cuenta DataFirefly.
2. Back office de PrestaShop, Módulos, Subir un módulo: envía el ZIP.
3. El módulo crea sus tablas, registra sus hooks y añade la pestaña Catálogo > Guías de tallas.
4. Vacía la caché en Parámetros avanzados > Rendimiento.

Para actualizar desde la 1.0, instala el nuevo archivo encima del anterior. Los scripts de actualización crean las nuevas tablas, migran el destino de cada tabla existente y registran los nuevos hooks.

Configuración

Abre Módulos > AI Size & Fit Advisor > Configurar. La página muestra el panel de rendimiento y dos bloques de ajustes.

Panel de rendimiento

Resume los últimos 30 días: recomendaciones y clientes, pedidos tras una recomendación, parte de pedidos en la talla recomendada, tasa de devolución en la talla recomendada y en otra talla, parte de recomendaciones hechas solo con estatura y peso, parte de respuestas de la IA y productos más consultados.

Asesor de tallas

• Hook de visualización: displayProductActions (junto al botón de añadir al carrito), displayProductAdditionalInfo, o el hook personalizado displayDfSizeFit, que colocas donde quieras en la plantilla de producto con {hook h='displayDfSizeFit' product=$product}.
• Texto del botón: uno por idioma. Déjalo vacío para usar «Encuentra mi talla».
• Estilo del botón: con borde, relleno o enlace de texto. Color de acento: se aplica al botón, a la talla recomendada y a las opciones activas.
• Unidad de tus tablas de tallas: centímetros o pulgadas. El cliente puede cambiar entre cm/kg e in/lb en el asesor.
• Preguntar el ajuste preferido: añade la elección ceñido, normal u holgado.
• Recordar el perfil del cliente: rellena el asesor y muestra «Tu talla: M» en la ficha en las siguientes visitas. Se guarda en el navegador y, con sesión iniciada, en la cuenta del cliente.
• Mostrar la pestaña de tabla de tallas y Botón para seleccionar la talla recomendada.
• Guardar las recomendaciones (estadísticas): necesario para el panel de rendimiento y el seguimiento de devoluciones.

Capa de IA

• Activar la capa de IA: desactivada, no se realiza ninguna llamada externa.
• Proveedor de IA: Mistral, OpenAI o Anthropic. Modelo: por ejemplo mistral-small-latest, gpt-4o-mini o claude-haiku-4-5.
• Clave API: campo oculto, guardada en el servidor. Déjalo vacío para conservar la clave guardada.
• Llamadas de IA por visitante y hora: por encima, responde solo el motor determinista. 0 elimina el límite.
• Guardar y probar la conexión: verifica la clave y el modelo, y muestra el error del proveedor si lo hay.

Crear una tabla de tallas

Abre Catálogo > Guías de tallas > Añadir.

Empezar con una plantilla

Seis plantillas rellenan la tabla y el género: ropa de mujer (busto, cintura, cadera), tops de hombre (pecho, cintura), vaqueros de hombre (cintura), calzado EU (longitud del pie), niños por estatura, sombreros (contorno de cabeza). Después ajusta los valores a tu marca. Si tu tienda trabaja en pulgadas, las plantillas se convierten.

Se aplica a

• Todos los productos: tabla por defecto.
• Categorías: marca una o varias categorías en el árbol.
• Marcas: selecciona una o varias marcas.
• Productos: busca productos por nombre, referencia o ID.

Cuando varias tablas corresponden a un producto, el módulo toma, por este orden: la tabla del producto, la de su marca, la de su categoría (primero la predeterminada, luego la más profunda) y, por último, la tabla «Todos los productos».

Género y horma del modelo

• Mujer u Hombre: el módulo estima las medidas para ese tipo de cuerpo.
• Todos o Unisex: el cliente elige «Mujer» u «Hombre» en el asesor.
• Niños: sin estimación por complexión. Usa una columna de estatura o peso.

La horma del modelo indica si el artículo talla normal, talla pequeño o talla grande. El motor desplaza entonces la recomendación alrededor de un 3,5 % y el cliente lee «Este modelo talla pequeño: el consejo lo tiene en cuenta».

La tabla

• Añade una columna por medida: pecho, busto, cintura, cadera, ancho de hombros, largo de manga, entrepierna, cuello, muslo, longitud del pie, contorno de cabeza, estatura o peso.
• Añade una fila por talla (S, M, L, 38, 40…) e introduce un rango mínimo / máximo en cada celda.
• Introduce medidas del cuerpo, no de la prenda.

Probar la tabla

Bajo la tabla, el bloque Probar esta tabla ejecuta el motor real sobre la tabla que estás editando, incluso antes de guardar. Indica un género, una estatura y un peso: obtienes la talla recomendada, el índice de confianza, la talla vecina y las medidas estimadas (marcadas con un asterisco).

En la lista de tablas, la acción Duplicar crea una copia desactivada con los mismos destinos, para declinar una tabla por marca o por horma.

El recorrido del cliente

En la ficha de producto, el botón «Encuentra mi talla» abre una ventana con dos pestañas, «Mi talla» y «Tabla de tallas». En móvil se abre como panel desde la parte inferior de la pantalla.

Estatura y peso

Recorrido por defecto. El cliente indica su estatura, su peso, su complexión (delgada, media o robusta) y, si la tabla es mixta, si compra para mujer o para hombre. No se pide ninguna medida con cinta métrica.

Mis medidas

El cliente introduce sus medidas con cinta métrica. Una silueta resalta la medida en curso y muestra el consejo correspondiente. La estatura y el peso siguen siendo opcionales: completan las medidas que quedan vacías.

El resultado

El cliente ve la talla recomendada, el índice de confianza, la talla vecina a considerar, una explicación y el detalle por medida (buen ajuste, ceñida u holgada, con la mención «estimada» cuando el valor procede de la estatura y el peso). El botón «Elegir la talla M» selecciona la combinación correspondiente en la ficha. La pestaña «Tabla de tallas» muestra la tabla, con la talla recomendada resaltada, en la unidad elegida por el cliente.

Perfil recordado

En las siguientes visitas, el botón de la ficha muestra directamente «Tu talla: M». El enlace «Olvidar mis medidas» borra el perfil del navegador y de la cuenta del cliente.

Cómo se calcula la talla

1. Estimación: sin medidas con cinta, los contornos (busto, pecho, cintura, cadera, cuello, muslo) se estiman con una regresión sobre el índice de masa corporal según el género, ajustada por la complexión, y las longitudes son proporcionales a la estatura.
2. Correspondencia: cada talla recibe una nota según la distancia de las medidas al centro de cada rango, con una penalización fuera del rango. El ajuste preferido y la horma del modelo desplazan las medidas antes de la comparación.
3. Confianza: se calcula medida por medida y se reduce cuando hay valores estimados.
4. Talla vecina: la talla justo por encima o por debajo en la tabla, del lado en que se sitúa el cuerpo del cliente.
5. IA (opcional): el proveedor confirma o ajusta la talla y redacta la explicación en el idioma del cliente.

Stock, pedidos y devoluciones

Con la gestión de stock activa, el módulo revisa las combinaciones cuyo nombre coincide con las tallas de la tabla. Si la talla recomendada está agotada en todas las combinaciones, el cliente ve «La talla M está agotada por el momento», el botón propone la talla vecina si está disponible y la ficha muestra «Tu talla: M (agotada)».

Al validar un pedido, la última recomendación del cliente (30 días) para cada producto se vincula al pedido, con la talla realmente pedida. Las devoluciones de mercancía solicitadas por el cliente y las facturas por abono creadas en el back office marcan después la recomendación como devuelta. Eso alimenta la tasa de devolución del panel de rendimiento.

RGPD y datos

• Los perfiles y las recomendaciones se guardan en tu tienda.
• Con el módulo psgdpr, la exportación y la eliminación de los datos de un cliente incluyen su perfil y sus recomendaciones.
• Con la capa de IA, solo se envían al proveedor las medidas necesarias para el cálculo, sin nombre ni e-mail.

Preguntas frecuentes y solución de problemas

El botón no aparece en la ficha de producto. Comprueba que una tabla activa se aplica al producto y que el hook elegido existe en tu tema. Con displayDfSizeFit, añade la llamada al hook en la plantilla de producto.

El botón «Elegir la talla» no aparece. El nombre del valor de atributo debe coincidir con el de la talla en la tabla (por ejemplo «M» en ambos lados).

El asesor pide más medidas. En modo «Mis medidas» se necesita al menos una medida que corresponda a las columnas de la tabla. En modo «Estatura y peso» se requieren estatura, peso y género.

La tasa de devolución sigue vacía. Activa «Guardar las recomendaciones». La tasa aparece tras los primeros pedidos vinculados a una recomendación.

La IA no responde. Usa «Guardar y probar la conexión» para leer el error del proveedor. Mientras tanto responde el motor determinista.