Home

Advertiser Conversion Tracking

Install conversion tracking

Option #1: you can match our click "sub id" to the specific conversion

Most of you can do this approach. It only requires a single parameter. All the other parameters are nice-to-haves but not necessary. Perform a GET or POST request to the following URL on every app install:

http://convert.crossinstall.com/convert/device?click_id=XXX

Parameters:

click_id (REQUIRED) - This is the "sub" value we passed you on the user's click.

ip (OPTIONAL) - The IP address of the user's mobile device. While the actual IP address is preferred, you may opt to pass an MD5 of the user's mobile device IP address if desired. md5(ip_address).

time (OPTIONAL) - The time, in UTC, when the user first launched your app. Example UTC formatted time string: 2012-08-17 15:30:45 UTC

platform (OPTIONAL) - May be one of the following: iphoneipadipodandroid

did (OPTIONAL) - The advertisingIdentifier (aka IDFA) (iOS) or Android Advertising ID (Android). Improved conversion matching as well as being useful for you to receive reporting back from CrossInstall on your conversions.

open_did (OPTIONAL) - The device's OpenUDID. Improved conversion matching as well as being useful for you to receive reporting back from CrossInstall on your conversions.

mac (OPTIONAL) - The device's MAC address. Improved conversion matching as well as being useful for you to receive reporting back from CrossInstall on your conversions.

Response 

The CrossInstall servers will respond with a JSON string containing some of the following fields:

success - true or false, depending on the validity of the request. If you failed to provide required parameters to the conversion URL or supplied invalid values then success will be false. There will be an error field explaining the issue.

error - This field will be present if success is false. It will explain the reason for the request's failure.

match - true or false to indicate if CrossInstall matched this user installation event to a user that came in via your CrossInstall campaign.

info - This field will be present if success is true. It will contain a string describing the results of the conversion URL request.

 

Option #2: you'd like to use our conversion-to-click matching

If your tracking platform does not enable you to track specific clicks and match them exactly to conversion events then you can use this method. CrossInstall will figure out which click led to the conversion event you are telling us about. Perform a GET or POST request to the following URL on every app install:

http://convert.crossinstall.com/convert/device?app=XXX&ip=XXX&time=XXX&platform=XXX&did=XXX&open_did=XXX&mac=XXX

Make sure to hit this conversion tracking URL on every app install. CrossInstall's servers will identify which ones came from a user referred by your CrossInstall campaign.

Parameters:

app (REQUIRED) - Your CrossInstall campaign identifier for this application

ip (REQUIRED) - The IP address of the user's mobile device. While the actual IP address is preferred, you may opt to pass an MD5 of the user's mobile device IP address if desired. md5(ip_address).

time (REQUIRED) - The time, in UTC, when the user first launched your app. Example UTC formatted time string: 2012-08-17 15:30:45 UTC

platform (REQUIRED) - May be one of the following: iphoneipadipodandroid

did (OPTIONAL) - The advertisingIdentifier (aka IDFA) (iOS) or Android Advertising ID (Android). Improved conversion matching as well as being useful for you to receive reporting back from CrossInstall on your conversions.

open_did (OPTIONAL) - The device's OpenUDID. Useful for you to receive reporting back from CrossInstall on your conversions.

mac (OPTIONAL) - The device's MAC address. Useful for you to receive reporting back from CrossInstall on your conversions.

 

Response

The CrossInstall servers will respond with a JSON string described in Option #1 above.