OpenX Advanced Targeting Using WordPress

Tech

What is Openx

OpenX is, in my opinion, the most efficient and hands-free open source ad server on the web today. It’s flexible, easy to use, and best of all, free.

What is WordPress

WordPress is one of the leading platforms in blogging on the web today. Whether you are self-hosted (using wordpress.org) or being hosted on Automattic servers (using wordpress.com), WordPress is an amazing blogging platform which makes blogging easy and fun.

This OpenX and WordPress tutorial will outline how to more effectively use the targeting features of OpenX utilizing the built-in features of WordPress. It will explain how to do this by using WordPress tags and OpenX source parameters, both built-in features to WordPress and OpenX, respectively.

OpenX Solution Used: Hosted OpenX (http://hosted.openx.org/)
WordPress Version: 2.6.2

For this tutorial, I will be using tags are the “source” for OpenX.


Step 1: Setup tags so OpenX can view them as a “source.”

<?php
while ( have_posts() ) : the_post();
$fsm_oxtags = get_the_tags();
if ($fsm_oxtags) { foreach ($fsm_oxtags as $tag) {
$taglist .= $tag-&gt;name . '|';
}
$taglist = rtrim($taglist, '|');
$oxtags = rawurlencode($taglist);
}
endwhile;
?>

I have these in the top of my single.php file within WordPress. This only creates the variable of $oxtags so it can be echo’d elsewhere.

Details of Step 1: The first bit of code will create the loop. then it will go through each tag and set it as “tag |” because I am using pipes to separate each tag for OpenX. Next, it will trim off the last pipe because it’s not needed, creating something like… “tag 1|tag 2|tag 3|tag 4” … and like I just mentioned, it will strip off the last pipe. Lastly, it will put that string, “tag 1|tag 2|tag 3|tag 4” … into a raw encoded URL string which we will be able to echo later in the page. Note: this is only being set at $oxtags so it can be used elsewhere, nothing is echo’d in this part of the script.

Step 2: Setup your OpenX invocation code

<script type='text/javascript'><!--//<![CDATA[
var m3_u = (location.protocol=='https:'?'https://d.openx.org/ajs.php':'http://d.openx.org/ajs.php');
var m3_r = Math.floor(Math.random()*99999999999);
if (!document.MAX_used) document.MAX_used = ',';
document.write (&quot;&lt;scr&quot;+&quot;ipt type='text/javascript' src='&quot;+m3_u);
document.write (&quot;?zoneid=1009&quot;);
document.write ('&amp;cb=' + m3_r);
if (document.MAX_used != ',') document.write (&quot;&amp;exclude=&quot; + document.MAX_used);
document.write (document.charset ? '&amp;charset='+document.charset : (document.characterSet ? '&amp;charset='+document.characterSet : ''));
document.write (&quot;&amp;loc=&quot; + escape(window.location));
document.write (&quot;&amp;source=<?php echo $oxtags; ?></strong>&quot;);
if (document.referrer) document.write (&quot;&amp;referer=&quot; + escape(document.referrer));
if (document.context) document.write (&quot;&context=&quot; + escape(document.context));
if (document.mmm_fo) document.write (&quot;&amp;mmm_fo=1&quot;);
document.write (&quot;'&gt;&lt;/scr&quot;+&quot;ipt&gt;&quot;);
//]]>--></script>

Now that we have the $oxtags variable ready, we can echo it where we need it. Simply add the next line, such as I have, document.write ("&source=<?php echo $oxtags; ?>");, then we’re almost ready to start using advanced targeting within OpenX using your WordPress tags.

Step 3: Rewind the content loop

!!! IMPORTANT !!!

This is critical! You must do this if you want your posts’ content to display properly.

<?php rewind_posts(); if (have_posts()) : while (have_posts()) : the_post(); ?>

The reason for this is that you need to rewind the posts so the loop is displayed properly. (documentation)

The line above is what my real loop looks like in my single.php file, ensuring that the content of the loop is displayed properly as it was originally.

Note: You only need to rewind_posts(); if you have multiple loops or you put the Step 1 code before the first loop, which I did for this tutorial.

Step 4: Setup OpenX Targetting to Deliver to Specific Tags

Now that we have sources setup within the JavaScript and PHP for WordPress, we need to get to work adding some banners using specific sources. Go to one of your campaigns, then select a banner you’ve already added or add a new banner. Go to the Delivery Options tab. This is where you can select your targeting limitations.

First, add the delivery option to limit the banner display for a specific source.

OpenX: Setup Delivery Options to be Limited by a Source

Next, set it to “contains” so you can specify which tagged posts you want to display this banner.

OpenX: Setup Delivery Options to Contain a Source

Lastly, specify the source you want to use fr banner delivery limitation.

OpenX: Specify the Delivery Source for Banner Limitation

Results

Here is what your final output should look like:

<script type='text/javascript'><!--//<![CDATA[
var m3_u = (location.protocol=='https:'?'https://d.openx.org/ajs.php':'http://d.openx.org/ajs.php');
var m3_r = Math.floor(Math.random()*99999999999);
if (!document.MAX_used) document.MAX_used = ',';
document.write (&quot;&lt;scr&quot;+&quot;ipt type='text/javascript' src='&quot;+m3_u);
document.write (&quot;?zoneid=1009&quot;);
document.write ('&amp;cb=' + m3_r);
if (document.MAX_used != ',') document.write (&quot;&amp;exclude=&quot; + document.MAX_used);
document.write (document.charset ? '&amp;charset='+document.charset : (document.characterSet ? '&amp;charset='+document.characterSet : ''));
document.write (&quot;&amp;loc=&quot; + escape(window.location));
document.write (&quot;&amp;source=<strong>tag%201%7Ctag%202</strong>&quot;);
if (document.referrer) document.write (&quot;&amp;referer=&quot; + escape(document.referrer));
if (document.context) document.write (&quot;&context=&quot; + escape(document.context));
if (document.mmm_fo) document.write (&quot;&amp;mmm_fo=1&quot;);
document.write (&quot;'&gt;&lt;/scr&quot;+&quot;ipt&gt;&quot;);
//]]>-->&</script>

I bolded the part that was used with the Step 1 code. Basically, it will output your tags for each WordPress post as a “source” so you can use them for targeting on your site.

Thanks goes out to Thomas and Steve Smith for helping me get this working

8 thoughts on “OpenX Advanced Targeting Using WordPress

  1. Glad you like it. I’m hoping to release some more tutorials in the near future about OpenX, but hopefully broader tutorials.

  2. Hi Jonathon, Interesting Article

    Quick Question I have

    Is openX able to target by inputted data from the user of a postcode search

  3. Mat, Unfortunately, hosted.openx.org doesn’t offer a postcode breakdown for delivery limitation. The best you’ll be able to get is by Geo: Continent and Geo: Country.

    You might be able to achieve it by limitation delivery by IP address, using a range for known IP address ranges for a specific zip code, but it will be a lot harder to get 100% or near 100% accuracy for that.

  4. Hello Jonathan, Does this technique only work with hosted.openx.org accounts or can it be used on a self hosted openx installation?

    Thanks.

    1. Yup! It should work just the same since you’re not actually changing any of the core OpenX code, only the delivery javascript code which you embed on your site.

  5. Thanks works perfect! This helps a lot. I’m working on using this technique to pull publisher profile data and using it as site variables. This tutorial has opened up my mind and made the targeting process more flexible and understandable.

    Thanks.

Comments are closed.