GoogleAnalytics: Unterschied zwischen den Versionen

Aus Contao Community Documentation

 
Zeile 2: Zeile 2:
 
{{ExtInfo
 
{{ExtInfo
 
| Dev=Jan Theofel
 
| Dev=Jan Theofel
| DevSite=[http://www.etes.de ETES GmbH]
+
| DevSite=[http://www.theofel.de Jan Theofel]
| ExtVersion=1.2.0 stable
+
| ExtVersion=1.3.1 stable
| Version=2.9
+
| Version=2.9 - 2.10
 
| ERLink=http://www.contao.org/erweiterungsliste/view/googleanalytics.de.html
 
| ERLink=http://www.contao.org/erweiterungsliste/view/googleanalytics.de.html
| TrackerLink=http://dev.typolight-forge.org/projects/show/googleanalytics
+
| TrackerLink=http://dev.contao-forge.org/projects/show/googleanalytics
 
}}
 
}}
 
=Google Analytics einbinden=
 
=Google Analytics einbinden=
Zeile 16: Zeile 16:
 
==Integration durch Erweiterung googleanalytics==
 
==Integration durch Erweiterung googleanalytics==
  
Alternativ steht die Erweiterung [http://www.contao.org/erweiterungsliste/view/googleanalytics.de.html googleanalytics] zur Verfügung. Diese ist aktuell nur mit Contao 2.9 getestet, sollte aber auch unter 2.8 einsatzfähig sein.
+
Alternativ steht die Erweiterung [http://www.contao.org/erweiterungsliste/view/googleanalytics.de.html googleanalytics] zur Verfügung. Diese ist aktuell nur mit Contao 2.9 und 2.10 getestet, sollte aber auch unter 2.8 einsatzfähig sein.
  
 
Diese bietet folgende Vorteile:
 
Diese bietet folgende Vorteile:
 
* Keine Anpassung an Templates notwendig
 
* Keine Anpassung an Templates notwendig
 
* Mehrere IDs im Multidomainbetrieb ohne verschiedene Seitenlayouts möglich
 
* Mehrere IDs im Multidomainbetrieb ohne verschiedene Seitenlayouts möglich
* Anonymisierung der IP Adresse möglich
+
* Anonymisierung der IP Adresse möglich (notwendig für den rechtssicheren Einsatz)
 
* Download-Tracking über mitgelieferte Templates möglich
 
* Download-Tracking über mitgelieferte Templates möglich
 +
* Manuelles oder automatisches Tracking für externe Links
 +
* Event-Tracking für andere Extensions vorbereitet
 +
* Insert-Tag <nowiki>{{ga::privacytext}}</nowiki> mit deutschsprachigem Text von Google für die Datenschutzhinweise (für den rechtssicheren Einsatz)
  
 
Zur Nutzung bitte wie folgt vorgehen:
 
Zur Nutzung bitte wie folgt vorgehen:
Zeile 28: Zeile 31:
 
* Zu bearbeitende Wurzelseite in der Seitenstruktur öffnen
 
* Zu bearbeitende Wurzelseite in der Seitenstruktur öffnen
 
* Im Abschnitt "Google Analytics" die Google Analytics ID eintragen
 
* Im Abschnitt "Google Analytics" die Google Analytics ID eintragen
* Wenn gewünscht das Häckchen zur Anonymisierung der IP-Adresse anhaken
+
* Wenn gewünscht das Häckchen zur Anonymisierung der IP-Adresse anhaken (in Deutschland für den rechtssicheren Einsatz zwingend notwendig!)
* Nicht vergessen: Datenschutzhinweise aus den Google Analytics AGB müssen in die Webseite eingebaut werden!
+
  
 
==Google Analytics ID ermitteln==
 
==Google Analytics ID ermitteln==
Zeile 38: Zeile 40:
 
* Rechts oben auf "Status prüfen" klicken
 
* Rechts oben auf "Status prüfen" klicken
 
* Den Wert "Web-Property-ID" auslesen (Format: UA-xxxxxx-x)
 
* Den Wert "Web-Property-ID" auslesen (Format: UA-xxxxxx-x)
 +
* Bitte die Hinweise zum [http://www.contao-anleitungen.de/post/google-analytics-datenschutzkonform-einsetzen.html rechtssicheren Einsatz] beachten!
 +
 +
=Spezialfunktionen nutzen=
 +
 +
==Insert-Tag für Datenschutzhinweise==
 +
Das Insert-Tag <nowiki>{{ga::privacytext}}</nowiki> stellt den Text aus den [http://www.google.com/intl/de/analytics/tos.html deutschen Nutzungsbedinungen von Google Analytics] zur Verfügung. Es wird bei Änderungen mit gepflegt, so dass hier stets die aktuelle Fassung zur Verfügung steht, ohne das manuell Textanpassungen übernommen werdenmüssen.
  
 
==Download-Tracking==
 
==Download-Tracking==
Um das Download-Tracking zu nutzen werden im Ordner system/modules/googleanalytics/templates die Dateien ce_download_ga.tpl (für Einzeldownloads) und ce_downloads_ga.tpl (für mehrere Downloads) mitgeliefert. Diese einfach in das zentrale Templates-Verzeichnis kopieren und als ce_download.tpl bzw. ce_downloads.tpl umbenennen.
+
Um das Download-Tracking zu nutzen werden im Ordner system/modules/googleanalytics/templates die Dateien ce_download_ga (für Einzeldownloads) und ce_downloads_ga (für mehrere Downloads) mitgeliefert. Diese einfach in das zentrale Templates-Verzeichnis kopieren und als ce_download bzw. ce_downloads umbenennen. Die Templates stehen ab Version 1.3.1 sowohl als tpl wie auch als xhtml/html5-Version (für Contao 2.10) zur Verfügung.
 +
 
 +
==Tracking externer URLS==
 +
In den Einstellungen kann das Trackign externen URLs in zwei verschiedenen Varianten aktiviert werden.
 +
 
 +
1. Alle externen URLs werden getrackt
 +
Dabei wird für alle externen URLs ein onClick-Event definiert bzw. die vorhandenen ergänzt, so dass alle Links auf externe Links ins Tracking mit einfließen.
 +
 
 +
2. Nur manuell gesetzte URLs werden getrackt
 +
Auf der Seite wird der Code für das Tracking externer Links vorbereitet, jedoch nicht in die Links eingefügt. Dies muss manuell oder über speziell angepasste Templates geschehen. Hierzu ist für jeden zu trackenden Link ein onClick-Event zu setzen, welches die Funktion recordOutboundLink mit folgenden Parameter aufruft: Gruppe im Event-Tracking, Wert und ein Flag, ob die URL in einem neuen Fenster geöffnet werden soll (1=ja, 0=nein). Beispiel:
 +
 
 +
<nowiki><a href="foobar.com" onClick="recordOutboundLink(this, 'Outbound Links', 'foobar.com', 1);return false;"></nowiki>
 +
 
 +
==Event-Tracking==
 +
Es kann ebenfalls der Code für das Tracking von Events auf der Seite in die Seite eingebunden werden. Dieser kann dann über Aufruf der Funktion gaTrackEvent genutzt werden, welche zwei Parameter nimmt: Die Gruppe im Event-Tracking und einen Wert. Beispiel:
 +
 
 +
<nowiki><a href="mailto:foo@bar.com" onClick="gaTrackEvent('E-Mail sent', 'foo@bar.com');"></nowiki>
 +
 
  
 
----
 
----
 
erstellt von Jan Theofel
 
erstellt von Jan Theofel

Aktuelle Version vom 24. Oktober 2011, 17:53 Uhr


Erweiterungs-Übersicht
Name des Entwicklers Jan Theofel
Entwickler Webseite Jan Theofel
Version der Erweiterung 1.3.1 stable
Kompatibilität mit Contao Version 2.9 - 2.10
Link zum Extension Repository http://www.contao.org/erweiterungsliste/view/googleanalytics.de.html
Link zum Tracker http://dev.contao-forge.org/projects/show/googleanalytics

Google Analytics einbinden

Integration durch Templateanpassungen

Seit Contao 2.9 ist die Unterstützung für Google Analytics aus dem Seitenlayout entfernt worden. Der im Core vorgesehene Weg ist, das Template moo_analytics zu editieren und dieses als MooTools-Template in das Seitenlayout einzubinden. (siehe zweiten Abschnitt hier).

Integration durch Erweiterung googleanalytics

Alternativ steht die Erweiterung googleanalytics zur Verfügung. Diese ist aktuell nur mit Contao 2.9 und 2.10 getestet, sollte aber auch unter 2.8 einsatzfähig sein.

Diese bietet folgende Vorteile:

  • Keine Anpassung an Templates notwendig
  • Mehrere IDs im Multidomainbetrieb ohne verschiedene Seitenlayouts möglich
  • Anonymisierung der IP Adresse möglich (notwendig für den rechtssicheren Einsatz)
  • Download-Tracking über mitgelieferte Templates möglich
  • Manuelles oder automatisches Tracking für externe Links
  • Event-Tracking für andere Extensions vorbereitet
  • Insert-Tag {{ga::privacytext}} mit deutschsprachigem Text von Google für die Datenschutzhinweise (für den rechtssicheren Einsatz)

Zur Nutzung bitte wie folgt vorgehen:

  • Google Analytics ID ermitteln (siehe unten)
  • Zu bearbeitende Wurzelseite in der Seitenstruktur öffnen
  • Im Abschnitt "Google Analytics" die Google Analytics ID eintragen
  • Wenn gewünscht das Häckchen zur Anonymisierung der IP-Adresse anhaken (in Deutschland für den rechtssicheren Einsatz zwingend notwendig!)

Google Analytics ID ermitteln

  • Neues Google Analytics Konto anlegen (wenn noch nicht vorhanden)
  • Die gewünschte Domain in Google Analytics eintragen
  • Auf der Startseite von GA die Domain anklicken.
  • Dort rechts auf "Bearbeiten" gehen
  • Rechts oben auf "Status prüfen" klicken
  • Den Wert "Web-Property-ID" auslesen (Format: UA-xxxxxx-x)
  • Bitte die Hinweise zum rechtssicheren Einsatz beachten!

Spezialfunktionen nutzen

Insert-Tag für Datenschutzhinweise

Das Insert-Tag {{ga::privacytext}} stellt den Text aus den deutschen Nutzungsbedinungen von Google Analytics zur Verfügung. Es wird bei Änderungen mit gepflegt, so dass hier stets die aktuelle Fassung zur Verfügung steht, ohne das manuell Textanpassungen übernommen werdenmüssen.

Download-Tracking

Um das Download-Tracking zu nutzen werden im Ordner system/modules/googleanalytics/templates die Dateien ce_download_ga (für Einzeldownloads) und ce_downloads_ga (für mehrere Downloads) mitgeliefert. Diese einfach in das zentrale Templates-Verzeichnis kopieren und als ce_download bzw. ce_downloads umbenennen. Die Templates stehen ab Version 1.3.1 sowohl als tpl wie auch als xhtml/html5-Version (für Contao 2.10) zur Verfügung.

Tracking externer URLS

In den Einstellungen kann das Trackign externen URLs in zwei verschiedenen Varianten aktiviert werden.

1. Alle externen URLs werden getrackt Dabei wird für alle externen URLs ein onClick-Event definiert bzw. die vorhandenen ergänzt, so dass alle Links auf externe Links ins Tracking mit einfließen.

2. Nur manuell gesetzte URLs werden getrackt Auf der Seite wird der Code für das Tracking externer Links vorbereitet, jedoch nicht in die Links eingefügt. Dies muss manuell oder über speziell angepasste Templates geschehen. Hierzu ist für jeden zu trackenden Link ein onClick-Event zu setzen, welches die Funktion recordOutboundLink mit folgenden Parameter aufruft: Gruppe im Event-Tracking, Wert und ein Flag, ob die URL in einem neuen Fenster geöffnet werden soll (1=ja, 0=nein). Beispiel:

<a href="foobar.com" onClick="recordOutboundLink(this, 'Outbound Links', 'foobar.com', 1);return false;">

Event-Tracking

Es kann ebenfalls der Code für das Tracking von Events auf der Seite in die Seite eingebunden werden. Dieser kann dann über Aufruf der Funktion gaTrackEvent genutzt werden, welche zwei Parameter nimmt: Die Gruppe im Event-Tracking und einen Wert. Beispiel:

<a href="mailto:foo@bar.com" onClick="gaTrackEvent('E-Mail sent', 'foo@bar.com');">



erstellt von Jan Theofel

Ansichten
Meine Werkzeuge

Contao Community Documentation

die Liste ist länger als ich und lindes zusammen...

Yanick Witschi
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge