{"_id":"57e0f374c4711017001cab65","project":"5429beef1163360800ed31fa","version":{"_id":"5429beef1163360800ed31fd","__v":21,"project":"5429beef1163360800ed31fa","createdAt":"2014-09-29T20:19:59.904Z","releaseDate":"2014-09-29T20:19:59.904Z","categories":["5429beef1163360800ed31fe","55e74e1f5d36b32b002563fa","55e7500a73169617001f2e86","55e76b8196131b2f00bf4b72","55e89569cdbb8a350096df9c","55f8935eb089b71700a8364e","55f8a67d3bb4bb0d0022d093","55f9dbefc7ef770d00d9bf6d","5601c21a22ecf60d002b27b3","5601c21ff12aee0d001bb06e","5601c2256c7b610d00280db5","5601c22c22ecf60d002b27b4","5603738d0c78b00d0039af47","5626f70bfcbbc621004ebf52","566f7a1ae144ab0d00e9732f","566f85ca7820960d00c3b93d","56708ce43a32d20d00c45cbf","56708d436995210d003aad8e","5736471abe10a9200030732c","57a82c7aff9bd30e00a6f1c1","591b8500e3992319007190f4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":1,"parentDoc":null,"user":"563b4a20dfa1282b000dd262","category":{"_id":"55f9dbefc7ef770d00d9bf6d","version":"5429beef1163360800ed31fd","__v":6,"pages":["55f9eec4c7ef770d00d9bf83","55f9fb8daba81f0d00a11566","5601ca6870694e0d00e3c66f","5601cb9b96e0f70d0044b0fd","56157d7af2d81d0d006c895f","5671d738c17bf90d00b95822"],"project":"5429beef1163360800ed31fa","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-16T21:15:27.664Z","from_sync":false,"order":4,"slug":"publisher-ui-setup","title":"Trafficking and Inventory"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-20T08:29:40.884Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":true,"order":15,"body":"Advertisers who run campaigns using the AdsNative platform can now track conversions within mobile apps (most typically for app download campaigns) and mobile web inventory. AdsNative is currently integrated with the following 3rd party trackers to enable conversion tracking:\n* TUNE\n* Kochava\n* AppsFlyer\n* Adjust\n\nAdvertisers who are using a different tracking partner or use an in-house tracking solution can also run app download campaigns on publishers who use the AdsNative platform and successfully track conversions.\n\nFollowing are the steps required to setup an app download campaign:\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Mobile Tracking or Measurement URL\"\n}\n[/block]\nIf you are integrated with the tracking partners listed above you can go to their dashboard to generate a tracking URL by selecting AdsNative as the advertising partner.\n\n**TUNE**\n\nInstructions for generating tracking url from TUNE\n https://help.tune.com/marketing-console/creating-a-measurement-url/\n\nSample tracking url from TUNE for AdsNative\nhttps://281549.measurementapi.com/serve?action=click&publisher_id=281549&site_id=2385&ios_ifa=[IDFA]&google_aid=[GAID]&ref_id=[SESSION_ID]\n\n**Kochava**\n\nInstructions for generating tracking url from Kochava\nhttp://www.kochavasupport.com/campaign-management/create-an-install-campaign\n\nSample tracking url from Kochava for AdsNative\nhttps://control.kochava.com/v1/cpi/click?campaign_id=sample&network_id=4196&click_id=[SESSION_ID]&device_id=[GAID]&site_id=adsnative\n\n**AppsFlyer**\n\nInstructions for generating tracking url from AppsFlyer\nhttps://support.appsflyer.com/hc/en-us/articles/207033816-Integrated-Media-Source-Partner-Configuration\n\nSample tracking url from AppsFlyer for AdsNative\nhttps://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=adsnative_int&clickid=[SESSION_ID]&idfa=[IDFA]&advertising_id=[GAID]\n\n**Adjust**\n\nInstructions for generating tracking url from Adjust\nhttps://docs.adjust.com/en/tracker-generation/\n\nSample tracking url from Adjust\nhttps://app.adjust.com/abc123\n\nPlease note that Adjust tracking setup is a bit unique. Unlike most tracking solutions, Adjust let's Network partners (like AdsNative) track conversions by letting them append Conversion Postback URLs to Adjust tracker link directly. In order to do that, please following the instructions below.\n\n1. Go to https://partners.adjust.com\n2. Enter your Adjust tracking link in the first box that says \"Enter your links\" (sample url https://app.adjust.com/abc123)\n3. In the second section \"Your callbacks\", please input the following url in the box next to \"Install\"\n    http://bevo.adsnative.com/conversions?tp=adjust&click_id=[SESSION_ID]&idfa=[IDFA]&gaid=[GAID]&ip_address=[IP]&user_agent=[UA]\n4. Once you complete step 3, you will see a link auto-generated in the last section \"Generated URLs\". Please copy this link. Sample generated url will look like this.\n    https://app.adjust.com/abc123?install_callback=http%3A%2F%2Fbevo.adsnative.com%2Fconversions%3Ftp%3Dadjust%26click_id%3D[SESSION_ID]%26idfa%3D[IDFA]%26gaid%3D[GAID]%26ip_address%3D[IP]%26user_agent%3D[UA]\n5. This is the final URL that you will need to use as explained in the \"Campaign Setup\" section below\n\n**Custom Tracking Partner or In-House Tracking**\nIf you are using a different tracking partner or custom/in-house tracking solution, you need to generate corresponding tracking url and must include following macros.\n [SESSION_ID] or [SESSION-ID] — this is mandatory\n [IDFA] — iOS advertising identifier (optional but recommended, if your tracking solution supports it\n [GAID] — Google advertising identifier (optional but recommended, if your tracking solution supports it)\n\nYou must also setup a postback to inform us of the conversion. You should send us the postback information on the following endpoint:\nhttp://bevo.adsnative.com/conversions?tp={your_tracking_partner_name}&click_id={SESSION_ID}&idfa={ios_advertising_identifier}&gaid={google_advertising_identifier}&dnt={limited_ad_tracking_flag_0_or_1}&ip_address={device_ip}&user_agent={device_user_agent}&ts={timestamp_in_unix_epoch_millis}\n\nPlease note that the click_id parameter in the postback must contain the value we passed on the tracking url (SESSION_ID). This is a mandatory parameter without which we will not be able to attribute the conversion back to your campaign.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Campaign Setup\"\n}\n[/block]\nWhile setting up campaign, you need to place the tracking URL (as explained in above section) under Creative’s click tracking placeholder. Please see the screenshot below.\n\nOnce the tracking URL is set up, fill rest of the campaign details and voila, you are done!\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/291fdb7-Conversion_Tracking_-_Tracking_URL_Setup.jpg\",\n        \"Conversion Tracking - Tracking URL Setup.jpg\",\n        1538,\n        462,\n        \"#fbfbf3\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Conversion Reports\"\n}\n[/block]\nYou can check conversions against your campaign under the Reports section of our dashboard. Please note that there will be a delay of 2–3 hours for conversion data to be updated on the console.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a76a45a-Conversion_Tracking_-_Reports.jpg\",\n        \"Conversion Tracking - Reports.jpg\",\n        1826,\n        636,\n        \"#fafafb\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"FAQs\"\n}\n[/block]\n**1. Is there an inventory constraint for running app download campaigns?**\nNo. Your campaigns can be set to run on all mobile apps and mobile web inventory that you have purchased uing the AdsNative platform. However, it will not work on desktop inventory since the app you are driving installs for is mobile specific.\n\n**2. Is [SESSION_ID] macro mandatory? What if I am using a tracking url that doesn’t contain this macro or doesn’t have placeholder for this macro?**\nYes, [SESSION_ID] is mandatory. We use this as unique click id to tie the conversion back to your campaign. Without this we won’t be able to attribute your conversions.\n If you are generating tracking urls from our integrated partners (TUNE, Kochava & AppsFlyer) then this macro is always present. However if your custom tracking solution doesn’t have a placeholder for this macro, then you won’t be able to track conversions.\n\n**3. What about [IDFA] & [GAID] macros? What are they used for and are they mandatory?**\n[IDFA] & [GAID] are macros for iOS and Google Advertising Identifier respectively. We internally replace these macros with corresponding advertising identifiers on click before sending tracking url to the tracking partner. While these macros are not mandatory, it increases the accuracy of attribution in case of mobile app inventory where advertising identifiers are available. Not having these macros will still work, but attribution may not be as accurate and your conversion rates can be lower. For mobile web inventory though, these macros are not required.\n\n**4. I have setup the campaign correctly but I am not seeing conversions. What could be the issue?**\nWe always recommend that before you setup a campaign, please perform a 1:1 testing of your tracking URL. This will help in figuring out if the entire end-to-end setup is working as expected. One of the common reasons for not seeing conversions, specially if you are using a custom tracking solution, is failing to set up postback to our system (conversion ping with valid click_id). If you are using our integrated partners (TUNE, Kochava & AppsFlyer), postback is always enabled by default.\n\n**5. What is the attribution window?**\nOur current attribution window is set to 7 days. This essentially means any conversion that happens upto 7 days after click is registered will be attributed. Conversions happening after 7 days from click time will not be attributed.However, we have plans to increase the window up to 28 days to allow for maximum attribution soon.","excerpt":"","slug":"conversion-tracking-for-mobile-apps","type":"basic","title":"Conversion Tracking for Mobile Apps"}

Conversion Tracking for Mobile Apps


Advertisers who run campaigns using the AdsNative platform can now track conversions within mobile apps (most typically for app download campaigns) and mobile web inventory. AdsNative is currently integrated with the following 3rd party trackers to enable conversion tracking: * TUNE * Kochava * AppsFlyer * Adjust Advertisers who are using a different tracking partner or use an in-house tracking solution can also run app download campaigns on publishers who use the AdsNative platform and successfully track conversions. Following are the steps required to setup an app download campaign: [block:api-header] { "type": "basic", "title": "Mobile Tracking or Measurement URL" } [/block] If you are integrated with the tracking partners listed above you can go to their dashboard to generate a tracking URL by selecting AdsNative as the advertising partner. **TUNE** Instructions for generating tracking url from TUNE https://help.tune.com/marketing-console/creating-a-measurement-url/ Sample tracking url from TUNE for AdsNative https://281549.measurementapi.com/serve?action=click&publisher_id=281549&site_id=2385&ios_ifa=[IDFA]&google_aid=[GAID]&ref_id=[SESSION_ID] **Kochava** Instructions for generating tracking url from Kochava http://www.kochavasupport.com/campaign-management/create-an-install-campaign Sample tracking url from Kochava for AdsNative https://control.kochava.com/v1/cpi/click?campaign_id=sample&network_id=4196&click_id=[SESSION_ID]&device_id=[GAID]&site_id=adsnative **AppsFlyer** Instructions for generating tracking url from AppsFlyer https://support.appsflyer.com/hc/en-us/articles/207033816-Integrated-Media-Source-Partner-Configuration Sample tracking url from AppsFlyer for AdsNative https://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=adsnative_int&clickid=[SESSION_ID]&idfa=[IDFA]&advertising_id=[GAID] **Adjust** Instructions for generating tracking url from Adjust https://docs.adjust.com/en/tracker-generation/ Sample tracking url from Adjust https://app.adjust.com/abc123 Please note that Adjust tracking setup is a bit unique. Unlike most tracking solutions, Adjust let's Network partners (like AdsNative) track conversions by letting them append Conversion Postback URLs to Adjust tracker link directly. In order to do that, please following the instructions below. 1. Go to https://partners.adjust.com 2. Enter your Adjust tracking link in the first box that says "Enter your links" (sample url https://app.adjust.com/abc123) 3. In the second section "Your callbacks", please input the following url in the box next to "Install" http://bevo.adsnative.com/conversions?tp=adjust&click_id=[SESSION_ID]&idfa=[IDFA]&gaid=[GAID]&ip_address=[IP]&user_agent=[UA] 4. Once you complete step 3, you will see a link auto-generated in the last section "Generated URLs". Please copy this link. Sample generated url will look like this. https://app.adjust.com/abc123?install_callback=http%3A%2F%2Fbevo.adsnative.com%2Fconversions%3Ftp%3Dadjust%26click_id%3D[SESSION_ID]%26idfa%3D[IDFA]%26gaid%3D[GAID]%26ip_address%3D[IP]%26user_agent%3D[UA] 5. This is the final URL that you will need to use as explained in the "Campaign Setup" section below **Custom Tracking Partner or In-House Tracking** If you are using a different tracking partner or custom/in-house tracking solution, you need to generate corresponding tracking url and must include following macros. [SESSION_ID] or [SESSION-ID] — this is mandatory [IDFA] — iOS advertising identifier (optional but recommended, if your tracking solution supports it [GAID] — Google advertising identifier (optional but recommended, if your tracking solution supports it) You must also setup a postback to inform us of the conversion. You should send us the postback information on the following endpoint: http://bevo.adsnative.com/conversions?tp={your_tracking_partner_name}&click_id={SESSION_ID}&idfa={ios_advertising_identifier}&gaid={google_advertising_identifier}&dnt={limited_ad_tracking_flag_0_or_1}&ip_address={device_ip}&user_agent={device_user_agent}&ts={timestamp_in_unix_epoch_millis} Please note that the click_id parameter in the postback must contain the value we passed on the tracking url (SESSION_ID). This is a mandatory parameter without which we will not be able to attribute the conversion back to your campaign. [block:api-header] { "type": "basic", "title": "Campaign Setup" } [/block] While setting up campaign, you need to place the tracking URL (as explained in above section) under Creative’s click tracking placeholder. Please see the screenshot below. Once the tracking URL is set up, fill rest of the campaign details and voila, you are done! [block:image] { "images": [ { "image": [ "https://files.readme.io/291fdb7-Conversion_Tracking_-_Tracking_URL_Setup.jpg", "Conversion Tracking - Tracking URL Setup.jpg", 1538, 462, "#fbfbf3" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "Conversion Reports" } [/block] You can check conversions against your campaign under the Reports section of our dashboard. Please note that there will be a delay of 2–3 hours for conversion data to be updated on the console. [block:image] { "images": [ { "image": [ "https://files.readme.io/a76a45a-Conversion_Tracking_-_Reports.jpg", "Conversion Tracking - Reports.jpg", 1826, 636, "#fafafb" ] } ] } [/block] [block:api-header] { "type": "basic", "title": "FAQs" } [/block] **1. Is there an inventory constraint for running app download campaigns?** No. Your campaigns can be set to run on all mobile apps and mobile web inventory that you have purchased uing the AdsNative platform. However, it will not work on desktop inventory since the app you are driving installs for is mobile specific. **2. Is [SESSION_ID] macro mandatory? What if I am using a tracking url that doesn’t contain this macro or doesn’t have placeholder for this macro?** Yes, [SESSION_ID] is mandatory. We use this as unique click id to tie the conversion back to your campaign. Without this we won’t be able to attribute your conversions. If you are generating tracking urls from our integrated partners (TUNE, Kochava & AppsFlyer) then this macro is always present. However if your custom tracking solution doesn’t have a placeholder for this macro, then you won’t be able to track conversions. **3. What about [IDFA] & [GAID] macros? What are they used for and are they mandatory?** [IDFA] & [GAID] are macros for iOS and Google Advertising Identifier respectively. We internally replace these macros with corresponding advertising identifiers on click before sending tracking url to the tracking partner. While these macros are not mandatory, it increases the accuracy of attribution in case of mobile app inventory where advertising identifiers are available. Not having these macros will still work, but attribution may not be as accurate and your conversion rates can be lower. For mobile web inventory though, these macros are not required. **4. I have setup the campaign correctly but I am not seeing conversions. What could be the issue?** We always recommend that before you setup a campaign, please perform a 1:1 testing of your tracking URL. This will help in figuring out if the entire end-to-end setup is working as expected. One of the common reasons for not seeing conversions, specially if you are using a custom tracking solution, is failing to set up postback to our system (conversion ping with valid click_id). If you are using our integrated partners (TUNE, Kochava & AppsFlyer), postback is always enabled by default. **5. What is the attribution window?** Our current attribution window is set to 7 days. This essentially means any conversion that happens upto 7 days after click is registered will be attributed. Conversions happening after 7 days from click time will not be attributed.However, we have plans to increase the window up to 28 days to allow for maximum attribution soon.