Configuración

Search viene con varias configuraciones que te permiten ajustar su comportamiento.

Cuando cambias una configuración, esto desencadena un análisis de tus datos que debe completarse antes de que los cambios tengan efecto.

Este proceso puede tomar hasta 15 minutos, pero puede ser más rápido dependiendo del tamaño de tu catálogo. Puedes monitorear el estado en Data > Configuration.

Estas configuraciones requieren que Search 3.0 esté habilitado. Después, podrás acceder a ellas en Search > Configuration.

Relevancia de atributos de búsqueda #

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

Orden de clasificación de atributos buscables #

La configuración Atributos buscables agrupados por orden de clasificación 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” sobre los artículos con esas palabras en su atributo name.

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

Por ejemplo, en las 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 sobre libros que incluyan “Stephen” en sus títulos.

Aviso: Ten cuidado al modificar estos grupos. Agregar demasiados atributos puede causar que Clerk.io de priorice la popularidad del producto, enfocándose solo en la relevancia del texto.

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 IDs internos, valores de margen, o cualquier dato que quieras usar para visualización o filtrado, 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 contienen números se vean afectadas por estos atributos. Puedes personalizar esta lista según sea necesario.

Puedes agregar atributos no buscables de dos maneras:

• 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 quieres excluir varios atributos a la 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 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.

Comportamiento de coincidencia exacta #

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

Se requiere Search v3: Esta función solo está disponible para las 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 solo resultado cuando la búsqueda 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 productos cuando deseas mostrar un producto específico.
• Devolver múltiples coincidencias exactas, ideal para atributos como IDs de categoría, donde muchos productos comparten el mismo valor.

Intervalos de precios por faceta #

Aquí puedes definir el rango de precios que se utilizará en los filtros de Search. Si lo dejas en blanco, Clerk.io los calculará dinámicamente en función del rango de precios de los datos de tus productos.

En el campo de texto puedes introducir una lista de valores de precio separados por comas, 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 vez de como un solo concepto.

Por ejemplo, si tu catálogo incluye productos de la marca de zapatillas D.A.T.E., tal vez quieras añadir “D.A.T.E.” y “D. A. T. E.” al diccionario personalizado.

Criterios #

Clerk.io detecta una búsqueda como identificador único cuando:

• Tiene caracteres alfanuméricos e incluye al menos uno de los siguientes: “-+/&_.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, ignorando cualquier regla de búsqueda o de merchandising personalizada. En caso contrario, la búsqueda se trata como una búsqueda regular.

Sobrescribir configuración #

La opción de sobrescribir configuración te permite ajustar configuraciones avanzadas del índice de Search agregando 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 solo deben cambiarse si sabes exactamente qué comportamiento de Search deseas ajustar.

Cambiar estos valores puede afectar todos los resultados de Search para la Store. Un pequeño error de tipeo en el JSON también puede impedir que se guarde la sobrescritura.

Configuración avanzada: Usa la sobrescritura de configuración con cuidado. Si no estás seguro de si es necesaria una sobrescritura, contacta al soporte de Clerk.io antes de cambiarla.

Atributos específicos de la Store #

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

Esto significa que displayedAttributes, filterableAttributes, searchableAttributes y sortableAttributes pueden verse diferentes 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 siguiente ejemplo muestra la estructura de una sobrescritura de configuración. Es probable que tu Store use 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 la búsqueda incluyan solo los campos necesarios por 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 al principio de 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 utilizable en lógica de filtrado. Los atributos específicos de producto de la Store deben existir en tus datos sincronizados antes de que puedan usarse.

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

Agrega campos como price, created_at o name si los quieres usar para ordenar.

rankingRules controla el orden de las 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 promover productos populares después de las comprobaciones previas de relevancia.

stopWords lista palabras que deben ignorarse en las búsquedas.

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 separar 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 separar palabras.

Úsalo cuando tus datos de productos contengan caracteres que deben dividir 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 marcas, abreviaturas o términos de productos que normalmente se separan en varias partes.

synonyms asigna un término de búsqueda 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 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 las 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 los errores ortográficos.

Puedes habilitar o deshabilitar la tolerancia de 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 facetas.

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

pagination controla la cantidad máxima 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 el tiempo máximo, en milisegundos, que Search puede dedicar a una consulta antes de devolver los mejores resultados encontrados hasta ese 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 de indexación multilingüe específica.

facetSearch controla si los valores de faceta pueden buscarse.

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

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

indexingTime activa la coincidencia de prefijos para un comportamiento de búsqueda mientras escribes más rápido. disabled desactiva la coincidencia de prefijos.