Integration‎ > ‎

Conversion Tracking

These instructions allow a developer to report device unique-ids where an app is installed to Vdopia. This will allow Vdopia to provide conversion metrics for campaigns which include an app download component.

The methodology is that the app developer uses a web-service to report hashed unique-ids of devices where the app is installed. The developer can learn of the unique-ids in various ways, but in all cases, reporting to Vdopia happens through the same web-service. For example:

A) Developer adds code to their app to read the unique-id from the device, create a hash and report it to Vdopia.

B) Developer already has code to collect unique-ids from the app on their server. The developer implements a server-side service to call Vdopia with installed unique-ids.

C) Developer receives unique-ids where the app is installed through an analystics service (e.g. Flurry) and implements a server-side service to call Vdopia with installed unique-ids.

For all cases, the URL to invoke is:
http://serve.vdopia.com/adserver/html5/evttrk.php?e=dl&id=APP_ID&clickId=[CLICK_ID]&[unique-id parameters]&ip=[DEVICE_IP_ADDRESS]&ua=[DEVICE_USER_AGENT]

Parameters for unique-id are :
  • dius - SHA-1 hashed device-id (UDID for iOS and ANDROID_ID for Android)
  • dims - SHA-1 hashed MAC address
  • diis - SHA-1 hashed IMEI number
  • diod - ODIN-1 id for the device
  • diou - OpenUDID for the device
  • dimm - MD5 hashed MAC address
  • dium - MD5 hashed device-id (UDID for iOS and ANDROID_ID for Android)
  • diim - MD5 hased IMEI number
Click-id parameter ([CLICK_ID]) refers to the id passed in to the click URL leading to the app-store download. This is for apps using referrer URL tracking in Android or using a fingerprint-reporting service.

Not all parameters are required. Any call must report at least one form of device-id. For any single app it is expected that all calls will report the same set of device ids. Reporting multiple formats will allow conversion tracking to be done across a larger fraction on the inventory.

Example URLs:
http://serve.vdopia.com/adserver/html5/evttrk.php?e=dl&id=com.vdopia.DemoApp&dium=e80b5017098950fc58aad83c8c14978e&dius=1f8ac10f23c5b5bc1167bda84b833e5c057a77d2

http://serve.vdopia.com/adserver/html5/evttrk.php?e=dl&id=com.vdopia.DemoApp2&dims=2b743ea5699560665032496d957cd8c0075029d5&dimm=613d3b9c91e9445abaeca02f2342e5a6
Comments