# Referring a friend

## Overview

In a referral campaign each user receives a referral code or link to share with friends, and a friend uses that code or link during sign-up, which connects the referral and activates tracking.

This article explains the two options for sharing and registration:

* **Code referrals (default)** – Each user receives a unique code to share. Friends enter this code at registration.
* **Link referrals (optional)** – A unique referral link is generated for each user through a [**Branch.io**](https://branch.io) integration, which they can then share with their friends. Friends join via the link, and Branch handles attribution.

#### Choosing between codes and links

* **Codes** → Most reliable, no third parties, built in by default.
* **Links** → Flexible and seamless for users, but requires external setup and ongoing Branch costs.

***

## <i class="fa-text">:text:</i> Code referrals

Code referrals are the standard approach and included with the Referrals module.

* Each user is given a unique, 8-character alphanumeric code (e.g., <kbd>4AD0E5B9</kbd>).
* If multiple referral campaigns are active, users receive a unique code for each.
* Friends must enter the code during registration to be counted as a valid referral.
* Tracking is fully managed by the Loyalty Engine—no third-party setup required.

**Best for: Guaranteed tracking, simple setup, no extra cost.**

***

## <i class="fa-link">:link:</i> Link referrals (Branch integration)

For clients who want shareable referral links instead of codes, the Loyalty Engine integrates with [**Branch.io**](https://branch.io).

* Branch generates referral links that users can share with friends.
* When clicked, links route users to the correct destination (app store, app, or website).
* Attribution is handled entirely by Branch, tying the referral back to the original user.
* Requires:
  * A Branch account (purchased separately).
  * Branch SDK integrated into your app or website.

#### Branch key features

* Deep linking – Sends friends directly to the right place, even if the app must be installed first.
* Attribution tracking – Identifies who shared the link and connects their actions.
* Customizable links – Branded URLs that fit your program.
* Real-time reporting – Track link creation, clicks, and conversions.

**Best for: Apps already using Branch, or programs wanting branded deep links.**

### Creating a Branch.io account

{% hint style="warning" %}
**Only required if you want to use link referrals.**
{% endhint %}

Branch offers a free tier for up to 10,000 monthly active users (MAUs). Their definition of MAU can be found [here](https://help.branch.io/docs/usage).

Follow the instructions below to create a Branch account and link it to the Loyalty Engine.

{% embed url="<https://scribehow.com/shared/Get_setup_with_Branchio_for_WLL_Referrals___gkMvOHURtW-pIXBlz7amg>" %}
