Social Invites

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.

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.

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 :

• JSON

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.

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

• JSON

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

• JSON

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

{
    "processes": [
        {
            "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

• JSON

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

• JSON

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.