Referral Page

Referral Landing Page

Cool, you’ve set up your Sharing page and your promoter can now share their love for your brand with their friends. But.. where will those friends go? To a great-looking dedicated landing page on your website, of course!

Just like with the Sharing page, we recommend you include at least some basic elements:

• A warm welcome to your Referral program

• The reward

• A quick explanation how and why the Referral got here

• Your USP’s

• Referral Landing Widget (in case of single use vouchers)

• CTA to shop!

Landing URL

The Landing URL determines where referrals are sent after opening a promoter’s share link. Configure it to point to the Referral Landing Page on your website.

MGMCo sale ID

When the referral reward type is cash, manual or no reward, MGMCo initializes a sale before redirecting the referral to your website. MGMCo then adds the reserved mgmco_saleid query parameter to the Landing URL. This ID is used to track the referral through the sales funnel and link an eventual purchase to the correct promoter.

Example:

https://www.yoursite.com/?mgmco_saleid=1234567890&utm_source=mgmco&utm_medium=referral&utm_campaign=summer2024

Your website must read mgmco_saleid when the referral arrives and retain it through the sales funnel, normally in a first-party cookie or equivalent storage. The ID is later returned to MGMCo by the sales-tracking integration so that the purchase can be linked to the correct promoter. See Tracking for the implementation steps.

This is one way to store the MGMCo sale ID in a first-party cookie:

const saleId = new URLSearchParams(window.location.search).get('mgmco_saleid');

if (saleId) {
  document.cookie =
    `mgmco_saleid=${encodeURIComponent(saleId)}; Path=/; Max-Age=2592000; SameSite=Lax; Secure`;
}

The Landing URL can also contain static query parameters and template variables. MGMCo resolves the template variables before redirecting the referral.

When the referral reward is a voucher code, mgmco_saleid will not be present and you wont need to store it: The Referral Landing Widget handles the tracking needed to link the referral to the correct promoter.

Referral Landing Widget

To prevent misusage of your Referral program’s voucher/discount codes, we’ve built a new feature. We call it the Referral Landing Widget.

How it works

The promoter shares their personal link with their friends. When their friend, now Referral, clicks the link and lands on your Referral Landing page, they will see the Referral Landing Widget. To claim their code, they need to fill in their name and email. Our system then does a few checks:

• Is the Referral email the same as the promoter email? They won’t get a voucher code.
• Has the Referral claimed a code before but not used it yet? We’ll show them the code they previously claimed so they can use it now.
• Has the Referral already claimed and used a code for a purchase? In this case, they won’t get a new voucher code either.

If the Referral passes all these checks, their personal voucher code will be shown with a CTA button that redirects to your shop.

Implementation

The implementation is basically the same as the Sharing widget: you need a page and a small piece of JavaScript.

The code

<div id="mgmco-referral-landing"></div>
<script src="https://embedded.membergetmember.co/app.js"></script>
<script>
MGMCo.referral.init({
  // Get this from your friendly MGMCo dev or operations person. Same one as in the Sharing widget
  project: 'your-identifier',

  // This part controls where on the page the application will be mounted
  selector: '#mgmco-referral-landing',

  // The page to which the referral will be redirected after claiming a voucher code.
  // The URL will have a voucherCode parameter containing the voucher code. For extra user friendliness, you could prefill this at checkout.
  salesFunnelUri: 'your-sales-funnel-uri',
});
</script>

Referral Webhook

The Referral Webhook lets your system verify a Referral’s submitted registration information before MGMCo completes the registration and issues a voucher code.

The Referral Webhook is available only for single-use voucher projects that use the Referral Landing Widget. It is not part of referral flows that do not use this widget.

MGMCo sends the Referral’s name, email address and any additional submitted fields to the configured webhook on your backend. The request format, response options and approval or rejection behavior are the same as for the Promoter Webhook.