In this document, we will outline how to connect clicks, conversions, actions, etc. into your system or a 3rd party measurement tool.
Tracking Links from Show To your system #
The redirect link (tracking link) from Show to your system would have the following scheme:
https://your.tracking.url/?your_click_id_receiver=<SHOW_ART>&your_channel_id_receiver=<SHOW_CNL_ID>&your_campaign_id_receiver=<SHOW_CMP_ID>
Where <SHOW_ART> would be replaced with Show’s unique (per click) click ID, which we expect to receive back in the postback sent to us.
And <SHOW_CNL_ID> would be replaced by Show’s channel ID, and <SHOW_CMP_ID> would be replaced by Show’s campaign ID – both are non-unique.
Postbacks from your system to Show #
If you’re using a tracking system and need to transfer install/action postbacks to Show Please use this URI:
https://api.show.marketing/conv?sct=<Click ID placeholder>&showdata=%7B%22cmpid%22%3A<campaign ID placeholder>%2C%20%22cnlid%22%3A%20<channel ID placeholder>%7D
where <Click ID placeholder> would be replaced by Show’s ad ID that Show passed you on the click.
If your tracking system doesn’t support passing unique click IDs, please make sure you pass us the campaign ID and the channel ID.
If your measurement system doesn’t support sending postback, please initiate one using your post-conversion page.
Postbacks from Show to your system #
Show supports two postback mechanisms: single postback per ad show, and per-impression postback as described below:
Single postback per ad show #
Once the ad is finished displaying, we will fire a real-time postback with the following options:
Placeholder | Explained | Value type / fixed | Example Value |
campaign_id | The campaign ID showed at the Campaigns screen UI | text | cmp1245 |
platform | The platform in which the ad was displayed at | Fixed value: twitch / youtube / facebook | twitch |
channel | The streaming platform’s own channel id in which the ad was shown | text | esl_csgo |
cpm | The CPM of the campaign in USD | int | 42 |
impressions | The number of live viewers that watched the ad | int | 742 |
cost | The cost of the ad, i.e. CPM/1000*impressions | float | 31.164 |
Per-impression postback #
Once the ad is finished displaying, we will fire multiple real-time postbacks, one postback per impression, with the following options:
Placeholder | Explained | Value type / fixed | Value for example |
campaign_id | The campaign ID showed at the Campaigns screen UI | text | cmp1245 |
platform | The platform in which the ad was displayed at | Fixed value: twitch / youtube / facebook | twitch |
channel | The streaming platform’s own channel id in which the ad was shown | text | esl_csgo |
cpm | The CPM of the campaign in USD | int | 42 |
ip | The number of live viewers that watched the ad | int | 742 |
ua | The user agent of the client | text | Mozilla/5.0 (Linux; Android 8.0.0; SM-G960F Build/R16NW) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.84 Mobile Safari/537.36 |
country | Country code for the client | 3 letter ISO code | USA |
imp_cost | The cost of the ad, i.e. CPM/1000 | float | 0.00164 |