Implementation steps Last modified
IMPLEMENTING TRADETRACKER REDIRECT AND CONVERSION INSTRUCTIONS AND CONSIDERATIONS
The articles on these pages are created to help you implement our tracking and conversion registration method.

If you arrived at this portal by using a link that was sent to you, we would like to inform you about the accompanying document to these pages.
This document contains more or less similar information as to be found on this site, but is structured chronological and contains links to the relevant pages on this site, making it somewhat easier to read, depending on what you prefer.
The document is part of the start mail you received or available in your account.

Implementing our click registration and conversion tracking should take about 30 minutes up to 2 hours for general situations.
Although it can be done in 15 minutes in case you are already familiar with setting it up using an available preconfigured implementation method and if there are no unexpected surprises. It can however be longer in more complex set-ups with more stakeholders or when encountering other problems.

We highly recommend you to read the information in the document or on this site.
These articles contain important information about how, why and what you should do in order to set up your campaign successfully.

Setting up the TradeTracker tracking consists of 2 parts:
1) Registering a click from the affiliate’s website to your site.
2) Registering resulting conversions to be able to match the click to the sale.

In order to be able to implement our tracking system, you must be able to:
1) Create a folder on your server and upload a file to it.
2) Make modifications to the checkout success / order confirmation page of your web shop system.

The first thing that needs to be done is getting the click registration mechanism to work.
In order to achieve this, a folder on your web server must be created and our special index redirect file must be uploaded to it. This should result in a file structure like: www.yoursite.com/redirectfolder/index.ext

The available languages we offer are ASP (.asp) | Coldfusion (.cfm) | CSHARP (.aspx) | JSP (.jsp) | PERL (.pl) | PHP (.php) | Python (.py) | Visual Basic ASPX (.aspx).

DOWNLOAD THE AVAILABLE REDIRECT INDEX FILES HERE and extract the zip-file to your computer.

The zipped file contains folders that represent the programming language of the index file. You should choose an index file in a language (extension) that is supported by your server.

ADD YOUR DOMAIN NAME TO THE INDEX REDIRECT FILE
The index file to use depends on the type of server and the programming language that is supported by your server. To make sure our tracking is working as intended, the domain of your website (without www. ) must be added to the index redirect file. The reason to set your domain name is that this is the domain that is used to set the cookie. The line number on where to add the domain for each file is:

ASP (line 9) | Coldfusion (line 7) | CSHARP (line 7) | JSP (line 7) | PERL (line 16) | PHP (line 6) | Python (line 7) | Visual Basic ASPX (line 7).

By default the index file we provide should work in most situations. They are created, tested and verified to work for the majority of our clients. We do not encourage further modification of the provided index file, unless you have a very good reason to do so and know exactly what you are doing.

CREATING A FOLDER TO PLACE THE INDEX FILE
The index file containing your domain name must be placed in a folder in the root of your website. The index file functions as a "ghost" site that is visited (unseen by the visitor) to register the click from the affiliate to your site. This is also referred to as the redirect file/folder.

Within the introduction e-mail that you received from your account manager a suggestion for the location of the redirect folder is made. If you decide to use an other location, please communicate this to your account manager because the correct location is needed to get your campaign to work.

NAMING THE REDIRECT FOLDER
The redirect folder’s name should be a phrase that best represents your shop or topic of your site. If you have a website that sells fashion items or clothing, the name of the redirect folder should represent this. For instance in this case it might be www.yourwebsite.com/fashion/ or www.yourwebsite.com/clothing/.

You should NOT USE a name that resembles any connection or relation to TradeTracker like www.yourwebsite.com/tt/ www.yourwebsite.com/tracking/ www.yourwebsite.com/tradetracker/ or www.yourwebsite.com/redirect/ for example.

Naming the folder like described above can have an negative effect on the performance of your campaign, so it is better to avoid this.

You should verify that the suggested folder is not already part of your website’s link structure. This can be the case if URL rewriting is used for the suggested folder and content is already attached to the suggested location. If that is the case, please think of an alternative location/folder to place the redirect file.

URL Rewriting must be turned OFF for the redirect folder
In case your site is using URL rewriting to create pretty links on your website, URL rewriting must be turned off for the redirect folder in order for it to work correctly. This is done in different ways for different server environments. On an Apache web server, the URL rewrite engine can be turned off for a specific folder by placing an .htaccess file within the redirect folder containing the line:

RewriteEngine Off
For more information about URL rewriting and links to different server settings we refer you to Wikipedia - URL Rewrite Engine.

In case your server supports .htaccess files you can download a zipped .htaccess file to use here.

SUMMARY TO SET UP THE REDIRECT FOLDER AND FILE

1. Determine the server environment and choose the index file format accordingly
2. Create the redirect folder
3. Set the domainName variable with your domain (without www.) in the index file
4. Upload the index file to the folder, turn off the URL rewrite engine according to your server configuration options (if applicable)
5. Use the tracking test url that corresponds to the redirect location to test the redirect

When these steps are done, you are ready to test the redirect to your site by using the tracking test link.

If you did not receive the tracking test link or used a different then suggested redirect location, please contact your account manager.

SETTING UP THE TRADETRACKER CONVERSION SCRIPT AND IMPLEMENTATION CONSIDERATIONS
Before you start copying and pasting the codes that can be found by clicking the links below to your site and come to the conclusion that it's not working as you had planned, please hold on to your horses. Implementing our conversion script requires some thought and consideration. The reason for this is that there are a lot of options and configuration situations to take into account.

Do you have a custom built website? If so, what program language is used? Do you use a Payment Service Provider? An existing web shop system? Are for example things that influence the technical implementation strategy to follow.

We have described a couple of things for you to consider or determine before continuing the implementation.

When you have a clear picture of your technical environment and the other factors described above, you have to main options:

PRE-CONFIGURED WEBSHOP CONVERSION IMPLEMENTATION SOLUTIONS
click the link above to see if we have a solution for your environment available.
The advantages are that these solutions are already configured to use the correct variable values and tested in a default installation of the web shop system.

OUR UNIVERSAL CONVERSION SCRIPTS.
Our universal script is the script that we use to create the web shop specific solutions.
The script requires the variable values that are needed to register conversions within our system to be added manually, but it can be used for any situation.
It does require some basic programming knowledge of the environment in which the script must be placed or use the supported variable placeholders of your shop or environment.
Shortlink to this article: https://sc.tradetracker.net/implementation/overview?f[id]=1
10-Jun-2015 15:14:58