Custom Click Parameters
With the new custom click parameters, you can add your own custom values to each click that comes through your account. With these, you can make the most of your click data. Organize, filter, and segment it however you please. Below we'll outline how to set up your own custom click parameters.
Passing Parameters
The first step is to pass your custom parameters along with your ad requests. In each request you can pass along up to 5 custom parameters. This will be a bit different depending on which of our zone tag types you're using.
Async Tags
For our Async JavaScript tags, you'll have to add your custom parameters into the ad tag as an array to the "opt" section of the tag. See below for an example:
<script type="text/javascript">if (!window.AdButler){(function(){var s = document.createElement("script"); s.async = true; s.type = "text/javascript";s.src = 'https://servedbyadbutler.com/app.js';var n = document.getElementsByTagName("script")[0]; n.parentNode.insertBefore(s, n);}());}</script>
<script type="text/javascript">
var AdButler = AdButler || {}; AdButler.ads = AdButler.ads || [];
var abkw = window.abkw || '';
var plc212491 = window.plc212491 || 0;
document.write('<'+'div id="placement_212491_'+plc212491+'"></'+'div>');
AdButler.ads.push({
handler: function(opt){
AdButler.register(167283, 212491, [300,250], 'placement_212491_'+opt.place, opt);
},
opt: {
place: plc212491++,
keywords: abkw,
domain: 'servedbyadbutler.com',
customParams: [
"param1",
"param2",
"param3"
],
click:'CLICK_MACRO_PLACEHOLDER' }});
</script>
Notice the "customParams" field near the bottom of the tag.
Other Tags
For all other AdButler ad tags, you'll have to manually add each custom parameter to the URL of your ad request. This is done by adding them as query parameters labeled "customParam1", "customParam2", and so on (with the last being "customParam5"). Here is one of our iframe tags as an example:
<iframe src="https://servedbyadbutler.com/adserve/;ID=167283;size=300x250;setID=212491;type=iframe;customParam1=foo;customParam2=bar;click=CLICK_MACRO_PLACEHOLDER" width="300" height="250" marginwidth="0" marginheight="0" hspace="0" vspace="0" frameborder="0" scrolling="no">
</iframe>
Please note that if your ad request includes the "click" parameter, you must add the custom parameters before it in the query string.
The Results
Now that you've passed in your custom parameters, any time someone clicks on one of your ad items, they will be recorded in your click details to be reviewed whenever you need. From your Click Details page, you'll be able to filter your clicks based on the parameters, and download your filtered clicks in case you want to crunch some numbers on your own! Here is a screenshot of what it will look like:
In the table, you'll be able to see a list of the different parameters that were applied to each click. As well, on the left-hand side, you'll be able to add filters. As you fill in filters, only the clicks that match your filter will be displayed in the table. As well, any filters will be applied when you click the "Download CSV" button below.