Tracking Code Installation

Overview

 

Activating SingleFeed's tracking feature is one of the best ways to monitor and improve your performance on the comparison shopping engines. SingleFeed reports can give you visibility into clicks, cost, sales, revenue, conversion rate, and return on ad spend for each of your active shopping engines. Within the Reports section of your SingleFeed account you will be able to see this information broken down per product, per engine and over any date range of your choosing.

There are several different methods that SingleFeed can use to track the performance of your shopping engine campaigns. For the most complete and accurate data we recommend the Advanced tracking option.  These options can be selected from the tracking settings page within your SingleFeed account (go to "Reports" and then "Reporting Overview" and then select the "Tracking Type" link at the upper right)

 

Novice

Activating Novice tracking will allow you to view reports with the clicks and cost (but not sales or revenue) generated from your shopping engine campaigns.  Novice tracking does not require you to install any tracking code on your website.  Simply select this option and SingleFeed will use URL redirects to track shopping engine traffic to your site.  Note: This option will not track clicks for Google Product Search.  In order to track Google you must select the Advanced option.

 

Advanced (Default On, Recommended)

Activating Advanced tracking will allow you to view reports with the clicks, cost, sales and conversion rate generated from your shopping engine campaigns and, optionally, revenue and return on ad spend. You will need to install a snippet of JavaScript tracking code onto your product pages as well as your post-checkout order confirmation page. Click here for installation instructions (please ensure you are logged into your SingleFeed account prior to clicking here). SingleFeed will use this code, along with URL redirects, to track your shopping engine traffic and sales.

 

 

Tracking Code Installation (Advanced Only)

 

Step 1: Install Product Page Code

You will need to insert a snippet of JavaScript code into all of your product pages.  This snippet will look similar to the one below except that your unique SingleFeed merchant ID will replace the '12345'.  Visit the tracking installation instructions page within your SingleFeed account to obtain your personalized snippet. This code is usually pasted into a template that applies to all of your product pages (so you don't have to install it onto hundreds or thousands of pages). The best place to insert the code is just before the closing body tag (</body>).  Inquire with your e-commerce platform if you need additional help installing the code.

 

NOTE: this code is required to show Google Product Search clicks in your reports 

 

<script type="text/javascript">
<!--
var merchant_id = "707";
//-->
</script>
<script src="http://reporting.singlefeed.com/z/track.js?v=1.1" type="text/javascript"></script>

<script type="text/javascript">

<!--

var merchant_id = "12345";

//-->

</script>

<script src="http://reporting.singlefeed.com/z/track.js?v=1.1" type="text/javascript"></script>


Step 2: Install Conversion Page Code

You will need to insert a snippet of JavaScript code into the post-purchase page that is displayed to a shopper AFTER they have placed an order.  In other words, every time this page loads, SingleFeed will count this as an order.  As such, it is very important that this code be placed on a page that only loads after an order has been placed.  This is usually an order confirmation or thank you page.  This snippet will look similar to the one below except that your unique SingleFeed merchant ID will replace the '12345'.  Visit the tracking installation instructions page within your SingleFeed account to obtain your personalized snippet.The best place to insert the code is just before the closing body tag (</body>).

 

 

<script type="text/javascript">

<!--

var order_id = " ";

var order_value = " ";

var total_units = " ";

var product_ids = " ";

var product_units = " ";

//-->

</script>

<script src="https://reporting.singlefeed.com/z/convert.pl?merchant_id=12345" type="text/javascript" ></script>

 


 

You will notice above that there are five optional - but highly recommended - parameters that you can pass to SingleFeed through this code snippet. These include "order_id", "order_value", "total_units", etc... This is usually done by inserting a dynamic variable enclosed in the doublequotes after the equal sign. The dynamic variable is determined by your e-commerce platform or shopping cart provider. For example, your variable for order_value may look like <$cart_subtotal$> and would automatically insert the dollar value of the order into the order_value parameter. Below are explanations of each optional parameter:

 

The following parameters are strongly recommended:

  • order_id:
    A unique identifier for the current order.  Ensures that duplicate orders aren't counted (ie: page refreshes, etc)
  • order_value:
    The value of this order.  Required in order to display revenue in your SingleFeed reports. We recommend you use order subtotal, aka order revenue without tax or shipping.

The following parameters are recommended:

  • total_units:
    Total number of units in this order.
  • product_ids:
    A comma separated list of product identifiers for the products in this order.
  • product_units:
    A comma separated list of unit counts that corresponds to the product_ids list.

Step 3: Test Your Tracking Code

After you have activated and installed all of the tracking components, wait several days for SingleFeed to begin sending out the new tracking parameters in your outgoing feeds and then click on one of your ads at a shopping engine.  Place an order on your site.  Within 24 hours, that click and order should appear in your SingleFeed reports.

 

Google Checkout (Optional)
 

If you accept Google Checkout, orders processed through that method will not use your own order confirmation page where the SingleFeed code is located. Therefore, special code needs to be placed into your Google Checkout account so that these orders can be tracked. To track these orders, simply include the following XML snippet in the <parameterized-urls> tag, which itself is within the <merchant-checkout-flow-support> tag, of your Google Checkout XML: 


<parameterized-url url="https://reporting.singlefeed.com/z/convert.gif?merchant_id=12345&cvsft=product_convert&cvsfpids=&cvsfpu=&cvsftu=">

<parameters>

<url-parameter name="cvsfoid" type="order-id"/>

<url-parameter name="cvsfov" type="order-subtotal"/>

</parameters>

</parameterized-url>

 

 

For more help, please visit Google Checkout Support documents for 3rd party tracking code. 


 

Additional Tracking Notes

 

  1. Reporting data is usually available 24-48 hours after tracking activation. Once data starts to be collected, there is roughly a one hour lag between a user's click or conversion and updates to your reports.
  2. It is not possible to track the conversions of shoppers who do not have JavaScript enabled on their web browsers. For this reason, expect conversions to be slightly underreported.
  3. If you accept Google Checkout and are using Advanced tracking, please see Step 3 on the Advanced Tracking Installation Instructions page.
  4. Cost data will only be displayed for select shopping engines from which SingleFeed collects this information. It may take several days before cost data appears in your reports.
  5. Google Product Search does not support redirect URLs and so SingleFeed will not use them in your feed to this engine. Reporting data will instead be collected via the JavaScript snippet you install on your site.
  6. If you would like to track orders placed via Google Checkout, please file a ticket with the SingleFeed Support Team.
  7. Tracking cookie expiration is 2 years from date of initial click.
  8. Conversions are recorded only if a click associated to a cookie has occurred within the last 30 days.
Have more questions? Submit a request

0 Comments

Article is closed for comments.