Buscador

El buscador es la caja de búsqueda de la tienda online: lo que el comprador escribe cuando no quiere navegar por el menú de categorías. Este módulo permite observar cómo está funcionando ese buscador y corregirlo sin depender de desarrollo.

Antes de este módulo, cualquier ajuste del buscador exigía una intervención técnica. Ahora el equipo de negocio puede ver qué busca la gente, qué no encuentra, y arreglarlo en minutos.

Qué se puede hacer

El módulo trabaja sobre cuatro palancas. Cada una responde a una pregunta distinta:

Pregunta	Palanca	Pantalla
¿Qué encuentra el comprador?	Sinónimos: enseñar al buscador que dos palabras significan lo mismo	Sinónimos
¿Qué ve primero?	Fijar los productos que deben salir arriba y ocultar los que no deben salir	Ajustar búsquedas
¿Qué se le sugiere mientras teclea, y qué tags se le proponen después?	Términos de autocompletado y Tags	Términos de búsqueda
¿Cómo se ordena en general?	Peso de cada campo del producto y tolerancia a erratas	Equalize

A las cuatro se suma una quinta pantalla, Resumen del buscador, que no configura nada: informa. Es el punto de partida natural, porque es donde se ve qué está fallando.

Las cinco pantallas

Resumen del buscador

El estado de salud del buscador de un vistazo: si el servicio está vivo, cuántos productos hay indexados, qué está buscando la gente y qué búsquedas se están quedando sin resultados. Desde aquí se salta directamente a corregir cada problema detectado.

Ajustar búsquedas

La pantalla del día a día. Se escribe un término tal y como lo teclearía un comprador, se ve exactamente lo que él vería, y se corrige: subir un producto, ocultar otro, reordenar. Es la única pantalla donde se ve el resultado real antes y después del cambio.

Sinónimos

El diccionario de equivalencias. Aquí se resuelven los casos de "el producto existe pero el comprador no lo encuentra porque lo llama de otra forma".

Términos de búsqueda

Lo que aparece en el desplegable mientras el comprador escribe, y las sugerencias que se le ofrecen después de buscar. Incluye las listas de lo que la gente busca de verdad y de lo que busca sin encontrar nada, filtradas por idioma, para poder promover los términos buenos y silenciar las erratas.

Equalize

Los ajustes globales de relevancia: cuánto pesa el nombre del producto frente a la descripción, cuántas letras puede fallar el comprador antes de que deje de encontrar nada. Es la pantalla de mayor impacto y la que menos se toca.

Glosario

Los términos que aparecen en las pantallas, explicados sin tecnicismos.

Sobre el catálogo

Documento — Un producto en un idioma. Un producto que existe en castellano, inglés, catalán y euskera cuenta como cuatro documentos. Por eso el número de "documentos indexados" del Resumen es mucho mayor que el número de productos del catálogo: es la suma de los idiomas, no productos únicos.

Indexado — Un producto está indexado cuando el buscador ya lo conoce y puede devolverlo. Un producto puede existir en el catálogo y no estar indexado: en ese caso, no aparecerá en ninguna búsqueda.

Feed — El fichero con el que el buscador aprende el catálogo. Tiene dos fechas que no siempre coinciden: feed publicado (cuándo se dejó preparado el fichero nuevo) y feed aplicado (cuándo el buscador lo cargó de verdad). Si el publicado es posterior al aplicado, el comprador todavía está viendo el catálogo antiguo.

Recarga de catálogo — Reiniciar el buscador para que vuelva a leer el feed. Tarda unos 30 segundos, durante los cuales la tienda sigue funcionando con el catálogo anterior. Es la forma de aplicar un feed publicado que aún no se ha cargado.

Sobre los sinónimos

Sinónimo — Una equivalencia que se le enseña al buscador. Sirve para que quien busque una palabra encuentre también productos que no la llevan escrita. Sin sinónimo, buscar birra no devuelve cervezas, porque ningún producto se llama "birra".

Sinónimo equivalente — Un grupo de palabras intercambiables entre sí: quien busque cualquiera de ellas encuentra también las demás. Funciona en todas las direcciones. Ejemplo: birra, cerveza, cervezas — buscar cualquiera de las tres devuelve lo mismo. Necesita al menos dos términos.

Sinónimo dirigido — Una equivalencia en un solo sentido: mopa → fregona significa "quien busque mopa debe encontrar fregonas". La palabra de la izquierda es la que teclea el comprador; la de la derecha, lo que hay en el catálogo. El sentido importa: escrito al revés (fregona → mopa) no arregla nada, porque nadie escribe "fregona" esperando encontrar mopas.

Nota: Si dudas entre los dos tipos, usa equivalente. Es el caso habitual y funciona en ambos sentidos. El dirigido se reserva para cuando la equivalencia solo tiene sentido en una dirección.

Sobre las búsquedas ajustadas

Regla de fijado (o regla de curación) — Un ajuste manual asociado a una búsqueda concreta y a un idioma. Guarda dos cosas: los productos fijados con la posición exacta que deben ocupar y la lista de productos que no deben salir. Solo se aplica a esa búsqueda en ese idioma; el resto del buscador no se ve afectado.

Fijar (un producto) — Forzar que un producto aparezca en una posición concreta de una búsqueda, por delante de lo que el buscador habría elegido por su cuenta. Lo que se guarda es la posición que ocupa su tarjeta en pantalla: fijar no mueve el producto, lo clava donde está. Para colocarlo en otro puesto se arrastra, y al soltarlo queda fijado ahí.

Ocultar (un producto) — Impedir que un producto salga en una búsqueda concreta. El producto sigue existiendo en la tienda y sigue apareciendo en otras búsquedas: solo desaparece de esta.

Coincidencia exacta / Coincidencia contiene — Define cuándo se aplica la regla. Exacta: solo si el comprador escribe ese término y nada más. Contiene: también si el término aparece dentro de una búsqueda más larga. Con la regla de vino en modo Contiene, se aplica también a vino tinto y vino rioja.

% de coincidencia — Cuánto se parece un producto al término buscado, calculado por el propio buscador. Sirve para entender por qué un producto está en la lista: un resultado con coincidencia baja suele ser el ruido que hay que ocultar. Los productos añadidos a mano no tienen porcentaje, porque no llegaron por el término.

Popularidad — Una señal de "cuánto se mueve" un producto que el buscador usa para desempatar entre resultados que casan igual de bien. Es la suma de todos los eventos que los compradores generan sobre ese producto: cada click, cada añadido al carrito y cada compra suman, y cada tipo de evento tiene su propio peso. Los pesos por defecto son 1 para el click, 1 para el añadido al carrito y 5 para la compra: una compra vale lo mismo que cinco clicks. Son un parámetro del despliegue, así que una marca puede tenerlos ajustados a otros valores. Se edita desde la etiqueta de la tarjeta en Ajustar búsquedas y es una semilla: el motor sigue sumando esos eventos a partir del valor escrito. Afecta al producto en todas las búsquedas, no solo a la que se está trabajando, y se guarda al momento.

Zona (contexto de previsualización) — La tienda preparadora desde la que se previsualiza una búsqueda. Como cada tienda tiene su propio surtido, el mismo término puede devolver resultados distintos, o ninguno, según la zona seleccionada.

Sobre los términos sugeridos

Autocompletado — El desplegable de sugerencias que aparece en la columna izquierda de la caja de búsqueda mientras el comprador escribe. Ahí es donde se ven los Related Tags y las Suggestions.

Related Tag — Una sugerencia escrita por el equipo de negocio, visible en la columna izquierda del autocompletado. Se decide qué se sugiere y en qué orden. Aparece por delante de las Suggestions.

Suggestion — Una búsqueda que los compradores han hecho de verdad, con el número de veces que la han hecho, visible en la columna izquierda del autocompletado. El buscador las va acumulando solo. Alimentan el autocompletado por debajo de los Related Tags. Es la lista más valiosa del módulo: dice qué quiere la gente con sus propias palabras.

Término excluido (etiqueta No se sugiere) — Una Suggestion marcada para no sugerirse nunca. Es la herramienta contra las erratas (leche desnatda), los insultos, las marcas de la competencia y el ruido técnico. El comprador puede seguir buscándolo; simplemente no se le ofrece a nadie más.

Tags (o siguientes búsquedas) — La lista de búsquedas que se le proponen al comprador asociada a un término, mostradas como etiquetas encima de los resultados de producto tras buscar. Se configura una sola vez y sirve para los dos usos: como autocompletado mientras teclea, y como "siguientes búsquedas" después de buscar. Su valor está en asociar conceptos que no se parecen como texto (barbacoa → carbón, chorizo criollo): eso el buscador no lo deduce solo, mientras que completar una palabra (leche → leche desnatada) ya lo hace con las Suggestions. No cambian los resultados de la búsqueda, solo proponen la siguiente.

Sobre la relevancia

Relevancia — El criterio por el que el buscador decide qué resultado va primero. No es el orden alfabético ni el precio: es una puntuación de parecido entre lo que se buscó y cada producto.

Peso de un campo — Cuánto cuenta que la palabra buscada aparezca en un campo concreto del producto. Que aparezca en el nombre debería contar más que que aparezca en la descripción: eso se consigue dándole más peso al nombre.

Tolerancia a erratas — Cuántas letras puede equivocar el comprador y seguir encontrando el producto. Con tolerancia 2, lehce encuentra leche. El precio de subirla es el ruido: con palabras cortas, mopa empieza a casar con sopa y ropa. Bajarla limpia el ruido pero deja fuera las erratas reales.

Priorizar la coincidencia exacta — Si está activo, un producto que contiene la frase buscada tal cual sube por delante de los que solo contienen palabras suyas sueltas.

Sobre cómo se guardan los cambios

Publicar — Guardar un cambio y dejarlo vivo para el comprador desde ese momento. No hay borrador ni previsualización previa: publicado es publicado.

Publicado / Aplicado — Cada cambio se guarda en dos pasos. Primero se publica (queda guardado de forma permanente) y después se intenta aplicar en caliente al buscador (que empiece a surtir efecto ya). Si lo primero funciona y lo segundo no, se avisa con este mensaje:

El cambio se ha publicado, pero no se ha podido aplicar al buscador en caliente. Se aplicará en la próxima recarga del catálogo.

El cambio no se ha perdido: está guardado y entrará en vigor en la siguiente recarga del catálogo. Si aparece este aviso, o se espera, o se lanza una recarga desde el Resumen.

Etiquetas que verás en pantalla

Las pantallas usan etiquetas de color para marcar el estado de las cosas. Estas son todas:

Etiqueta	Dónde aparece	Qué significa
Vivo (verde)	Resumen	El servicio de búsqueda responde con normalidad
Caído (rojo)	Resumen	El servicio de búsqueda no responde: la tienda no está buscando
Popularidad (icono de gráfica)	Ajustar búsquedas	La popularidad acumulada del producto; se puede pulsar para editarla
Fijado	Ajustar búsquedas	El producto está fijado por una regla, no lo ha elegido el buscador
No indexado	Ajustar búsquedas	El producto está fijado en la regla pero el buscador no lo tiene: no saldrá
Related Tag	Ajustar búsquedas (autocompletado)	La sugerencia la ha escrito el equipo de negocio
Suggestion	Ajustar búsquedas (autocompletado)	La sugerencia sale de búsquedas reales de compradores
Exacta	Ajustar búsquedas (reglas)	La regla solo se aplica a esa búsqueda literal
Contiene	Ajustar búsquedas (reglas)	La regla también se aplica a búsquedas más largas que incluyan el término
No se sugiere	Términos de búsqueda (Suggestions)	El término está excluido del autocompletado

Tres reglas que conviene tener claras

1. Los idiomas son independientes

Casi todo se guarda por idioma, y cada idioma está aislado del resto. Un idioma sin sinónimos no hereda los de castellano: si se crea el sinónimo birra → cerveza en castellano, en catalán no existe.

Qué	Alcance
Sinónimos	Por idioma
Related Tags y sus Tags	Por idioma
Reglas de fijado	Por idioma
Contadores de búsquedas (más buscados y sin resultados)	Por idioma, y también consultables agregados
Popularidad de un producto	Por idioma
Ajustes de Equalize	Comunes a todos los idiomas

En todas las pantallas el idioma por defecto es castellano, independientemente del idioma en el que el gestor tenga el backoffice.

Ojo con las reglas de fijado: antes eran comunes a todos los idiomas y ahora no. Una regla creada trabajando en castellano no actúa sobre las búsquedas hechas desde la tienda en catalán: hay que repetirla cambiando el idioma del filtro.

Los contadores de búsquedas son el único caso con doble lectura: en Términos de búsqueda se ven por idioma, y en el Resumen se pueden ver agregados por el texto de la búsqueda vaciando su filtro de idioma.

2. Lo que se publica está vivo

No hay estado de borrador. En cuanto se pulsa Publicar, el comprador ya está viendo el efecto.

La única excepción es la pantalla Ajustar búsquedas, donde fijar, ocultar y reordenar se van acumulando en pantalla y no tienen ningún efecto hasta que se pulsa Guardar regla. Si se sale de la pantalla con cambios pendientes, se avisa antes de perderlos.

3. La última publicación gana

No hay bloqueo entre gestores. Si dos personas trabajan a la vez sobre la misma regla, el mismo grupo de sinónimos o el mismo término, la última en publicar sobrescribe a la anterior sin ningún aviso. Conviene repartirse el trabajo por pantalla o por idioma.

Permisos

Perfil	Roles	Qué puede hacer
Gestión	`search_engine:admin`	Todo lo de consulta y, además, publicar sinónimos, reglas, términos y relevancia; importar ficheros; vaciar listas y recargar el catálogo.
Solo consulta	`search_engine:read`	Ver las cinco pantallas completas, previsualizar cualquier búsqueda y exportar sinónimos. Los botones de crear, editar, borrar, importar, reordenar, publicar, editar la popularidad, vaciar listas y recargar el catálogo no aparecen: no están deshabilitados, directamente no se muestran. En Ajustar búsquedas, las etiquetas de producto fijado y de popularidad siguen visibles, pero no se pueden pulsar.
Sin acceso	—	La sección Buscador no aparece en el menú. Si se accede por la dirección de una de sus pantallas, se muestra el aviso «No tiene permisos para acceder a esta sección» y se vuelve a la página de inicio.

Estos permisos son los mismos para las cinco pantallas del módulo.

Por dónde empezar

Si es la primera vez que se entra al módulo, este es el recorrido que más rinde:

Resumen del buscador → mirar el bloque Términos sin resultados. Cada término de esa lista es un comprador que buscó algo y se fue con las manos vacías.
Para cada uno, decidir si es un hueco de sinónimo (el producto existe, se llama de otra forma) o un hueco de surtido (el producto no está en la tienda). Los primeros se arreglan aquí; los segundos son un asunto de catálogo.
Para los huecos de sinónimo, usar el atajo Crear sinónimo de la propia fila: lleva el término ya escrito a la pantalla de Sinónimos.
Después, mirar el bloque Términos más buscados y comprobar en Ajustar búsquedas que las búsquedas más frecuentes devuelven lo que deberían — con la zona puesta en la tienda preparadora que interese, porque el surtido cambia de una a otra. Son las que más tráfico mueven: un fallo ahí cuesta mucho más que en la cola larga.
Dejar Equalize para el final, y solo si hay un problema transversal que no se arregla búsqueda a búsqueda.