Comparación
El comparador permite al usuario seleccionar hasta 4 productos del listado y obtener un análisis lado a lado generado por IA: pros, cons, match score, recomendación de "ganador" y resumen general. Componentes implicados: ComparisonBar y ComparisonModal e InlineComparison.
Cómo se activa
- El usuario hace click en "Añadir a comparación" en una
ProductCard. La barra flotante (ComparisonBar) muestra los productos elegidos y un contador. - Al alcanzar 2-4 productos, "Comparar" abre el modal y dispara la petición.
Endpoint
GET
/api/widget/comparecurl "https://api.neuroon.ai/api/widget/compare?productIds=p1,p2,p3" \
-H "X-Widget-Token: $WIDGET_TOKEN"
Controlador en WidgetProductController.java.
Respuesta
ComparisonResponse (.
- Toggle análisis IA — sección expandible con
summary(comparison.aiSummary). - Drag to reorder — accesible y con anuncio para SR (
comparison.dragToReorder). - On-demand — algunos shops sólo cargan el análisis IA al hacer click ("Obtener análisis IA" →
comparison.getAiAnalysis).
Límites
- Máximo 4 productos. Al intentar añadir un quinto, el botón muestra
comparison.comparisonFull. - Sólo productos con
idválido del shop actual. No hay comparación cross-shop.
Rate limits
GET /api/widget/compare está limitado a 10 peticiones por minuto por widget token. Cada análisis es relativamente caro (call al LLM con metadata de varios productos), por eso el límite es estricto.
Próximas lecturas
- Búsqueda por texto
- Cross-sell — recomendaciones complementarias sobre el carrito.
- Reference → Modelos de datos —
ComparisonProduct.