Campaign Screen

Referral Campaign Sharing Screen

The sharing screen appears once the user logins into the REFERRAL campaign. The screen enables him to refer to the brand with his friends or acquaintances so that he could earn points and rewards for referring. Here is a detailed guide to know how to launch the sharing screen in InviteReferrals.
Steps :

In your Dart code, you can import the invitereferrals files

import 'package:flutter_invitereferrals/IRUserInfo.dart';
import 'package:flutter_invitereferrals/IRCampaignInfo.dart';

Use the code mentioned below in order to activate the referral screen: -

IRCampaignInfo campaignData = new IRCampaignInfo();
campaignData.campaignID = 0; // pass 0(default) or your own campaign-id
campaignData.templateID = 0; // pass 0(default) or your own tamplate-id

IRUserInfo userData = new IRUserInfo();
userData.name = "user_name";
userData.email = "user_email";
userData.mobileNo = "01234567899";
userData.customValueOne = "value_1";
userData.customValueTwo = "value_2";

Invitereferrals.shared.campaign(campaignData, userData);
Invitereferrals.shared.campaignCallbacksListener((msg) {
  //do your task
});

Parameters
The parameters used in the above function are as follows: -

Parameter Name	Description	Value
name (string)	customer's name	abc
email (string)	customer's email id	[email protected]
mobileNo (string)	customer's mobile number	9812XXXXXX
subscriptionID (string)	customer's subscriptionID (Optional)	nil
customValueOne (string)	Any extra value you wanted to receive (Optional)	Mumbai
customValueTwo (string)	Any extra value you wanted to receive (Optional)	Maharashtra
campaignID (Integer)	ID of the campaign	10XXX or 0 (for default Campain if set in dashboard)
templateID (Integer)	ID of the UI template	0 (for default UI) or 1

When you call the above method in your app, then this function either loads the login screen or the campaign screen according to the value you have passed.

Response

You will get a response in terms of success or failure.

In case of SUCCESS

{"Authentication":"success","hitApi":"true"}

In case of FAILURE :

{"Authentication":"fail","Error":"Invalid authentication","ErrorType":"4"}

Following are the error-type with error message we receive in this callback in failure response.

Error Message	Error Type	Scenario
Data not found	2	In case when data not found
Campaign data not found	3	In case campaign is InActive or no campaign found
Invalid authentication	4	Invalid authentication
No internet connection	7	Parameter missing, email id or mobile no as per IR account setting cannot be empty or null
No internet connection	8	No internet connection

Login Screen

This screen will get loaded in case you don't pass user data in the function as shown in the example mentioned below: -

In your Dart code, you can import the invitereferrals files

import 'package:flutter_invitereferrals/IRCampaignInfo.dart';

IRCampaignInfo campaignData = new IRCampaignInfo();

campaignData.campaignID = 0; // pass 0(default) or your own campaign-id
campaignData.templateID = 0; // pass 0(default) or your own tamplate-id

Invitereferrals.shared.campaign(campaignData, null);
Invitereferrals.shared.campaignCallbacksListener((msg) {
      // do you task
});

Show Campaign Invite Popup

Simply, add the following line in the activity in which you want to show the referral program popup.

import 'package:flutter_invitereferrals/IRUserInfo.dart';
import 'package:flutter_invitereferrals/IRCampaignInfo.dart';

IRCampaignInfo campaignData = new IRCampaignInfo();

campaignData.campaignID = 0; // pass 0(default) or your own campaign-id
campaignData.templateID = 0; // pass 0(default) or your own tamplate-id

IRUserInfo userData = new IRUserInfo();
userData.name = "user_name";
userData.email = "user_email";
userData.mobileNo = "01234567899";
userData.customValueOne = "value_1";
userData.customValueTwo = "value_2";

Invitereferrals.shared.campaignPopup("rule_name", userData, campaignData);

Parameters
The parameters used in the above function are as follows: -

Parameter Name	Description	Value
ruleName (string)	Name of the rule to activate popup	Home referralInvite
name (string)	customer's name	abc
email (string)	customer's email id	[email protected]
mobileNo (string)	customer's mobile number	9812XXXXXX
subscriptionID (string)	customer's subscriptionID (Optional)	nil
customValueOne (string)	Any extra value you wanted to receive (Optional)	Mumbai
customValueTwo (string)	Any extra value you wanted to receive (Optional)	Maharashtra
campaignID (Integer)	ID of the campaign	10XXX or 0 (for default Campain if set in dashboard)
templateID (Integer)	ID of the UI template	0 (for default UI) or 1

Create Your Own Campaign Screen

This function can be used, in case you want to design your own custom sharing screen, using our sharing data.

import 'package:flutter_invitereferrals/IRUserInfo.dart';
import 'package:flutter_invitereferrals/IRCampaignInfo.dart';

IRCampaignInfo campaignData = new IRCampaignInfo();

campaignData.campaignID = 0; // pass 0(default) or your own campaign-id
campaignData.templateID = 0; // pass 0(default) or your own tamplate-id

IRUserInfo userData = new IRUserInfo();
userData.name = "user_name";
userData.email = "user_email";
userData.mobileNo = "01234567899";
userData.customValueOne = "value_1";
userData.customValueTwo = "value_2";

Invitereferrals.shared.getSharingDetails(userData, campaignData).then((value) {
    // do you task
});

Sample Response

{
   "Authentication":"success",
   "CustomerName":"Jack90",
   "Email":"[email protected]",
   "referral_code":"JACKQTVU",
   "referral_link":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136",
   "unique_code":"null",
   "stats":{
      "totalInvites":"0",
      "totalClicks":"0",
      "totalConverts":"0"
   },
   "popup_shareText":"Refer and win #Referral #Contests #inviteReferrals",
   "shareSubject":"Explore Tagnpin Referral Contest",
   "inviteMail":"<table>\r\n    <tr>\r\n        <td>Hi,<\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td><\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td>Your friend Jack90, has invited you to try Tagnpin through his referral link<\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td><\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td>Accept the invitation by clicking the link mentioned below.<\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td>https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136<\/td>\r\n    <\/tr>\r\n<\/table>",
   "whatsp_txt":"Refer and win #Referral #Contests #inviteReferrals",
   "shareText":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136 Refer and win #Referral #Contests #inviteReferrals",
   "email_shareText":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136?r=email <table>\r\n    <tr>\r\n        <td>Hi,<\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td><\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td>Your friend Jack90, has invited you to try Tagnpin through his referral link<\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td><\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td>Accept the invitation by clicking the link mentioned below.<\/td>\r\n    <\/tr>\r\n    <tr>\r\n        <td>https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136<\/td>\r\n    <\/tr>\r\n<\/table>",
   "whatsapp_shareText":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136?r=wa Refer and win #Referral #Contests #inviteReferrals",
   "sms_shareText":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136?r=sms Refer and win #Referral #Contests #inviteReferrals",
   "twitter_shareText":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136?r=tw Refer and win #Referral #Contests #inviteReferrals",
   "linkedin_shareText":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136?r=li Refer and win #Referral #Contests #inviteReferrals",
   "pinterest_shareText":"https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136?r=pi Refer and win #Referral #Contests #inviteReferrals",
   "fb_shareText":"{\nfbLink= https:\/\/tagnpinkp.ref-r.com\/c\/i\/27894\/59810136?r=fb Refer and win #Referral #Contests #inviteReferrals\n fbImage= https:\/\/s3.ap-south-1.amazonaws.com\/tagnpin-mumbai\/images\/fb_46287_27894_1.jpg\n}",
   "loginScreenData":"<link rel=\"stylesheet\" href=\"https:\/\/maxcdn.bootstrapcdn.com\/bootstrap\/3.3.5\/css\/bootstrap.min.css\"><style>body{background: transparent;}<\/style><div class=\"text-center\">\n    <h3><br \/>Heading<\/h3>\n    <p class=\"lead\">\n        The description of your referral campaign \n        <br>\n        comes here\n    <\/p>\n<\/div>",
   "shareScreenData":"<link rel=\"stylesheet\" href=\"https:\/\/maxcdn.bootstrapcdn.com\/bootstrap\/3.3.5\/css\/bootstrap.min.css\"><style>body{background: transparent;}<\/style><div class=\"text-center\">\n<h3><br \/>Heading<\/h3>\n<p class=\"lead\">The description of your referral campaign <br \/>comes here<\/p>\n<\/div>"
}