Tracking and callback

As Instal publisher you can register a postback URL where your platform will be notified about every install conversion of your published campaigns.

Your postback URL can be setted at this page in Instal Web Console. You can customize your URL with the following placeholders that will be replaced with the runtime values during the tracking and postback process.

Postback example URL:{campaign_id}/?country={country}&event_id={custom1}&site_version={custom2}

Supported placeholders:

  • {tm}: Number of milliseconds since the epoch (aka: unix_time * 1000)
  • {convertion_type}: The type of the event that got the conversion ex. (install, goal_1, goal_2, goal_3, goal_4, goal_5)
  • {appid}: Application ID
  • {campaign_id}: Campaign ID
  • {transaction_id}: Transaction ID, which is unique per conversion
  • {payout}: Payout
  • {payout_decimal}: Payout Decimal
  • {browser}: Browser
  • {ip}: IP Address
  • {lang}: Language
  • {osversion}: OS Version
  • {country}: User country
  • {custom1}: Custom Value 1
  • {custom2}: Custom Value 2
  • {custom3}: Custom Value 3
  • {custom4}: Custom Value 4

In addition to the self-explanatory parameters you have the possibility to use generic parameter placeholders as {custom1}, {custom2}, {custom3} and {custom4}. During the invocation of your postback URL these placeholders will be substitued with the values you porvided in the invocation of the install tracking URL. Here an example.

When a final user clicks on your tracking URL, your tracking system will track the event and it'll redirect the user to Instal tracking URL with the appropriate parameters and values. The called Instal tracking URL will be for example the following, where you have to add the custom values you want receive back during the postback:

When there will be the conversion, the Instal platform will call your callback URL with the following values: