Mobile Referral Program Guide - Outline
An overview of what the structure of your referral program will look like, an outline of the technical components that will be involved in setting up your mobile platform's referral program, and how each of these components tie together to create a full referral loop.
The focus of this Mobile referral program guide is on making use of an “API-only” Referral SaaSquatch program including the use of our squatch.js library and either Dollar Credit or Percent Discount rewards.
This Program Outline is based around the same core topics covered in the How Referral SaaSquatch Works Success Center article.
A high level look at referral programs for mobile platforms can be found back in the Mobile Referral Program Guide - Intro.
Further details, including code examples, on how to integrate this referral program into your product can be found in the companion Installation Guide in our technical documentation.
Existing customers can participate in the referral program in several different ways:
- Referral Widget in the app behind a login.
Placing the Referral Widget behind a login will allow your existing customers to interact with the referral program. Use each user’s personalized URL to load the Mobile Widget in an iFrame.
- Use the Mobile SDK to build your referral program into your native app's brand experience.
The above steps will allow the customers within the app to refer their friends by sharing their unique share link. There are also several other methods of engaging users outside of the app by providing them program information and their unique share links, such as broadcast/marketing emails, push notifications, etc.
Identification & Attribution
When a friend clicks on the unique share link we can redirect iOS or Android users, using our Branch integration, to the app store to install your app. The Branch integration stores the referral code of the person who referred them to easily build the referral connection.
After the referred user completes the signup flow for an account, identify this referred user using one of these methods:
- Use the SaaSquatch REST API to Create the Account & Create the User
- Load the Mobile Widget using EMPTY mode to register new participants and attribute the referral
- Using the Mobile SDK to register new participants and attribute the referral
Once the referred user hits the goalpost, SaaSquatch should be informed so we can mark this referral as complete in our system and generate a reward for the referrer. This step can be done in three different ways:
- Manually through the SaaSquatch Portal by looking up the user and changing their status
- Using the Mobile Widget URL and adding the account_status = "PAID" parameter
- Through the REST API by Updating the Account and setting it to PAID.
Since we are running a double sided referral program we need to fulfill both of these rewards.
Whenever a reward is created by SaaSquatch there is a webhook event generated. You can subscribe to these webhooks and listen for the
reward.created event. The rewards for both parties will be as following:
This reward is generated when a Referred User signs up through your platform and you identify them to us. You can filter by the
rewardSourceparameter equal to
REFERREDand fulfill this reward inside your system.
When the referred user’s account status was updated (see Conversion step), we mark the referral as successful and generate a reward. The webhook event
rewardSourceparameter that will say
FRIEND_SIGNUP. Use this webhook event to kick off reward fulfillment inside your system.
After fulfilling each reward, make sure to mark these rewards as redeemed using the Redeem a Single Reward API call. This will make sure that the user’s reward progress is updated inside the Referral Widget.
The companion installation guide for this overview can be found in our technical docs.
The information above provides an overview showing how each of the individual components of a referral program tie together to create a full referral loop.
If you have any further questions about information in this guide please don’t hesitate to contact our support team.