Social Invites

Learn how to use Infobip's Social Invites feature in only a few easy steps.

Social invites are the most efficient app referral system. By including this capability, users can send an SMS to their phone contacts and invite them to download your app and try it out for themselves. The SMS is free for the user and you can include information about the contact sending the invite, which guarantees the message will have a greater chance of being read.

Social Invites explained

  1. Send an SMS using API to acquire new users
  2. Infobip takes care of the global coverage and highest delivery rates
  3. User receives the SMS containing a direct download link for you app
  4. User opens the SMS and clicks the link - You get a new client
  5. Analyze statistics to detect conversion rate patterns

Furthermore, Infobip offers you the possibility to see how many people recommended your app to their friends and how many of those friends viewed your app in the app store. This is done following the automatic activation of conversion rate statistics for social invites messages sent to users.

Integrating social invites into your app is as easy as all Infobip solutions. In the following tutorial we’ll show you how to do it in three easy steps.

Step 1. Send Social Invites

The Social Invites functionality is a built-in feature of the Fully featured textual message API method. You just need to include the tracking object in the request.

Note

When defining the tracking object for Social Invites, set the parameter track to URL.

For the parameter type choose your own identifier. For example : IOS_APP, or SOCIAL_INVITES

By enabling tracking you are both enabling automatic shortening of your long links and also tracking users’ click-through rates. Here is an example of how to send social invites for your new Android application using Infobip’s API :

POST /sms/1/text/advanced HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

{
   "bulkId":"BULK-ID-123-xyz",
   "messages":[
      {
         "from":"InfoSMS",
         "destinations":[
            {
               "to":"41793026727",
               "messageId":"MESSAGE-ID-123-xyz"
            },
            {
               "to":"41793026731"
            }
         ],
         "text":"Hey, take a look at this awesome application :  https://play.google.com/store/apps/details?id=com.myApp"
      }
    ],
   "tracking":{
         "track":"URL",
     		 "type":"SOCIAL_INVITES"
    }
}	
  

The user will receive the original SMS message with the shortened URL:

Hey, take a look at this awesome application: http://eel.nu/EJsE/cf9ZH

So, the only remaining things are: open the SMS message and click the shortened link - and you have a new user!

In the following chapter we’ll show you how to retrieve the conversion rate statistics for your new and awesome app.

Step 2. Social Invites Statistics

In order for you to focus on your new app, Infobip will take care of message delivery and handle the conversion rate process statistics.

Social Invites conversion rate process

Send SMS - start process User clicks link - end of process

Fully automatized feature - no need for additional API calls or additional parameters

As soon as you’ve sent your message with the included tracking object, the conversion rate process has begun. Once the user clicks the link included in the SMS the end of the process is triggered. It is all done automatically, with no need of configuring additional parameters or calling different APIs, all of the messages and URL link clicks will be included in the statistics.

api.infobip.com/ct/1/process

The conversion rate processes are identified by a key. There are several methods which can be used to obtain the statistics of conversion rate processes but the first step is to get all conversion rate processes linked to your account.

JSON request

GET: /ct/1/processes
HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json	
  

JSON response - contains all processes on a single account

HTTP/1.1 200 OK
Content-Type: application/json

{
"processes": [1]
  {
        "key": "34BC1CA2CA7DF423459556AD7FC5A1A2"
        "name": "AUTO_GENERATED_PROCESS"
        "timeAdded": "2015-03-29T11:01:49.373+0000"
        "type": "SOCIAL_INVITES"
        "description": "Auto generated tracking process."
	}
}	
  

api.infobip.com/ct/1/process/:key/conversionrate

Retrieve conversion rate statistics for a single process, using the key from the previous statement.

JSON Request

GET: /ct/1/process/34BC1CA2CA7DF423459556AD7FC5A1A2/conversionrate
HTTP/1.1
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json	
  

JSON Response - conversion tracking statistics

HTTP/1.1 200 OK
Content-Type: application/json

{
  "statistics": [
    {
      "intervalStart": "2015-02-12T09:58:20.337+0100",
      "startCount": 200,
      "endCount": 170,
      "conversionRate": 0.85
    }
  ], 
  "cumulativeStatistics": {
    "startCount": 200,
    "endCount": 170,
    "conversionRate": 0.85
  }
}	
  

The response contains basic statistical data of a single conversion rate process :

Parameter Type Description
startCount long Number of sent SMS messages.
endCount long Number of opened links from SMS messages.
conversionRate double Conversion rate for your application.

The following statistics represent the basic set of data which is collected and that could be retrieved using API.

Additionally, we collect detailed CTR with other useful information:

  • User’s mobile phone number
  • Network prefix
  • Country prefix
  • Mobile phone operating system

Contact us for additional information about conversion tracking and setup assistance.