CONVERSANT TRAFFIC INSTRUCTIONS

Transcription

1 CONVERSANT TRAFFIC INSTRUCTIONS CACHE BUSTER AND CLICK TRACKING UPDATED 2/6/2014 CONVERSANTMEDIA.COM

2 TABLE OF CONTENTS 1 Ad Tag Trafficking instructions cache-buster How to implement a cache-buster JavaScript Generated cache-buster publisher click tracking publisher controlled encoding CONVERSANTMEDIA.COM

3 1 AD TAG TRAFFICKING INSTRUCTIONS The traffic order consists of trafficking instructions, followed by ad tags for each ad placement. A test link is provided to allow websites to test the ad tags and preview the creative. The trafficking instructions are generated from a customizable template. Per-placement instructions can be generated from a customizable template as well. Normally, a traffic order will be generated to containing the ad tags for all the placements running on a publisher s website. The system selects which tag types to generate, but the trafficker can override this selection when filling out the traffic order details page. 1.1 CACHE-BUSTER Cache-busting is a dynamic generated code that prevents a browser from reusing an ad that has already been viewed and stored in the user s temporary web browser files. It is added after the key value pair mpt= on an HTTP request, in which the value is dynamically generated each time the page is loaded. Publishers must add a cache-buster to all pages containing live Conversant impressions and click tags. The cache-buster accomplishes the following: The cache-buster doesn t stop a browser from caching the file; it just prevents it from reusing it. In most cases, this is accomplished with nothing more than a random number inserted into the Conversant Ad Server tag after the mpt= on each page load. The random number makes every ad call look unique to the browser and therefore prevents it from associating the tag with a cached file, forcing a new call to the ad server. 1.2 HOW TO IMPLEMENT A CACHE-BUSTER The publisher is required to replace the place holder [CACHEBUSTER] and insert their macro that will generate a random number. For example, DFPs macro requirement is %n for cache-busting. mpt=[cachebuster] mpt=%n 3 CONVERSANTMEDIA.COM

4 1.3 JAVASCRIPT GENERATED CACHE-BUSTER Here is an example of a Conversant Ad Server JavaScript ad tag generating its own timestamp cachebuster: <script type="text/javascript"> var mpt = new Date(); var mpts = mpt.gettimezoneoffset() + mpt.gettime(); document.write("<script type=\"text\/javascript\" src=\" + mpts + "&mpvc=\"><\/script>"); 1.4 PUBLISHER CLICK TRACKING Conversant Vendor Click (MPVC) is a Conversant Ad Server macro that gives website publishers the ability to track clicks. A Conversant Ad Server ad tag contains MPVC near the end of the ad tag, "mpvc=". To track clicks using the standard, iframe, or script tag, please insert your redirect string as the value following "mpvc=" which is present near the end of our tag. For example, DFPs click tracking macro is "%c". &mpvc= &mpvc=%c Make sure the click tracking string does not contain a "?" or "%3f" (encoded value for "?"). Instead, use ";" or "%3B" (encoded value for ";"). 1.5 PUBLISHER CONTROLLED ENCODING Conversant Vendor Click Encoding (mpvce) is a Conversant Ad Server parameter that gives website publishers the ability to do an extra encoding of the mpvc parameter for flash creatives only. Gif/jpg creatives are not affected by the presence of this parameter. 4 CONVERSANTMEDIA.COM

5 Some publishers need to single encode their mpvc variable for a gif/jpg creative. However, if a flash is served the click may not function properly. Likewise, a double encoding may result in the click working on a flash unit, but then the click may be non-functional if a gif/jpg is served. The solution to this issue is the mpvce parameter. If the parameter mpvce=1 is inserted on the ad tag an extra encoding is done on flash creative units only. This means a publisher can then insert this parameter and singly encode their mpvc parameter to resolve the above encoding scenario. To enable this optional feature a publisher would insert before &mpvc= the following code: &mpvce=1 <script type="text/javascript" src=" <script type="text/javascript" src=" 5 CONVERSANTMEDIA.COM