Documentación · Niveles y barras

Cómo basar una barra de progreso en importe, peso, cantidad o historial del cliente

Una barra fija lo que miden sus niveles (importe del carrito, peso, número de artículos, gasto o pedidos anteriores del cliente) y qué productos cuentan.

· Versión MarkdownEN · FR · ES · DE

Qué es una barra

Una barra es una medida, sobre un conjunto de productos, con sus niveles. En la instalación, la app solo crea las barras que necesitan los niveles importados de tus descuentos existentes: una barra por importe para un umbral de envío gratis o un importe mínimo, una barra por cantidad para un descuento «Compra X y llévate Y», y una barra por cada conjunto de productos al que se limita un descuento. Si no hay nada que importar, la tienda empieza con una sola barra sobre el importe del carrito, la clásica barra de envío gratis. Puedes añadir otras, por ejemplo una barra por cantidad junto a una barra por importe.

Los niveles de una misma barra la comparten: cambiar su alcance se aplica a todos. Cuando un nivel necesita su propio alcance, Duplicar para este nivel le da una copia de la barra. Un nivel Compra X, llévate Y siempre tiene su propia barra, que cuenta artículos. Cómo se ven varias barras en la tienda, lado a lado o apiladas, se ajusta en diseño. Apilada, cada barra puede mostrar su propio mensaje de éxito: consulta mensaje de éxito.

Añadir una barra

Hay dos caminos:

  • Desde un nivel: haz clic en la medida en la frase del nivel, luego en Crear una barra, o elige una en Barras de la tienda. La barra solo se crea al confirmar.
  • Desde la pestaña Barras: abre Niveles y descuentos, pestaña Barras, y luego Añadir una barra.

Después haz clic en Guardar. El Nombre de la barra solo se ve en la app.

Elegir la medida

La barra avanza según fija en qué se expresan los umbrales de los niveles. Las medidas se agrupan en dos: Carrito actual, visible para todos los visitantes, e Historial del cliente, solo para clientes con sesión iniciada.

Medida Lo que cuenta la barra
Importe El importe del carrito, para umbrales de gasto.
Cantidad El número de artículos.
Peso El peso del carrito, en la unidad de peso de la barra: kg, g, lb u oz (la de tu tienda por defecto).
Total gastado Todo lo que el cliente ha gastado desde su primer pedido, más el carrito actual.
Pedidos anteriores El número de pedidos que el cliente ya ha realizado. El carrito actual no cuenta.

Cambiar la medida de una barra conserva los números de los umbrales de sus niveles: un nivel de 20 € pasa a ser un nivel de 20 artículos. Revisa los umbrales después del cambio. En una barra de peso, Unidad de peso fija la unidad en la que se introducen los umbrales; cambiarla los convierte (1 kg pasa a 2,2 lb).

Elegir qué se cuenta

La tarjeta Qué se cuenta fija qué artículos del carrito hacen avanzar la barra:

  • Tipo de compra: compra única, suscripción o ambas.
  • Excluir tarjetas regalo.
  • Filtrado de artículos del carrito: Incluir solo artículos de o Excluir cualquier artículo de los productos o colecciones elegidos. Una lista admite un solo tipo de recurso.
  • Contar los artículos dentro de los paquetes (barras por cantidad): un paquete nativo de Shopify de 6 cuenta 6; desactivado, cuenta 1.

Hay dos límites con los paquetes. Los paquetes de apps que no usan los paquetes nativos de Shopify siempre cuentan 1. Y para un nivel de descuento en porcentaje o importe sobre una barra por cantidad, el descuento del checkout cuenta un paquete como 1 artículo (límite de Shopify): solo la barra y los regalos cuentan sus componentes.

Artículos que cuentan como varias unidades

En una barra por cantidad, la sección Artículos que cuentan como varias unidades hace que un pack o una caja de suscripción cuente por el número de artículos que contiene: una caja de 6 latas cuenta 6. Sirve para los productos que no son paquetes nativos de Shopify, como una caja de suscripción (Shopify no vende paquetes en suscripción).

El número se fija con una o varias reglas:

  • Productos y variantes: elige productos, o solo algunas de sus variantes, e introduce el número de cada uno.
  • Colecciones: cada producto de la colección cuenta por el número introducido.
  • Productos con la etiqueta: cada producto que lleva la etiqueta.
  • Número de unidades leído en un metacampo: un metacampo del producto o de la variante que contiene el número, por ejemplo custom.pack_size.
  • Número de unidades leído en una opción de variante: la opción cuyo valor contiene el número, por ejemplo «Pack de 6» en Formato. Un valor sin número cuenta 1.

Cuando varias reglas coinciden con un producto, gana la más precisa: variante, luego opción, producto, metacampo, etiqueta y colección. En una lista, gana la primera regla. Una regla también prevalece sobre el contenido de un paquete nativo. Las reglas solo se aplican a los artículos que cuenta la barra: un producto excluido sigue excluido.

Tras cambiar una etiqueta, una opción o un metacampo en Shopify, la barra usa el nuevo número en unos minutos. Los niveles de descuento cuentan los packs igual en el checkout. En un nivel Compra X, llévate Y, un pack completa el lote pero nunca es el artículo con descuento.

Etiquetas de cantidad

En una barra por cantidad, la tarjeta Etiquetas de cantidad (Etiquetas de pedidos en una barra de pedidos anteriores) ajusta cómo escribe la barra los números. {quantity} se sustituye por el número; {number}, la variable de la etiqueta del umbral, también funciona.

  • Un artículo (singular) y Varios artículos (plural): los valores que se ven en la barra, como «3 artículos».
  • Cantidad restante (singular) y Cantidad restante (plural): el texto del mensaje de progreso, como «2 artículos más».
  • Mostrar solo el número en la barra: «3» en lugar de «3 artículos».

Estas etiquetas valen para todos los niveles de la barra. Para cambiar el texto de un solo nivel, por ejemplo «3+ láminas», usa su etiqueta del umbral: consulta añadir un nivel.

Los campos vienen rellenados en el idioma principal de tu tienda y traducidos a sus demás idiomas, se cree donde se cree la barra: al instalar la app, desde un nivel, desde la pestaña Barras o con tu asistente de IA. Cambiar la medida de una barra (importe del carrito a cantidad, cantidad a pedidos anteriores) pasa al nuevo vocabulario las etiquetas y traducciones que no has modificado; un texto que hayas escrito nunca se reemplaza. Cada uno se traduce o se corrige desde el icono de traducción al final del campo. Una barra más antigua puede tener solo tu idioma principal: añade los demás desde ese icono.

Importe máximo del pedido

En una barra que cuenta el importe del carrito, la tarjeta Importe máximo del pedido desactiva los niveles de la barra por encima de un importe del carrito, por ejemplo para los pedidos grandes que presupuestas tú. Es opcional: deja Importe máximo del pedido vacío para no fijar ningún máximo.

Cuando el carrito supera el máximo (un carrito igual al máximo sigue cumpliendo):

  • No se aplica ningún nivel de la barra. Ni descuento, incluidos los descuentos automáticos de Yaco en el checkout, ni regalo: un regalo que ya está en el carrito se retira, como cuando el carrito vuelve a quedar por debajo de su umbral.
  • La barra queda llena y ningún nivel aparece desbloqueado.
  • El mensaje sustituye al texto de la barra. El Mensaje por encima del máximo ocupa el lugar del texto de progreso y del mensaje de éxito de la barra, en la tienda y en el bloque del checkout. {price} se sustituye por el máximo, en la moneda del cliente. Si lo dejas vacío, la barra queda llena, sin texto.

Tus otras barras no se ven afectadas.

  • Introduce el máximo en la moneda de tu tienda. Se convierte a la moneda del cliente al tipo de cambio, sin ajuste por mercado.
  • Debe superar el umbral de cada nivel de la barra; si no, no se puede guardar.
  • Cambiar la barra a otra medida (cantidad, peso…) elimina el máximo.
  • El mensaje se traduce desde el icono de traducción al final del campo.

Ejemplo: niveles con un 10 % de descuento desde 300 $, un 15 % desde 500 $ y un 20 % desde 800 $, un máximo de 5000 $ y el mensaje Pedidos de más de {price}: contáctanos para un presupuesto. Un carrito de 5000 $ obtiene el 20 %. Un carrito de 5200 $ no obtiene ningún descuento, y la barra muestra «Pedidos de más de 5000 $: contáctanos para un presupuesto».

Barras basadas en el historial del cliente: la trampa habitual

Una barra basada en el historial del cliente no mide el carrito. Elegirla por error da dos síntomas típicos:

  • La barra desaparece en navegación privada. Estas barras se ocultan a los visitantes sin sesión iniciada.
  • El nivel se alcanza nada más abrir el carrito para un cliente que ya ha comprado. El descuento o el envío gratis se concede sin añadir nada.

El filtrado por productos o colecciones no se aplica a estas barras. Para medir el carrito, vuelve a poner la medida de la barra en Importe.

¿El total de la barra parece incorrecto? Consulta importe incorrecto.

¿Falta algo? Escribe a support@yaco.studio, o pruébalo antes en la demo.

Sigue leyendo

¿Listo para probarla en tu tienda?

Instala Yaco Progress Bar, fija tu primer nivel, y la barra aparece en tu carrito en minutos. Sin desarrollador, sin pop-ups.

Prueba gratisPrueba gratuita de 14 días · plan gratuito para siempre