Manual de usuario

Bienvenido a ApproSearch

ApproSearch es el buscador inteligente para tu tienda online. Sustituye al buscador estándar por uno mucho más rápido y preciso, con sinónimos, filtros, corrección de errores tipográficos, búsqueda por voz e imagen, y reglas para destacar los productos que te interesan.

Toda la configuración se hace desde el panel de control, sin tocar código. Esta guía te explica, paso a paso, qué hace cada apartado del panel y cómo sacarle partido.

Cómo acceder al panel

Entra en panel.approsearch.com.
Introduce tu email y contraseña y pulsa Iniciar sesión.
Si gestionas varias tiendas, selecciónala en el desplegable de la parte superior.

El selector de tienda Arriba a la izquierda verás el nombre de la tienda activa. Todo lo que configures (sinónimos, filtros, relevancia…) se aplica a la tienda seleccionada. Si tienes varias, cambia de tienda ahí antes de editar.

Mapa del panel

Estos son los apartados principales. Pulsa en cualquiera para ir a su explicación:

🏬

Tiendas

Conecta y gestiona tus tiendas.

📊

Dashboard

Resumen de uso y métricas.

🗂️

Índices

Los datos que alimentan el buscador.

🔁

Sinónimos

Palabras equivalentes al buscar.

🎯

Relevancia

Qué pesa más en los resultados.

⚖️

Reglas

Destaca o reordena productos.

🔧

Filtros

Filtros visibles en el buscador.

🧪

Playground

Prueba el buscador real sin tocar la tienda.

📈

Analíticas

Qué buscan tus clientes.

💎

Facturación

Plan, facturas y consumo.

🧩

Widget

Apariencia e integración.

Primeros pasos

Tiendas

Aquí gestionas las tiendas conectadas a tu cuenta. Cada tienda tiene su propia configuración de buscador, índices y analíticas.

En el listado verás, para cada tienda: su nombre y URLs, la plataforma (PrestaShop, Shopify…), el estado (Activa) y la fecha de alta. A la derecha tienes las acciones para editar o eliminar. Arriba se indica cuántas tiendas usas respecto al límite de tu plan (p. ej. 1 / 30).

Crear una tienda

Pulsa Nueva tienda y completa el formulario:

Formulario de creación de tienda — Formulario «Crear tienda».

Campo	Para qué sirve
Nombre	Nombre con el que identificas la tienda dentro del panel.
URL de producción	La dirección real de tu tienda (donde lo verán tus clientes).
Dominio de desarrollo (opcional)	Un entorno de pruebas o staging. En este dominio el buscador muestra un aviso de Modo desarrollo y no consume la cuota de tu plan.
Plataforma	El tipo de tienda (PrestaShop, Shopify, etc.).
Restringir a estos dominios	Si lo activas, el buscador solo funcionará en la URL de producción y en el dominio de desarrollo. El resto de dominios quedarán bloqueados.

Consejo Usa el dominio de desarrollo para probar el buscador sin gastar búsquedas de tu plan ni mostrar nada a tus clientes finales.

Primeros pasos

Dashboard

La pantalla de inicio resume el estado de tu cuenta y la actividad del buscador de un vistazo.

Qué muestra

Plan actual: el plan contratado y su estado.
Búsquedas (mes): número de búsquedas del mes en curso y pico de concurrencia.
Llamadas IA: uso de las funciones de inteligencia artificial (imagen y voz).
Límites: nº de tiendas y de productos que permite tu plan.
Búsquedas, Clicks, Carrito y CTR: indicadores de rendimiento del buscador.
Volumen de búsquedas (30 días): gráfica de evolución.
Top búsquedas: los términos más buscados por tus clientes.

Para qué te sirve El Top búsquedas es oro: te dice qué busca de verdad la gente. Úsalo para crear sinónimos y reglas que mejoren justo esas búsquedas.

Buscador

Índices

Los índices son la copia optimizada de tu catálogo que usa el buscador. Hay un índice por cada idioma y tipo de contenido.

Cómo leer la tabla

Nombre: identificador técnico del índice.
Idioma: el idioma del contenido (ES, EN, FR…).
Tipo: qué contenido guarda el índice:
- PRODUCT — productos.
- CATEGORY — categorías.
- MANUFACTURER — marcas / fabricantes.
- PAGE — páginas CMS (y BLOG).
Estado: Activo si tiene contenido, Vacío si aún no se ha sincronizado.
Docs: número de elementos indexados.

Novedad: buscar por marcas Igual que las categorías, las marcas pueden aparecer como resultados propios en el buscador (un bloque «Marcas» con enlace a la página de cada marca). Para activarlo, crea un índice de tipo Marcas por cada idioma con Nuevo índice y sincroniza desde tu módulo (en PrestaShop, el botón «Solo marcas» o «Reindexar todo»). Si no creas el índice de Marcas, el buscador sigue funcionando igual que antes: las marcas solo aparecen como filtro.

¿Tienes que tocar esto? Normalmente no. Los índices se crean y se sincronizan automáticamente con tu tienda. Este apartado es sobre todo informativo: te confirma que tus productos y categorías están correctamente cargados en cada idioma.

Un índice «Vacío» Si ves un índice Vacío en un idioma que sí usas, suele significar que falta sincronizar ese idioma. Las acciones de la derecha permiten reindexar (volver a sincronizar) o eliminar el índice.

Buscador

Sinónimos

Los sinónimos agrupan palabras que significan lo mismo, para que el buscador encuentre los productos correctos aunque tus clientes usen términos distintos a los de tu catálogo.

Por ejemplo, si alguien busca celular o smartphone y tus productos se llaman móvil, un sinónimo hace que todos esos términos devuelvan los mismos resultados.

Listado de sinónimos — Grupo de sinónimos: móvil / smartphone / celular…

Crear un sinónimo

Pulsa Nuevo sinónimo y rellena:

Formulario de creación de sinónimo — Formulario «Crear sinónimo».

Campo	Descripción
Idioma	El idioma al que se aplica el grupo de sinónimos.
Tipo	Bidireccional: todos los términos son equivalentes entre sí (lo más habitual).
Términos	Las palabras equivalentes, separadas por comas. Todas se considerarán iguales al buscar.

Otras opciones

Importar CSV: sube muchos sinónimos a la vez desde un archivo.
Generar sinónimos con IA (Beta): propuestas automáticas a partir de tu catálogo.

Se aplican al guardar (sin reindexar) Los sinónimos actúan en el momento de buscar, así que se aplican en cuanto los guardas: no hay que reindexar el catálogo. Un matiz: conviene listar las variantes en singular y plural que quieras equiparar (p. ej. «zapatilla, zapatillas»), porque el sinónimo casa formas exactas.

Consejo Revisa el Top búsquedas y las búsquedas sin resultados: si ves términos que tus clientes usan pero no están en tu catálogo, conviértelos en sinónimos.

Buscador

Relevancia de búsqueda

Aquí ajustas qué pesa más a la hora de ordenar los resultados. Es la sección más potente del buscador y permite afinar la precisión al detalle.

Pesos por campo en relevancia — Pesos por campo: cuánta importancia tiene cada dato del producto.

1. Pesos por campo

Cada control (de 0 a 20) decide cuánta importancia tiene una coincidencia en ese campo. Un valor más alto = ese campo manda más en el ranking. Por ejemplo, subir Nombre del producto hace que las coincidencias en el título pesen más que las de la descripción.

Puedes ajustar, entre otros: nombre, autocompletado, referencia, EAN13/UPC, MPN, categorías, etiquetas, atributos, características, descripción, descripción corta, marca/fabricante, proveedor y los textos generados por IA (manual y automático).

Coincidencia parcial (junto / separado) Un peso especial que hace que casen las palabras escritas juntas o separadas: p. ej. «microconvert» / «micro converter». Con 0 está apagado. Importante: para que surta efecto hay que reindexar el catálogo desde el panel (no basta con guardar).

2. Parámetros de búsqueda

Tolerancia a errores tipográficos: cuánto se perdona una errata. Elige entre Desactivada, Estricta (recomendada), Normal o Alta. Cuanto más alta, más resultados encuentra aunque el cliente escriba mal, a cambio de algo más de ruido.
Umbral de query larga: a partir de cuántas palabras se relaja la exigencia de coincidencia.
Coincidencia mínima (cortas / largas): qué porcentaje de las palabras buscadas debe aparecer.
Corte por relevancia (score mínimo): muestra solo los productos cuyo score alcance al menos ese % del score del primer resultado. Ej.: con un 30 %, si el primer producto puntúa 1000 se descartan los que bajen de 300. 0 % = desactivado (se muestran todos). Útil para eliminar «cola» poco relevante.
Búsqueda exacta por referencia: si está activada, solo coincide la referencia completa (p. ej. «MO6760»). Desactívala para permitir coincidencias parciales («6760» encuentra «MO6760»).
Boosts: bonificación por frase exacta, por referencia/EAN/UPC exacto y por campos cruzados.

Factores de ranking de negocio — Factores de ranking y opción de ocultar productos agotados.

3. Factores de ranking

Ajustan cómo influyen los factores de negocio (un 0 los desactiva):

Ocultar productos agotados: si lo activas, los productos sin stock no aparecen en los resultados.
Disponibilidad (stock): prioriza productos en stock frente a agotados (sin llegar a ocultarlos).
Popularidad (ventas): sube los más vendidos.
Valoración: tiene en cuenta la puntuación del producto.
Descuento: da un empujón a los productos con descuento activo.

Simulador de pesos con desglose de scoring — Simulador: cada resultado desplegable muestra cómo se calculó su posición.

4. Simulador de pesos

Prueba una búsqueda con los pesos y parámetros que tienes arriba sin necesidad de guardar. Elige cuántos resultados mostrar y despliega cualquiera para ver cómo se ha calculado su posición: la relevancia de texto campo a campo (nombre, categorías, descripción…) y los factores de negocio que se han activado.

Aplicar reglas: marca esta casilla para que la prueba tenga en cuenta también tus reglas (boost, fijar, ocultar). El panel te avisa si ninguna regla coincide con el término, para diagnosticar reglas que no se aplican.
Ver detalle técnico: abre la explicación completa de Elasticsearch para cada resultado.

Recuerda guardar Los cambios no se aplican hasta que pulsas Guardar cambios. Si te lías, Restaurar vuelve a los valores por defecto. Recuerda que la coincidencia parcial además necesita reindexar el catálogo.

Buscador

Reglas de búsqueda

Las reglas modifican los resultados cuando se cumple una condición: destacar productos, fijarlos arriba, redirigir, etc. Son tu herramienta de merchandising.

Listado de reglas con su tipo, trigger, prioridad y estado.

Crear una regla

Pulsa Nueva regla:

Formulario de creación de regla — Formulario «Crear regla».

Campo	Descripción
Nombre	Un nombre descriptivo para reconocer la regla.
Tipo	La acción de la regla (p. ej. Boost, para dar más relevancia).
Cuando busquen + Coincidencia	El término que dispara la regla y cómo debe coincidir (Contiene, exacto…).
Prioridad	De 0 a 1000. Las reglas con mayor prioridad se aplican antes.
Acción (Campo / Valor / Peso)	Qué se potencia. Ej.: campo Marca, valor Apple, peso 2 → al buscar el término, los productos de esa marca suben en los resultados.

Ejemplo práctico «Cuando busquen movil, destaca la marca Apple» → creas una regla de tipo Boost, trigger movil, campo Marca, valor Apple. Así esos productos aparecerán primero para esa búsqueda.

Buscador

Filtros y ordenación

Configura qué filtros ve el cliente en el buscador (categorías, precio, atributos…) y en qué orden aparecen.

Filtros activos

Nombre: el texto que ve el cliente (p. ej. «Categorías», «Precio»).
Campo: el dato del producto sobre el que filtra (categories.name, price…).
Tipo / Selector: cómo se muestra: CHECKBOX (casillas) o RANGE (rango, ideal para precio).
Orden: arrastra las filas para cambiar el orden en que aparecen en el buscador.

Editar un filtro

Con Editar puedes cambiar el campo, el selector y, sobre todo, el nombre por idioma:

Formulario de edición de filtro — Edición de filtro: nombre por defecto y traducción por idioma.

Nombre: el que se usa si un idioma no tiene traducción.
Nombre por idioma: cambia el idioma y escribe cómo quieres que se vea el filtro en cada uno.

Para añadir uno nuevo, usa Nuevo filtro. Las opciones de ordenación (relevancia, precio, etc.) se crean automáticamente con la tienda.

Filtros por atributo o característica: «Id exacto» Al crear un filtro sobre un atributo (talla, color…) o una característica, el diálogo usa el Id exacto del grupo (por ejemplo el id_attribute_group o id_feature de PrestaShop) en vez del nombre. Así el filtro es preciso aunque el texto varíe entre idiomas.

«Ver más» por grupo Cuando un filtro tiene muchos valores, el buscador ya no los corta en seco: muestra los primeros y un botón «Ver más» para desplegar el resto dentro de ese grupo.

Buscador

Playground

Prueba el buscador real con tu configuración guardada —reglas, filtros, sinónimos y relevancia— tal como lo ve el cliente, sin tocar tu tienda.

Qué hace

Widget en vivo: es el mismo buscador que verán tus clientes, con la configuración que tienes guardada. Haz clic en la caja y busca como lo haría un cliente.
Escritorio / móvil: alterna la vista para comprobar cómo se comporta en cada tamaño de pantalla.
Contexto del visitante: simula ser un cliente logueado o un visitante anónimo. Útil para probar el Modo B2B (tienda cerrada).
Recargar: vuelve a cargar el widget con la última configuración guardada.

No gasta tu cuota Las búsquedas del Playground se hacen contra tu índice real pero cuentan como entorno de desarrollo: no consumen las búsquedas de tu plan ni ensucian tus analíticas.

Diferencia con el simulador El simulador de Relevancia sirve para afinar los pesos viendo el scoring de cada resultado. El Playground es para ver el buscador terminado (aspecto, filtros, carrito…) tal cual quedará en la tienda.

Analíticas

Estadísticas

Analíticas completas del buscador: cuánto se usa, qué funciona y qué se puede mejorar.

Qué encontrarás

Rango temporal: elige el periodo (7, 14, 30 o 90 días).
Métricas: Búsquedas, Clicks, CTR y Compras del periodo.
Top búsquedas: los términos más buscados.
Búsquedas sin resultados: qué buscan tus clientes y no encuentran.
Productos más clicados: los que más interés generan desde el buscador.
Categorías más clicadas: qué categorías abren tus clientes desde los resultados.

Exportar y resetear

Exportar: descarga las analíticas del periodo en CSV para analizarlas en tu hoja de cálculo.
Resetear: borra los datos de analítica acumulados (empezar de cero).
Filtro por idioma: si tu tienda tiene varios idiomas, puedes ver las analíticas de todos o de un idioma concreto. Nota: el filtro por idioma no es retroactivo (solo afecta a los datos registrados desde que existe).

Productos y categorías más clicados desde el buscador.

El dato más útil Las búsquedas sin resultados te dicen exactamente qué falta o qué no se está encontrando. Cada una es una oportunidad de crear un sinónimo, una regla o de revisar el catálogo.

Analíticas

Detalle de búsquedas

El análisis detallado, término a término, de lo que buscan tus clientes.

Top búsquedas: ranking completo de términos con su número de búsquedas.
Sin resultados: ranking de términos que no devolvieron nada, con cuántas veces se buscaron.

Cómo usarlo Es la versión ampliada del Top búsquedas del Dashboard. Repásalo cada cierto tiempo para detectar tendencias y términos a los que dar respuesta.

Facturación

Mi Plan

Consulta tu plan actual y compáralo con el resto para cambiar cuando lo necesites.

Comparativa de planes — Plan actual y comparativa (Start, Growth, Scale, Enterprise).

Cada plan indica sus límites y funciones: número de productos, búsquedas simultáneas, tiendas e idiomas, además de funciones avanzadas como Búsqueda con IA, por imagen, por voz, Modo B2B y Multi-tienda.

Cambiar de plan Pulsa Cambiar a este plan en el que te interese. Tu plan actual aparece marcado como Actual.

Facturación

Facturas

El historial de tus facturas y pagos, y la gestión del método de pago.

Listado de facturas: aquí aparecen tus facturas a medida que se generan, con opción de descarga.
Gestionar método de pago: añade o cambia la tarjeta/método con el que se cobra tu plan.

Facturación

Uso

El consumo del mes actual frente a los límites de tu plan.

Total búsquedas: búsquedas realizadas este mes.
Pico concurrencia: máximo de búsquedas simultáneas alcanzado.
Llamadas IA: uso de las funciones de inteligencia artificial.
Gráficas diarias: evolución día a día de búsquedas y concurrencia.

¿Te quedas corto? Si te acercas a los límites de tu plan, revisa Mi Plan para subir de nivel. Recuerda que las pruebas en el dominio de desarrollo no cuentan.

Configuración

API Keys

Las claves de acceso que usan tus widgets y módulos para conectarse con ApproSearch.

Cómo funciona

Pulsa Nueva API Key para generar una clave (por ejemplo, una para producción y otra para desarrollo).
Cada clave está asociada a una tienda y puede activarse/desactivarse o eliminarse.
La clave se copia en el módulo/widget de tu tienda (ver Widget y Ajustes).

Trátala como una contraseña No compartas tu API Key públicamente. Si crees que se ha filtrado, desactívala o elimínala y crea una nueva.

Configuración

Widget de búsqueda

El centro de personalización: aquí defines cómo se ve y se comporta el buscador en tu tienda, y obtienes el código para integrarlo.

Comportamiento y búsqueda predeterminada

Búsqueda predeterminada: qué se muestra al abrir el buscador antes de que el cliente escriba (p. ej. «Más vendidos» o «Productos destacados») y cuántos productos.
Búsqueda nativa: integra el buscador con el de tu tema. Al pulsar Intro (o al usar la página de resultados nativa de la tienda) los resultados los sirve ApproSearch, aprovechando la caja de búsqueda que ya tiene tu tema.

Modo de visualización

Ventana (modal): centrado, con filtros plegables. Puedes fijar el ancho de la ventana (px o %).
Pantalla completa: cubre la pantalla con los filtros desplegados.
Minimal: listado compacto en una sola columna.

A la derecha tienes una vista previa en vivo que refleja los cambios al instante.

Miniaturas del tema (PrestaShop)

Con esta opción, la tarjeta de cada producto la pinta tu propia tienda con la miniatura real de tu tema (imagen, precio, insignias y personalizaciones incluidas), en lugar de la tarjeta configurable del buscador. Pensado para temas con miniaturas muy personalizadas que no compensa replicar.

Vista, orden y filtros

Vista por defecto: cuadrícula o lista (el cliente puede cambiarla con un botón), configurable por escritorio y móvil.
Ordenación por defecto y productos por fila en cuadrícula.
Panel de filtros: su ancho y si aparece siempre abierto.
Máximo de resultados y ancho de la caja de búsqueda.

Precios mostrados, etiqueta de impuestos y datos de la tarjeta — Precios con/sin impuestos, etiqueta de IVA y qué datos mostrar en la tarjeta.

Precios y datos de la tarjeta

Precios mostrados: elige mostrar el precio con impuestos (IVA incluido) o sin impuestos. Afecta a lo que se ve y a cómo se ordena/filtra por precio.
Mostrar etiqueta de impuestos: añade un texto junto al precio («IVA incluido» / «sin IVA»), traducible.
Precios en vivo (PrestaShop): calcula el precio en el momento (grupos de cliente, descuentos específicos) en lugar del precio indexado.
Mostrar referencia, EAN, disponibilidad, marca y categoría: activa u oculta cada dato en la tarjeta.
Etiquetas en productos: insignias (p. ej. «Novedad», «Oferta») a partir de tags o características.
Añadir al carrito y selector de unidades: permite comprar desde el propio buscador. En Shopify, PrestaShop y WooCommerce usa la API nativa del carrito.

Personalización visual y CSS/JS personalizado — Apariencia (color, bordes, texto…) y CSS/JS personalizado.

Apariencia

Ajusta el aspecto del buscador: color principal, radio de bordes, tamaño de texto, placeholder, imagen por defecto (cuando un producto no tiene foto), caracteres mínimos para buscar, recordar la última búsqueda y mostrar atajos de teclado (incluido el badge Ctrl+K).

CSS y JS personalizado

Para casos avanzados, puedes habilitar CSS personalizado (ajustes finos de estilo) y JS personalizado (comportamientos a medida) que se cargan con el widget. Actívalos solo si sabes lo que haces.

Acceso y plan: Modo B2B

Para tiendas cerradas al público (mayoristas o catálogos privados). Permite elegir el comportamiento con visitantes no registrados: bloquear las búsquedas por completo (mensaje personalizado y botón CTA) u ocultar datos del producto (pueden buscar, pero sin ver precio, disponibilidad ni botón de compra). Los clientes registrados siempre ven el buscador completo. Debajo se listan las funcionalidades avanzadas que incluye tu plan (voz, imagen, IA).

Código de integración

Copia el snippet que genera el panel y pégalo en tu tienda. Incluye tu storeId y dónde poner tu apiKey:

No olvides guardar Tras cualquier cambio, pulsa Guardar cambios para que se aplique al buscador de tu tienda.

Configuración

Traducciones

Personaliza todos los textos de la interfaz del buscador, idioma por idioma.

Textos del widget por idioma — Textos editables del buscador, agrupados por bloques.

Cómo funciona

Elige el idioma en el desplegable superior.
Edita los textos que quieras. Si dejas un campo vacío, se usa el valor por defecto.
Los textos están organizados por bloques: Buscador, Búsqueda por imagen, Búsqueda por voz, Resultados y Filtros y orden.

Personaliza tu voz de marca Aquí puedes adaptar mensajes como el placeholder («Buscar productos…»), el «Powered by», los estados sin resultados o los nombres de los filtros y ordenaciones para que suenen como tu tienda.

Configuración

Configuración de IA

Configura la búsqueda semántica, por voz y por imagen, y el proveedor de inteligencia artificial.

Proveedor de IA

Elige el proveedor (p. ej. OpenAI) e introduce su API Key. Puedes usar Probar conexión para verificar que funciona.

Funcionalidades

Búsqueda semántica: entiende la intención del usuario, no solo las palabras exactas.
Búsqueda por voz: icono de micrófono en el buscador.
Búsqueda por imagen: icono de cámara para buscar con una foto.

Peso semántico

Un control que va de solo texto (BM25) a solo semántico (kNN). Te permite equilibrar entre coincidencia literal de palabras y comprensión del significado.

Modelos

Opcionalmente puedes especificar los modelos de embeddings, visión y voz. Si los dejas vacíos, se usan los valores por defecto.

Relación con otros apartados La IA configurada aquí es la que enriquece tu catálogo en Catálogo IA y la que activa los iconos de voz e imagen del Widget.

Configuración

Enriquecimiento IA del catálogo

Genera descripciones automáticas de tus productos con IA para mejorar la búsqueda por imagen y la búsqueda semántica.

Cómo funciona

Elige la tienda y el idioma.
Pulsa Enriquecer catálogo para generar descripciones de todos los productos (o marca Reprocesar todo para rehacerlas).
El panel muestra un coste estimado antes de lanzar el proceso.
También puedes generar la descripción de un producto concreto, o editarla a mano con Clic para editar.

Filtra el listado por Todos, Con descripción o Pendientes para ver el avance.

¿Para qué sirve? Una buena descripción ayuda al buscador a entender mejor cada producto, lo que mejora la búsqueda semántica y los resultados de la búsqueda por imagen.

Configuración

Ajustes

Los datos de tu cuenta y de la tienda, y los valores que necesitas para configurar los módulos CMS.

Qué encontrarás

Tu cuenta: nombre, email, rol y tus identificadores (User ID, Tenant ID).
Tienda actual: nombre, URL, plataforma, estado y Store ID.
Datos para módulos CMS: el Store ID, Tenant ID, API URL y API Key que copiarás en el módulo de PrestaShop, WooCommerce, Shopify, etc.
Endpoints de la API: las rutas disponibles para integraciones a medida (buscar, sugerencias, indexar productos, estado, eventos…).

Para integrar tu tienda Si usas el módulo oficial de tu CMS, copia el Store ID, Tenant ID, API URL y una API Key (creada en API Keys con permisos search e index).