{"__v":0,"_id":"58e651be701bd123006faa18","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":"58e64f4ad303ca1900c7e712","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":"2017-04-06T14:33:34.484Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":true,"order":21,"body":"When you're having an SMS or Voice campaign, it can be very useful to track it's performance and to measure your users conversion rates. For example, if you are sending One-Time PINs, it is really important to track conversion rates so you can optimize your flow and processes.\nOTP tracking solution will automatically track every message sent over Infobip platform. Just set the track parameter to SMS or Voice , and optionally put the type parameter of your campaign and tracking will be done automatically.\nThese features are set in the tracking objects in the Fully featured textual message API for SMS or Fully featured Voice message API for Voice method:\n\n###SMS tracking example:\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   \\\"messages\\\":[\\n      {\\n         \\\"from\\\":\\\"InfoSMS\\\",\\n         \\\"destinations\\\":[\\n            {\\n               \\\"to\\\":\\\"41793026731\\\"\\n            }\\n         ],\\n         \\\"text\\\":\\\"Your PIN is 1a2B3c.\\\"\\n      }\\n    ],\\n   \\\"tracking\\\":{\\n         \\\"track\\\":\\\"SMS\\\",\\n     \\t\\t \\\"type\\\":\\\"One_Time_Pin\\\"\\n    }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nResponse:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"HTTP/1.1 200 OK\\nContent-Type: application/json\\n\\n{\\n  \\\"bulkId\\\": \\\"1446634544520356423\\\",\\n  \\\"messages\\\": [\\n    {\\n      \\\"to\\\": \\\"41793026731\\\",\\n      \\\"status\\\": {\\n        \\\"groupId\\\": 1,\\n        \\\"groupName\\\": \\\"PENDING\\\",\\n        \\\"id\\\": 7,\\n        \\\"name\\\": \\\"PENDING_ENROUTE\\\",\\n        \\\"description\\\": \\\"Message sent to next instance\\\"\\n      },\\n      \\\"smsCount\\\": 1,\\n      \\\"messageId\\\": \\\"8ef699bc-d4c6-4cf6-8d6e-9a9aa62ad93a\\\"\\n    }\\n  ]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nAs a response you should receive a **`200 OK`** status with message details in the response body.\n\n###Voice tracking example:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /tts/3/advanced HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\\nAccept: application/json\\n\\n{\\n   \\\"messages\\\": [\\n      {\\n         \\\"from\\\": \\\"41793026700\\\",\\n         \\\"destinations\\\": [\\n            {\\n               \\\"to\\\": \\\"41793026731\\\"\\n            }\\n         ],\\n         \\\"text\\\": \\\"Test Voice message.\\\",\\n      }\\n   ],\\n   \\\"tracking\\\":{\\n         \\\"track\\\": \\\"VOICE\\\",\\n         \\\"type\\\": \\\"MY_CAMPAIGN\\\"\\n   }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nResponse:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"bulkId\\\": \\\"BULK-ID-123-xyz\\\",\\n  \\\"messages\\\": [\\n    {\\n      \\\"to\\\": \\\"41793026731\\\",\\n      \\\"status\\\": {\\n        \\\"groupId\\\": 1,\\n        \\\"groupName\\\": \\\"PENDING\\\",\\n        \\\"id\\\": 26,\\n        \\\"name\\\": \\\"PENDING_ACCEPTED\\\",\\n        \\\"description\\\": \\\"Message accepted, pending for delivery.\\\"\\n      },\\n      \\\"messageId\\\": \\\"MESSAGE-ID-123-xyz\\\"\\n    }\\n  ]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nAs a response you should receive a **`200 OK`** status with message details in the response body.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Conversion rate submision\"\n}\n[/block]\nWhen user successfully performs the action after receiving the SMS or Voice message, for example enters One-Time PIN in your app, you can send that info to us so we can measure Conversion rates.\nFor Conversion rate submission, you need to provide only the messageId received after sending the SMS or Voice message. The messageId has to be submitted to our endpoint as conversion happens.\nEndpoint for submitting the conversion rates: https://api.infobip.com/ct/1/log/end/{messageId}.\n\n\n**Example:**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /ct/1/log/end/8ef699bc-d4c6-4cf6-8d6e-9a9aa62ad93a HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nAs a response, you will receive a **`processKey`** that is used for [getting conversion rates and statistics](doc:getting-conversion-rate-and-statistics):\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n \\t\\t\\\"processKey\\\": \\\"A37D448C1ACCA02FABA745522558326C\\\" \\n} \",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n-----\n### **Tip:** [Get your Conversion rates and statistics](doc:getting-conversion-rate-and-statistics)\nYou can easily get Conversion rates for your SMS tracking processes.","excerpt":"Automatically track Conversion rates for your campaigns.","slug":"sms-tracking","type":"basic","title":"Message tracking solution"}

Message tracking solution

Automatically track Conversion rates for your campaigns.

When you're having an SMS or Voice campaign, it can be very useful to track it's performance and to measure your users conversion rates. For example, if you are sending One-Time PINs, it is really important to track conversion rates so you can optimize your flow and processes. OTP tracking solution will automatically track every message sent over Infobip platform. Just set the track parameter to SMS or Voice , and optionally put the type parameter of your campaign and tracking will be done automatically. These features are set in the tracking objects in the Fully featured textual message API for SMS or Fully featured Voice message API for Voice method: ###SMS tracking example: [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 \"messages\":[\n {\n \"from\":\"InfoSMS\",\n \"destinations\":[\n {\n \"to\":\"41793026731\"\n }\n ],\n \"text\":\"Your PIN is 1a2B3c.\"\n }\n ],\n \"tracking\":{\n \"track\":\"SMS\",\n \t\t \"type\":\"One_Time_Pin\"\n }\n}", "language": "json" } ] } [/block] Response: [block:code] { "codes": [ { "code": "HTTP/1.1 200 OK\nContent-Type: application/json\n\n{\n \"bulkId\": \"1446634544520356423\",\n \"messages\": [\n {\n \"to\": \"41793026731\",\n \"status\": {\n \"groupId\": 1,\n \"groupName\": \"PENDING\",\n \"id\": 7,\n \"name\": \"PENDING_ENROUTE\",\n \"description\": \"Message sent to next instance\"\n },\n \"smsCount\": 1,\n \"messageId\": \"8ef699bc-d4c6-4cf6-8d6e-9a9aa62ad93a\"\n }\n ]\n}", "language": "json" } ] } [/block] As a response you should receive a **`200 OK`** status with message details in the response body. ###Voice tracking example: [block:code] { "codes": [ { "code": "POST /tts/3/advanced HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json\nAccept: application/json\n\n{\n \"messages\": [\n {\n \"from\": \"41793026700\",\n \"destinations\": [\n {\n \"to\": \"41793026731\"\n }\n ],\n \"text\": \"Test Voice message.\",\n }\n ],\n \"tracking\":{\n \"track\": \"VOICE\",\n \"type\": \"MY_CAMPAIGN\"\n }\n}", "language": "json" } ] } [/block] Response: [block:code] { "codes": [ { "code": "{\n \"bulkId\": \"BULK-ID-123-xyz\",\n \"messages\": [\n {\n \"to\": \"41793026731\",\n \"status\": {\n \"groupId\": 1,\n \"groupName\": \"PENDING\",\n \"id\": 26,\n \"name\": \"PENDING_ACCEPTED\",\n \"description\": \"Message accepted, pending for delivery.\"\n },\n \"messageId\": \"MESSAGE-ID-123-xyz\"\n }\n ]\n}", "language": "json" } ] } [/block] As a response you should receive a **`200 OK`** status with message details in the response body. [block:api-header] { "type": "basic", "title": "Conversion rate submision" } [/block] When user successfully performs the action after receiving the SMS or Voice message, for example enters One-Time PIN in your app, you can send that info to us so we can measure Conversion rates. For Conversion rate submission, you need to provide only the messageId received after sending the SMS or Voice message. The messageId has to be submitted to our endpoint as conversion happens. Endpoint for submitting the conversion rates: https://api.infobip.com/ct/1/log/end/{messageId}. **Example:** [block:code] { "codes": [ { "code": "POST /ct/1/log/end/8ef699bc-d4c6-4cf6-8d6e-9a9aa62ad93a HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json", "language": "json" } ] } [/block] As a response, you will receive a **`processKey`** that is used for [getting conversion rates and statistics](doc:getting-conversion-rate-and-statistics): [block:code] { "codes": [ { "code": "{\n \t\t\"processKey\": \"A37D448C1ACCA02FABA745522558326C\" \n} ", "language": "json" } ] } [/block] ----- ### **Tip:** [Get your Conversion rates and statistics](doc:getting-conversion-rate-and-statistics) You can easily get Conversion rates for your SMS tracking processes.