{"__v":20,"_id":"5714f033b9061c0e00d12387","category":{"__v":65,"_id":"551546edbc466623002afe72","pages":["551549c0bc466623002afe76","55154afbc859ac2f0001b486","55154daec859ac2f0001b48b","55154f36bc466623002afe7c","551550c5e68daa2f00cff84c","551551d4f854a31900368737","551552e7c859ac2f0001b494","551be4e3a0ee622b0087f69e","5527acc447b71d0d0044e6cd","552f84ad633a5b0d00e99daf","5537533df162750d00bbf7d0","554b3ffd6b448d0d00646d79","55506416fa289c0d0075e4f0","5550aaea00420e0d00d13113","55545865b450630d00041d80","55546906f9a7871700ef8e3c","555c4bf87e271d0d00f3c8c4","5564318c1fa8002300ea4bb0","556ffbd5910c090d00c432b6","557019f4cc189a21001ab258","55703aefcc189a21001ab2a3","5575a3c60b81dc230069c910","558ab69575eaf50d004e4cf3","55b0b41fb3171b3700b1539a","55ba2e48d72d1e1900276ac1","55ba45c804775a2f00628101","55c0b789344dc40d00f55933","55c0b8c837298d0d00088d88","55c0c095344dc40d00f55960","55d43e05b49ab11900328e2e","55d72c8c60fc730d00fc2738","55e6c564d678ad17001589ac","55e9b7780c9b420d0042b275","55f7cf2de32e9b0d00a2d4b6","56094efea7b2590d0089eb95","5613cdbeecbebc21003fa179","5613d8de6a092921004c30b8","5613de7c443514170060dbb6","5613e02823ecf6350009eefc","5613e4271db46e2100e142ad","5614d73c8113d20d00082e3e","561e11ae50e0a62100955946","561e2008efcf8217003adf77","5620f184b244890d001868e0","5620feb740e2c30d0002a899","562105ce40e2c30d0002a8a3","56210b3340e2c30d0002a8b3","56210c74b244890d0018690e","56249a0372ac510d00e49149","56249df185a31117001c53de","56249f0c85a31117001c53e1","5624a9e7c4bf501700bc5ec8","5624b29806e8040d005ed6a0","562507435a86b42300946324","563877854bfb360d00a463c1","5639e0f91846790d0089529a","565327d17d29410d004a0835","565457df04feff210074b17d","56545821ec189235002967af","565485099c4c6d0d00aeda02","5666f1f1f672550d000851ad","566abc7b74d574170070b700","566ad3c7c7c3cd1700265d14","566aede7b5ccc20d00817f71","566aef3147ebaf1900fe65d6"],"project":"54eb50e5615ffc1900305a16","version":"54eb63b859b1172100334fae","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-03-27T12:02:53.314Z","from_sync":false,"order":9,"slug":"advanced-tutorials","title":"Advanced tutorials"},"parentDoc":null,"project":"54eb50e5615ffc1900305a16","user":"5683bbad70331a0d00484b27","version":{"__v":21,"_id":"54eb63b859b1172100334fae","forked_from":"54eb63a1867e1917009b711d","project":"54eb50e5615ffc1900305a16","createdAt":"2015-02-23T17:30:32.501Z","releaseDate":"2015-02-23T17:30:32.501Z","categories":["54eb63b959b1172100334faf","54eb63b959b1172100334fb0","54eb63b959b1172100334fb1","54eb63b959b1172100334fb2","54ed8dd4ab373e2300f50eae","54ed99b2ab373e2300f50ede","55153a6de68daa2f00cff838","551546edbc466623002afe72","5515472ac28d6125001b8884","55154749c28d6125001b8885","555d9b4106dfec0d00d38ea7","5613e06e433e5735007c7708","5624bbb785a31117001c5403","56669e857cc81e0d00253f8e","568b8d837a42220d00498311","56a632277ef6620d00e2f18a","56d8147c3eb4dd0b00201aac","57a9ce2fac6db30e000d7efd","57a9cf4e944ea60e00dc3f74","58172386715dce0f00da4aa0","582dc59ee1b8692300c0dd03","589b19b4fec2730f0082e040","58b04a023529383900a759b5","58b92d1598157a0f004869bf"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-04-18T14:33:23.648Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":20,"body":"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 who is sending it, which guarantees it will be read more carefully.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Social Invites explained\",\n  \"body\": \"1. Send SMS using API to increase interest of your app\\n2. Infobip takes care about global coverage and highest delivery rates\\n3. User receives SMS containing direct download link for you app\\n4. User opens the SMS and clicks the link - You get a new client\\n5. Analyze statistics to detect conversion rate patterns\"\n}\n[/block]\nFurthermore, Infobip offers you the possibility to understand how many people recommended your app to their friends and how many of those friends viewed your app on the app store. It is done by automatic activation of conversion rate statistics for social invites messages sent to users.\n\nIntegrating 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.\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Step 1. Send Social Invites\"\n}\n[/block]\nThe Social Invites functionality is a built-in feature of the **[Fully featured textual message](doc:fully-featured-textual-message)** API method. You just need to include the **`tracking`** object in the request.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note\",\n  \"body\": \"When defining the tracking object for Social Invites, set the parameter **`track`** to **`URL`**.\\n\\nFor parameter **`type`** choose your own identifier. For example : **`IOS_APP`**, or **`SOCIAL_INVITES`**\"\n}\n[/block]\nBy enabling **`tracking`** you are both enabling automatic shortening of your long links and also tracking users’ click-through rates. Here is an example how to send social invites for your new Android application using Infobip's API :\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /sms/1/text/advanced HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\\n\\n{\\n   \\\"bulkId\\\":\\\"BULK-ID-123-xyz\\\",\\n   \\\"messages\\\":[\\n      {\\n         \\\"from\\\":\\\"InfoSMS\\\",\\n         \\\"destinations\\\":[\\n            {\\n               \\\"to\\\":\\\"41793026727\\\",\\n               \\\"messageId\\\":\\\"MESSAGE-ID-123-xyz\\\"\\n            },\\n            {\\n               \\\"to\\\":\\\"41793026731\\\"\\n            }\\n         ],\\n         \\\"text\\\":\\\"Hey, take a look at this awesome application :  https://play.google.com/store/apps/details?id=com.myApp\\\"\\n      }\\n    ],\\n   \\\"tracking\\\":{\\n         \\\"track\\\":\\\"URL\\\",\\n     \\t\\t \\\"type\\\":\\\"SOCIAL_INVITES\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nThe user will receive the original SMS message with the shortened URL:\n\n>*Hey, take a look at this awesome application: http://eel.nu/EJsE/cf9ZH*\n\nSo, the only remaining things are : open the SMS message and click the shortened link - and you have a new user on your application!\n\n\nIn the following chapter we'll show You how to retrieve the conversion rate statistics for your new and awesome application.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Step 2. Social Invites Statistics\"\n}\n[/block]\nIn order for You to focus on Your new app Infobip will take care of the delivery of messages and will handle the conversion rate process statistics. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Social Invites conversion rate process\",\n  \"body\": \"Send SMS - start process\\nUser clicks link - end of process\\n\\nFully automatized feature - no need for additional API calls or additional parameters\"\n}\n[/block]\nAs soon as you've sent your message with included **`tracking`** object the conversion rate process has begun. Once the user clicks the link included in the SMS the end of process is triggered. It is all done automatically, with no need to configure additional parameters or call different APIs, all the messages and URL link clicks will be included in the statistics. \n\n[block:api-header]\n{\n  \"type\": \"get\",\n  \"title\": \"api.infobip.com/ct/1/process\"\n}\n[/block]\nThe 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. \n\n**JSON request**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"GET: /ct/1/processes\\nHTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\",\n      \"language\": \"json\",\n      \"name\": \"JSON\"\n    }\n  ]\n}\n[/block]\n**JSON response** - contains all processes on a single account\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HTTP/1.1 200 OK\\nContent-Type: application/json\\n\\n{\\n\\\"processes\\\": [1]\\n  {\\n        \\\"key\\\": \\\"34BC1CA2CA7DF423459556AD7FC5A1A2\\\"\\n        \\\"name\\\": \\\"AUTO_GENERATED_PROCESS\\\"\\n        \\\"timeAdded\\\": \\\"2015-03-29T11:01:49.373+0000\\\"\\n        \\\"type\\\": \\\"SOCIAL_INVITES\\\"\\n        \\\"description\\\": \\\"Auto generated tracking process.\\\"\\n\\t}\\n}\",\n      \"language\": \"json\",\n      \"name\": \"JSON\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"get\",\n  \"title\": \"api.infobip.com/ct/1/process/:key/conversionrate\"\n}\n[/block]\nUsing the  **`key`**  from the previous statement retrieve conversion rate statistics for a single process.\n\n**JSON Request**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"GET: /ct/1/process/34BC1CA2CA7DF423459556AD7FC5A1A2/conversionrate\\nHTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\",\n      \"language\": \"json\",\n      \"name\": \"JSON\"\n    }\n  ]\n}\n[/block]\n\n**JSON Response** - conversion tracking statistics\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HTTP/1.1 200 OK\\nContent-Type: application/json\\n\\n{\\n  \\\"statistics\\\": [\\n    {\\n      \\\"intervalStart\\\": \\\"2015-02-12T09:58:20.337+0100\\\",\\n      \\\"startCount\\\": 200,\\n      \\\"endCount\\\": 170,\\n      \\\"conversionRate\\\": 0.85\\n    }\\n  ], \\n  \\\"cumulativeStatistics\\\": {\\n    \\\"startCount\\\": 200,\\n    \\\"endCount\\\": 170,\\n    \\\"conversionRate\\\": 0.85\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"JSON\"\n    }\n  ]\n}\n[/block]\n\nThe Response contains basic statistical data of a single conversion rate process  :\n\n|Parameter|Type|Description|\n|-|-|-|\n|*startCount*|long|Number of sent SMS messages|\n|*endCount*|long|Number of opened links from SMS messages.|\n|*conversionRate*|double|Conversion rate for your application.|\n\n\n\nThe following statistics represent the basic set of data which is collected and that could be retrieved using API.\n\nAdditionally, we collect detailed CTR with other useful information:\n\n- User’s mobile phone number\n- Network prefix\n- Country prefix \n- Mobile phone operating system\n\n***[Contact us](mailto:conversion.tracking:::at:::infobip.com)* for additional information about conversion tracking and setup assistance.**","excerpt":"Learn how to use Infobip's Social Invites feature in few easy steps.","slug":"social-invites","type":"basic","title":"Social Invites"}

Social Invites

Learn how to use Infobip's Social Invites feature in 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 who is sending it, which guarantees it will be read more carefully. [block:callout] { "type": "warning", "title": "Social Invites explained", "body": "1. Send SMS using API to increase interest of your app\n2. Infobip takes care about global coverage and highest delivery rates\n3. User receives SMS containing direct download link for you app\n4. User opens the SMS and clicks the link - You get a new client\n5. Analyze statistics to detect conversion rate patterns" } [/block] Furthermore, Infobip offers you the possibility to understand how many people recommended your app to their friends and how many of those friends viewed your app on the app store. It is done by 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. [block:api-header] { "type": "basic", "title": "Step 1. Send Social Invites" } [/block] The Social Invites functionality is a built-in feature of the **[Fully featured textual message](doc:fully-featured-textual-message)** API method. You just need to include the **`tracking`** object in the request. [block:callout] { "type": "info", "title": "Note", "body": "When defining the tracking object for Social Invites, set the parameter **`track`** to **`URL`**.\n\nFor parameter **`type`** choose your own identifier. For example : **`IOS_APP`**, or **`SOCIAL_INVITES`**" } [/block] By enabling **`tracking`** you are both enabling automatic shortening of your long links and also tracking users’ click-through rates. Here is an example how to send social invites for your new Android application using Infobip's API : [block:code] { "codes": [ { "code": "POST /sms/1/text/advanced HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json\n\n{\n \"bulkId\":\"BULK-ID-123-xyz\",\n \"messages\":[\n {\n \"from\":\"InfoSMS\",\n \"destinations\":[\n {\n \"to\":\"41793026727\",\n \"messageId\":\"MESSAGE-ID-123-xyz\"\n },\n {\n \"to\":\"41793026731\"\n }\n ],\n \"text\":\"Hey, take a look at this awesome application : https://play.google.com/store/apps/details?id=com.myApp\"\n }\n ],\n \"tracking\":{\n \"track\":\"URL\",\n \t\t \"type\":\"SOCIAL_INVITES\"\n }\n}", "language": "json" } ] } [/block] 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 on your application! In the following chapter we'll show You how to retrieve the conversion rate statistics for your new and awesome application. [block:api-header] { "type": "basic", "title": "Step 2. Social Invites Statistics" } [/block] In order for You to focus on Your new app Infobip will take care of the delivery of messages and will handle the conversion rate process statistics. [block:callout] { "type": "info", "title": "Social Invites conversion rate process", "body": "Send SMS - start process\nUser clicks link - end of process\n\nFully automatized feature - no need for additional API calls or additional parameters" } [/block] As soon as you've sent your message with included **`tracking`** object the conversion rate process has begun. Once the user clicks the link included in the SMS the end of process is triggered. It is all done automatically, with no need to configure additional parameters or call different APIs, all the messages and URL link clicks will be included in the statistics. [block:api-header] { "type": "get", "title": "api.infobip.com/ct/1/process" } [/block] 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** [block:code] { "codes": [ { "code": "GET: /ct/1/processes\nHTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json", "language": "json", "name": "JSON" } ] } [/block] **JSON response** - contains all processes on a single account [block:code] { "codes": [ { "code": "HTTP/1.1 200 OK\nContent-Type: application/json\n\n{\n\"processes\": [1]\n {\n \"key\": \"34BC1CA2CA7DF423459556AD7FC5A1A2\"\n \"name\": \"AUTO_GENERATED_PROCESS\"\n \"timeAdded\": \"2015-03-29T11:01:49.373+0000\"\n \"type\": \"SOCIAL_INVITES\"\n \"description\": \"Auto generated tracking process.\"\n\t}\n}", "language": "json", "name": "JSON" } ] } [/block] [block:api-header] { "type": "get", "title": "api.infobip.com/ct/1/process/:key/conversionrate" } [/block] Using the **`key`** from the previous statement retrieve conversion rate statistics for a single process. **JSON Request** [block:code] { "codes": [ { "code": "GET: /ct/1/process/34BC1CA2CA7DF423459556AD7FC5A1A2/conversionrate\nHTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json", "language": "json", "name": "JSON" } ] } [/block] **JSON Response** - conversion tracking statistics [block:code] { "codes": [ { "code": "HTTP/1.1 200 OK\nContent-Type: application/json\n\n{\n \"statistics\": [\n {\n \"intervalStart\": \"2015-02-12T09:58:20.337+0100\",\n \"startCount\": 200,\n \"endCount\": 170,\n \"conversionRate\": 0.85\n }\n ], \n \"cumulativeStatistics\": {\n \"startCount\": 200,\n \"endCount\": 170,\n \"conversionRate\": 0.85\n }\n}", "language": "json", "name": "JSON" } ] } [/block] 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](mailto:conversion.tracking@infobip.com)* for additional information about conversion tracking and setup assistance.**