> For the complete documentation index, see [llms.txt](https://academy.gopersonal.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.gopersonal.ai/guia-de-usuario/go-search/configuraciones/el-camino-de-una-busqueda.md).

# El camino de una búsqueda

<figure><img src="https://1714366366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuYUYzfG5fXW0akjkg1XQ%2Fuploads%2Fgit-blob-0ba72c8333c9ae8a36a760511a056b1ea053b1aa%2F02-el-camino.png?alt=media" alt="El camino de una búsqueda: campo de prueba, filtros como los vería el cliente, contadores y primeros pasos"><figcaption></figcaption></figure>

**El camino de una búsqueda** es el probador del buscador. Escribes lo que buscaría un cliente y ves, paso a paso, qué hizo el buscador con esa búsqueda: qué corrigió, qué filtros eligió, qué reglas se aplicaron y por qué aparece cada producto en los resultados.

Úsalo para:

* Entender por qué una búsqueda muestra ciertos resultados.
* Comprobar el efecto de un ajuste después de guardarlo.
* Encontrar rápido qué ajuste cambiar: cada paso tiene un enlace **Editar** que lleva a su sección.

{% hint style="info" %}
Las búsquedas que haces en el probador no cuentan en las métricas de tu tienda.
{% endhint %}

## Probar una búsqueda

1. Abre la pantalla **Buscador** y elige la vista **El camino de una búsqueda**.
2. Escribe la búsqueda en el campo **Escribí lo que buscaría un cliente…**. A partir de dos letras se despliegan los **Productos sugeridos**; si eliges uno, se busca su nombre.
3. Haz clic en **Probar búsqueda** o presiona Enter.

También puedes buscar con **Buscar por voz** (el ícono del micrófono) o **Buscar con una imagen** (el ícono de la cámara) para ver qué productos aparecerían. El recorrido paso a paso se arma para las búsquedas escritas.

Debajo del campo, **Recientes:** muestra las últimas seis búsquedas que probaste en este navegador. Haz clic en una para repetirla.

## Los contadores

Arriba del recorrido, una fila de contadores resume cuántos productos quedaron en cada etapa, con una barra que muestra la proporción:

| Contador              | Qué indica                                                                                                                                           |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **en el catálogo**    | Productos de tu catálogo en el buscador.                                                                                                             |
| **con los filtros**   | Productos que encontró la búsqueda con los filtros que se decidieron.                                                                                |
| **candidatos**        | Productos que pasan a ordenarse. Si el rescate por nombre sumó productos, dice **+N rescatados**; si se aflojó un filtro, **+N al aflojar filtros**. |
| **después de reglas** | Productos que quedan después de las reglas de negocio y del corte de resultados que no tienen que ver.                                               |
| **en total**          | Productos que se muestran al cliente.                                                                                                                |
| **tiempo total**      | Cuánto tardó la búsqueda.                                                                                                                            |

**Ejemplo:** "colágeno" muestra 4.200 **en el catálogo**, 180 **con los filtros**, 186 con **+6 rescatados**, 150 **después de reglas** y 150 **en total**. Entre **candidatos** y **después de reglas** salieron 36 productos: los excluyó una regla de negocio o los sacó el corte de resultados que no tienen que ver.

## Los pasos

El recorrido sigue el mismo orden y los mismos números que [Todos los ajustes](https://academy.gopersonal.ai/guia-de-usuario/go-search/configuraciones/todos-los-ajustes.md), agrupado por etapas:

| Etapa                              | Pasos                                                                                                                                                                   |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **A · Atajos**                     | 1 **Redirecciones** · 2 **Código o SKU exacto**                                                                                                                         |
| **B · Limpiar lo que escribieron** | 3 **Corrección de “menos de / más de”** · 4 **Errores de tipeo** · 5 **Palabras que se ignoran** · 6 **Sinónimos**                                                      |
| **C · Entender qué piden**         | 7 **Ocasión o look** · 8 **Filtros que entiende la IA** · 9 **Reglas de filtros** · 10 **Marcas y valores conocidos**                                                   |
| **D · Traer productos**            | 11 **Buscar en el catálogo** · 12 **Rescate por nombre** · 13 **Si quedan pocos resultados**                                                                            |
| **E · Ordenar**                    | 14 **Orden por relevancia** · 15 **Ajustes finos de orden** · 16 **Reglas de negocio: subir, bajar, excluir** · 17 **Corte de irrelevantes** · 18 **Productos fijados** |
| **F · Lo que ve el cliente**       | 20 **Orden que elige el cliente**                                                                                                                                       |

Cada paso muestra:

* Su número, su nombre y sus etiquetas de tipo (**Automático**, **Aprendido**, **Lo ajustás vos** o **Regla de negocio**). La leyenda de las etiquetas está debajo del campo de búsqueda.
* Una línea con lo que hace el paso en general.
* El estado del paso en esta búsqueda y un resumen de lo que hizo, por ejemplo **“colagneo” → “colágeno”**, **También busca: championes** o **Encontró 180 candidatos**.
* Cuando corresponde, cuántos productos quedaron después del paso (por ejemplo, **180 productos**) y cuánto tardó.
* Los enlaces **Editar** y **Preguntar**.

### Estados de cada paso

<figure><img src="https://1714366366-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuYUYzfG5fXW0akjkg1XQ%2Fuploads%2Fgit-blob-3daffbf15b3eff83f1e29be454be7609d9a88437%2F03-el-camino-pasos.png?alt=media" alt="Pasos 7 a 10 de una búsqueda: el paso 8 aplicó un filtro de categoría y los demás no aplicaron"><figcaption></figcaption></figure>

| Estado          | Qué significa                                                                                                                                      |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Aplicó**      | El paso hizo algo en esta búsqueda: corrigió una palabra, eligió un filtro, movió productos, etc.                                                  |
| **No aplicó**   | El paso corrió, pero no cambió nada. Por ejemplo, **Sin errores de tipeo**.                                                                        |
| **Terminó acá** | La búsqueda se resolvió en este paso y no siguió. Pasa con una redirección o con un código de producto exacto.                                     |
| **No llegó**    | La búsqueda terminó en un paso anterior, así que este no corrió. El paso aparece atenuado con el texto **La búsqueda terminó antes de este paso.** |

**Ejemplo:** si buscas "envíos" y tienes una redirección para esa palabra, el paso 1 muestra **Terminó acá** con el resumen **Coincide con una redirección: lleva a** y la página de destino. Todos los pasos siguientes muestran **No llegó**.

### Solo lo que aplicó

Activa **Solo lo que aplicó** para ocultar los pasos que no hicieron nada. Quedan visibles solo los pasos con estado **Aplicó** o **Terminó acá**, y es más fácil ver qué cambió los resultados.

### Detalle técnico

Activa **Detalle técnico** para ver, debajo de cada paso, los datos completos que devolvió el buscador en ese paso, en formato técnico. Para el uso diario no lo necesitas.

### Editar un paso

Haz clic en **Editar** en cualquier paso para abrir **Todos los ajustes** directamente en la sección de ese paso. Después de guardar el cambio, vuelve a esta vista y repite la búsqueda para ver el efecto.

{% hint style="info" %}
Algunos ajustes rigen al guardar y otros en el próximo entrenamiento del catálogo (por ejemplo, los sinónimos). Si el resultado no cambia enseguida, revisa en la sección del ajuste cuándo rige.
{% endhint %}

### Preguntar a Calvin

* **Preguntar**, en un paso, abre [**Pedile a Calvin**](https://academy.gopersonal.ai/guia-de-usuario/go-search/configuraciones/pedile-a-calvin.md) y le pide que explique ese paso en la búsqueda que estás mirando.
* **¿No es lo que esperabas? Preguntale a Calvin**, debajo de los resultados, le pregunta por qué la búsqueda muestra esos resultados.
* La barra **Preguntale o pedile un cambio sobre el buscador…**, arriba de la vista, envía cualquier pregunta o pedido a Calvin.

Calvin recibe la búsqueda que estás mirando, así que puedes pedirle un cambio sobre ella sin volver a escribirla.

## Lo que ve el cliente

A la derecha del recorrido, **Lo que ve el cliente** muestra los resultados en el orden en que los vería tu cliente, con el título **Primeros resultados para “…” · N en total**. Cada producto muestra su posición, imagen, nombre, marca y precio. Si hay más resultados, **Ver más** carga los siguientes.

### Por qué aparece cada resultado

Debajo de cada producto pueden aparecer etiquetas que explican por qué está ahí o por qué está en esa posición:

| Etiqueta                 | Qué significa                                                                             |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| **rescatado por nombre** | El filtro lo dejaba afuera, pero se llama como la búsqueda y lo sumó el paso 12.          |
| **filtro aflojado**      | Apareció porque se aflojó un filtro al quedar pocos resultados (paso 13).                 |
| **nombre coincide**      | La búsqueda está en su nombre y subió por los ajustes finos de orden (paso 15).           |
| **atributo pedido**      | Tiene el atributo que pidió la búsqueda y subió por los ajustes finos de orden (paso 15). |
| **subido por regla …**   | Lo subió una regla de negocio (paso 16). La etiqueta incluye el nombre de la regla.       |
| **bajado por regla …**   | Lo bajó una regla de negocio (paso 16). La etiqueta incluye el nombre de la regla.        |
| **fijado**               | Está fijado arriba para esta búsqueda (paso 18).                                          |

**Ejemplo:** buscas "colágeno" y el tercer resultado es unas gomitas con la etiqueta **rescatado por nombre**. Eso indica que el producto está cargado en otra categoría (por ejemplo, "Golosinas") y que el filtro de tipo lo había dejado afuera.

## Como lo vería el cliente

Después de probar una búsqueda, la fila **Como lo vería el cliente:** te deja repetir lo que haría un cliente en la página de resultados:

* Orden: elige **Más relevantes**, **Menor precio**, **Mayor precio**, **Más nuevos**, **Más populares** o **Más vendidos**.
* Precio: completa **Desde** y **Hasta**.
* Filtros: hasta cuatro filtros laterales de la búsqueda, con sus valores. Si un filtro tiene muchos valores, **Ver N más** muestra el resto.
* **Limpiar**: quita los filtros y el rango de precio elegidos.
* **Ver puntaje**: muestra el puntaje de cada producto junto al precio.

Estos controles cambian la lista de **Lo que ve el cliente**. El recorrido paso a paso sigue mostrando la búsqueda tal como se escribió.

### Copiar link a la tienda

Haz clic en **Copiar link a la tienda** para copiar un link que abre esa búsqueda en una página de resultados del buscador de tu proyecto. Aparece el aviso **Se copió el link**. Puedes pegarlo en un mail o en un chat para que otra persona vea los mismos resultados.
