Configuración

Search incluye varias configuraciones que te permiten ajustar su comportamiento.
Cuando cambias una configuración, se desencadena un análisis de tus datos que debe completarse antes de que los cambios tengan efecto.
Este proceso puede tardar hasta 15 minutos, pero puede ser más rápido dependiendo del tamaño de tu catálogo. Puedes monitorizar el estado en Data > Configuration.
Puedes acceder a la configuración en Search > Configuration.
Searchable attributes #
Elige qué atributos de producto pueden buscar los compradores y cuán relevante es cada atributo para la coincidencia.
Busca un atributo en Searchable attributes y selecciona su Search relevance:
| Relevance | Efecto |
|---|---|
| High | Da mayor relevancia a las coincidencias en este atributo. |
| Medium | Usa la relevancia normal. |
| Low | Da menor relevancia a las coincidencias en este atributo. |
| Not searchable | Excluye su texto de las coincidencias de búsqueda. |
Por ejemplo, configura brand y _category_name en High cuando estos sean importantes para tu catálogo. Usa una relevancia menor para textos secundarios. Evita poner todos los atributos en High para que la popularidad del producto aún ayude a clasificar resultados.
Usa Not searchable para campos como identificadores internos o valores de margen que necesitas para mostrar o filtrar pero no quieres que los compradores busquen.
Wildcard rules #
Wildcard rules pueden mantener grupos de atributos fuera de la búsqueda. Elige Create a rule para un patrón como *url o child*. Las filas marcadas Rule muestran estos patrones. Usa Edit en una regla para cambiarla.
Para patrones más específicos, *_url hace coincidencia con atributos que terminan en _url, y child_* con atributos que empiezan con child_.
Sortable attributes #
Agrega los atributos de producto que quieras que estén disponibles para ordenar resultados. Esta sección sigue a Searchable attributes.
Filterable attributes #
Los atributos en esta lista estarán disponibles como filtros/facetas en Search, Omnisearch y Merchandising. Si un atributo de producto no aparece cuando configuras facetas o creas una regla de Merchandising, agrégalo aquí y espera a que termine el análisis de configuración.
- Agrega atributos desde la lista de atributos de producto disponibles.
- Los cambios pueden tardar hasta 15 minutos en aplicarse dependiendo del tamaño del catálogo.
Exact Match Behaviour #
Por defecto, Clerk.io devuelve todos los resultados relevantes para búsquedas en tu sitio. Sin embargo, en casos específicos —como buscar un número SKU o EAN— podrías esperar sólo una coincidencia.
Requiere Search v3: Esta función solo está disponible para tiendas que usan Search v3. Puedes comprobarlo en Settings > Features > Early access features.
Al incluir atributos en esta lista, configuras Clerk.io para devolver un solo resultado cuando la consulta coincida con un valor en esos atributos. Esto también desactiva la autocorrección para asegurar que solo se muestre la coincidencia exacta.
Los más comunes son sku y ean, pero se pueden usar cualquier atributo sincronizado.
Al agregar un atributo tienes dos opciones:
- Devolver una sola coincidencia exacta, ideal para identificadores únicos como SKUs o IDs de producto donde quieres devolver un producto específico.
- Devolver múltiples coincidencias exactas, ideal para atributos como IDs de categoría, donde muchos productos comparten el mismo valor.
Facet Price Buckets #
Aquí puedes definir el rango de precios que se usará en los filtros de Search. Si lo dejas vacío, Clerk.io los calculará dinámicamente según el rango de precios de los datos de tus productos.
Ingresa precios separados por comas en Add buckets, por ejemplo 0,50,100,150,200. Déjalo vacío para calcular los rangos dinámicamente a partir de los datos de productos.
Custom dictionary #
El custom dictionary te permite definir términos de búsqueda que de otra forma serían tratados como palabras separadas en vez de un solo concepto.
Ingresa un término en Add term y haz clic en Add. Puedes ingresar varios términos separados por comas.
Por ejemplo, si tu catálogo incluye productos de la marca de zapatillas D.A.T.E., podrías querer añadir “D.A.T.E.” y “D. A. T. E.” al custom dictionary.
Criteria #
Clerk.io detecta una consulta como identificador único cuando:
- Es alfanumérica e incluye al menos uno de los siguientes caracteres: “-+/&_.0123456789”.
- Tiene al menos 4 caracteres.
- No contiene espacios ni comillas.
Si Clerk.io encuentra una sola coincidencia exacta en cualquiera de los atributos identificadores únicos, ese producto se devuelve inmediatamente, reemplazando cualquier configuración personalizada de búsqueda o reglas de merchandising. De lo contrario, la consulta se trata como una búsqueda normal.
Settings override #
Settings override te permite ajustar configuraciones avanzadas del índice de Search añadiendo un objeto JSON en Search > Configuration.
Estas configuraciones controlan cómo Clerk.io lee, clasifica, filtra, ordena y devuelve los resultados de búsqueda. Son configuraciones avanzadas y normalmente sólo deberían cambiarse cuando sabes exactamente qué comportamiento de Search quieres modificar.
Al cambiarlas puedes afectar todos los resultados de Search para la tienda. Un pequeño error tipográfico en el JSON también puede impedir que se guarde la configuración.
Configuración avanzada: Usa Settings override con cuidado. Si no estás seguro de que necesitas un override, contacta con el soporte de Clerk.io antes de cambiarlo.
Store-specific attributes #
Atributos como brand, color, size, sku, price o campos de categorías personalizados dependen de los datos sincronizados en cada tienda.
Esto significa que displayedAttributes, filterableAttributes, searchableAttributes y sortableAttributes pueden variar entre tienda y tienda.
Los atributos que comienzan con un guion bajo, como _all_categories, _category_name o _price_range, son generados por Clerk.io y están disponibles para todas las tiendas.
Example #
El ejemplo a continuación muestra la estructura de un Settings override. Es probable que tu tienda use atributos distintos.
{
"displayedAttributes": [
"_all_categories",
"_category_name",
"_price_range",
"brand",
"categories",
"description",
"id",
"image",
"name",
"price",
"stock",
"url"
],
"searchableAttributes": [
"high_relevance",
"medium_relevance",
"low_relevance"
],
"filterableAttributes": [
"_all_categories",
"_category_name",
"_price_range",
"brand",
"categories",
"price",
"stock"
],
"sortableAttributes": [
"created_at",
"name",
"price"
],
"rankingRules": [
"sort",
"words",
"typo",
"attribute",
"proximity",
"clerk.popularity:desc"
],
"stopWords": [],
"nonSeparatorTokens": [],
"separatorTokens": [],
"dictionary": [],
"synonyms": {},
"distinctAttribute": null,
"proximityPrecision": "byAttribute",
"typoTolerance": {
"enabled": true,
"minWordSizeForTypos": {
"oneTypo": 3,
"twoTypos": 8
},
"disableOnWords": [],
"disableOnAttributes": [
"high_relevance.id",
"high_relevance.sku"
],
"disableOnNumbers": false
},
"faceting": {
"maxValuesPerFacet": 100,
"sortFacetValuesBy": {
"*": "alpha"
}
},
"pagination": {
"maxTotalHits": 1000000
},
"embedders": {},
"searchCutoffMs": null,
"localizedAttributes": null,
"facetSearch": true,
"prefixSearch": "indexingTime"
}
Available settings #
displayedAttributes controla qué atributos puede devolver Clerk.io en los resultados de Search.
Úsalo cuando quieras que los resultados de Search incluyan sólo los campos que necesitan tus diseños, respuestas de API o lógica frontend.
searchableAttributes controla qué atributos se buscan cuando un visitante escribe una consulta.
El orden importa. Los atributos más arriba en la lista se consideran más importantes para la relevancia del texto.
filterableAttributes controla qué atributos pueden usarse para filtros, facetas y reglas que acotan los resultados.
Agrega un atributo aquí si debe ser seleccionable como faceta o usable en la lógica de filtrado. Los atributos de producto específicos de la tienda deben existir en tus datos sincronizados antes de poder usarse.
sortableAttributes controla por qué atributos se pueden ordenar los resultados de Search.
Agrega campos como price, created_at o name si quieres usarlos en la ordenación.
rankingRules controla el orden de reglas de relevancia usadas para clasificar los resultados coincidentes.
Las reglas al principio tienen mayor influencia. Reglas personalizadas como clerk.popularity:desc pueden usarse para destacar productos populares tras los chequeos de relevancia previos.
stopWords lista palabras que deben ignorarse en las consultas de búsqueda.
Esto puede ser útil para palabras muy comunes que no ayudan a los compradores a encontrar productos, como “el” o “y”.
nonSeparatorTokens lista caracteres que no deben dividir una palabra.
Por ejemplo, añadir @ puede ayudar a que Clerk.io trate un término que contenga ese carácter como un solo valor conectado.
separatorTokens lista caracteres que deben dividir palabras.
Úsalo cuando tus datos de producto contengan caracteres que claramente deben dividir un término de otro.
dictionary lista términos que deben ser tratados como una sola palabra o concepto.
Esto es útil para marcas, abreviaturas o términos de producto que normalmente se dividen en varias partes.
synonyms mapea un término de consulta a palabras o frases equivalentes.
Usa sinónimos cuando los compradores suelen buscar diferentes palabras que significan lo mismo en tu catálogo.
distinctAttribute agrupa resultados por un atributo compartido y devuelve un resultado por valor único.
Esto es útil cuando las variantes se indexan como productos separados, pero solo deseas un resultado por producto padre o grupo.
proximityPrecision controla cuán estrictamente se evalúa la cercanía entre palabras.
byWord compara la distancia exacta entre palabras coincidentes. byAttribute comprueba si las palabras coincidentes aparecen en el mismo atributo.
typoTolerance controla cómo Search maneja errores de escritura.
Puedes activar o desactivar la tolerancia a errores, establecer la longitud mínima de palabra para uno o dos errores, y desactivar la tolerancia para palabras, atributos o números específicos.
faceting controla cómo se devuelven los valores de faceta.
maxValuesPerFacet establece cuántos valores puede devolver cada faceta. sortFacetValuesBy controla si los valores de las facetas se ordenan alfabéticamente o por conteo de resultados.
pagination controla el número máximo de resultados que Search puede devolver para una consulta.
maxTotalHits es el límite máximo disponible para resultados paginados.
embedders está reservado para configuraciones avanzadas de búsqueda semántica.
Déjalo vacío a menos que el soporte de Clerk.io te haya indicado configurarlo.
searchCutoffMs establece un tiempo máximo, en milisegundos, que Search puede invertir en una consulta antes de devolver los mejores resultados encontrados hasta el momento.
Usa null para mantener el comportamiento predeterminado.
localizedAttributes puede definir el manejo específico de idioma para patrones de atributos coincidentes.
Déjalo en null a menos que tu tienda tenga una configuración multilingüe específica.
facetSearch controla si se puede buscar dentro de los valores de faceta.
Cuando está activo, los compradores e integraciones pueden buscar dentro de valores de facetas, como encontrar una marca específica dentro de un filtro de marcas extenso.
prefixSearch controla si las palabras parciales pueden coincidir mientras un comprador escribe.
indexingTime activa la coincidencia por prefijo para un comportamiento rápido de búsqueda-en-escritura. disabled desactiva la coincidencia por prefijo.
Esta página ha sido traducida por una IA útil, por lo que puede contener errores de idioma. Muchas gracias por su comprensión.