ClickBooth

Introduction

ClickBooth is a popular third-party affiliate network that can easily integrate with UltraCart.  This tutorial will cover the best practices for deployment of conversion and tracking code on your website and within UltraCart.  First we need to understand the flow that the customer experiences:

Affiliate Website → ClickBooth → Merchant Website → UltraCart Checkout → UltraCart Receipt

There are two important areas that we must have; tracking and conversion logic:

  1. On the Merchant's website we must capture and store the aid and subid that comes in on the URL to the merchant's website.
  2. On the receipt we need a conversion pixel to fire to notify ClickBooth of the conversion.

ClickBooth requires the storage of the aid and subid on the order record so that if for any reason the tracking pixel does not fire there is a clear audit trail of which orders should attribute to ClickBooth affiliate.

Merchant Website Tracking

Typically the URL will look something like this when the browser reaches your website:

http://www.yourwebsitehere.com/cb?subid=CD1&cid2=OFFER1

To track this information we need to deploy a single JavaScript snippet on your website.  Below is an example of this snippet:

<script type="text/javascript" src="https://secure.ultracart.com/cgi-bin/UCCustomFieldTrack?merchantId=MID&mapping=subid,cid2"></script>

Make sure to replace the MID with your own UltraCart merchant ID in the URL.

What this tracking code will do is read the subid and cid2 parameters off the URL and store the values in custom field 1 and custom field 2.

You should deploy this tracking script on 100% of the pages that clickbooth might send traffic to.

Receipt Tracking

ClickBooth will provide conversion snippets that look like the following:

<script src="https://publishers.clickbooth.com/lead_third/12345/OPTIONAL_INFORMATION"></script>
<noscript><img src="https://publishers.clickbooth.com/track_lead/12345/OPTIONAL_INFORMATION"></noscript>

Please do not use the snippet above! The snippet that they provide you has your own account number in it.

Take the snippet and replace the OPTIONAL_INFORMATION text with the [OrderId] token so that the UltraCart order id will be visible in the ClickBooth system.

This makes reporting and auditing easier.  The snippet should now look like this:

<script src="https://publishers.clickbooth.com/lead_third/12345/[OrderId]"></script>
<noscript><img src="https://publishers.clickbooth.com/track_lead/12345/[OrderId]"></noscript>

In the snippet above, [OrderId] is literally what you should have in your code. This is not a placeholder. You need the word [OrderId].

Finally place the conversion pixel on your conversion HTML under

For the Storefronts Checkout

Main Menu → Storefronts → (Choose Storefronts Host) → Conversion Tracking (tab) → Custom (tab) → "Conversion HTML (20,000 character maximum) - injected into only the receipt page" (section)

UltraCart will automatically replace the [OrderId] token with the proper value and inject the pixel into the receipt that the customer's browser loads.

For the Screen Branding Themes Checkout

Main Menu → Configuration → Screen Branding Themes → [edit] → Conversion & Tracking → Conversion HTML

UltraCart will automatically replace the [OrderId] token with the proper value and inject the pixel into the receipt that the customer's browser loads.