How Product Logics Work

Clerk está construido alrededor de una potente API que ofrece muchas formas diferentes de mostrar resultados a los clientes. Estas se llaman Product Logics y ofrecen diversas funcionalidades adaptadas a distintos casos de uso.

Este artículo explica las lógicas disponibles para Email y cómo funcionan.

Los nombres de estos Product Logics coinciden con lo que ves en el backend de my.clerk.io al usar Content. Cada uno de ellos tiene un Endpoint correspondiente en la API de Clerk, que puedes consultar en nuestra documentación para desarrolladores utilizando los enlaces que se proporcionan a continuación.

Best Sellers #

Endpoint: recommendations/popular

Muestra los productos más populares en tu tienda, específicamente aquellos que han sido incluidos en más pedidos durante un período prolongado. La cantidad del mismo producto en cada pedido no afecta a este ranking. Generalmente permanece igual durante períodos largos, siempre que mantengas los mismos productos en stock.

Hot Products #

Endpoint: recommendations/trending

Destaca artículos que han experimentado un aumento reciente en ventas. No existe un marco temporal fijo; en cambio, se calcula dinámicamente en función de los cambios en las ventas de productos. Por ejemplo, si un producto normalmente se vende tres veces por semana y de pronto se vende 20 veces en dos días, se identifica como trending.

Newest Products #

Endpoint: recommendations/new

Muestra los artículos que se han añadido más recientemente a tu tienda, mostrando primero los más nuevos. Requiere que los productos cuenten con el atributo “age” o “created_at” disponible.

Best Sellers In Category #

Endpoint: recommendations/category/popular

Muestra los productos más populares dentro de una categoría específica.

Hot Product In Category #

Endpoint: recommendation/category/trending

Destaca los productos que han experimentado recientemente un aumento en ventas dentro de una categoría específica.

Newest Products In Category #

Endpoint: recommendations/category/new

Muestra los productos más recientes añadidos a una categoría específica, ordenados primero por los más nuevos. Esto requiere que los productos cuenten con el atributo “age” o “created_at”.

Best Alternative Products #

Endpoint: recommendations/substituting

Muestra los artículos más similares al producto que se está viendo, ordenados por popularidad. Compara productos según atributos disponibles como name, brand, category, price y otros datos relevantes.

Fallbacks #

Si se proporciona un ID de producto desconocido, se mostrarán Visitor Recommendations. Si el visitante es desconocido, se mostrarán Best Sellers.

Best Cross-Sell Products #

Endpoint: recommendations/complementary

Muestra los artículos que es más probable que se compren junto con el producto visto. Considera productos que suelen comprarse juntos y aquellos que probablemente se complementen, como un cinturón con unos pantalones.

Lo hace analizando los patrones de compra habituales para mostrar recomendaciones adecuadas, incluso para productos que aún no se han comprado juntos.

Ejemplo: si es normal comprar un par de botas de fútbol y espinilleras de la misma marca y color, Clerk dará prioridad a estos pares para todas las marcas y colores, incluso si aún no se han vendido juntos.

Fallbacks #

Si se proporciona un ID de producto desconocido, se mostrarán Visitor Recommendations. Si el visitante es desconocido, se mostrarán Best Sellers.

Most Sold With #

Endpoint: recommendations/most_sold_with

Identifica los productos que se han comprado con mayor frecuencia junto con cualquier producto o conjunto de productos dado. Esta lógica es más simple que Best Cross-Sell Products, ya que solo cuenta los artículos que se han vendido con el/los producto(s) especificado(s), sin hacer predicciones.

Recommendations Based On Keywords #

Endpoint: recommendations/keywords

Muestra los productos que coinciden con una palabra clave o frase específica, ordenados según su desempeño en ventas.

Specific Products #

No tiene endpoint ya que es exclusivo de my.clerk.io.

Muestra exactamente los productos especificados. Si en algún momento el Number of products es mayor que el producto seleccionado, los resultados se complementarán con Best Sellers.

Esto también ocurre si algunos productos seleccionados se eliminan de Clerk, como cuando se quedan sin stock.

Esta lógica no se ve afectada por Merchandising porque devuelve exactamente los productos que seleccionas, sin lógica adicional.

Visitor Recommendations #

Endpoint: recommendations/visitor/complementary

Muestra los productos que es más probable que un visitante compre en función de su navegación reciente. Combina recomendaciones de cross-sell y alternativas para encontrar las mejores opciones para cada visitante.

Fallbacks #

Si el visitante es desconocido, se mostrarán Best Sellers.

Visitor Alternatives #

Endpoint: recommendations/visitor/substituting

Muestra productos similares que probablemente compre un visitante, según su historial de navegación reciente.

Fallbacks #

Si el visitante es desconocido, se mostrarán Best Sellers.

Visitor Click History #

Endpoint: recommendations/visitor/history

Muestra exactamente los productos en los que un visitante ha hecho click.

Esta lógica no se ve afectada por Merchandising porque refleja el historial de clicks del visitante sin lógica adicional.

Fallbacks #

Se mostrarán Best Sellers cuando el visitante sea desconocido.

Recommendations Based On Orders #

Endpoint: recommendations/customer/complementary

Muestra los productos que un cliente tiene más probabilidades de comprar, basándose en compras pasadas. Combina cross-sell y alternativas para encontrar las mejores recomendaciones.

Fallbacks #

Si el cliente es desconocido, se mostrarán Visitor Recommendations. Si el visitante es desconocido, se mostrarán Best Sellers.

Similar To Order History #

Endpoint: recommendations/customer/substituting

Muestra artículos similares que un cliente tiene más probabilidades de comprar, basándose en compras anteriores.

Fallbacks #

Si el cliente es desconocido, se mostrarán Visitor Recommendations. Si el visitante es desconocido, se mostrarán Best Sellers.

Customer Order History #

Endpoint: recommendations/customer/history

Muestra los productos exactos que un cliente ha comprado.

Esta lógica no se ve afectada por Merchandising porque refleja el historial de compras del cliente sin lógica adicional.

Fallbacks #

Se mostrarán Best Sellers cuando el visitante sea desconocido.

What Customers Look At Right Now #

Endpoint: recommendations/currently_watched

Muestra los productos en los que han hecho click más recientemente los visitantes del sitio web.

Esta lógica no se ve afectada por Merchandising porque refleja la actividad de clicks en todo el sitio sin lógica adicional.

Recently Purchased Products #

Endpoint: recommendations/recently_bought

Muestra los artículos adquiridos más recientemente por cualquier cliente en el sitio web.

Esta lógica no se ve afectada por Merchandising porque refleja la actividad de compras en todo el sitio sin lógica adicional.

Best Page Alternatives #

Endpoint: recommendations/page/substituting

Sugiere páginas similares a la que se está visualizando actualmente. Analiza el cuerpo de texto de cada página para identificar palabras clave asociadas con otras páginas relevantes.

Pages Related To A Product #

Endpoint: recommendations/page/product

Encuentra las páginas que mejor coinciden con el producto que se está visualizando. Analiza los datos del producto y los compara con las páginas que mencionan el producto o conceptos relacionados.

Pages Related To A Category #

Endpoint: recommendations/page/category

Encuentra las páginas que mejor coinciden con la categoría que se está visualizando. Analiza los datos de la categoría y los compara con las páginas que mencionan la categoría o conceptos relacionados.

Products Related To A Page #

Endpoint: recommendations/page/related_products

Muestra los productos que mejor coinciden con la página que se está visualizando, ordenados por popularidad. Analiza el texto de la página para identificar palabras clave relevantes para productos específicos.

Categories Related To A Page #

Endpoint: recommendations/page/related_categories

Encuentra las categorías que mejor coinciden con la página que se está visualizando, ordenadas por la popularidad de los productos dentro de ellas. Analiza el texto de la página para encontrar palabras clave asociadas a categorías específicas.