How to Configure and Track the Referral Program

This guide provides step-by-step instructions for administrators on how to set up, manage, and monitor the referral program on the WhiteLabel Community Deals Platform.

Table of Contents

1. Overview
2. Prerequisites
3. Accessing Referrer Management
4. Adding New Referrers
5. Managing Existing Referrers
6. Tracking Referral Performance
7. Managing Referral Transactions
8. Best Practices
9. Troubleshooting

Overview

The WhiteLabel Community Deals Platform includes a powerful referral program that allows you to partner with external individuals or organizations who can refer investors to your platform. This system enables you to:

1. Create and manage referrer accounts
2. Set custom commission rates for each referrer
3. Track referral links, clicks, and conversions
4. Monitor and process referral transactions
5. Analyze referral program performance

A well-configured referral program can significantly expand your platform's reach and bring in qualified investors.

Prerequisites

Before you begin, ensure you have:

• Admin access to the WhiteLabel Community Deals Platform
• A clear strategy for your referral program
• Identified potential referral partners
• Determined appropriate commission rates
• Wallet addresses for commission payments

Accessing Referrer Management

1. Log in to your admin account and navigate to the Admin Dashboard.

2. Access Referrer Management by clicking on "Referrers" in the left sidebar navigation menu.

3. View the Referrer Dashboard which displays key metrics:

   • Total Referrers: Number of referral partners (including pending approval)
   • Total Referrals: Number of successful referrals
   • Commission Paid: Total amount paid to referrers
   • Conversion Rate: Percentage of clicks that result in investments

Adding New Referrers

To add a new referral partner to your platform:

1. Click the "Add New Referrer" button in the top-right corner of the Referrer Management page.

2. Complete the referrer information form:

   • Name: Enter the name of the referrer or organization
   • Wallet Address: Enter the Ethereum address where commission payments will be sent
   • Commission Rate: Set the percentage of investment that the referrer will receive as commission
   • Status: Select the initial status (typically "Pending" until approved)
   • Notes: Add any additional information about this referrer

3. Click "Add Referrer" to create the new referrer account.

4. The system will generate a unique referral code for this partner, which they can use to create referral links.

Managing Existing Referrers

The Referrers table allows you to manage all your referral partners:

1. View all referrers in the table, which displays:

   • Name
   • Wallet address
   • Commission rate
   • Status
   • Number of links
   • Number of transactions
   • Creation date

2. Filter referrers by status:

   • All: View all referrers
   • Approved: View only active referrers
   • Pending: View referrers awaiting approval
   • Suspended: View referrers who have been temporarily disabled

3. Search for specific referrers using the search box.

4. Access referrer details by clicking on the three dots menu for a specific referrer.

5. Approve or reject pending referrers:

   • Review pending applications
   • Click "Approve" to activate a referrer
   • Click "Reject" to decline a referrer application

Tracking Referral Performance

To monitor the performance of individual referrers:

1. Click on a referrer's name in the Referrers table to access their detailed profile.

2. View referrer details:

   • Basic information (name, wallet address, status)
   • Commission rate
   • Creation date

3. Review performance metrics:

   • Total Links: Number of active referral links
   • Conversion Rate: Percentage of clicks resulting in investments
   • Total Commission: Amount earned by this referrer
   • Transactions: Number of completed referral transactions

4. Access quick actions:

   • Manage Referral Links: View and manage this referrer's links
   • View Transactions: See all transactions attributed to this referrer
   • Back to All Referrers: Return to the main referrer list

5. Monitor clicks and conversions in the detailed analytics section.

6. Track commission earnings over time with the earnings chart.

Managing Referral Transactions

The referral system tracks all transactions that result from referrals:

1. Access transactions by clicking "View Transactions" from a referrer's detail page.

2. Review transaction details:

   • Deal: The investment opportunity that was referred
   • Investor: The wallet address of the referred investor
   • Investment: The amount invested
   • Commission: The amount earned by the referrer
   • Status: Current status of the transaction (Pending, Approved, Rejected)
   • Created: Date the transaction was created

3. Filter transactions by status using the status dropdown.

4. Process pending transactions:

   • View Details: See complete transaction information
   • Approve: Confirm the transaction and initiate commission payment
   • Reject: Decline the transaction (no commission will be paid)
   • Delete: Remove the transaction record

5. Create manual transactions if needed by clicking "Create Transaction" button.

Best Practices

To maximize the effectiveness of your referral program:

1. Set appropriate commission rates:

   • Consider industry standards (typically 1-10%)
   • Adjust rates based on referrer quality and volume
   • Consider tiered commission structures for high-performing referrers

2. Establish clear approval criteria:

   • Define who qualifies to be a referrer
   • Create a vetting process for new applicants
   • Document approval requirements

3. Monitor performance regularly:

   • Review conversion rates to identify successful referrers
   • Track click-to-investment ratios
   • Analyze which types of deals are most successful through referrals

4. Communicate with referrers:

   • Provide regular updates on platform changes
   • Share marketing materials and deal information
   • Offer guidance on how to improve conversion rates

5. Optimize payment processes:

   • Establish regular payment schedules
   • Ensure wallet addresses are verified
   • Keep detailed records of all commission payments

Troubleshooting

Common Referral Program Issues

Issue	Solution
Referral links not tracking	Check that cookies are enabled and tracking parameters are correct
Commissions not calculating correctly	Verify commission rates and investment amounts
Referrer cannot access their dashboard	Ensure their account is approved and they have the correct access
Low conversion rates	Review referral landing pages and provide better marketing materials
Payment failures	Verify wallet addresses and ensure sufficient funds for commission payments

Technical Issues

Problem	Solution
Missing transaction data	Check database synchronization and referral tracking code
Duplicate referral credits	Review transaction logs and remove duplicates
Referral attribution errors	Verify cookie duration and multi-touch attribution settings
Reporting discrepancies	Reconcile transaction data with blockchain records

If you encounter persistent issues with the referral program, contact your platform's technical support team for assistance.

---

By following this guide, you'll be able to effectively configure and track your referral program on the WhiteLabel Community Deals Platform, expanding your investor base and growing your platform's reach.