Referral Customization for iOS | Referral Marketing Developer Guide

UI Customization

The referral UI components are available in LoyaltyMobileSDK-iOS/SampleApps/MyNTORewards/MyNTORewards/Referral/Views.

For example, to include Gmail as one of the options to share a referral code:

Add the new Gmail icon in the LoyaltyMobileSDK-iOS/SampleApps/MyNTORewards/MyNTORewards/Assets.xcassets folder.
Open the LoyaltyMobileSDK-iOS/SampleApps/MyNTORewards/MyNTORewards/Referral/Views/ReferAFriendView.swift file in Xcode, and add the new icon ID to the list of icon IDs.

1HStack("spacing":15){
2   "Button"{
3      "showShareSheet.toggle()"
4   }"label":{
5      "Image(""ic-fb"")"
6   }".sheet(isPresented":"$showShareSheet)"{
7      "ActivityViewController(activityItems":[
8         "shareText"
9      ]")"
10   }"Button"{
11      "showShareSheet.toggle()"
12   }"label":{
13      "Image(""ic-ig"")"
14   }".sheet(isPresented":"$showShareSheet)"{
15      "ActivityViewController(activityItems":[
16         "shareText"
17      ]")"
18   }"Button"{
19      "shareToWhatsApp(text":"shareText)"
20   }"label":{
21      "Image(""ic-whatsapp"")"
22   }"Button"{
23      "shareToTwitter(text":"shareText)"
24   }"label":{
25      "Image(""ic-twitter"")"
26   }"Button"{
27      "shareToGmail(text":"shareText)"
28   }"label":{
29      "Image(""ic-gmail"")"
30   }"Button"{
31      "showShareSheet.toggle()"
32   }"label":{
33      "Image(""ic-share"")"
34   }

Settings Customization

You can modify the referral program details in the LoyaltyMobileSDK-iOS/SampleApps/SampleApps/MyNTORewards/MyNTORewards/AppSettings.swift file.

Here are all the properties you can modify.

1// Referral settings
2static let referralProgramName = loyaltyProgramName
3// Configure the referral promotion details below, where a user can enroll and refer from the My Referrals screen
4static let promotionCode = "TEMPRP7"
5static let referralDateFormat = "yyyy-MM-dd'T'HH:mm:ss"
6static let referralDateFormatWithoutTime = "yyyy-MM-dd"
7/* Provided an example link here instead of the actual Terms and Conditions link.
8Replace with valid terms and conditions link while using the feature */
9static let referralTermsLink = "https://www.google.com"

promotionCode: The default promotion code.
referralDateFormat and referralDateFormatWithoutTime: The referral activity date format with and without time.
referralProgramName: The default referral program name.
referralTermsLink: An external Terms and Conditions link.

For a complete walkthrough of the referral feature in the MyNTORewards app, see Walkthrough of the Sample App.

An advocate can refer a friend only once. When an advocate makes repeated attempts to refer a friend, you can show a custom message based on your company’s branding.

Note