Postback APIs
1. Endpoints
- Install Postbacks (including rejected, re-attributed & re-engagements)
- Endpoint: https://log.bubbleye.com/install
- In-App Event Postbacks (including revenue, ad revenue & app launch for retention)
- Endpoint: https://log.bubbleye.com/postinstall
- Rejected Install Postbacks (including Revenue)
- Endpoint: https://log.bubbleye.com/rejectedinstall
2. Postback parameters
| Parameter | Description | Install | Rejected Install | App Open / Session | Postinstall Event / Revenue |
| c | Name of the campaign being run on the network | Required | Required | Required | Required |
| pub_id | ID used by the network to identify the publisher displaying the ad | Required | Required | Required | Required |
| adv | Android package name (string) or iTunes ID (digits only) of the app being advertised | Required | Required | Required | Required |
| click_id | ID assigned to each customer by network | Required | Required | Required | Required |
| t_ifa | Ifa of user’s phone | Required | Required | Required | Required |
| t_created_at | Timestamp (could be timestamp in milli-second, ex., 1400000000123 | Required | Required | Required | Required |
| t_it | Install time (only for postinstall events) | Required | Required | ||
| crid | Creative id | Required | Required | Required | Required |
| t_uid | Unique User ID as set by MMP / Attribution Partner | Required | Required | Required | Required |
| t_activity_kind | One of: install, reattribution, reengagement | Required | Required | Required | Required |
| event_type | The ID or unique name of the event. Ie tutorial_completed. For app opened events to calculate retention, use bb_app_opened | bb_app_opened | Required | ||
| t_rev_usd | Revenue in USD (only needed for events related to revenue) | Required | |||
| t_rej_r | Rejected Reason | Required | |||
| t_ct | Click time, required for fraud KPIs | ||||
| t_reattributed_at | time of reattribution | ||||
| s | ID used to Bubbleye Kraken to identify the network where the campaign is run | ||||
| s_country | Country that was targeted by the campaign (filled by network through MACRO) | ||||
| t_country | Country where the advertised app was installed (filled by bubbleye) | ||||
| s_* | Any additional fields that are desired to be filled in, please contact bubbleye before using | ||||
| t_os | OS name such as ios or android | ||||
| t_osv | OS Version | ||||
| s_ifa | Ifa as set by network macros | ||||
| t_con | Connection Type | ||||
| t_ip | IP Address | ||||
| t_lt | Limit Ad Tracking set by User |
