How do I integrate the Tsuiseki Tracking into my Drupal site?

Step 1

To be able to use the Tsuiseki tracking and data analysing system you will need a Tsuiseki Tracking Key, which you receive per email after your registration on https://tsuiseki.com.

Step 2

You can download the Tsuiseki Tracking Module for Drupal at our downloads section.

Step 3

After finishing the download, you will have to unpack the archive and copy the folder into the module directory (.../sites/all/modules) of your Drupal installation.

Step 4

Activate the Tsuiseki Tracking Module: Administer --> Side building --> Modules in the "Other" area.

[Picture of the modules area]

Step 5

Before any data can be captured, the Tsuiseki Module has to be configured. Configuration is possible at Administer --> Settings --> Tsuiseki. After your registration you have received your "key" in an extra email. Enter the key into the field "Tsuiseki Tracking Key".

[Picture of the tracking key input field]

Step 6

This step offers you 3 possibilities:

Option 1:

All of your links on your website have the same class:
e.g.: <a href="http:..." class="tsuiseki-link">
Enter this element and class definition into the "CSS class for outgoing links" field. The format of this entry should correspond with a CSS-selector, e.g. a.tsuiseki-link for an element of type <a> of the class tsuiseki-link.

Option 2:

If you want to capture links of different classes, separate them by comma (maximum 128 characters):
e.g.: a.tsuiseki-link, a.your-tracking-class, a.your-tracking-class2
Enter these elements and their class definitions into the "CSS class for outgoing links" field. The format of this entry should correspond with a CSS-selector, e.g. a.tsuiseki-link for an element of type <a> of the class tsuiseki-link.

Option 3:

If the links to be captured have no class or to many different classes (see Option 2 with over 128 characters) you will have to enter the Tsuiseki class manually. You can present these classes separated by spaces:
e.g.: <a href="http:..." class="your-css-class tsuiseki-link">
Enter an element and class definition into the "CSS class for outgoing links" field. The format of this entry should correspond with a CSS-selector, e.g. a.tsuiseki-link for an element of type <a> of the class tsuiseki-link. Add this class to the elements that should be captured.

Step 7 (optional but recommended)

To distinguish between different types of clicks you can set the id attribute of the tracked elements.
e.g.: <a id="banner-click" href="http://www.example.com/foo" class="tsuiseki-link">...</a>
...
<a id="affiliate-partner" href="http://partners.example.com/ads/foobar" class="tsuiseki-link">...</a>
The length of the value you may enter into the id attribute is limited to 64 characters and should contain only alphanumerical characters and the minus sign.

You can analyse your data after the next data import (data imports are carried out hourly).

Necessary/additional settings for arbitrage websites:
As an operator of an arbitrage website you would distort results with the common settings, because an extra page call up could occur on possible configuration or "thank you" pages. To avoid that you can enter paths that are not to be captured at the settings section of the Tsuiseki Tracking Module. (e.g. admin*, to not capture the admin section of Drupal). If you are carrying out major maintenance for your website you might temporarily deactivate the Tsuiseki Module by clicking disable tracking at advanced settings.

Additional Settings for online shops:
As an operator of an online shop you might not want to analyse every ordering step, because maybe the page to confirm the order is only available through the shopping cart. This again would distort the results as we count a click at the shopping cart section in addition to the click made with every order. To avoid this you can enter those paths not to be considered at the configuration page of the Tsuiseki Tracking Module (e.g.: admin*, for not including the admin section of Drupal). If you are carrying out major maintenance for your website you might temporarily deactivate the Tsuiseki Module by clicking disable tracking at advanced settings.