Referencia de variables dinámicas

Las variables dinámicas muestran datos en vivo del producto y de la clientela dentro del texto de tus insignias; se sustituyen por el valor real cuando alguien visita el producto.

Por ejemplo, una insignia con el texto Save {sale}! se mostrará como Save 25%! en un producto con un 25 % de descuento.

Tabla de variables

Variable	Descripción	Ejemplo de resultado	Plan
{product_vendor}	Nombre del proveedor del producto	“Nike”	FREE
{product_type}	Tipo de producto	“T-Shirt”	FREE
{product_sku}	SKU del producto	“SKU-12345”	FREE
{inventory}	Total de artículos en stock	“42”	FREE
{sale}	Porcentaje de descuento	“25%”	FREE
{sale_amount}	Importe del descuento	“$10.00”	FREE
{product_variant_count}	Número de variantes	“3”	FREE
{customer_order_total}	Total de pedidos de la persona	“5”	FREE
{customer_spent_total}	Total gastado por la persona	“$250.00”	FREE
{product_rating_star}	Valoración media en estrellas del producto	“4.8”	FREE
{product_number_of_star}	Número de reseñas del producto	“126”	FREE
{product_metafield}	Valor del metacampo de producto	(varía)	DIAMOND
{variant_metafield}	Valor del metacampo de variante	(varía)	DIAMOND
{countdown}	Cuenta regresiva hasta la fecha de finalización, estilo 1	“12Days 20Hrs 50Mins”	GOLD
{countdown_2}	La misma cuenta regresiva en estilo 2, con cada unidad en un recuadro	“12 : 20 : 50”	GOLD

Variables de descuentos de Sami

Estas cuatro variables obtienen su valor de un descuento creado en la página Discounts de la aplicación. En Insert dynamic text aparecen agrupadas en la pestaña Sami Discount.

Variable	Descripción	Ejemplo de resultado
{sami_discount_value_percent}	El porcentaje de descuento de Sami aplicado al producto	“20%”
{sami_discount_value_amount}	El importe de descuento de Sami aplicado al producto	“Save 10.00”
{sami_discount_code}	El código de descuento de Sami aplicado al producto (solo descuentos con código)	“SUMMER20”
{sami_new_price}	El precio del producto después de aplicar el descuento de Sami	“Now 40.00”

Precaución

Una variable de descuento de Sami solo tiene valor en una insignia asociada a ese descuento: la pestaña Products de la insignia debe usar Products matching conditions con la condición Sami discount is equal to el descuento. Si guardas un descuento y haces clic en Create badge, esto se configura automáticamente.

Variables de reseñas de producto

Estas dos variables obtienen su valor de la aplicación de reseñas que usa tu tienda: Judge.me, Loox, Junip, CWILL(Trustoo), LAI Product Reviews o AG Product Reviews. En Insert dynamic text están en la pestaña Advanced.

Variable	Descripción	Ejemplo de resultado
{product_rating_star}	La valoración media en estrellas del producto, siempre con un decimal	“4.8”
{product_number_of_star}	Cuántas reseñas tiene el producto	“126”

Precaución

Una variable de reseñas solo tiene valor en una insignia asociada a una aplicación de reseñas: la pestaña Products de la insignia debe usar Products matching conditions con la condición Product review app is equal to tu aplicación. Sin ella, no se puede guardar y un banner indica la variable. Consulta Muestra insignias a partir de tu aplicación de reseñas.

Nota

Si un producto no tiene reseñas, ambas variables quedan vacías, por lo que la aplicación oculta la insignia por completo en lugar de mostrar «stars» sin un número delante.

Notas

Nota

Variables de oferta y ocultación automática
{sale} y {sale_amount} admiten una opción para ocultar la insignia automáticamente cuando el producto no está en oferta, de modo que no aparezca “0%” ni “$0.00” en productos a precio completo.

Nota

Variables de metacampos
{product_metafield} y {variant_metafield} requieren el plan DIAMOND. Al seleccionar una, se muestran como casillas las definiciones de metacampos de tu tienda: marca las que quieras y la aplicación crea el token real por ti, por ejemplo {product.metafields.custom.material}.

Nota

Temporizador de cuenta regresiva
La cuenta regresiva requiere el plan GOLD y una end date definida en Display > Visibility Date & Countdown en el editor de insignias. Se actualiza en tiempo real y muestra el tiempo que falta hasta esa fecha. Los dos estilos son dos tokens distintos: Style 1 inserta {countdown} y Style 2 inserta {countdown_2}, así que elige el estilo en Insert dynamic text antes de insertarlo.

Precaución

Las variables distinguen mayúsculas de minúsculas: escríbelas exactamente como se muestran, incluidas las llaves. {sale} funciona; {Sale} o {SALE} no.

---

Próximos pasos

• Uso de variables dinámicas: aprende paso a paso a añadir variables al texto de tu insignia.
• Crea una insignia de texto: crea tu primera insignia de texto con contenido dinámico.