Configuración

Search viene con varios ajustes que te permiten modificar su comportamiento.

Cuando cambias una configuración, esto desencadena un análisis de tus datos que debe completarse antes de que los cambios surtan 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.

Las configuraciones requieren que Search 3.0 esté habilitado. Después, puedes acceder a ellas en Search > Configuration.

Relevancia de atributos en la búsqueda #

Esta sección te permite personalizar tu búsqueda según tus necesidades. Aquí tienes dos opciones: Clasificación de atributos buscables y Atributos no buscables.

Clasificación de atributos buscables #

La configuración Searchable attributes grouped by ranking order te permite crear grupos de atributos con diferentes niveles de importancia para los resultados de búsqueda. Los atributos en grupos de mayor rango tienen mayor influencia en los resultados mostrados.

Por ejemplo, si el grupo 1 contiene "brand" y _category_name, mientras que el grupo 2 contiene name y color, una búsqueda de “botas Nike azules” priorizará los productos con la marca “Nike” en la categoría “Botas” por encima de los artículos que contengan esas palabras en su atributo name.

Esta priorización ayuda a destacar datos significativos como géneros, especificaciones u otros atributos clave.

Por ejemplo, en librerías, a menudo es más relevante priorizar el autor de un libro. Una búsqueda de “Stephen” debería priorizar los libros de Stephen King por encima de libros que incluyan “Stephen” en sus títulos.

Aviso: Ten cuidado al modificar estos grupos. Agregar demasiados atributos puede hacer que Clerk.io reduzca la prioridad de la popularidad de los productos, enfocándose solo en la relevancia textual.

Atributos no buscables #

Esta sección te permite excluir atributos del índice de búsqueda, lo que significa que su texto no será buscable. Esto es útil para cosas como identificadores internos, valores de margen, o cualquier dato que quieras usar para mostrar o filtrar, pero que no quieres que los clientes busquen.

Por defecto, los atributos price y stock están en la lista para evitar que las búsquedas que contengan números se vean afectadas por estos atributos. Puedes personalizar esta lista según sea necesario.

Puedes agregar atributos no buscables de dos formas:

• Manualmente desde la lista de atributos disponibles.
• Usando reglas si tienes un patrón de atributos con nombres similares.

Las reglas son especialmente útiles si deseas excluir varios atributos de una vez. Solo usa el comodín (*):

• *_url coincidirá con todos los atributos que terminen en _url
• child_* coincidirá con todos los atributos que comiencen con child_

Atributos filtrables #

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 finalice el análisis de la configuración.

• Agrega atributos desde la lista de atributos de producto disponibles.
• Los cambios pueden tardar hasta 15 minutos dependiendo del tamaño del catálogo.

Comportamiento de coincidencia exacta #

Por defecto, Clerk.io muestra todos los resultados relevantes para las búsquedas en tu sitio. Sin embargo, en ciertos casos—como buscar un SKU o un número EAN—puedes esperar solo una coincidencia.

Requiere Search v3: Esta función solo está disponible para Stores que usan Search v3. Puedes comprobarlo en Settings > Features > Early access features.

Al incluir atributos en esta lista, configuras Clerk.io para devolver un único resultado cuando la consulta coincide con un valor en esos atributos. Esto también desactiva la autocorrección para garantizar 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 deseas mostrar un producto específico.
• Devolver varias coincidencias exactas, ideal para atributos como IDs de categoría, donde muchos productos comparten el mismo valor.

Intervalos de precio en facetas #

Aquí puedes definir el rango de precios que se usará en los filtros de Search. Si lo dejas en blanco, Clerk.io los calculará dinámicamente basándose en el rango de precios de tus productos.

En el campo de texto puedes introducir una lista separada por comas de valores de precio, por ejemplo: 0,50,100,150,200,…

Diccionario personalizado #

El diccionario personalizado te permite definir términos de búsqueda que normalmente serían tratados como palabras separadas en lugar de un solo concepto.

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 diccionario personalizado.

Criterios #

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 única coincidencia exacta en cualquiera de los atributos de identificador único, ese producto se devuelve inmediatamente, ignorando cualquier regla de búsqueda personalizada o de merchandising. En caso contrario, la consulta se trata como una búsqueda normal.

Ajustes avanzados #

Settings override te permite ajustar configuraciones avanzadas del índice de Search agregando un objeto JSON en Search > Configuration.

Estos ajustes controlan cómo Clerk.io lee, clasifica, filtra, ordena y devuelve los resultados de búsqueda. Son configuraciones avanzadas y normalmente solo deberían cambiarse si sabes exactamente el comportamiento de Search que deseas personalizar.

Cambiar esto puede afectar todos los resultados de Search para la Store. Un pequeño error tipográfico en el JSON también puede impedir que se guarde el ajuste.

Configuración avanzada: Usa Settings override con precaución. Si no estás seguro de que necesitas un override, contacta con el soporte de Clerk.io antes de cambiarlo.

Atributos específicos de la Store #

Atributos como brand, color, size, sku, price, o campos de categoría personalizados dependen de los datos sincronizados con cada Store.

Esto significa que displayedAttributes, filterableAttributes, searchableAttributes y sortableAttributes pueden variar de una Store a otra.

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 Stores.

Ejemplo #

El ejemplo a continuación muestra la estructura de un Settings override. Probablemente tu Store usará diferentes atributos.

{
  "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"
}

Configuraciones disponibles #

displayedAttributes controla qué atributos puede devolver Clerk.io en los resultados de Search.

Úsalo cuando quieras que los resultados de Search incluyan solo los campos que necesitas para tus diseños, respuestas de API o lógica del frontend.

searchableAttributes controla qué atributos se buscan cuando un visitante escribe una consulta.

El orden importa. Los atributos antes en la lista se consideran más importantes para la relevancia textual.

filterableAttributes controla qué atributos pueden usarse para filtros, facetas y reglas que acoten los resultados.

Agrega un atributo aquí si debe ser seleccionable como faceta o utilizable en lógica de filtrado. Los atributos específicos de producto deben existir en tus datos sincronizados antes de poder utilizarlos.

sortableAttributes controla por qué atributos pueden ordenarse los resultados de Search.

Agrega campos como price, created_at o name si deseas utilizarlos para ordenar.

rankingRules controla el orden de reglas de relevancia usadas para clasificar los resultados coincidentes.

Las reglas más arriba tienen la influencia más fuerte. Reglas personalizadas como clerk.popularity:desc pueden usarse para que los productos populares se muestren antes tras las comprobaciones previas de relevancia.

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, agregar @ puede ayudar a Clerk.io a tratar un término que contiene ese carácter como un solo valor conectado.

separatorTokens lista caracteres que deben dividir palabras.

Úsalo cuando tus datos de producto contengan caracteres que deban separar claramente un término de otro.

dictionary lista términos que deben tratarse como una sola palabra o concepto.

Esto es útil para nombres de marca, abreviaturas o términos de producto que normalmente se dividirían en varias partes.

synonyms relaciona un término de consulta con palabras o frases equivalentes.

Utiliza sinónimos cuando los compradores busquen a menudo diferentes palabras que signifiquen lo mismo en tu catálogo.

distinctAttribute agrupa resultados por un atributo común y devuelve un resultado por cada valor único.

Esto es útil cuando las variantes se indexan como productos separados, pero solo quieres un resultado por producto principal o grupo.

proximityPrecision controla cuán estrictamente se evalúa la cercanía de palabras.

byWord compara la distancia exacta entre palabras coincidentes. byAttribute verifica si las palabras coincidentes aparecen en el mismo atributo.

typoTolerance controla cómo Search maneja los errores ortográficos.

Puedes activar o desactivar la tolerancia de errores, establecer la longitud mínima de la palabra para uno o dos errores, y desactivar la tolerancia de errores para palabras, atributos o números específicos.

faceting controla cómo se devuelven los valores de las facetas.

maxValuesPerFacet establece cuántos valores puede devolver cada faceta. sortFacetValuesBy controla si los valores de faceta se ordenan alfabéticamente o por número de resultados.

pagination controla el número máximo de resultados que Search puede devolver para una consulta.

maxTotalHits es el límite superior 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 aconseje configurarlo.

searchCutoffMs establece un tiempo máximo, en milisegundos, que Search puede gastar 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 por idioma para patrones de atributos coincidentes.

Déjalo como null a menos que tu Store tenga una configuración específica de indexación multilingüe.

facetSearch controla si se puede buscar dentro de los valores de faceta.

Cuando está activado, los compradores y las integraciones pueden buscar dentro de los valores de las facetas, como encontrar una marca específica dentro de un filtro largo de marcas.

prefixSearch controla si las palabras parciales pueden coincidir mientras el comprador escribe.

indexingTime activa la coincidencia de prefijo para un comportamiento más rápido de búsqueda a medida que se escribe. disabled desactiva la coincidencia de prefijos.