Top
New to MailBeez? Start learning the basics
Advanced Module - Version 4.303 updated 29. Feb. 2024

Coupon Referral Honey


Get this Module as part of following plans:

Start Up

S M L

Business

S M L

Enterprise

S M L

ReferralHoney is a fully automated customer referral system for the Mailbeez framework. Customers refer friends or family to your store, and get rewarded when one of their referral group makes a purchase, a cycle which truly makes every customer a potential marketeer.

Take a look at the following flow to see how the ReferralHoney cycle works:

ReferralHoney emails a personalized coupon code link to each customer after they have placed an order in your store, which they can then share with friends, family or co-workers, in the knowledge that if one of their contacts places an order with the code, they will automatically receive a store reward. Within the initial referral email, your customers will also find a link that will take them to their own coupon code page hosted at your store’s website, a page that they can share with their contacts on Facebook, Twitter, their blog or personal website.

Automated and personalized

A true fit and forget, fully automated and intelligent system, at its heart, ReferralHoney uses your store’s inbuilt coupon system alongside the MailBeez framework to create the basis on which codes are created, tracked, rewarded and ultimately emailed to the participants. Relying on this coupon functionality means that there is nothing to install apart from the module itself, and absolutely no tracking code to add to the front end of your site.

As you may already be aware, a Mailbeez module installation is very easy, and simply requires you to drop the new files into your store’s FTP area. Most importantly, no existing store files need be altered. However for best results we recommend to utilize the MailBeez Service for custimization, configuration and going live.

General Module Options:

Order-Status of Customer order to start
Choose the order status on which ReferralHoney will begin the referral cycle – we would recommend ‘despatched’, or your store equivalent.

Set Order Status for friends order to recognize
Choose the order status on which ReferralHoney will recognize an order from a referrer’s friend – we would recommend ‘despatched’, or your store equivalent.

Delay after order
The number of days after your customer’s last order before it qualifies for a ReferralHoney invitation.

Set number of days to skip processing
The number of days after processing is skipped (depending how often you run MailBeez). This number must be bigger then “Delay after order”

Delay since last invite
Delay since a customer was invited to join the referral scheme – set this to over 7 days if you have customers that order very regularly to ensure that multiple invitations are not sent out.

Share-Coupon: Expires after days
The number of days after which the initial share coupon expires – calculated from the sending point in time.

Reward-Coupon: Expires after days
The number of days after which the reward coupon expires – calculated from the sending point of time.

Length of Coupon Code
Sets the length of the automatically generated coupon code

Sender email**, Sender name**
Sets the from email address and name in each ReferralHoney email. Typically you would want to use your store’s most used email address and name to ensure high delivery rates.

 

Options for Invite

Delay after order (same as in General Options)
The number of days since last order

Coupon Template – Friends Coupon for sharing
Choose the coupon code template you have configured in the coupon system. This coupon will be used as template to generate a personalized, unique coupon. The coupon code must start with ‘template_‘ e.g. ‘template_game

When setting up the ReferralHoney refer a friend coupon template, please make sure to leave the usage field blank, or for example enter a number of at least 50. If we take this scenario as an example, the customer who receives the coupon to share with their friends is always marked as having used the coupon (so only their friends can use it), leaving 49 more uses available.
The number of usages per customer field should be set to 1 – the refer a friend coupon is automatically marked as used by the referring customer when it is sent, which makes sure the coupon is only used by newly referred customers and not the initial recipient.

Share-Coupon: Expires after days (same as in General Options)
The number of days after which the share coupon expires – calculated from the sending point of time.

 

Options for Order Notification / Recognition

Set Order Status for friends order to recognize
Set the status of orders to recognize accepted friend orders

 

Options for Reward

You can set up to 3 levels of rewards, which means that for each level you can define the reward Coupon you would like to give out.

Delay after Coupon Expiry date
The number of days after the expiry of the friend coupon before sending the reward coupon.

Number of Orders for Level 1
The number of recognized orders to get reward coupon level 1

Reward: Choose Coupon as Template for Level 1
Choose the relevant coupon code you have configured in the coupon system. This coupon will be used as template to generate a personalized, unique coupon. The coupon code must start with ‘template_‘ e.g. ‘template_reward1

Number of Orders for Level 2
The number of recognized orders to get reward coupon level 2

Reward: Choose Coupon as Template for Level 2
Choose the coupon code you have configured in the coupon system. This coupon will be used as template to generate a personalized, unique coupon. The coupon code must start with ‘template_‘ e.g. ‘template_reward2

Number of Orders for Level 3
The number of recognized orders to get reward coupon level 3

Reward: Choose Coupon as Template for Level 3
Choose the coupon code you have configured in the coupon system. This coupon will be used as template to generate a personalized, unique coupon. The coupon code must start with ‘template_‘ e.g. ‘template_reward3

Reward-Coupon: Expires after days
The number of days after which the coupon expires – calculated from the sending point of time.

Customization of sharepage

the sharepage is fully customizable, the default templates (will be overwritten with updates) are located in


/mailhive/mailbeez/coupon_referral_honey/templates/

make a copy of these templates and remove the default_ from the filenames. Then adopt the templates to your needs

The System will try to load the templates in following order:

sharepage_<language>.tpl.html
sharepage.tpl.html
default_sharepage_<language>.tpl.html
default_sharepage.tpl.html

so if a language specific template is not found the sharepage.tpl.html templates will be used.

 


Compatibility
This module is compatible with following shop systems

Gambio GX2/GX3/GX4

Modified-Shop 1.x/2.x/3.x

ZenCart 1.3.x/1.5.x

osCommerce 2.x coupon system required

MailBeez.io API V2


Changelog

v4.3.3

15.01.2024

    • PHP8.2 refactoring

v4.3.2

27.06.2023

    • PHP8.1 refactoring

v4.3.1

03.11.2022

    • PHP8.1 refactoring

v4.3.0

14.10.2022

    • PHP8 refactoring

v4.2.0

21.04.2020

    • PHP7.4 refactoring
    • Support for 4.0 Core Framework

v4.11

26.03.2019

    • remove G+ Button from Sharepage - please do this manually for customized sharepage templates located in mailhive/mailbeez/coupon_referral_honey/templates

v4.10

14.10.2018

    • undefined function mg_get_conf()

v4.01

26.09.2018

    • number of configured coupon expire days are not accepted

v4.0

24.09.2018

    • PHP7.2 refactoring
    • Upgrade to 4.0 Pro Framework

v3.54

01.11.2017

    • refactoring

v3.53

04.10.2017

    • server compatibility / app_path
    • invalid db schema on some db servers

v3.52

10.02.2017

    • coupon_expire_date placeholder does not show correct date

v3.51

13.09.2016

    • PHP7 refactoring

v3.5

01.09.2016

    • support for coupon value preview

v3.41

14.06.2016

    • support for preheader

v3.4

12.06.2016

    • PHP7 refactoring

v3.36

18.04.2016

    • in some environments the custom sharepage template was not loaded, but the default template
    • PHP5.6 compatibility

v3.35

17.11.2015

    • added chunksize option to control the number of emails send out

v3.31

21.10.2015

    • optimized invitation module query

v3.3

08.10.2015

    • updated Facebook sharer integration (you need to update your custom share page templates)

v3.2

24.04.2015

    • support Gambio 2.3 and modified-shop 2.0 pre-integration

v3.1

    • support for custom sharepage templates, default_ templates will be overwritten by updates

v3.0

10.12.2014

    • CloudBeez ready

v2.76

    • Viewbeez module: Function to end game (requires coupon engine 2.8)

v2.7

    • Viewbeez module: Function to end game (requires coupon engine 2.8)

v2.6

    • Viewbeez module for MailBeez Customer Insight
    • reporting, option to invite customer manually

v2.5

    • option to send reward emails only to customers with referrals
    • improvements for mailchimp compatiblity

v2.4

    • changelog started
    • general improvements
    • mailchimp ready

Found errors? Think you can improve this documentation?   edit this page