Contest

You can add contest functionality to any of your ReferralHero campaigns. This allows you to:

• Reward top advocates

• Select random winners (see section: Select Random Contest Winners)

• Issue manual rewards for any reason

These functionalities are available depending on the template you've selected for the campaign. If you're using the Waitlist & Contest template, all contest features are enabled by default. For Affiliate Program, Referral Program, or Custom templates, you'll need to toggle Manual Rewards ON in the Rewards section to use these features.

Manual Rewards for Promoted Winners

A manual reward can be triggered when you promote a subscriber through the ReferralHero dashboard or API. To set up a manual reward:

1. Go to Edit Campaign > Rewards > Toggle ON Manual Rewards > Click Add Reward

   
2. Assign a name (this field is required — leaving it blank will result in a “can’t be blank” error), label, and description to the reward

3. You have the option to set the subscriber’s rank to the last position after promotion

Example:

If you run a weekly competition where the top 5 subscribers on the leaderboard win a reward, and you've enabled the setting to move promoted subscribers to the last position:

• Promote the top 5 winners using the dashboard or API

• Their ranks are automatically moved to the last positions

• In the second week, a new set of top 5 winners can be selected

• The previous winners no longer occupy top spots but can still refer others, earn points, and unlock milestone rewards

This feature helps maintain fairness and ongoing engagement — without needing to delete past winners from the campaign.

Promoted Reward Email Notification

1. Turn on the ‘Notify subscriber when this reward is sent’ toggle in the reward setup to send an email notification to the subscribers

1. Go to Edit Campaign > Automations > Reward Emails/SMS Messages

2. Locate the email/SMS for this particular reward

3. Customize the email/SMS

4. Toggle ON the email/SMS and save the changes

Select Random Contest Winners

ReferralHero utilizes the ‘Pickup’ Ruby Gem to choose winners for your contest campaigns. This Gem enables the selection of a winner from the subscriber list with different probabilities based on the number of points/referrals assigned to them.

Subscribers with higher point/referral values have a higher chance of being chosen.

Example:

1. SubA - 3 points (The chance of SubA to pick is 30% (3/10 * 100)) 2. SubB - 4 points (The chance of SubB to pick is 40% (5/10 * 100)) 3. SubC - 2 points (The chance of SubC to pick is 20% (2/10 * 100)) 4. SubD - 1 point (The chance of SubD to pick is 10% (1/10 * 100))

They make a collection like, [SubA, SubA, SubA, SubB, SubB, SubB, SubB, SubC, SubC, SubD]

The collection is a list that contains four different subscribers (SubA, SubB, SubC, and SubD), each with a different number of points they’ve accumulated. The percentages provided for each subscriber represent the probability of that subscriber being chosen at random from the list.

SubA has a 30% chance of being chosen because it has three points, which is 30% of the total points (10) in the list. Similarly, SubB has a 40% chance of being chosen because it has four points, which is 40% of the total points in the list.

Promote Subscribers

There are three ways to promote subscribers:

Method 1: Pick Winners Randomly

1. In the Subscribers list, check the box next to the subscribers who are qualified for the promoted reward. This will activate the “Pick Winner” button

1. Click the “Pick Winner” button to open a modal popup with a randomly selected winner

1. To choose a different winner, click the “Pick new winner” button to generate a new random selection

2. From the reward dropdown, select the reward you want to assign to the promoted winner

3. Click the Promote button to apply the reward

Method 2: Bulk Promote a Set of Subscribers

1. In the Subscribers list, check the boxes next to the subscribers who are qualified for the promoted reward. This will activate the “Promote” button

1. Click the “Promote” button to open the “Reward for Winners” popup

1. Select the reward you want to assign to the selected subscribers

2. Click “Promote”

Method 3: Promote a Specific Subscriber

1. Go to the subscriber's profile

2. In the Campaign Info section, click the three-dot dropdown

3. Select “Promote”

1. In the “Reward for Winners” popup, select the reward

2. Click “Promote”

Unpromote Option

1. Once a subscriber is promoted, an “Unpromote” option will appear in the three-dot dropdown of the Campaign Info section within their profile

1. Unpromoting a subscriber will remove them from the Promoted list and place them back into their original position on the Subscribers list.

Promoted Subscribers List

To view the list of promoted subscribers, select “Promoted” under the Group filter.

All promotions / unpromotions will be recorded in the subscriber’s Timeline Log.