How to Use Dynamic Tokens

Dynamic tokens allow you to dynamically display real-time information to your customers, such as inventory levels, pricing, and cart values, creating a more engaging shopping experience.

What Are Dynamic Tokens?

Dynamic tokens are placeholders that pull real-time data into your content. Instead of hardcoding static messages, you can use tokens to display relevant details tailored to your customers, such as product prices, visitor locations, or cart totals.

For example, a message like:

“Only ${|round(50 - viewing_user.cart_total)|} away from free shipping!”

…will dynamically update to show the exact amount the visitor needs to add to their cart to qualify for free shipping.

Caveat: Where Tokens Can Be Used

It’s important to know where each type of token is supported:

Product-Specific Tokens (PDP Pages Only)

Product-specific tokens are designed to pull details about a specific product and are only supported on Product Detail Pages (PDPs). These tokens cannot be used in campaigns that appear on other page types, such as badge campaigns.

For example, you cannot use the {|compare_at_price|} token in a badge campaign because it relies on data from a specific product page.

The following tokens are PDP-only:

• Inventory Left

• Product Price

• Compare at Price

• Discounted Price

• Compare at Price Discount

  Example Use:

  “Hurry! Only {|inventory_left|} left in stock for {|product_title|}, now at {|product_price|}!”

Tokens That Work on All Page Types

The following tokens can be used on any page of your site, including in badge campaigns:

• Visitor Country

• Current Cart Total

• Close to Free Shipping

• Discount Code

  Example Use:

  “Hello, shopper from {|visitor_country|}! Spend {|close_to_free_shipping|} more to unlock free shipping.”

Available Dynamic Tokens

1. Inventory Left

   • What it does: Displays the current inventory stock for a product.

   • Example: “Hurry, only {|inventory_left|} left in stock!”

2. Product Price

   • What it does: Displays the current price of the product being viewed.

   • Example: “Buy now for just {|product_price|}!”

3. Compare at Price

   • What it does: Displays the original (pre-discount) price of the product.

   • Example: “Originally {|compare_at_price|}, now {|product_price}}!”

4. Discounted Price

   • What it does: Displays the price after discounts have been applied.

   • Example: “Save big—your price is now {|discounted_price|}!”

5. Compare at Price Discount

   • What it does: Displays the difference between the original price and the discounted price.

   • Example: “You’re saving {|compare_at_price_discount|}!”

6. Visitor Country

   • What it does: Displays the visitor’s location based on their IP address.

   • Example: “Hello, shopper from {|visitor_country|}! We ship worldwide.”

7. Current Cart Total

   • What it does: Displays the total value of the customer’s current cart.

   • Example: “Your cart total is {|current_cart_total|}.”

8. Close to Free Shipping

   • What it does: Displays the amount a customer needs to spend to qualify for free shipping.

   • Example: “Spend {|close_to_free_shipping|} more to unlock free shipping!”

9. Discount Code

   • What it does: Displays the applicable discount code for a promotion.

   • Example: “Use code {|discount_code|} at checkout for a special offer!”

How to Use Tokens in the Because Rules Engine

1. Add a Rule:

   Go to the Rules Engine and set up a rule based on specific triggers or conditions. For example, you might create a rule to show a free shipping message when the cart value is under your free shipping threshold.

2. Place Tokens in Messages:

   Within the text editor of your message, type the token you want to use in double curly bracket + pipe (e.g., {|inventory_left|}).

3. Preview and Test:

   Use the preview feature to ensure your tokens are working correctly. A/B testing is a great way to optimize messages and see which ones perform best.

Tips for Effective Token Use

• Be Page-Aware: Use PDP-specific tokens (e.g., {|inventory_left|}) only on product pages. Universal tokens (e.g., {|visitor_country|}) work on any page.

• Keep It Relevant: Tailor messages to match your customer’s shopping journey. For example, display {|close_to_free_shipping|} on cart pages to encourage upsells.

• Use Tokens to Create Urgency: Show limited inventory or time-sensitive discounts to drive conversions.

• Personalize with Location: Use {|visitor_country|} to greet customers and emphasize international shipping options.

Dynamic tokens help you deliver smarter, more engaging messages that connect with your customers and drive conversions. If you have any questions or need assistance, don’t hesitate to reach out to us at [e-mail].