Redeem Points On-site Module (Interactive)

      Redeem Points On-site Module (Interactive)


        Article Summary

        Products


        Loyalty & Referrals
        Supported plans

        Premium, Enterprise

        eCommerce Platform

        Shopify, Shopify Plus, BigCommerce, Salesforce Commerce Cloud, Adobe Commerce (Magento), Custom

        The Interactive Redeem Points Module is a highly-customizable way to let customers redeem their points for rewards. You can deploy a new module in minutes, with no development required. 

        In this article find out how to access, customize, and deploy the Interactive Redeem Points Module on your site.

        Tip:

        Before you start

        Before setting up your Interactive module, you'll want to:

        Accessing the editor

        Accessing via the Rewards Page Builder

        To access and edit the section via the Rewards Page Builder, do the following:

        1. In your Yotpo Loyalty & Referrals main menu, go to Display On-site > Rewards Page Builder.
        2. Click Create Rewards Page or click the existing page you want to edit.
        3. Click Redeem Points (Free Products Section).
        4. Proceed below to the next step, "Customize settings".
        Accessing as a module

        To access and edit as a Module, do the following:

        1. In your Yotpo Loyalty & Referrals main menu, go to Display On-site > Redeem Points Modules.
        2. Scroll down to the "Interactive" section.
        3. Click Edit on the instance you wish to edit or click "+ Create new"
        Please note:
        Your Module won't appear on your site until you publish it

        Customizing the module

        There are three sections in the module editor:

        1. Layout
        2. General appearance
        3. Customize reward appearance

        1. Layout

        In this section, you can choose which rewards to display, arrange the order in which they appear, and change the layout of your module.

        2. General appearance

        These are the settings that are general to the module. To edit individual rewards, go to Customize reward appearance 

        General appearance > Fonts & general text

        Background color
        Choose whether you want to add a background color or have the widget be transparent.

        Fonts
        The primary and secondary fonts are two fonts that will apply in several places throughout your module. Click below to see where the fonts appear.

        Primary & Secondary Fonts 

        Exchange rate

        Display here how much your points are worth in store credit.

        Button

        Default text: "Redeem My Points." This button shows on the logged-out state, and it redirects the customer to your site's login page.

        If you are using an e-commerce platform that has a pre-built integration with Yotpo Loyalty & Referrals, this is done automatically in the integration. 

        If you are working with a generic or custom-built platform, this login page URL that you defined in your settings page. You can change it here: Settings > Account Login URL.

        Advanced

        CSS editor 

        If you'd like to make further customizations to the module, use our embedded CSS editor. If you need to make any overriding changes to the Interactive Redeem Points Module CSS, use this CSS class name before the class you want to override:

        .yotpo-coupons-redemption-widget.yotpo-widget-override-css
        

        If you are using the CSS Editor, you may see a notification asking you to update your Module version from time to time. Read more about Module Versions.

        Please note:
        Make sure to use our embedded CSS editor instead of hardcoding directly onto your storefront.

        If our system detects CSS implementation outside the module, we will refrain from updating the module version as it might impact your site.

        General appearance > Logged in view

        Point balance This is the number of points the customer currently has. This field must include at least one variable, either {{current_point_balance}}, or {{points_as_credit}}.

        • {{current_point_balance}} - This shows how many points the customer currently has. For example 500 points.  
        • {{points_as_credit}} - This shows how many points the customer has in terms of store credit. For example $5.00.

        Redeem button

        Clicking the button opens the following options: Yes/no

        If the customer clicks yes, points are deducted from their account, and they are given the reward code. They need to copy it and apply it at checkout. 



        3. Customize reward appearance

        First, select which reward appearance you want to customize. Then you can adjust the following options: 

        Discount amount
        Discount amount (usually in the form of currency, such as $10.00). Changing this will only change how it appears, but will not change the actual value of the reward. To change the value of the reward, do so in the loyalty admin.

        Points
        This is the number of points needed to claim the discount. The system will auto-populate the number of points you set up in your admin. This field must contain the variable:

        {{points}} 

        Apply Design to All Tiles

        This is a quick and easy way to apply changes to your tile design. Clicking Apply Design to All Tiles will take the following design settings and apply them across all the tiles:

        • Reward amount color
        • Points text & color 
        • Button style, color, and button font color

        You may see that your button color stays gray on some of your rewards after you click apply design to all tiles. This is a preview of what it will look like if the customer doesn't have enough points to redeem this reward.

        Publishing the module

        For your Module to appear onsite, you need to embed some code onto your site. See a guide for Embedding Modules on Shopify.

        Publishing via the Rewards Page Builder

        If you are building your Redeem Points Section with the Rewards Page Builder, follow the steps for publishing your Rewards page.

        Active/Inactive

        Active

        If your module is active (green dot), this means that any changes you publish will be reflected on your store if the module snippet is embedded

        Inactive

        If your module is inactive (yellow dot), this means that any changes you publish/save will not be reflected on your store. This also means if you had the module snippet embedded and active on your store before, it will not be visible when inactive.

        Advanced customizations

        There are some additional customizations that can be made to the module if you are savvy with code. See below the advanced options.

        The following attributes can be added to your module's code snippet, just after your instance ID.

        For example, if your module's code snippet looks like this:
        <div class="yotpo-widget-instance" data-yotpo-instance-id="0000"></div>

        Then add the attribute here:
        <div class="yotpo-widget-instance" data-yotpo-instance-id="0000" add-attribute-name=value> </div>

        If you want to add multiple attributes, add them one after the other, separated by spaces.

        Advanced Attributes
        • coupons-redemption-headline="insert your own text here!"
          Default - "How to use your points", the text of the headline of the module.
        • coupons-redemption-description="insert your own text here!"
          Default - "Redeeming your points is easy! Click Redeem My Points and copy & paste your code at checkout.", the text of the description of what the module does.
        • coupons-redemption-rule="insert your own text here!"
          Default - "100 points equals $10.00", the text of the exchange rate of points to dollars.
        • redeem-button-text="insert your own text here!"
          Default - "REDEEM", the text of the button to make the redemption coupon
        • login-button-text="insert your own text here!"
          Default - "REDEEM MY POINTS", the text of the button that takes you to the login page in case the customer is logged out
        • point-balance-text="insert your own text here!"
          Default - "You have {{current_point_balance}} points", the text that presents the point balance of the customer
        • coupon-code-copied-message-title="insert your own text here!"
          Default - "COPIED", the text of the message that appears after the coupon code was copied
        • coupon-code-copied-message-body="insert your own text here!"
          Default - "Thank you for redeeming your points. Please paste the code at checkout.", the text of the message that appears after a redeemed coupon
        • confirmation-step-title="insert your own text here!"
          Default - "ARE YOU SURE?", the text of the message to confirm the redeem action
        • confirmation-step-confirm-option="insert your own text here!"
          Default - "YES", the text of the button to confirm the redeem action
        • confirmation-step-cancel-option="insert your own text here!"
          Default - "NO", the text of the button to reject  the redeem action
        • donate-button-text="insert your own text here!"
          Default - "DONATE", the text of the button to make the donation
        • donation-success-message-body="insert your own text here!"
          Default - "Thank you for donating {{donation_amount}}$ to {{company_name}}", the text of the message after donation was success
        • donation-success-message-title="insert your own text here!"
          Default - "SUCCESS", the text of the title after a donation was successful


        Was this article helpful?