This version works with Google Analytics Content Experiments and no longer supports Google Website Optimizer. Versions prior to 3.0.0 will become obsolete on August 1, 2012.

Conversion Optimizer Pro for Joomla!

Conversion Optimizer Product Image

Joomla! 1.6 Native  Joomla! 1.7 Native  Joomla! 2.5 Native  Joomla! 3.0  Joomla! Plugin

Setup & Configuration

Set up and Configuration is simple, quick and painless. Here's how to get started using the Conversion Optimizer Pro for Joomla!. After purchasing the product, our installer takes care of the hard work for you.

Install Conversion Optimizer Pro

You'll need a Google Website Optimizer account to take advantage of this product. If you haven't already, click here to sign up. Assuming you've purchased and downloaded the Conversion Optimizer Pro installation file, log on to your site's Administrator console then:

  • Select Install from the Extensions Menu
  • In the first box, Upload a Package click the Browse button, locate and select the Optimizer Pro installation package on your hard drive.
  • Click the Upload File and Install Button.

Please note, the Conversion Optimizer Pro requires both a component and a plugin. Our component installer will automatically install and enable the plugin, to save you the time and trouble of installing it separately. Also note, if you need to reinstall the application for any reason, simply repeat these steps and install it on top of the existing installation. Our uninstaller will remove the component, plugin and all existing experiments.

Create your Experiment on Google

alt

Designing an experiment is beyond the scope of this, however Google offers a wealth of free information on the topic, we also strongly recommend the book Always Be Testing: The Complete Guide to Google Website Optimizeralt. Once you're ready, set up your experiment on Google's Website Optimizer. Google will ask for several URLs during the process, if you're using SEF, remember to use the SEF version of the URLs.

When you reach Step 3 - Add and check experiment code, do the following:

  • Choose the I'll add the experiment code myself option, this gives the Conversion Optimizer Pro the scripts needed to run this experiment. Keep this page up. You'll need to cut and paste that script code in a moment. You're ready to set up the experiment in Joomla.

Tell Joomla about Your Experiment

Open a new browser window and login to your Joomla Administrator console, then:

  • Launch the Conversion Optimizer Pro - by selecting Conversion Optimizer Pro from the Component menu.
  • Click the New button - in the upper right icon bar. This will open a simplified Experiment screen (see screen shot below).

  • Screen shot of new experiment screen


  • Add Google's script code - Toggle back over to the Google window, highlight and copy the Code. Flip back to Joomla and paste the URL in the box.


Edit experiment screen shot

You're almost there! Next, you'll need to mark your content with Conversion Optimizer Pro's tags. Here's how to set that up:

Adding The Tags

Joomla needs to know which pages are part of your experiment. To do this, we'll need to add tags on each page in your experiment. Conversion Optimizer Pro supports tags anywhere on a page, either in content or a module. The edit screen gives you the tags specific to each experiment. Just cut and paste the appropriate tags onto each page in your experiment. This page appears when you create an experiment (see illustration on the previous page). You can access this page at any time by editing the experiment.

Adding Tags for A/B Experiments

  • Original Page - Cut & paste the Original tag from the experiment's edit screen. If you wish, you can add the code by hand using the following format:

    {optimizerpro 999 o}
    Replace the 999 with the Experiment ID. You can find this in the ID column on the Website Optimizer Experiments page. The letter o tells Conversion Optimizer Pro that this is the Original page. Place this tag just once on the Original page, wherever you feel best.

  • Variation Pages - Again, cut & paste the Variation tag ANYWHERE on each of your variation pages. The plugin will grab the Google Javascript code from the database and put them where Google wants them. In experiments with multiple variation pages, you may find it easier to publish the tag in a module rather than within the content of each page. Variation tags are formatted like this:

    {optimizerpro 999 v}
    Here the letter v identifies this as a Variation page.

  • Conversion Pages - Just as with the other tags, it's best to cut & paste the tags from the experiment's edit screen anywhere on your conversion page. In fact, it's not well documented, but if you have several pages that mark a conversion, place the code on each of those pages, and Google will count them all as a conversion. We tested this on a site with several opt-in mailing lists. Each list had it's own, customized "Thank you" page. We placed the conversion code on each page, because for that experiment signing up for any of the mailing lists meant success. Please note, Virtuemart users will need to put this conversion tag in the "checkout.thankyou.tpl.php" file. The conversion tag is formatted:

    {optimizerpro 999 c}
    Here the letter c identifies this as a Conversion page.

  • Publish the Experiment - If you haven't already done so, publish your experiment within Conversion Optimizer Pro.
  • You're done on the Joomla side.

Adding Tags for Multivariate Experiments

  • Conversion Pages - Just as with the other tags, it's best to cut & paste the tags from the experiment's edit screen anywhere on your conversion page. Please note, Virtuemart users will need to put this conversion tag in the "checkout.thankyou.tpl.php" file. The conversion tag is formatted:

    {optimizerpro 999 c}
    Here the letter c identifies this as a Conversion page.

  • Test Page - Here you'll have to name each of your Page Sections and mark them at the start and end. It's best to cut from the experiment's edit screen and paste them into your content.

    • Place the Test page (Section Start) tag at the very start of each page section. Again, this is available to cut & paste on the Edit Experiment page. These tags are formatted:

      {optimizerpro 999 s SECTION NAME}
      Replace the 999 with the experiment ID (shown on the Conversion Optimizer Pro Experiments list page). Replace SECTION NAME with any name you choose. Note, though, that you should limit this to simple letters, numbers and spaces. We filter the names for security reasons.

      Here's an example of what this may look like using the Joomla! 1.6, 1.7 or 2.5 versions:
      {optimizerpro 999 s Heading}
      <h1>Page Heading</h1>
      {optimizerpro /}
       
      {optimizerpro 999 s Product Description}
      <p>This product is spectacular, fantastic AND amazing!</p>
      {optimizerpro /}
       
      {optimizerpro 999 s Call To Action Button}
      <img src="call_to_action.png" alt="Buy It Now" />
      {optimizerpro /}
      Remember, this extension does support module positions, so you can place these codes (start and end) within a custom html module on the test page as well as in the content. Make sure that modules included in a test appear ONLY on the test page, otherwise Google may think any other page that module appears on are part of the experiment. This will pollute your results.

  • Publish the Experiment - If you haven't already done so, publish your experiment within Conversion Optimizer Pro.

  • You're done on the Joomla side.

Validate on Google

Now that you've set up the experiment and added codes to each of the pages in your experiment, go back to Google Website Optimizer - Step 2 page. And do the following:

  • Validate with Google - Scroll to the bottom of the Step 2 page and click the Validate Pages button. Google will check to make sure the scripts and Page Sections (Multivariate testing only) are properly placed and correct. If Google fails validation check our Troubleshooting section (below):

  • Finish setting up the experiment - Follow Google's instructions to finish setting up your experiment on the Google side.

  • Start the Experiment - Start the experiment on Google, and you'll start collecting data. Google uses many servers to collect data and consolidates with batches, so be patient Website Optimizer results can take several hours before it shows up in your reports.

Troubleshooting

  • Is the Plugin installed and enabled? - The plugin must be enabled to do anything, so make sure it's installed and enabled from within Joomla's Plugin Manager.

  • Is the Plugin Order set to LAST? - Some other plugins (e.g., SEF) will attempt to modify or rewrite the Google scripts and URLs added by this plugin. To avoid this possible conflict, run this plugin last. Our installer will set the plugin's order to LAST, however it's possible to change its order. Change this through the Plugin Manager, in the Extensions menu of the Administrator.

  • Is the Plugin Access Level set to Public? - Google is not logged on to your site, so if the plugin isn't set to public, Google won't be able to test it.

  • Are the page access levels set to public? - Again, Google appears as a public visitor when testing your pages, so make sure Google can reach them to test.

  • Correct URLs on Google - recheck each of the URLs in your experiment and make sure you've given Google the correct URL. If it's checking the wrong page, it won't find the optimizer code.

  • Plugin Tags on each page? - Remember, all experiments must have at least one conversion page. Make sure that the conversion tag appears somewhere on conversion pages (in the content or a module). In A/B testing you'll also need an original tag on the original page and at least one variation page, with variation tag on that page. If you're running a multivariate experiment, you'll need to define at least one Page Section on your test page.

  • Page Section Tags - If you're running a multivariate experiment, revisit the Test page and make sure you've defined at least one Page Section. Each Page Section must have a Section Start tag and a Section End tag. Also, you cannot overlap or nest page sections. Once you start a page section, you must end it before beginning the next.

  • Experiment Scripts - Make sure that each of the three Google JavaScript blocks are in the right boxes, and include all the code from Google. You may wish to reimport the scripts or delete and copy them individually from Google, ensuring that you copy all the code and that they're in the right boxes.

  • Firewalls - Make sure that you can access the Script site from your computer. Some organizations block or firewall the Google Analytics site to prevent polluting test results. If you're not sure try browsing to http://www.google-analytics.com/siteopt.js (copy and paste this url into a browser tab), you should see a javascript file. If not, you will need to either unblock the site or test from outside your firewall.

  • If all else fails, contact us with the details and we'll help you get it working, who knows we may even update the code or these instructions to make them easier to follow.

{kunena_discuss:2}

Get It Now

Get it now

What Users Say

Hugely simplifies setting up of Google Optimizer... in short, great plugin, excellent support and help that goes beyond.

- Andrew Wilkin | Cyberion Consulting


Does what it says on the tin. Excellent instructions... a pleasant surprise.

- Sandra Newton | Essentee.com


Massively simplifies Joomla side of GWO... support was fast, friendly and efficient.

- Dominic Hughes | homewatt.co.uk