Neue TYPO3-Erweiterung: Google Analytics Download Link Tracker

28.09.2009 - 10:26

Eine neue Erweiterung von TYPO3 aus dem Hause LOGLAN ist im Online Typo3 Extension Repository (TER) verfügbar: der Google Analytics Download Link Tracker. Diese TYPO3-Erweiterung kann unter typo3.org/extensions/repository/view/ga_download_tracker/current/ heruntergeladen werden.

Google Analytics erfasst die Benutzeraktivität auf einer Webseite. Jeder Besuch wird umfangreich analysiert uns statistisch ausgewertet. Bei der standardmässigen Installation von Google Analytics werden aber die Downloads von PDF-Dokumenten nicht statistisch erfasst. Dies ist von Nachteil, wenn auf einer Webseite wichtige Informationen in PDF-Form zur Verfügung stehen. Da das Aufbereiten solcher Dokumente meistens ein aufwendiger Prozess ist, ist es für den Anbieter solcher Informationen wichtig zu wissen, ob und wie oft diese Dokumente heruntergeladen werden.

Ein bisschen TypoScript

Die ga_download_tracker Erweteiterung baut auf dem Javascript Framework MooTools auf. Dieses ist auch als TYPO3-Erweiterung vorhanden (t3mootools) und muss vorinstalliert werden.

Im Grunde besteht die Download Tracker Erweiterung aus einem kurzen TypoScript, das sowohl t3mootols als auch ga_download_tracker einfügt. Dieses TypoScript muss als statisches Templates dem Root-Template angefügt werden.

/typo3conf/ext/ga_download_tracker/static/ga_download_tracker/setup.txt

# Add mootools library

includeLibs.t3mootools = EXT:t3mootools/class.tx_t3mootools.php
page.130 = USER
page.130.userFunc = tx_t3mootools->addJS
page.130.jsfile = EXT:ga_download_tracker/res/ga_download_tracker.js
 

... und ein paar Zeilen Javascript

Nachdem das DOM vollständig geladen ist, werden über Javascript alle Links auf der aktuellen Seite überprüft. Jeder Link auf eine PDF-Datei wird mit einem passenden onclick Event Handler ergänzt:

/typo3conf/ga_download_tracker/res/ga_download_tracker.js (Ausschnitt)

if (pageTracker) item.addEvent('click', function(event) { pageTracker._trackPageview(pathToTrack); });

Die Variable pathToTrack enthält den Pfad, der von  Google Analytics bei einem Download erfasst wird. Dieser wird von der Erweiterung automatisch aus der URL der aktuellen Seite und dem PDF-Dateinamen erstellt. Somit können die Downloads übersichtlich pro Seite und Sprache von Google Analytics ausgewertet werden. Zudem hat die automatische Benennung des Pfades hat ausserdem den Vorteil, dass kein redaktioneller Aufwand anfällt.

Angenommen, der Benutzer befindet sich auf der Seite www.loglan.net/de/angebot/webdesign/fallstudien/ auf der ein PDF-Dokument mit dem Dateinamen «fallstudie_kundeXY.pdf» vorhanden ist. Google Analytics würde dann die Anzahl Downloads dieses Dokuments unter dem Pfad /de/angebot/webdesign/fallstudien/fallstudie_kundeXY.pdf erfassen.

Für allfällige Fragen zu dieser Erweiterung steht Ihnen der Autor zur Verfügung: Ivan Ruiz Gallego.