{"_id":"599ebea4b8aed9002535d057","project":"5540ce1b31827a0d007ab1cc","version":{"_id":"5540ce1c31827a0d007ab1cf","project":"5540ce1b31827a0d007ab1cc","__v":31,"createdAt":"2015-04-29T12:27:08.390Z","releaseDate":"2015-04-29T12:27:08.390Z","categories":["5540ce1c31827a0d007ab1d0","5540d91bbb9e762d00f594ad","5540e5f131827a0d007ab212","5540e5febb9e762d00f594d3","5540e61331827a0d007ab213","5540e6195cf9682100d61afa","5540e62631827a0d007ab214","5540e63031827a0d007ab215","5540e63531827a0d007ab216","5540e63e5cf9682100d61afc","5540e6445cf9682100d61afd","5540e64a5cf9682100d61afe","55a4ff5b2e70c0250038050f","55acb28318eefd0d0071d504","55ae1abe8576b92300291c80","55ae453ef302af23000ac109","55af586d555b900d0036d296","55af91dac8a85321007a53c3","55b9fee204775a2f00628071","55b9ff0e04775a2f00628072","55b9ff4604775a2f00628073","55b9ff5fd72d1e1900276a38","55b9ff7f04775a2f00628074","55b9ff90eb08801900f833e5","55b9ffa5d72d1e1900276a39","55b9ffca04775a2f00628075","55b9fffdd72d1e1900276a3a","56bc2f033ee9e70d008b46af","56c2f6efbbf9ec2d00e0fe4f","57595bbb18760817001e8bbe","57d8d9793916800e003dde53"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55a4ff5b2e70c0250038050f","pages":["55a4ff7d750a9a23005332af","55a4ff8b750a9a23005332b1","55a4ff9b750a9a23005332b3","55a60bfcaaf9cf1900114efb","55a6184880c8a30d00b32526","55a61ba780c8a30d00b32532","55a61c97aaf9cf1900114f40","55a61ea9aaf9cf1900114f48","55a6206580c8a30d00b32544","55a64277aaf9cf1900114fc2","55a694d1aaf9cf1900115102","55a6a23eaaf9cf19001151e2","55a6a9b389c9da1900e2a41d","55a6aba45f88a70d0065b255","55a90687c8bd450d000dd157","55af84f3aa902f1700300daa","55afa3e3902fd51700f5f858","55b0cc5cb3171b3700b153fa","56015bdc3aa0520d00da0ced","5603fe3490ee490d004404c2","5633dd18d28a340d004004f5","56448c697a8cb50d00a3ea3f","56d7a2ec5208281500a2506c","56d859b8b159f10b00304577","56d9822add90610b002708a1","56ef44c6e8d6fa17006f244f"],"version":"5540ce1c31827a0d007ab1cf","project":"5540ce1b31827a0d007ab1cc","__v":26,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-07-14T12:23:55.603Z","from_sync":false,"order":2,"slug":"features","title":"Features"},"user":"55b125feae3b7621003e6482","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-08-24T11:55:16.599Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":41,"body":"## Overview\n\nA user can perform various actions in an app: send a message to a friend, upvote an article or add something to a shopping cart. Marketing specialists treasure this information as it helps to understand the audience and find ways to achieve business goals. One of such goals is conversion increase, or getting as many users as possible to act according to your needs.\n\nTo put it simply, **Conversion** is a desired action performed by a user. The **Conversion Rate** is the ratio of conversions to push opens. The **Conversion Tracking** shows the conversion rate of your pushes.\n\n## How it works\n\nWhen a user performs a specific action in your application, a `postEvent` API method gets fired. Our backend registers the number of times this method was fired in the application. The process is the following:\n\n  1. You launch a campaign or send a push message\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7f2b5dd-sendPush.png\",\n        \"sendPush.png\",\n        865,\n        449,\n        \"#efefef\"\n      ]\n    }\n  ]\n}\n[/block]\n2. A user receives a push notification and opens the message\n3. Any action of a user fires a `postEvent` method with the following attribute:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{“msgHash”:“hash_value”} // where “hash_value” is the hash of the push sent\",\n      \"language\": \"javascript\",\n      \"name\": null\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Setting up an Event\",\n  \"body\": \"To configure Events in your application, please see [**this guide**. ](http://docs.pushwoosh.com/docs/events)\"\n}\n[/block]\n4. Our server tracks the number of `postEvent` calls, or the number of conversions\n5. In your push statistics, we show the number of event hits and the conversion rate\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/c0c07fb-tracking.png\",\n        \"tracking.png\",\n        855,\n        317,\n        \"#e1eaee\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nIn case there are multiple events in the app, the statistics will show the Top 5. You can check the conversion rate for each action in the drop-down menu. \n\n## Using with Campaigns\n\nIf a push message is a part of a push campaign, you can monitor the Conversion Rate in the Campaign statistics tab:\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3f425a0-skitch-45.png\",\n        \"skitch-45.png\",\n        1154,\n        274,\n        \"#215788\"\n      ]\n    }\n  ]\n}\n[/block]\nLink your Push Campaign to a Preset so you can use it with other features such as [Autopushes](http://docs.pushwoosh.com/docs/autopushes), [Geozone notifications](http://docs.pushwoosh.com/docs/geozones), [Abandoned Cart alerts](http://docs.pushwoosh.com/docs/abandoned-cart-recovery), etc.","excerpt":"This guide describes how to set up and use the Conversion Tracking feature.","slug":"conversion-tracking","type":"basic","title":"Conversion tracking"}

Conversion tracking

This guide describes how to set up and use the Conversion Tracking feature.

## Overview A user can perform various actions in an app: send a message to a friend, upvote an article or add something to a shopping cart. Marketing specialists treasure this information as it helps to understand the audience and find ways to achieve business goals. One of such goals is conversion increase, or getting as many users as possible to act according to your needs. To put it simply, **Conversion** is a desired action performed by a user. The **Conversion Rate** is the ratio of conversions to push opens. The **Conversion Tracking** shows the conversion rate of your pushes. ## How it works When a user performs a specific action in your application, a `postEvent` API method gets fired. Our backend registers the number of times this method was fired in the application. The process is the following: 1. You launch a campaign or send a push message [block:image] { "images": [ { "image": [ "https://files.readme.io/7f2b5dd-sendPush.png", "sendPush.png", 865, 449, "#efefef" ] } ] } [/block] 2. A user receives a push notification and opens the message 3. Any action of a user fires a `postEvent` method with the following attribute: [block:code] { "codes": [ { "code": "{“msgHash”:“hash_value”} // where “hash_value” is the hash of the push sent", "language": "javascript", "name": null } ] } [/block] [block:callout] { "type": "info", "title": "Setting up an Event", "body": "To configure Events in your application, please see [**this guide**. ](http://docs.pushwoosh.com/docs/events)" } [/block] 4. Our server tracks the number of `postEvent` calls, or the number of conversions 5. In your push statistics, we show the number of event hits and the conversion rate [block:image] { "images": [ { "image": [ "https://files.readme.io/c0c07fb-tracking.png", "tracking.png", 855, 317, "#e1eaee" ], "border": true } ] } [/block] In case there are multiple events in the app, the statistics will show the Top 5. You can check the conversion rate for each action in the drop-down menu. ## Using with Campaigns If a push message is a part of a push campaign, you can monitor the Conversion Rate in the Campaign statistics tab: [block:image] { "images": [ { "image": [ "https://files.readme.io/3f425a0-skitch-45.png", "skitch-45.png", 1154, 274, "#215788" ] } ] } [/block] Link your Push Campaign to a Preset so you can use it with other features such as [Autopushes](http://docs.pushwoosh.com/docs/autopushes), [Geozone notifications](http://docs.pushwoosh.com/docs/geozones), [Abandoned Cart alerts](http://docs.pushwoosh.com/docs/abandoned-cart-recovery), etc.