# Referral System Guide

A complete guide to understanding and launching your referral program with Upzelo.

***

## What is a Referral Program?

A **referral program** turns your existing customers into your sales team. Instead of paying for ads, you reward customers for recommending your business to friends and family.

**How it benefits you:**

* ✓ New customers acquired through trusted recommendations (higher conversion)
* ✓ Lower customer acquisition cost than traditional marketing
* ✓ Increased customer lifetime value (referred customers tend to be more loyal)
* ✓ Viral growth (customers tell friends, who tell friends)

**How it benefits your customers:**

* ✓ Easy way to earn rewards without spending more money
* ✓ Help friends discover products they love
* ✓ Exclusive perks just for referring

***

## How Upzelo Referrals Work: The Basic Flow

### Step 1: Customer Gets a Referral Link

Your customer opens the loyalty widget on your site and copies / shares a **unique referral link** that tracks their identity.

```
Example: https://mystore.com?ref=john_2847
```

### Step 2: Customer Shares with Friends

They copy and share this link via:

* Social media (Instagram, Facebook, TikTok, email)
* Text message
* Email
* Messaging apps

### Step 3: Friend Clicks Link and Shops

When a friend clicks the referral link:

* Friend's browser remembers the referral code
* Friend makes a purchase on your site
* ✓ **Referrer gets rewarded** (bonus points, discount, etc.)
* ✓ **New customer gets rewarded** (welcome bonus, discount, etc.)

### Step 4: Everyone Wins

* **Your referrer** earns points → can redeem for rewards
* **New customer** gets a discount or bonus points
* **You** gain a new paying customer

***

## The Complete Referral Workflow

```
Customer A opens loyalty widget
         ↓
"Share & Earn" section appears
         ↓
Generates unique referral link
(example: ref=cust_5024)
         ↓
Shares link on social/email/text
         ↓
Friend B clicks link
         ↓
Friend B's purchase tracked
         ↓
🎉 BOTH GET REWARDS
Customer A: +25 bonus points
Friend B:   10% off first order
```

***

## Setting Up Your Referral Program

### Step 1: Enable Referrals in Upzelo

1. Go to **Upzelo Dashboard** → **Loyalty Program** → **Referral Program**
2. Click **Enable Referral Program**
3. Choose your settings:
   * **Referrer reward**: How many points does the person who refers get? (Example: 50 points)
   * **Referred friend reward**: What discount/bonus does the new customer get? (Example: 15% off first order)
   * **Minimum order for credit**: Does the referred friend need to spend a minimum? (Optional)

### Step 2: Customize Your Messaging

1. Go to **Referral Settings** → **Customize Widget**
2. Edit the copy:
   * "Share & Earn" button text
   * Reward description ("Earn 50 points for each friend who buys!")
   * Social sharing message
3. Upload **referral graphics** (what appears when friends share)

### Step 3: Test It

1. Open your store as a customer
2. Click loyalty widget
3. Look for "Share & Earn" or "Refer a Friend" section
4. Generate a test referral link
5. Open link in different browser/device
6. Make test purchase
7. Verify both rewards appear in dashboard

***

## How Customers Experience Referrals

### Experience #1: Desktop/Web

**Step 1: Loyalty Widget Opens** Customer clicks floating "Loyalty" button on your site → Widget pops up

**Step 2: Referral Section** They see a section like:

```
📢 SHARE & EARN
"Earn 50 points for every friend who shops!"

Your referral link: [Copy]
Share on: [Facebook] [Twitter] [Copy Link]
```

**Step 3: Generate Link** They click **"Copy Link"** → Unique URL copied to clipboard

* Example: `https://mystore.com?ref=john_5024`

**Step 4: Share** They paste into:

* Instagram caption or DM
* Email to a friend
* Text message
* Facebook post

**Step 5: Friend's Experience** Friend clicks link → Automatically tracked → Makes purchase → Referrer notified they earned points

***

### Experience #2: Social Media Sharing

When customer clicks "Share on Facebook/Twitter":

1. **Pre-filled social post appears** with:
   * Referral link embedded
   * Eye-catching description ("My favorite store! Use my link for a discount")
   * Product image (optional)
2. **Friend sees post**, clicks link → tracked → buys → referrer rewarded

***

## System Protection: How Fraud is Prevented

### Automatic Checks

Upzelo automatically detects and blocks:

* ✓ **Self-referrals**: Someone using their own referral link
* ✓ **Refunded orders**: Referral rewards reversed if order is refunded
* ✓ **Velocity abuse**: Unusually high referral counts from single person

***

## Referral Analytics: What You Should Monitor

### Key Metrics in Upzelo Dashboard

1. **Referral Rate**
   * % of customers actively referring
   * Goal: 10-30% is strong; vary by industry
2. **Conversion Rate**
   * % of referred friends who actually purchase
   * Track: Better than cold traffic? (Typically yes)
3. **Average Order Value (AOV)**
   * Do referred customers spend more than non-referred?
   * Typically YES — referred by trusted friend = higher spending
4. **Lifetime Value (LTV)**
   * Referred customers worth more long-term?
   * Typically YES — referrals build loyalty networks
5. **Cost Per Acquisition (CPA)**
   * Total referral reward value ÷ new customers acquired
   * Example: Paid 500 points ($50 value) to acquire 10 customers = $5 CPA

### Reports to Run Monthly

* Top referrers (who should you feature/reward?)
* Conversion rates by channel (social vs. email vs. SMS?)
* Referral trends (growing or declining?)

***

## Best Practices for Referral Success

### 1. Make Rewards Actually Valuable

❌ Don't: 5 points per referral (feels meaningless) ✅ Do: 50 points per referral + exclusive badge (feels rewarding)

### 2. Make Sharing Easy

* ✓ One-click social sharing buttons
* ✓ Pre-filled messages (don't make them write)
* ✓ Copy-to-clipboard link option
* ✓ Mobile-optimized widget

### 3. Reward BOTH Sides

* ✓ Referrer gets points
* ✓ New customer gets discount
* Both feel valued

### 4. Use Tiered Rewards

* Encourage repeat referrals
* Recognize "power referrers"
* Keep customers engaged longer

### 5. Promote the Program

* Feature on homepage
* Mention in confirmation emails
* Post on social media
* SMS reminder to inactive customers

### 6. Celebrate Success

* **"You earned 50 points!"** notification when referral converts
* **Leaderboard** showing top referrers
* **Special badges** for referral milestones

### 7. Monitor & Adjust

* Track which channels drive most referrals (social, email, SMS)
* Adjust reward amounts if needed
* Run seasonal promotions

***

## Common Questions

**Q: How long does it take for a referral to credit?** A: Usually within 1 hour of friend's purchase. Sometimes up to 24 hours if order requires approval.

**Q: Can customers game the system?** A: Upzelo detects self-referrals, and suspicious patterns automatically.

**Q: What if a referred friend returns their purchase?** A: Referral rewards are reversed (referee loses their discount, referrer loses bonus points).

**Q: Does it work on mobile?** A: Yes. The loyalty widget is fully optimized for phones and tablets. Also, the Loyalty pass can be used to improve the experience.

**Q: Can we exclude certain products from referral rewards?** A: Yes. Set rules like "exclude clearance items" or "only award for $50+ orders."

***

## Troubleshooting

| Issue                         | Why It Happens                    | Fix                                         |
| ----------------------------- | --------------------------------- | ------------------------------------------- |
| Friend isn't getting discount | Browser cache stored old tracking | Clear cookies, use private/incognito mode   |
| Referral credit not showing   | Order still processing            | Wait 24 hours; check order status in Upzelo |
| Referral link broken          | Link expired (optional)           | Regenerate link in loyalty widget           |
| Can't share to social media   | Widget pop-up blocked             | Allow pop-ups in browser settings           |

***

## Examples: Real Referral Programs

### Example 1: Simple Points

* Referrer gets: 25 bonus points
* New customer gets: $10 off first order
* Best for: Low-price items, high volume

### Example 2: Tiered Rewards

* Referrer gets: 50 points (1 referral), 150 points (5 referrals), 500 points (10 referrals)
* New customer gets: 20% off first order + free shipping
* Best for: Higher-price items, retention focus

### Example 3: Seasonal Boost

* Regular: 50 points per referral
* Holiday season: 100 points per referral (2X multiplier)
* New customer: Doubled discount too
* Best for: Driving sales in key periods

***

## Next Steps

1. **Plan your rewards**: Decide what referrers and referees get
2. **Set it up**: Follow "Setting Up Your Referral Program" section above
3. **Test**: Make test referrals to verify everything works
4. **Launch**: Announce to customers via email/social
5. **Monitor**: Check analytics weekly for first month
6. **Optimize**: Adjust rewards/messaging based on performance

***

## Need Help?

* **Dashboard**: Check Upzelo dashboard for real-time referral data
* **Support**: Contact Upzelo support for technical issues
* **Ideas**: See what competitors are doing (check their referral links!)

🚀 **Your referral program is now ready. Let your customers become your best marketers!**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.upzelo.xyz/documentation/referral_system_guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.