tiny-track.js - Page tracking for tinyJS

Download

tiny-track.js [3834b] - tiny-track-min.js.gz [1170b]

tiny-track-extra.js [991b] - tiny-track-extra-min.js.gz [441b]

Hinweis

Die t.track-Funktion benötigt tiny.js, falls slicing verwendet werden soll, zudem noch tiny-cookie; die optionale Browser-Erkennung* des client-Parameters erfordert zudem tiny-browser und die optionale Flash-Erkennung* tiny-swf. Auch ohne die zusätzlichen Scripte, von tiny.js abgesehen, funktioniert tiny-track, ist jedoch in seinem Funktionsumfang eingeschränkt. Andere Scripte sind nicht erforderlich.

Verwendung

Das Tracking wird beim Laden der Seite mit den entsprechenden Optionen über die Methode t.track.init(opts) initialisiert. Die Optionen sind dabei als Objekt gekapselt (es kann auch ein Array von Optionen übergeben werden):

Zusätzlich kann man die folgenden Eigenschaften des Trackings jederzeit einstellen bzw. auslesen:

Events

Grundsätzlich kann man jedes normale DOM-Event verwenden, einschließlich weniger gebräuchlicher Events wie window.onorientationchange beim iPhone. Darüber hinaus hat tiny-track noch folgende Besonderheiten:

init

"init" ist kein normales Event, sondern wird direkt beim Initialisieren aufgerufen; es kann durchaus sein, dass manche Informationen zu dieser Zeit nicht verfügbar sind.

ready

document.ready wird aufgerufen, sobald das DOM fertig ist, d.h. der Ladevorgang an HTML, CSS und JS ist abgeschlossen, lediglich Bilder und iframes können noch nachfolgen.

clickin*/clickout*

Diese Events unterteilen das normale click-Event in solche Clicks, welche die Seite verlassen und solche, die es nicht tun. Diese click-Events werden bei Mausklick ausgelöst. Nur hier und bei mousemove gibt pos vernünftige Werte zurück.

mousemove

Wenn der Mauszeiger für mehr als standardmäßig 5 Sekunden (siehe movetimeout) an einer Stelle verharrt, wird dieses Event ausgelöst.

keydown

In allen Browsern außer dem MSIE wird, wenn man ein Formular durch Druck auf Enter innerhalb eines Felds (außer Textarea) abschickt, der erste button/input-submit-node gesucht und dort ein click-Event generiert. Um auch im IE Formular-Absendungen messen zu können, wird hier implizit (ohne Zutun des Nutzers) das keydown-Event mißbraucht.

Manueller Aufruf

In manchen Fällen möchte man Ereignisse tracken, die nicht direkt mit einem Event verbunden sind. In diesem Fall kann man die Funktion t.track([simuliertes Event]) mit einem simulierten Event aufrufen. In jedem Fall gesetzt sein sollten target (ggf. document), ts (new Date()*1) und type (beliebig, es muss jedoch eine URL mit diesem Typ eingetragen sein).

Tracking-Parameter

Die folgenden Informationen können standardmäßig getrackt werden:

Man kann diese Tracking-Parameter leicht ergänzen oder überschreiben, indem man auf t.track.par.[name] zugreift, als Werte kann jeder String oder jede Funktion verwendet werden. Leerstrings und alles, was zu false konvertiert, werden samt der dazugehörigen GET-Parameterschlüssel herausgefiltert.

Beispiel

t.track.par.content = function(e) {
    var T=e.target, c;
    while (!c&&(c=(T.innerHTML||T.value).replace(/<[^>]*>/g,''))&&(T=T.parentNode));
    return escape(c.substr(0,29));
};
t.track.par.cpos=function(e){return ((e.mouseX||0)>>3)+'x'+((e.mouseY||0)>>3)};
var slice={cookie: { name: 'dice', date: 63072000000, path: '/', domain: '.'+location.hostname }, chance: 10};
t.track.init([
    { url: '/cgi-bin/tracking.rb?url=${url}&t=${duration}&ua=${client}&ts=${ts}&s=${screen}&w=${window}&fv=${flash}&ev=${type}', type: 'ready', slice: slice },
    { url: '/cgi-bin/tracking.rb?url=${url}&t=${duration}&pos=${cpos}&lnk=${action}&lnk=${link}&ts=${ts}&ev=${type}', type: 'click', slice: slice }
]);

Test-Formular

© 2010 Alex Kloss