Filters

Interfaz de filtros #

Los filtros se pueden utilizar para cada Contenido con el fin de limitar los resultados según los atributos de producto.

Encontrarás esta opción en cada Contenido que crees para Recommendations, Search o Email, en Content type > Product filters.

Cada parte del filtro consta de lo siguiente:

• Un atributo por el que filtrar
• Una comparación que decide cómo se debe comparar el atributo con el valor
• Un valor que determina con qué se debe comparar el atributo

Puedes crear filtros basados en cualquier atributo de producto que envíes a Clerk. Los operadores de comparación disponibles dependen del tipo de atributo por el que filtres.

Ejemplo: price contiene un número, lo que significa que puedes usar tanto mayor que, menor que y otras comparaciones numéricas, mientras que los atributos de texto/cadena como name solo permiten comparaciones booleanas como es o no es.

Al crear filtros, la interfaz te mostrará cuántos productos coinciden con el filtro y el string de filtro generado.

Filtros simples #

Estos contienen solo un atributo y una comparación. Un ejemplo es mostrar solo productos por debajo de €400:

Conjuntos de filtros #

Estos te permiten reducir la selección de productos agregando múltiples filtros dentro del mismo conjunto. Puedes hacer esto haciendo clic en el icono "+" dentro de un filtro existente y agregando uno nuevo.

Dentro de un conjunto, puedes elegir entre dos lógicas de filtrado:

• AND solo muestra productos que cumplen todos los filtros del conjunto.
• OR muestra productos que cumplen al menos uno de los filtros del conjunto.

Ejemplo: Quieres mostrar solo productos que estén por debajo de €400 y además en oferta.

Combinando conjuntos #

Puedes combinar conjuntos de filtros para que funcionen juntos mediante diferentes condiciones. En lugar de agregar filtros dentro de un conjunto existente, haz clic en "+ Add filter" para iniciar un nuevo conjunto.

Cada conjunto de filtros funciona por separado, y puedes elegir cómo interactúan:

• AND solo muestra productos que cumplen todos los conjuntos.
• OR muestra productos que cumplen al menos uno de los conjuntos.

Ejemplo: Quieres mostrar productos que están por debajo de €400 Y en oferta, pero también de Vendor A O de una categoría específica.

• El primer conjunto asegura que los productos cumplan con las condiciones de precio y descuento.
• El segundo conjunto da flexibilidad incluyendo productos de ya sea un proveedor específico o una categoría.

String de filtro #

La interfaz de filtros crea automáticamente la sintaxis correcta según los datos disponibles en tus atributos. Ejemplo: si tus SKU están formateados como cadenas, como “GT-1234”, las comillas se agregan automáticamente al string de filtro.

sku = "GT-1234"

Si un atributo es un número, se agrega sin comillas.

price < 300

Si tienes problemas con el filtrado, revisa el string de filtro para asegurarte de que se esté usando la sintaxis correcta, y haz ajustes si es necesario.

Si tienes dudas, puedes ver qué tipo de datos tiene un atributo determinado (string, number, list, boolean) yendo a Data > Products y consultando cualquier producto.

Siempre puedes ajustar manualmente el string de filtro según tus necesidades haciendo clic en el icono lápiz junto a Filter expression.

Valores dinámicos de atributos #

Al crear filtros para campañas de Merchandising o Contenido que usa lógicas basadas en producto, puedes hacer referencia a los atributos del producto visualizado como valores dinámicos escribiendo {{ attribute_name }}.

En el momento de la evaluación, el marcador de posición se sustituye por el valor real del producto que se está visualizando. Por ejemplo, un filtro como type = {{ type }} asegura que los resultados solo incluyan productos con el mismo type que el que el visitante está viendo en ese momento.

Esto es especialmente útil cuando deseas que los filtros se adapten automáticamente sin codificar valores específicos. Puedes combinar valores dinámicos con otros filtros, por ejemplo type = {{ type }} junto con price < 500 para que coincidan solo productos del mismo tipo cuyo precio sea inferior a €500.

Los valores dinámicos de atributos solo funcionan cuando la solicitud incluye uno o más IDs de producto, como Best Cross-Sell y Best Alternatives en Recommendations.

Filtrado dinámico #

Filters se pueden agregar directamente a los códigos embed usando el atributo data-filter. Esto te permite hacer los filtros dinámicos cambiando los valores según la lógica del frontend.

A continuación, varios ejemplos comunes de cómo puedes utilizar el filtrado dinámico.

Límite de envío gratis #

Define una variable, por ejemplo, $free_shipping_limit, que contenga la cantidad restante que el cliente necesita para alcanzar el límite de envío gratis. Utiliza esto como filtro dinámico para mostrar solo productos por encima de ese precio:

<span class="clerk"
      data-template="@complementary-to-basket"
      data-filter="price > $free_shipping_limit">
</span>

Coincidencia de género #

Si tus productos contienen un atributo como gender que incluye female, male, kids, unisex, etc., puedes obligar a los elementos de Clerk a mostrar productos para el mismo género.

Define una variable, por ejemplo, $product_gender, que contenga el género del producto actualmente visualizado, y úsala para mostrar productos del mismo género:

<span class="clerk"
      data-template="@Bestsellers"
      data-filter="gender = $product_gender">
</span>

Categoría específica #

En este caso necesitas una lista en tu tienda con las categorías de producto, que podría definirse como $available_categories = [1,2,3,4,5]. Utiliza esto para filtrar sliders y mostrar solo productos dentro de esas categorías:

<span class="clerk"
      data-template="@type-slider"
      data-filter="categories in $available_categories">
</span>