Google Analytics zur online HTML-Dokumentation hinzufügen, um die Seitenaufrufe zu verfolgen

Google Analytics (GA) ist eine von Google offerierte, kostenfreie Dienstleistung, welche verschiedene, anonyme Informationen über Benutzer verfolgen kann, welche eine bestimmte Webseite besuchen. GA kann beispielsweise feststellen, wie viele Benutzer sich welche Seiten angeschaut haben und für wie lange. Die Dienstleistung ermöglicht die Erstellung von vielen, detaillierten Reports über das Verhalten der Nutzer. Es handelt sich um ein entscheidendes Instrument, um die Bedürfnisse und Erwartungen des Zielpublikums verstehen zu können. Die Integration von Google Analytics in eine HTML-Dokumentation ist sehr nützlich, um genaue Kenntnisse über die Anwendersuchen zu erlangen. Die Nutzung stellt sich dank dem leistungsstarken HelpNDoc-Vorlagensystem überaus unkompliziert dar.

Track HTML documentation views with Google Analytics

Schritt 1: Den Tracking-Code von Google Analytics ausfindig machen

Ein spezieller Tracking-Code ist nötig, damit Google Analytics weiß, welche Domain aktuell verfolgt wird. Um den Code für die Domain zu erlangen, auf welcher die online Dokumentationen platziert werden sollen, müssen Sie ganz einfach zu den Google Analytics Grundeinstellungen für die Domain gehen und den bereitgestellten Code kopieren. Der Code sollte dem folgenden Code gleichen, jedoch mit einem angepassten Kontowert:

<script>

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-123456-7']);
  _gaq.push(['_trackPageview']);

  (function() {
   var ga = document.createElement('script');
   ga.type = 'text/javascript'; ga.async = true;
   ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'https://www')
            + '.google-analytics.com/ga.js';
   var s = document.getElementsByTagName('script')[0];
   s.parentNode.insertBefore(ga, s); })();

</script>

Schritt 2: Code in Ihrer HelpNDoc-Vorlage einfügen

HelpNDoc bietet einen äußerst bequemen Weg, um die HTML-Ausgabe der generierten Dokumentation zu kontrollieren: Erstellen oder bearbeiten Sie ganz einfach eine Vorlage, um HelpNDoc darüber zu instruieren, wie die Dokumentation generiert werden soll. HelpNDoc unterstützt dies durchs Kopieren der standardmäßigen HTML-Vorlage und dem wo nötigem Hinzufügen des Tracking-Codes:

  • Als bestes Verfahren wird empfohlen die im HelpNDoc Installationsverzeichnis zur Verfügung gestellten, standardmäßigen Vorlagen nicht zu bearbeiten. Kopieren Sie die standardmäßige HTML-Vorlage aus C:\Program Files\IBE Software\HelpNDoc\templates\html\default zum persönlichen Vorlagenordner, welcher sich unter My Documents\HelpNDoc\templates\html\default
  • Der Vorlagenname kann nun geändert werden. Nennen Sie den Ordner von default auf analytics und bearbeiten Sie die template.info Datei, um einen neuen Namen für die Vorlage festzulegen, wie zum Beispiel HTML-Vorlage mit Google Analytics
  • Zu guter Letzt sollten Sie den Tracking-Code in den HTML-Kopfteil Ihres Themas einfügen und zwar durch die Bearbeitung der topics.pas.html Datei. Fügen Sie den Google Analytics Code im head der HTML-Vorlagendatei ein

Schritt 3: Veröffentlichen Sie Ihre Dokumentation, um Statistiken einzuholen

Jetzt können Sie die HTML-Dokumentation von einem HelpNDoc-Projekt aus generieren. Spezifizieren Sie die neu erstellte Vorlage im Erstellungsfenster, laden Sie diese auf den Webserver und voilà! Google Analytics wird frei Daten für Sie sammeln und Ihnen unkomplizierte aber sehr leistungsstarke Reports präsentieren, welche klare Indikationen darüber liefern, was die Anwender genau mit Ihrer Onlinedokumentation machen.

Kategorien: artikel