How do I integrate the Tsuiseki Tracking into my Typo3 site?
Step 1
To be able to use the Tsuiseki tracking and Data Analysis 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 extension for Typo3 at the repository or our downloads section.
Step 3
Now you will have to import and install the Tsuiseki Tracker via the extension manager.
Step 4
Before any data can be captured, the Tsuiseki Tracking extension has to be configured. Configuration is possible at the Admintools → Tsuiseki. After your registration you have received your "key" in an extra email. Enter the key into the field "Tsuiseki Tracking Key".
Step 5
Allocation of the tracking class. 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 6
Insert Tsuiseki in every page, to do this there are several ways:
Option 1:
The easiest way is to insert it as plugin on the pages you want to observe. This is recommended if you just want to observe a few pages and don't want to exclude all other pages in the admintool for tsuiseki.
Option 2:
The other way is to include the tsuiseki tracking extension via the Template Setup:
- page = PAGE...page.100 < plugin.tx_tsuiseki_pi1
Here you can manage the sites you want to observe with Typoscript conditions or you exclude the site-ids you don't want to track in Admintools → Tsuiseki.
Step 7
Option 1:
The easiest way is to insert it as plugin on the pages you want to observe. This is recommended if you just want to observe a few pages and don't want to exclude all other pages in the admintool for tsuiseki.
Option 2:
The other way is to include the tsuiseki tracking extension via the Template Setup:
- page = PAGE...page.100 < plugin.tx_tsuiseki_pi1
Here you can manage the sites you want to observe with Typoscript conditions or you exclude the site-ids you don't want to track in Admintools → Tsuiseki.
Now you will have to include the static template. To do this you select "Edit whole template record" in Webmodule → Template, switch to the tab called "Includes" and select the "Tsuiseki Tracker"-template. Save this selection and your site is ready for the Tsuiseki Tracking and Data Analysis System.