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
  1. <!-- WiredMinds Web eMetrics V2.14 START -->
  2. <script type="text/javascript">
  3. <!--
  4.   var pgname="PAGE_NAME";
  5.   var grname="GROUP_NAME";
  6.   var version="2.14";
  7.   var resolution="";
  8.   var color_depth="";
  9.   var plugin_list="";
  10.   var jv=0;
  11.   var ref=document.referrer;
  12.   if(typeof(top.document)=="object") ref=top.document.referrer;
  13.   resolution=screen.width+"x"+screen.height;
  14.   color_depth=navigator.appName!='Netscape'? screen.colorDepth : screen.pixelDepth;
  15.   for (var i=0; i<navigator.plugins.length; i++) { plugin_list += navigator.plugins[i].name + ';'; }
  16.   if (navigator.javaEnabled()) { jv=1; }
  17.   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>');
  18. //-->
  19. </script>
  20. <noscript>
  21. <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>
  22. </noscript>
  23. <!-- 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 vondurchin 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
  1. <!-- WiredMinds Web eMetrics V2.14 START -->
  2. <script type="text/javascript">
  3. <!--
  4.   var pgname="###CT_PAGE###";
  5.   var grname="###CT_GROUP###";
  6.   var version="2.14";
  7.   var resolution="";
  8.   var color_depth="";
  9.   var plugin_list="";
  10.   var jv=0;
  11.   var ref=document.referrer;
  12.   if(typeof(top.document)=="object") ref=top.document.referrer;
  13.   resolution=screen.width+"x"+screen.height;
  14.   color_depth=navigator.appName!='Netscape'? screen.colorDepth : screen.pixelDepth;
  15.   for (var i=0; i<navigator.plugins.length; i++) { plugin_list += navigator.plugins[i].name + ';'; }
  16.   if (navigator.javaEnabled()) { jv=1; }
  17.   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>');
  18. //-->
  19. </script>
  20. <noscript>
  21. <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>
  22. </noscript>
  23. <!-- 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 · typoscript page tracking · e-mail newsletter tracking typo3 · typo3 tracker