Configuración

Search incluye varias configuraciones que te permiten ajustar su comportamiento.

Cuando cambias una configuración, se activa 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 monitorear el estado en Data > Configuration.

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

Searchable attributes #

Elige qué atributos de producto pueden buscar los compradores y qué fuerza tiene cada atributo al afectar la coincidencia.

Busca un atributo en Searchable attributes y elige su Search relevance:

Por ejemplo, configura brand y _category_name en High cuando estos sean importantes para tu catálogo. Usa menor relevancia para textos secundarios. Evita establecer todos los atributos en High para que la popularidad del producto siga influyendo en la clasificación de los resultados.

Usa Not searchable para campos como IDs internos o valores de margen que necesitas para mostrar u ordenar, pero que no deseas que los compradores puedan buscar.

Reglas de comodín #

Las reglas de comodín 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 coincide con atributos que terminan en _url y child_* con atributos que empiezan con child_.

Sortable attributes #

Agrega los atributos de producto que quieres que estén disponibles para ordenar los 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 según el tamaño del catálogo.

Exact Match Behaviour #

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 SKU o EAN— puedes esperar solo una coincidencia.

Search v3 requerido: 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 solo resultado cuando la consulta coincide exactamente 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 cualquiera de los atributos sincronizados.

Al agregar un atributo tienes dos opciones:

• Devolver una coincidencia exacta única, ideal para identificadores únicos como SKUs o IDs de producto donde deseas retornar 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 se deja en blanco, Clerk.io los calcula dinámicamente basándose en el rango de precios de tus productos.

Introduce precios separados por comas en Add buckets, por ejemplo 0,50,100,150,200. Déjalo vacío para calcular rangos dinámicamente a partir de los datos de productos.

Custom dictionary #

El diccionario personalizado te permite definir términos de búsqueda que de otro modo se tratarían como palabras separadas en lugar de un solo concepto.

Introduce un término en Add term y haz clic en Add. Puedes introducir varios términos separados por comas.

Por ejemplo, si tu catálogo incluye productos de la marca de zapatillas D.A.T.E., quizá desees agregar “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 sola coincidencia exacta en cualquiera de los atributos identificadores únicos, ese producto se devuelve de forma inmediata, reemplazando cualquier regla personalizada de búsqueda o merchandising. De lo contrario, la consulta se trata como una búsqueda regular.

Settings override #

Settings override 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 modificar.

Cambiar estos ajustes puede afectar todos los resultados de Search para la Store. Un pequeño error de escritura en el JSON puede impedir que se guarde la sobreescritura.

Configuración avanzada: Usa Settings override con precaución. Si no estás seguro de si es necesario, contacta al soporte de Clerk.io antes de hacer cambios.

Store-specific attributes #

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

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

Los atributos que empiezan 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 Settings override. Es probable que tu Store use otros 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 necesarios para tus diseños, respuestas de la 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 del texto.

filterableAttributes controla cuáles atributos pueden utilizarse en filtros, facetas y reglas que restrinjan resultados.

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

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

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

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

Las reglas en la parte superior tienen la mayor influencia. Pueden usarse reglas personalizadas como clerk.popularity:desc para mostrar productos populares arriba tras los controles de relevancia previos.

stopWords enumera palabras que deben ignorarse en las consultas de búsqueda.

Esto es útil para palabras muy comunes que no ayudan a los compradores, como “el” o “y”.

nonSeparatorTokens enumera caracteres que no deben separar una palabra.

Por ejemplo, agregar @ puede ayudar a Clerk.io a tratar un término con ese carácter como un solo valor.

separatorTokens enumera caracteres que deben dividir palabras.

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

dictionary enumera términos que deben tratarse 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 asigna un término de consulta a palabras o frases equivalentes.

Úsalo 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 están indexadas 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 las palabras coincidentes. byAttribute verifica si las palabras coincidentes aparecen en el mismo atributo.

typoTolerance controla cómo Search maneja los errores de escritura.

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

faceting controla cómo se devuelven los valores de faceta.

maxValuesPerFacet define cuántos valores puede devolver cada faceta. sortFacetValuesBy controla si los valores se ordenan alfabéticamente o por cantidad 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 haya instruido a 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 punto.

Usa null para mantener el comportamiento predeterminado.

localizedAttributes puede definir el manejo específico de lenguaje para patrones de atributos.

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

facetSearch controla si se pueden buscar los valores de las facetas.

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

prefixSearch controla si las coincidencias parciales se permiten mientras el comprador escribe.

indexingTime habilita la coincidencia por prefijo para una búsqueda tipo “search-as-you-type” más rápida. disabled desactiva la coincidencia por prefijo.