User Tracking für TYPO3 Websites

Die Software HotTracker / WiredMinds Enterprise Edition analysiert mittels eines Zählpixels das Besucherverhalten auf Websites und erstellt aussagefähige Reports (ähnlich Google Analytics). Die WiredMinds AG bietet mit Hot Tracker Web-Tracking als gehostete ASP (Application Solution Provider) Lösung an. Mit diesem Tutorial zeigen wir, wie Sie Ihre TYPO3-Website um diese interessante Funktion erweitern können.

Vorgehensweise

Nachdem Sie sich auf der Website www.wiredminds.de registriert haben, können Sie sich Ihren Zählpixel-Code im HTML-Format herunterladen. Ein beispielhafter Code hat in etwa folgendes Format:

Beispiel für einen Zählpixel Tracking-Code

HTML

<!-- WiredMinds Web eMetrics V2.14 START -->

```
<script type="text/javascript">
```
```
<!--
```
```
  var pgname="PAGE_NAME";
```
```
  var grname="GROUP_NAME";
```
```
  var version="2.14";
```
```
  var resolution="";
```
```
  var color_depth="";
```
```
  var plugin_list="";
```
```
  var jv=0;
```
```
  var ref=document.referrer;
```

  if(typeof(top.document)=="object") ref=top.document.referrer;

  resolution=screen.width+"x"+screen.height;

  color_depth=navigator.appName!='Netscape'? screen.colorDepth : screen.pixelDepth;

  for (var i=0; i<navigator.plugins.length; i++) { plugin_list += navigator.plugins[i].name + ';'; }

  if (navigator.javaEnabled()) { jv=1; }

  document.write('<div><a target="_blank" href="http://www.wiredminds.de"><img src="http://ctsde01.wiredminds.de/click_track/ctin.php?custnum=12345&amp;sname=SERVER_NAME&amp;pagename='+escape(pgname)+'&amp;group='+escape(grname)+'&amp;version='+version+'&amp;js=1&amp;jv='+jv+'&amp;resolution='+resolution+'&amp;color_depth='+color_depth+'&amp;plugins='+escape(plugin_list)+'&amp;referrer='+escape(ref)+'" alt="WiredMinds eMetrics tracking with Click Track" border="0"><\/a><\/div>');

```
//-->
```
```
</script>
```
```
<noscript>
```

<div><a target="_blank" HREF="http://www.wiredminds.de"><img src="http://ctsde01.wiredminds.de/click_track/ctin.php?custnum=12345&amp;sname=SERVER_NAME&amp;pagename=PAGE_NAME&amp;group=GROUP_NAME&amp;version=2.14" alt="WiredMinds eMetrics tracking with Click Track" border="0"></a></div>

```
</noscript>
```

<!-- WiredMinds Web eMetrics V2.14 END --> 

Diesen Pixelcode kopieren Sie nun in das HTML-Template Ihrer TYPO3-Website, am besten direkt vor den abschließenden </body> Tag.
Um später aus dem TypoScript Template Ihrer Website automatische Ersetzungen in diesem Code durchführen zu können, sind folgende Anpassungen nötig:

Ersetzen von	durch	in Zeile(n)
PAGE_NAME	###CT_PAGE###	4 und 21
GROUP_NAME	###CT_GROUP###	5 und 21
SERVER_NAME	###CT_SERVER###	17 und 21

Hinweis: Nach custnum= sollte bereits Ihre eigene Kundennummer stehen (im Beispiel '12345'; Zeilen 17 und 21).
Nachdem Sie diese Änderungen durchgeführt haben, sollte Ihr Pixelcode in etwa so aussehen:

Pixelcode nach den Anpassungen

HTML

<!-- WiredMinds Web eMetrics V2.14 START -->

```
<script type="text/javascript">
```
```
<!--
```
```
  var pgname="###CT_PAGE###";
```
```
  var grname="###CT_GROUP###";
```
```
  var version="2.14";
```
```
  var resolution="";
```
```
  var color_depth="";
```
```
  var plugin_list="";
```
```
  var jv=0;
```
```
  var ref=document.referrer;
```

  if(typeof(top.document)=="object") ref=top.document.referrer;

  resolution=screen.width+"x"+screen.height;

  color_depth=navigator.appName!='Netscape'? screen.colorDepth : screen.pixelDepth;

  for (var i=0; i<navigator.plugins.length; i++) { plugin_list += navigator.plugins[i].name + ';'; }

  if (navigator.javaEnabled()) { jv=1; }

  document.write('<div><a target="_blank" href="http://www.wiredminds.de"><img src="http://ctsde01.wiredminds.de/click_track/ctin.php?custnum=12345&amp;sname=###CT_SERVER###&amp;pagename='+escape(pgname)+'&amp;group='+escape(grname)+'&amp;version='+version+'&amp;js=1&amp;jv='+jv+'&amp;resolution='+resolution+'&amp;color_depth='+color_depth+'&amp;plugins='+escape(plugin_list)+'&amp;referrer='+escape(ref)+'" alt="WiredMinds eMetrics tracking with Click Track" border="0"><\/a><\/div>');

```
//-->
```
```
</script>
```
```
<noscript>
```

<div><a target="_blank" HREF="http://www.wiredminds.de"><img src="http://ctsde01.wiredminds.de/click_track/ctin.php?custnum=12345&amp;sname=###CT_SERVER###&amp;pagename=###CT_PAGE###&amp;group=###CT_GROUP###&amp;version=2.14" alt="WiredMinds eMetrics tracking with Click Track" border="0"></a></div>

```
</noscript>
```

<!-- WiredMinds Web eMetrics V2.14 END --> 

Jetzt fehlen nur noch die Anpassungen im TypoScript Template, die die jeweiligen Seiteninformationen dynamisch ersetzen sollen.
Hierzu öffnen Sie den SETUP-Teil Ihres TypoScript Templates zum Bearbeiten. Im Dort gibt es einen Bereich, in dem bereits andere Platzhalter Ihres Website-Layouts ersetzt werden. Diese befinden sich innerhalb des PAGE-Objektes und sind gekennzeichnet durch die Angaben subparts oder marks.
Nun kopieren Sie den folgenden TypoScript Code dort hinein:

Erweiterung des TypoScript-Templates

SETUP

   1: marks {
   2:   # Servername der Website setzen
   3:   CT_SERVER = TEXT
   4:   CT_SERVER.value = www.example.com
   5:   # URL der aktuellen Seite auslesen
   6:   CT_PAGE = TEXT
   7:   CT_PAGE.typolink {
   8:     parameter.data = TSFE : id
   9:     returnLast = url
  10:   }
  11:   # Als "Group" den Titel der Seite auf Ebene 1 im Rootpath
  12:   CT_GROUP = TEXT
  13:   CT_GROUP.data = leveltitle : 1
  14: }

Die einzige Änderung, die Sie in diesem Code noch durchführen ist, den Text www.example.com (Zeile 4) durch die Domain Ihrer Website zu ersetzen.
Dieser Code ersetzt im HTML-Template den Platzhalter ###CT_PAGE### durch die vollständige URL der aktuellen Seite und trägt bei ###CT_GROUP### den Titel derjenigen Seite ein, der sich im Rootpath der aktuellen Seite auf der ersten Ebene befindet.
Hinweis: Wenn Sie das User Tracking nur für eine einzelne Website, deren Name sich nicht ändert, verwenden wollen, dann können Sie den Namen (im Beispiel 'www.example.com') auch direkt (statt SERVER_NAME bzw. ###CT_SERVER###) ins HTML-Template eintragen. In diesem Fall erübrigen sich die Zeilen 3 und 4 im TypoScript SETUP.

Besucher fanden diese Seite unter folgenden Suchbegriffen:

typo3 user tracking · typo3 tracking · tracking homepage typo3 · wiredminds emetrics · wiredminds typo3