Los Price tokens hacen referencia a precios del producto, porcentajes de descuento y monto de ahorro correspondiente. Dentro de estos se tienen tres tipos, los Standard prices valores propios de BigCommerce correspondientes a MSRP, Prices o Sale price, los que corresponden a Discount By Category prices, para mostrar por ejemplo el precio del producto luego de aplicado un 10% de descuento a los productos de una categoría y finalmente los Best &  Better prices para el producto, que hacen referencia a los mejores valores de los dos tipos anteriores.

Price token types

(see note  below to understand Product/Variant selected and Min and Max tokens)

Standard Prices

• MSRP
  • Product/Variant selected:
    • {msrp}
  • Variant range:
    • {msrp_min}, {msrp_max}
• Price (Default price)
  • Product/Variant selected:
    • Available if {price} is set as the retail price for all or some customers
      • {price}
      • {price_discount}, discount percentage from {msrp}
      • {price_save}, savings compared to  {msrp_price}
    • Available if {price} is not set as the retail price
      • {price_before} = {price}
      • {price_was} = {price} but appears strikethrough
      • {price_discount_before} = {price_discount_msrp}
      • {price_discount_was} = {price_discount_msrp} but appears strikethrough
  • Variant range:
    • {price_min}, {price_max}
• Sale Price
  • Product/Variant selected:
    • Available if {sale_price} is set as the retail price for all or some customers
      • {sale_price}
      • {sale_discount}, discount percentage from {price}
      • {sale_save}, savings compared to {price}
      • {sale_discount_msrp}, discount percentage from {msrp}
      • {sale_save_msrp}, savings compared to {msrp}
    • Available if {sale_price} is not set as the retail price
      • {sale_price_before} = {sale_price}
      • {sale_price_was} = {sale_price} but appears strikethrough
  • Variant range:
    • Available if {sale_price} is set as the retail price for all or some customers
      • {sale_min}, {sale_max}

Discount By Categiory Prices

• DBC #1
  • Product/Variant selected:
    • Available if {dbc1_price} is set as the retail price for all or some customers
      • {dbc1_price}
      • {dbc1_discount}, discount percentage from lower price of {sale_price} and {price}
      • {dbc1_save}, savings compared to lower price of {price} and {sale_price}
      • {dbc1_discount_msrp}, discount percentage from {msrp}
      • {dbc1_save_msrp}, savings compared to {msrp}
  • Variant range:
    • Available if {dbc1_price} is set as the retail price for all or some customers
      • {dbc1_min}, {dbc1_max}
• DBC #2
  • Product/Variant selected:
    • Available if {dbc2_price} is set as the retail price for all or some customer
      • {dbc2_price}
      • {dbc2_discount},  discount percentage from best price of {sale_price} and {price}
      • {dbc2_save}, savings compared to best price of {price} and {sale_price}
      • {dbc2_discount_msrp}, discount percentage from {msrp}
      • {dbc2_save_msrp}, savings compared to {msrp}
    • if Include items that apply Discount by Category #1 is off:
      • {dbc2_discount_dbc1},  discount percentage from {dbc1_price}
      • {dbc2_save_dbc1}, savings compared to {dbc1_price}
  • Variant range:
    • {dbc2_min}, {dbc2_max}

Best &  Better Prices

• Better
  • Product/variant selected:
    • {better_price}, the lower price, excluding DBC prices not applicable to all customers
    • {better_discount}, discount percentage from {price}
    • {better_save}, savings compared to {price}
    • {better_discount_msrp}, discount percentage from {msrp}
    • {better_save_msrp}, savings compared to {msrp}
  • Variant range:
    • {better_min}, {better_max}
• Best
  • Product/Variant selected:
    • {best_price}, the lowest among {price}, {sale_price}, {dbc1_price}, and {dbc2_price}, regardless of whether DBC1 or DBC2 applies to all customers
    • {best_discount}, discount percentage from {price}
    • {best_save}, savings compared to {price}
    • {best_discount_msrp}, discount percentage from {msrp}
    • {best_save_msrp}, savings compared to {price}
  • Variant range:
    • {best_min}, {best_max}

Note:

Token availability

Tokens are not always available. For instance:

• If the product has a variant, and the customer has not yet selected a variant, {price} is unavailable,  but {price_min} and {price_max} are.
• When the product is on sale, {price} is unavailable, but {sale_price} is.
• In cases where the product is on sale, and there’s a discount like DBC1 applicable to all customers, {sale_price} is not available, but {dbc1_price} is.
• If the product is on sale, and there’s a discount like DBC1 that doesn’t apply to all customers, both {sale_price} and {dbc1_price} are available.

Whether a price serves as the selling price for some or all customers depends on whether the 'Apply to all customers' option of DBC1 or DBC2 is selected or not.

Product/Variant selected vs Variant range
Product/Variant selected refers to a scenario where a variant has been chosen or the product has no variants. On the other hand, Variant range indicates that the customer hasn't selected a product/variant, and the product offers variant options with different values.

Los Attributes tokens refieren a los siguientes datos del producto y sus variantes: 

• Products
  • brand: Brand name 
  • weight: Weight
  • width: Width
  • depth: Depth
  • height: Height
  • stock: Inventory level
• Variants
  • weight: Weight
  • width: Width
  • height: Height
  • depth: Depth
  • stock: Inventory level

Los Custom tokens son tokens que tienen un nombre variable, no es como los otros dos grupos, Price tokens y Attribute tokens, cuyos nombres están preestablecidos sino que en este caso, el nombre depende de los datos que se hayan cargado al producto.

Básicamente los Custom token hacen referencia a datos cargados en el catálogo y se subdividen en los siguientes grupos:

Custom fields tokens

El nombre del token es el nombre del custom field y el valor es el valor del custom field.

Por ejemplo, si se tuviera un custom field de nombre ip que indique el grado de resistencia al polvo y al agua de un celular, se podría destacar el grado de cumplimiento con un display widget con el contenido "IP: {ip}", este se mostraría solo en los productos que tienen asignado el custom field ip con un valor.

Category & Brand tokens

Estes tokens ssirven para mostrar un Display widget para una determinada categoría o marca.

Por ejemplo, si quisiéramos destacar que extendemos la garantía a todos los productos Apple podríamos hacerlo con un display widget que contuviera "{apple}::2-Year Extended Warranty Plan". Display Widget mostrará "2-Year Extended Warranty Plan" solamente en los productos que tuvieran Apple como marca (Ver Cuándo se muestra un bloque y cuándo no?). 

URL tokens

Estos tokens sirven para mostrar display widgets solo a los usuarios que llegan al sitio con una determinada URL. Básicamente se usan en mailings, posteo en redes sociales o publcidad, donde el usuario hace clic en un enlace preparado especialmente para recibirlo con determinados mensajes.

El nombre del token tiene que aparecer en la URL precedido con el prefijo dwt_.

Por ejemplo, si se quisiera mostrar un cupón de descuento a una base de leads a la que se enviará un mailing, bastaría con linkear al sitio con una URL del tipo www.mysite.com?dwt_vip_coupon=PRE-BLACK-FRIDAY.

Haciendo referencia al token {vip_coupon} en un display widget, por ejemplo, 10% off with {vip_coupon} coupon", los usuarios que entraran al sitio desde ese link, verían "10% off with PRE-BLACK-FRIDAY coupon".

Combinando URL tokens con Category & Brand tokens, se podría hacer que a estos leads solo les muestre el cupón en los productos de la categoría Black friday con el contenido "{black friday}::10% off with {vip_coupon} coupon".

Nota: La información del URL Token es guardada durante 60 días en el dispositivo con el que entró al sitio, debe verificarse que la Política de cookies lo permita. 

Image tokens

Estos tokens permiten hacer referencia a una imagen que se haya cargado en Image Manager de BigCommerce. Para indicar la imagen a cargar, se le antepone el prefijo img_, por ejemplo, {img_sale-badge.png} refiere a la imagen sale-badge.png que debería existir en el Image Manager para que se muestre.
Nota: si no se especifica la extensión del archivo, se asume png. 

Variant option tokens

Como indica su nombre, estos tokens hacen referencia a las opciones de una variante, por ejemplo, {color} haría referencia a la opción Color de una variante. 

Por ejemplo, se podría destacar el código de modelo elegido sobre la imagen como en este caso usando "Diseño: {model}:

 

ToDo: Ilustrar los 4 ejemplos

ToDo: Definir tema de tamaños de la imagen en Image tokens