Product Link Tracking Pixel Installation

Article author
Matt Hanan
  • Updated

The purpose of this document is to provide instructions for installing your product link tracking pixel for the purpose of enabling the first-party tracking of product links shared by creators.

Installation

The installation of the tracking pixel is easy. The following javascript code should be placed on all of your product pages. Please note where it says “XXXXXXX”, this needs to be replaced with your account id, otherwise the tracking pixel will not work properly. Please contact your client success account manager if you do not have your account id.

<script type="text/javascript">
 window._tvpa = window._tvpa || [];
 window._tvpa.push(['config', {
   li: "XXXXXXX", // Account ID
   mode: "dl"
 }]);

 (function() {
   var tvpa = document.createElement('script'); tvpa.type = 'text/javascript'; tvpa.async = true;
   tvpa.src = ('https:' == document.location.protocol ? 'https' : 'http') + '://a.tvpage.com/tvpa.min.js';
   var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(tvpa, s);
 })();

</script>

Once installed, this pixel will always load on your product page, if the URL of the product page contains a trackable product link variable, the analytics pixel will fire a subsequent request.

It is a best practice to use a tag manager to install this pixel as it makes the process of managing tracking pixels in general much easier.

Testing

After you have completed the installation, if you wish to validate that the pixel is working correctly, this can be easily tested with the following steps.

  1. Obtain a link to a product details page where the tracking pixel has been installed. For the purposes of these steps, let’s assume: https://www.domain.com/product.html
  2. Append to this URL the following parameter: ?_dl=000000;123456789
  3. Once you have combined your product page URL and the test parameter, open up a web browser and open the Dev Tools console. If needed, select the Network tab so that you can observe the network requests.
  4. Paste the URL into the web browser, and you should see lots of network requests being made, if you filter this by “_tvpa” you will see a short list of network requests after the page has completely loaded.
  5. There should be a total of 3 network requests that are made. If you look at the URL parameters of each of these requests, you should see the rt= parameter. The 3 different requests being made are rt=cid, rt=hb and rt=dl.

If you examine the rt=dl request’s URL parameters, you should see the li=, ui= and ct= parameters populated with your account ID, and the 2 values that were parsed from the page’s original URL request. If this request is not present, then there is a problem with the implementation of the tracking pixel, please contact support@creatable.io and we will work with you to get it working as expected.