How can I personalize emails sent to participants?
GrowSurf lets you use dynamic text to craft personalized emails for each recipient, thereby improving open and click rates.
Variables (Basic)
Use variables to generate dynamic text.
Variable | Description | Restrictions | Example |
{{email}} | Participant's email | |
[email protected] |
{{firstName}} | Participant's first name | |
Emily |
{{lastName}} | Participant's last name | |
Smith |
{{rank}} | Participant's rank | |
3 |
{{participantId}} | Participant's ID | x87aD | |
{{impressions}} | Participant's impressions count | |
94 |
{{uniqueImpressions}} | Participant's unique impressions count | |
21 |
{{referrals}} | Participant's referral count in total | |
9 |
{{monthlyReferrals}} | Participant's referral count this month | |
2 |
{{shareUrl}} | Participant's unique referral link — generated as HTML* <a href="{{shareUrl}}" clicktracking="off">{{shareUrl}}</a> |
|
https://company.com?grsf=x87aD |
{{shareUrlRaw}} | Participant's unique referral link — generated as raw text {{shareUrlRaw}} |
https://company.com?grsf=x87aD | |
{{rewardWon}} | The description of the most-recent reward that the participant has won (the appropriate reward description will be displayed based on whether the winner is a referrer or referred friend) |
Can only be used in email templates
New Participant Reward and
Campaign Ended (to winners)
|
Refer 2 people and receive a Tesla duffel bag not available for general purchase. |
{{rewardWonCoupon}} | The coupon code of the most-recent reward that the participant has won (the appropriate reward coupon will be displayed based on whether the winner is a referrer or referred friend). NOTE: If you have a third-party integration enabled like Stripe Coupons then {{rewardWon}} will be overwritten with the value of the unique coupon code. |
Can only be used in email templates New Participant Reward and Campaign Ended (to winners) | X7LKD |
{{isReferrer}} | If the participant is the referrer (only applies to double-sided rewards) | Can only be used in email template New Participant Reward | true |
{{campaignRewards}} | A list of all rewards in the campaign | |
|
{{referrerEmail}} | The referrer's email | Can only be used in email template Invite | [email protected] |
{{referrerFirstName}} | The referrer's first name | Can only be used in email template Invite | Emily |
{{referrerLastName}} | The referrer's last name | Can only be used in email template Invite | Smith |
{{referrerShareUrl}} | The referrer's unique referral URL | Can only be used in email template Invite | https://company.com?grsf=x87aD |
{{referrerMessage}} | The referrer's custom message they wrote when sending out email invites. | Can only be used in email template Invite | I've been using this service for a few years and I'd highly recommend it. If you sign up, we both get 3 months free: https://company.com?grsf=x87aD |
{{oneTimeLoginLink}} | A one-time login link that the participant can authenticate with | Can only be used in email template One-Time Login Link | https://piedpiper.com?grsf_auth_token=240a8047b973c20 |
{{oneTimeLoginLinkExpiration}} | The expiration period (in hours) of the one-time login link that the participant can authenticate with. This value will always be 12 hours. |
Can only be used in email template One-Time Login Link | 12 |
{{oneTimeLoginLinkRequestUrl}} |
The URL that the participant requested their one-time login link from | Can only be used in email template One-Time Login Link | https://piedpiper.com |
{{landingPageUrl}} | The referral portal the participant can visit to grab their unique link and track their rewards progress | https://refer.piedpiper.com |
|
{{landingPageUrlWithAuth}} | The referral portal the participant can visit to grab their unique link and track their rewards progress (participant will automatically be added or logged in) | https://[email protected] |
*{{shareUrl}} is generated as an HTML anchor link with a clicktracking="off"
attribute. This is necessary for your email recipients to properly copy/paste their unique share URLs from their email client; otherwise, copy/pasting will produce an obfuscated and longer URL generated by GrowSurf's email service provider (e.g., http://click.growsurf.com/ls/click?upn=QPpqCxKpqDVKM14
). Please note, that referral tracking will still work, but the copied link isn't preferable for your participants to share.
For example:
Hi {{firstName}},
if the participant’s first name is Emily, the results will look like this:
Hi Emily,
Fallbacks (Basic)
GrowSurf parses dynamic text as JavaScript. Use fallbacks in case a variable doesn’t have a value.
For example:
Hi {{firstName || 'Friend'}},
if the participant’s first name is Emily, the results will look like this:
Hi Emily,
if the participant does not have a first name, the results will look like this:
Hi Friend,
Conditionals (Advanced)
Since GrowSurf parses dynamic text as JavaScript, it means you can use conditional expressions to display different text based on different scenarios.
For example:
Did you know that {{ referrals >= 1 ? "you’re doing an awesome job!" : "you can refer your friends to win big" }}!
If the participant has 1 or more referrals, the results will look like this:
Did you know that you're doing an awesome job!
Did you know that you can refer your friends to win big prizes?
New Participant Reward Emails
Display different text based on the reward won:
You can use the {{rewardWon}}
conditional in the following manner:
- Go to Campaign Editor > 1. Rewards and copy the description of each reward (to be used in the next step)
- Go to Campaign Editor > 3. Emails, and edit the New Participant Reward email. Here is an example:
{{rewardWon === 'Refer a friend and win a shirt!' ? 'You just won a shirt!' : ''}}
{{rewardWon === 'Refer a friend and win a sticker!' ? 'You just won a sticker!' : ''}}
You just won a shirt!
You just won a sticker!
Display different text based on whether the participant is the referrer or referred friend
You can use the {{isReferrer}}
conditional if your campaign has a double-sided reward and you want to discern between the referrer and the referred friend's unlocked reward.
For example:
{{isReferrer ? "You won a free trip to Mexico!" : "You've received 1 month free of our Startup plan!" }}
If the participant is the referrer, the results will look like this:
You won a free trip to Mexico!
If the participant is the referred friend, the results will look like this:
You've received 1 month free of our Startup plan!