Bidease callback specifications

Default Bidease callback structure:

https://track-us.bidease.com/conv?
x=[BID_ID]
&goal_id=[GOAL_ID]
&attr_type=[ATTR_TYPE]
&is_attributed=[IS_ATTRIBUTED]
&tracker=[TRACKER]
&bundle=[BUNDLE]
&purchase_usd=[REVENUE]
&ip=[IP]
&make=[MAKE]
&model=[MODEL]
&os=[OS]
&os_ver=[OS_VER]
&user_agent=[USER_AGENT]
&lang=[LANGUAGE]
&country=[COUNTRY]
&region=[REGION]
&city=[CITY]
&carrier=[CARRIER]

Required parameters

These parameters are mandatory. If any of them are missing in the callbacks, the data will be corrupted or may not be recognized at all.

• x – unique session id (or click id) that Bidease pass through click or impression
• goal_id – name of event that user does, e.g., registration, purchase etc. If user made an install - left this parameter empty
• attr_type – type of attribution. If conversion came from click (postclick conversion) - send '0' and if conversion came from impression (postview conversion) - send '1'
• is_attributed – send '1' if user was attributed through Bidease click/impression and '0' if user comes from another partner. If you can't split them by this characteristics - send '1' for all conversions
• bundle – pass here bundle of your application

In case if you passing callbacks from website - you can use your website adress. For example - &bundle=bidease.com

• tracker – name of your tracker/platform that you use to send callbacks, e.g. for SampleManager platform you would send 'SampleManager'

Optional parameters

• revenue – amount of purchase in USD. If you are sending event/install callback which doesn’t have amount of purchase, leave this parameter empty
• ip – the ip address of the user when the event occurs
• make – device maker
• model – device model
• os – device operating system: android/ios
• os_ver – device operating system version
• user_agent – browser user agent string
• language – browser language using ISO-639-1-alpha-3
• country – country code using ISO-3166-1-alpha-3
• region – region code using ISO-3166-2; 2-letter state code if USA (for non US English-written name is preferred)
• city – we prefer the United Nations Code for Trade & Transport. (for non US English-written name is preferred)
• carrier – carrier or the ISP using exchange, curated string names which should be published to bidders a priori

type=image - by default trackers returns empty text. If you set up callback as a pixel (inside tag) on a web-page, then you need to add to tracker returns 1x1 image instead of empty test.

Examples

Install callback example
https://track-us.bidease.com/conv?x=gyaG7wMJC6ItL9F3&goal_id=&attr_type=0&is_attributed=1&tracker=SampleManager&purchase_usd=

Event callback example:
https://track-us.bidease.com/conv?x=gyaG7wMJC6ItL9F3&goal_id=purchase&attr_type=0&is_attributed=1&tracker=SampleManager&purchase_usd=15.45