Implementing pixels

advertisement
Rocket Fuel Pixels
This document shows how to instrument Rocket Fuel Inc (RFI) pixels into sites or ads.
Contents
Rocket Fuel Pixels .................................................................................................................................................................. 1
Implementing pixels ................................................................................................................................................................ 1
Pixel versions........................................................................................................................................................................... 1
Image Non-Secure............................................................................................................................................................... 2
Image Secure....................................................................................................................................................................... 2
Javascript Non-Secure ......................................................................................................................................................... 2
Javascript Secure ................................................................................................................................................................. 2
Cache busting .......................................................................................................................................................................... 3
Common cache busting macros .......................................................................................................................................... 3
Passing data values in pixel calls ............................................................................................................................................. 4
Third-party Certification ......................................................................................................................................................... 4
Technical Contact .................................................................................................................................................................... 4
Implementing pixels
Pixels can be implemented directly into the HTML of the page, at the bottom of HTML code of the page. If the site is
using pixel management solutions (aka ‘parent’ or ‘container’ pixels) like DART Floodlight or Atlas UAT, then pixels
should be implemented into their respective containers. This is especially important for conversion pixels, to insure that
Rocket Fuel’s view of conversions matches that of the parent pixel.
Pixel versions
There are four versions of Rocket Fuel pixel: Javascript and GIF Image, each with secure and non-secure version. Secure
vs. Non-Secure choice is determined by the type of the page the pixel is instrumented into. HTTP pages such as landing
page will use non-secure pixels and HTTPS pages such as purchase confirmation page will use secure version.
Confidential Rocket Fuel Inc., 350 Marine Parkway, Suite 220, Redwood Shores, CA 94065, Fax (650) 595-1274
Javascript allows more data to be collected than Image versions: collects referrer URL information when implemented
inside iFrames and enables rich set of parameters to be passed with the pixel call.
Image Non-Secure
Here is an example of Rocket Fuel non-secure image pixel. It has three parameters – account ID (rb=3), action ID
(ca=1991) and cache buster (&ra=%n).
<!-- Begin Rocket Fuel Conversion Action Tracking Code Version 7 -->
<img src='http://1991p.rfihub.com/ca.gif?rb=3&ca=1991&ra=' height=0 width=0
style='display:none' alt='Rocket Fuel'/>
<!-- End Rocket Fuel Conversion Action Tracking Code Version 7 -->
Image Secure
Here is an example of Rocket Fuel secure image pixel. It has three parameters – account ID (rb=3), action ID (ca=1991)
and cache buster (&ra=%n).
<!-- Begin Rocket Fuel Conversion Action Tracking Code Version 7 -->
<img src='https://1991p.rfihub.com/ca.gif?rb=3&ca=1991&ra=' height=0 width=0
style='display:none' alt='Rocket Fuel'/>
<!-- End Rocket Fuel Conversion Action Tracking Code Version 7 -->
Javascript Non-Secure
Here is an example of Rocket Fuel non-secure Javascript pixel . It has two parameters – account ID (publisher:3) and
action ID (conversionID:1991). To support browsers with Javascript turned off, the pixel also contains noscript part,
identical to image pixel version.
<!-- Begin Rocket Fuel Conversion Action Tracking Code Version 7 -->
<script type="text/javascript">var cache_buster =
parseInt(Math.random()*99999999);document.write("<img
src='http://p.rfihub.com/ca.gif?rb=3&ca=1991&ra=" + cache_buster + "' height=0 width=0
style='display:none' alt='Rocket Fuel'/>");</script>
<noscript><iframe src='http://1991p.rfihub.com/ca.html?rb=3&ca=1991&ra='
style='display:none;padding:0;margin:0' width='0' height='0'></iframe></noscript>
<!-- End Rocket Fuel Conversion Action Tracking Code Version 7 -->
Javascript Secure
Here is an example of Rocket Fuel secure Javascript pixel. It has two parameters – account ID (publisher:3) and action ID
(conversionID:1991). To support browsers with Javascript turned off, the pixel also contains noscript part, identical to
image pixel version.
<!-- Begin Rocket Fuel Conversion Action Tracking Code Version 7 -->
<script type="text/javascript">var cache_buster =
parseInt(Math.random()*99999999);document.write("<img
src='http://p.rfihub.com/ca.gif?rb=3&ca=1991&ra=" + cache_buster + "' height=0 width=0
style='display:none' alt='Rocket Fuel'/>");</script>
Confidential Rocket Fuel Inc., 350 Marine Parkway, Suite 220, Redwood Shores, CA 94065, Fax (650) 595-1274
<noscript><iframe src='https://1991p.rfihub.com/ca.html?rb=3&ca=1991&ra='
style='display:none;padding:0;margin:0' width='0' height='0'></iframe></noscript>
<!-- End Rocket Fuel Conversion Action Tracking Code Version 7 -->
Cache busting
Individual user browsers store local copies of HTML code and images they have previously accessed. Large Internet
service providers (ISPs) often cache frequently accessed content on their own proxy servers. This is known as caching.
On subsequent requests for the same URL, browsers use cached copy to minimize data transmission and increase speed.
Thus subsequent requests are not visible to the ad or pixel servers. For example if the user comes to a page with a
Rocket Fuel pixel on July 1 for the first time, browser will request the pixel from Rocket Fuel server
(http://1991p.rfihub.com/ca.gif?rb=3&ca=1991) and then will cache the pixel. When the user visits the same page with
the same browser again on July 15, the pixel will not be requested from the server and will instead be served from local
cache. Thus Rocket Fuel “will not know” that the user visited the page on July 15, only on July 1.
To defeat caching, a value that is different every time is inserted dynamically into the URL, making it look to the browser
as new URL every time and forcing it to request the pixel from the server every time. Such value is known as cache
buster. It could be a timestamp to the precision of milliseconds. Continuing from the previous example, the first time the
user visits the page, the request will be (http://1991p.rfihub.com/ca.gif?rb=3&ca=1991&ra=20110701_08:00:00.000).
The next time the user visits the page the URL will be different due to different cache buster value and will thus be
forced to request from the server again (http://1991p.rfihub.com/ca.gif?rb=3&ca=1991&ra=20110715_08:00:00.000).
Common cache busting macros
More often cache busters are random values generated by the code on the page pixels are instrumented into or
generated by macros in ‘container’ (aka ‘parent’) pixels such as DART Floodlight. When page is served, these macros are
replaced by the actual values. Here are the most common container pixels and their cache busting macros:
Container Pixel
Cache busting
macro
Rocket Fuel pixel with cache busting
DART Floodlight
%n
http://1991p.rfihub.com/ca.gif?rb=3&ca=1991&ra=%n
%RAND%
http://1991p.rfihub.com/ca.gif?rb=3&ca=1991&ra=%RAND%
Atlas UAT
24/7 Real Media OAS
%%REALRAND%% http://1991p.rfihub.com/ca.gif?rb=3&ca=1991&ra=%%REALRAND%%
Confidential Rocket Fuel Inc., 350 Marine Parkway, Suite 220, Redwood Shores, CA 94065, Fax (650) 595-1274
Passing data values in pixel calls
Rocket Fuel pixels support general purpose array of key value pairs that can be utilized for passing any data in pixel calls.
For example, the following pixel passes Order Amount and Number of Items inside PageTags array:
<!-- Begin Rocket Fuel Conversion Action Tracking Code Version 7 -->
<script type='text/javascript'>var
rfiPub={ver:7,publisher:3,conversionID:1991,pageTags:"orderAmount:REPLACE_ME_WITH_YOUR_ORDER_
AMOUNT,orderItems:REPLACE_ME_WITH_NUMBER_OF_ITEMS"};var rfiAds=new Array();</script><script
type='text/javascript' src='https://rfihub.pantherssl.com/js/bcC.js'></script>
<noscript><iframe
src='https://1991p.rfihub.com/ca.html?rb=3&ca=1991&ca=1814&pc=orderAmount%3AREPLACE_ME_WITH_Y
OUR_ORDER_AMOUNT%2CorderItems%3AREPLACE_ME_WITH_NUMBER_OF_ITEMS' border='0' frameborder='0'
vspace='0' hspace='0' scrolling='no' marginheight='0' marginwidth='0'
style='display:none;padding:0;margin:0' width='0' height='0'></iframe></noscript>
<!-- End Rocket Fuel Conversion Action Tracking Code Version 7 -->
REPLACE_ME_WITH_YOUR_ORDER_AMOUNT and REPLACE_ME_WITH_NUMBER_OF_ITEMS placeholders are replaced
with clients’ macros that expand to the actual values at run time.
Third-party Certification
Rocket Fuel is certified by and has been successfully instrumented into all major third-party ad servers:

Atlas Universal Action Tag (UAT)

DoubleClick Floodlight

MediaPlex
Technical Contact
Account Manager
Jessica Lilly
jlillly@rocketfuelinc.com
Confidential Rocket Fuel Inc., 350 Marine Parkway, Suite 220, Redwood Shores, CA 94065, Fax (650) 595-1274
Download