Loading...

Advertiser documentation

  Last updated: November 2nd, 2021  

Tracking variables

PopUnderSTAR offers a set of tracking variables which advertisers can include in their landing page URLs while creating or modifying a campaign in order to help them keep track of the visits their campaigns receive.

These variables can be used by any advertiser, on any campaign, and are cost free.

Variable Type Description
[clickid] INTEGER An unique ID generated by our system and used to track conversions.
[campaignid] INTEGER The ID of your campaign as defined within our system.
[sourceid] INTEGER The ID of website that delivered the visit as defined within our system.
[campaigntype] STRING The type of the campaign that received the visit, as defined within our system.
[category] STRING The category of the website that delivered the visit, as defined within our system.
[country] STRING The visitor's country as the 2 letters country code.
[browser] STRING The visitor's browser.
[os] STRING The visitor's operating system.
[platform] STRING The platform used by the visitor.
[origin] STRING The origin of the visit also known as the referring website type.
[engagement] STRING The type of engagement displayed by the visitor before firing the ad.

Example landing page URL which includes our tracking variables:
https://mywebsite.com/my_landing_page.php?vid=[clickid]&cid=[campaignid]&website=[sourceid]&type=[campaigntype]&cat=[category]&cc=[country]&browser=[browser]&os=[os]&platform=[platform]&origin=[origin]&engagement=[engagement]

Upon delivering an actual visit the final URL will look something like this:
https://mywebsite.com/my_landing_page.php?vid=123456&cid=123&website=321&type=cpm&cat=Arts&cc=US&browser=Firefox&os=Windows&platform=Desktop&origin=Social%20Media&engagement=High%20%28%3E90s%29

Conversion pixel

PopUnderSTAR offers a conversion pixel that can be installed within your "Thank you" pages in order to track conversions. The tracked conversions will be stored within our system and will allow you to optimize your campaign and improve your R.O.I.

Note! Either a conversion pixel or S2S postback must be installed in order to use the automatic optimization offered by PopUnderSTAR.

To install our conversion pixel, simply copy / paste the code below within the source code of your "Thank you" page, between the <body> and </body> tags:

S2S postback

Aside from the regular conversion pixel, PopUnderSTAR also offers a server to server postback option for conversion tracking. This call is a regular GET call that only needs 1 parameter, which is the click ID. When calling the postback URL, if the conversion was successfully logged in our system, the URL will output 1 otherwise the output will be 0.

Note! The S2S postback requires you to fetch the [clickid] sent within your landing page URL.
Note! Either a conversion pixel or S2S postback must be installed in order to use the automatic optimization offered by PopUnderSTAR.

The S2S postback call can be made to the URL below:

Make sure to replace the [clickid] with the ID of the visit received within your landing page URL.

PHP example using file_get_contents
<?php
$thesavedclickid = '123456';
$postbackURL = 'https://popunderstar.com/tracking/postback?clickid='.$thesavedclickid;
$sendback = file_get_contents($postbackURL);
?>

PHP example using cURL
<?php
$thesavedclickid = '123456';
$postbackURL = 'https://popunderstar.com/tracking/postback?clickid='.$thesavedclickid;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $postbackURL);
$execCURL = curl_exec($ch);
curl_close($ch);
?>

JavaScript example using XMLHttpRequest
<script>
var thesavedclickid = '123456';
var postbackURL = 'https://popunderstar.com/tracking/postback?clickid='+thesavedclickid;
var req = new XMLHttpRequest();
req.open("GET", postbackURL);
req.send();
</script>

Automatic optimization

The team behind PopUnderSTAR has over 12 years of experience within the advertising industry. We know how painful and time consuming manual optimization can be, and for this reason our platform allows our advertisers to set their goals and let system do the rest.

The principle behind the whole thing is quite simple. You, as an advertiser, can specify the minimum acceptable conversion rate and the maximum conversion price that any source must meet in order to keep sending traffic to your campaign.

The traffic volume required for each source to be optimized is 10 000 ad views. Any lower would not offer relevant data, while higher volumes would not be cost effective.

Our system will deliver notifications when / if a source gets blocked, so that you are always aware of the low performing sources that were removed for your campaign.

You can always change / remove the limits as needed, or even remove any previously blocked sources.