• Developer Docs
• Integration Guides
• Zinrelo Loyalty Rewards Platform

Zinrelo Loyalty Rewards Platform

1. Overview
2. Sign Up With Zinrelo
3. Setup & Configuration
4. Verify Configuration
5. Setup Redemptions
1. Setup Coupons in Zinrelo

OR

2. Setup In-Cart Redemptions (Recommended)
6. Loyalty Points Message (Optional)

Overview

The Zinrelo Loyalty Rewards Platform enables a rewards program based on previous sales and customer engagement. It allows you to set up rewards for referrals, reviews, frequent buyers, social media activity, and other specific user behavior. You can award bonuses for birthdays and customer account creation. You can set up custom rewards for any user activity that suits your purposes.

Sign Up With Zinrelo

Before installing the Zinrelo module in your Miva store, you must sign up with Zinrelo and complete the basic setup of your Zinrelo account. You can sign up for a Zinrelo account here.

Note: It is recommended that you backup your Miva store and do the Zinrelo integration on your test server first before performing the integration on your production server.

Setup & Configuration

Installation

1. The Zinrelo Loyalty Rewards module can be downloaded from the Miva App Store here.
2. Go to Home > Modules and click the Add Module button [ + ] to upload the module.
3. Click the UPLOAD button and select zinrelo.mvc.
4. Click the [ + Add ] button.
5. To make it live, the module needs to be installed on the store. Under Utility Settings > Add/Remove Modules, click [+] Install on the Zinrelo module.

Note: The module automatically injects scripts required to enable Zinrelo in your Miva store. You do not need to add any other code manually to enable Zinrelo in your Miva store.

Configuration

After installing the module, there is a new Zinrelo tab under Utility Settings.

1. Enter the Partner ID and API Key that you received from Zinrelo. These can be found on your Zinrelo Settings page.
2. You have the option of awarding loyalty points when an order is placed or when an order is shipped.
• If you select Order Placed, points will be awarded as soon as the customer places the order.
• If you select Order Shipped, points will be awarded when the order status changes to 'Shipped'.
3. Check the Enable box to turn on Zinrelo Rewards.
4. Click Save Settings.

On the Zinrelo Store Settings page, you must enter your Store Login URL (Customer Login Page) and Store Sign Up URL (Customer Registration page). Scroll down and click SAVE at the bottom of the page.

Verify Configuration

Before you can launch your rewards program, you must verify your configuration in Zinrelo. Log into your Zinrelo account and follow the instructions. When you have finished, click the LAUNCH NOW button.

Once you have launched the Zinrelo Rewards program, you will see a Rewards Program button on your Miva store page. When you click on this button, a Rewards dialog appears.

Setup Redemption Options

Redemption options allow your users to redeem their points for rewards. You can set up the redemption options in either of the following ways:

• Setup Coupons in Zinrelo
• OR
• Setup In-Cart Redemptions (recommended)

Setup Coupons in Zinrelo

For this option, shoppers will be able to redeem their points for coupons in the Zinrelo dashboard. They can then use this coupon at checkout.

Coupons must be set up on the Miva side first. Under Marketing > Coupons, click the [ + Generate ] button. The Generate Coupons dialog appears.

Give the coupon a name in the Code field and add a brief description in the Description field. In the Eligibility field, select who you want to be able to redeem this coupon: Specific Customers, All Logged-In Customers or All Shoppers (the default). Enter the number of coupons you want to generate in the # of Coupons field and click the Generate button.

Note: The coupon code must be a unique, single use code. When generating the code, Miva automatically appends random characters to the end of the coupon code specified to ensure that all the coupons created are unique.

To set up coupons on the Zinrelo side, log into your Zinrelo account and go to Program Settings > Rewards.

Select one of the available reward templates or create a new one via the New Reward option.

Note: You can't use the slider to activate the reward until you add a coupon code from Miva.

To add the Miva coupon code, perform the following steps.

1. Click the Edit button (circle with a pencil icon) in the lower left corner of the reward box.
2. The coupon dialog appears. Click on the MANAGE CODES tab.

3. Click the ADD COUPONS button.
4. Add the previously generated Miva coupon codes to the text box (one per line).


Note: Each code must be unique. If you try to add the same code more than once, the system will reject the duplicates. Add single use, unique coupon codes only. The system will notify you when your codes are running low or exhausted.

5. Click SAVE.

Adding Coupons in Batch

In general, you will probably want to add large batches of coupon codes to your rewards program at once. The easiest way to do this is by exporting the coupon codes from Miva to a CSV file and then copy/pasting from the CSV file into Zinrelo. To do this, perform the following steps.

1. From your Miva admin account, go to Marketing > Coupons.
2. Select the coupons you want to export by checking the box to the left of the +Code column.
3. Click the CSV button.

4. Open the resultant export.csv file and select the contents of column A (the Code column).

5. Copy (Ctrl-C) and paste (Ctrl-V) the codes into the Zinrelo MANAGE CODES text box.

6. Click SAVE.

Setup In-Cart Redemptions

In-cart redemption allows users to redeem their rewards from their shopping cart without leaving the purchase flow. It is implemented on the payment page during the checkout process. This achieves the following objectives:

• It makes redemption easy for customers
• It increases conversion percentages
• It attracts customers back for more purchases

To setup in-cart redemptions, perform the following steps.

1. From your Miva admin account, go to Menu > User Interface.
2. Search for the OSEL page and click the Edit button.
3. Search the template for the following line of code:

< form method="post" action="&mvte:urls:OPAY:secure;">

4. Just above this line, add the following code:

< mvt:item name="zinrelo" param="rewards"/>

5. Click the [ ✔ Update ] button.

After making this change, customers will see their accrued loyalty points and redemption options on the checkout page.

Note: 'Zero-point rewards' (rewards that are given without deducting any points) will not be displayed in the Redeem drop-down list. Zero-point rewards are automatically applied to the cart. The drop-down list only displays rewards for which points will be deducted from the available balance.

Loyalty Points Message on Product Pages (Optional)

When customers visit the product pages on your website, you can let them know that they will earn reward points for buying the product on that page. This achieves the following objectives:

• It improves the purchase conversion rate
• It increases customer awareness of the loyalty rewards program

To setup a loyalty points message on product pages, perform the following steps.

1. From your Miva admin account, go to Menu > User Interface.
2. Search for the PROD page and click the Edit button.
3. Add the following code in the position on the page where you want to display loyalty point details:

<div>
	<span style="float: left;">You will earn </span>
	<div data-zrl-product-points style="float: left;"> </div>
	<span> reward points for this purchase </span>
</div>



4. Log into your Zinrelo account and go to Notifications > Onsite Notifications > PRODUCT DISPLAY PAGES.
5. Update the Javascript Product Price Identifier Function code as follows:

zrl_mi.price_identifier = function(){
var product = {};
price = miva_product_price;
category = miva_product_category;
product_id = miva_product_id;
if(price) { product['price'] = price; }
if(product_id)  { product['product_id'] = product_id; }
if(category) { product]['category'] = category; }
return product; }

With these changes, customers will see the loyalty points information on the product display pages.