{"id":22879034,"url":"https://github.com/xenbytecom/contao-etracker","last_synced_at":"2026-02-08T16:02:39.267Z","repository":{"id":234999582,"uuid":"789890086","full_name":"xenbytecom/contao-etracker","owner":"xenbytecom","description":"Inoffical etracker plugin for Contao CMS","archived":false,"fork":false,"pushed_at":"2025-07-01T16:30:35.000Z","size":696,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-19T01:32:40.346Z","etag":null,"topics":["contao","contao-bundle","etracker","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xenbytecom.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":"https://www.paypal.com/donate/?hosted_button_id=J425R728CYH9N"}},"created_at":"2024-04-21T20:31:44.000Z","updated_at":"2025-07-01T16:30:38.000Z","dependencies_parsed_at":"2024-09-10T16:21:22.992Z","dependency_job_id":"60bd076d-5857-43db-a92b-cc290cb913d2","html_url":"https://github.com/xenbytecom/contao-etracker","commit_stats":null,"previous_names":["xenbytecom/contao-etracker"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/xenbytecom/contao-etracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenbytecom%2Fcontao-etracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenbytecom%2Fcontao-etracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenbytecom%2Fcontao-etracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenbytecom%2Fcontao-etracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xenbytecom","download_url":"https://codeload.github.com/xenbytecom/contao-etracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xenbytecom%2Fcontao-etracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29236134,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-08T14:18:14.570Z","status":"ssl_error","status_checked_at":"2026-02-08T14:18:14.071Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["contao","contao-bundle","etracker","php"],"created_at":"2024-12-13T16:36:48.053Z","updated_at":"2026-02-08T16:02:39.260Z","avatar_url":"https://github.com/xenbytecom.png","language":"PHP","funding_links":["https://www.paypal.com/donate/?hosted_button_id=J425R728CYH9N"],"categories":[],"sub_categories":[],"readme":"# etracker-Integration für Contao CMS\n\n![etracker.svg](etracker.svg)\n\nMit diesem Bundle kann etracker Analytics einfach in Contao eingebunden werden. Kompatibel zu Contao 5.3 und Contao 5.4.\nDie Versionen zwischen Contao 4.13 und 5.2 werden nur bis Version 0.5.x der Erweiterung unterstützt.\n\nEs handelt sich noch um eine Vorab-Version in der aktiven Entwicklungs- und Testphase. Jedes Feedback (via Github, im\nContao-Forum oder per E-Mail) ist willkommen.\n\n![Packagist Version](https://img.shields.io/packagist/v/xenbyte/contao-etracker)\n[![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://www.paypal.com/donate/?hosted_button_id=J425R728CYH9N)\n\n## Features\n\n* etracker-Account je Startpunkt einer Seite\n* optionales Deaktivieren von etracker für eingeloggte Benutzer und/oder Mitglieder\n* Setzen der Variable et_pagename je Seite oder automatische Erkennung\n* Setzen der Variable et_areas je Seite oder automatische Ermittlung über die Seitenstruktur\n* Berücksichtung von Titeln der News, Kalender-Einträge etc.\n* Tracking der Formular-Interaktionen (muss in den Formular-Einstellungen konfiguriert werden)\n* Tracking der Suchergebnisse als Onsite-Kampagne (muss in den Suchmodul-Einstellungen konfiguriert werden und erfordert\n  etracker Pro oder Enterprise)\n* Tracking von Logins (erfolgreich und fehlgeschlagen), Logouts und Registrierungen\n* Event-Tracking-Vorlagen\n\n## Geplante Funktionen\n\n* deaktivierung Cookie-less tracking\n* eigene Dimensionen: https://www.etracker.com/docs/integration-setup/tracking-code-sdks/tracking-code-integration/eigene-segmente/\n* evtl. Anbindung and Cookiebar\n* Registrierungsformular für Formular-Tracking berücksichtigen\n* Einstellung, ob der intersection observer für die Feld-Sichtbarkeit verwendet werden soll\n\n## Voraussetzzungen\n\n* Contao 5.3 oder neuer\n* PHP 8.1 oder neuer\n* [etracker-Konto](https://www.xenbyte.com/go-etracker) (kostenpflichtig)[^1]\n\n## Installation\n\nEntweder über den Contao Manager oder mittels composer via `composer require xenbyte/contao-etracker`\n\n## Konfiguration\n\n### Website-Startseite (Root-Ebene)\n\n![docs/01_rootpage_setup.png](docs/01_rootpage_setup.png)\n\nDie etracker-Integration wird auf den jeweiligen Website-Startseiten aktiviert. Der Account-Schlüssel von etracker ist\ndas einzige Pflichtfeld. Weitere Felder:\n\n* Haupt-Domain: Die im etracker hinterlegte Haupt-Domain. Diese Angabe wird nur für den Zählungsausschluss benötigt.\n  Dieses Konfigurationsfeld wird voraussichtlich noch verschoben.\n* Eigene Tracking-Domain: Wenn\n  eine [eigene Tracking-Domain](https://www.etracker.com/docs/integration-setup/tracking-code-sdks/eigene-tracking-domain-einrichten/)\n  eingerichtet wurde, ist die abweichende Tracking-Domain hier anzugeben.\n* Debug mode: ermöglicht den etracker-eigenen debug mode, wahlweise komplett oder nur für Backend-Benutzer\n* Bereich-Name: legt einen Bereichsnamen fest, der für et_area an die Unterseiten weitergegeben wird. Auf\n  Website-Startseiten-Ebene wäre bei mehrsprachigen Seiten z. B. die Sprache als Bereich 1 empfehlenswert. Wenn es nur\n  eine Website-Startseite (Root-Ebene) gibt, sollte das Feld leergelassen werden.\n* Do Not Track (DNT) berücksichtigen: Standardmäßig berücksichtigt etracker die DNT-Angabe des Browsers nicht (\n  siehe [etracker-Artikel](https://www.etracker.com/tipp-der-woche-do-not-track/)), die Berücksichtigung kann jedoch mit\n  der Einstellung erzwungen werden.\n* Frontend-Benutzer ausschließen: bindet kein Tracking Code für eingeloggte Mitglieder aus, auch nicht bei aktiviertem\n  debug mode\n* Backend-Bentuzer ausschließen: bindet kein Tracking Code für eingeloggte Benutzer aus, auch nicht bei aktiviertem\n  debug mode\n* Cross_Devide-Tracking von Frontend-Benutzern: Zum Geräteübergreifenden Tracking kann der Benutzername als md5-Hash\n  übermittelt werden\n\n### Reguläre Seite\n\n![docs/02_page_setup.png](docs/02_page_setup.png)\n\nSämtliche Angaben für die Unterseiten sind optional.\n\n* Seitenname: Wenn kein Seitenname in den etracker-Einstellungen gesetzt ist, wird der Seitentitel (welcher u. U. aber\n  noch den Suffix des Website-Namens enthält) herangezogen.\n* Bereich-Name: Standardmäßig identisch zum Seitenname, kann aber überschrieben werden. Dieser Wert wird als Ebenen-Name\n  für die Unterseiten weitergegeben.\n* Bereiche: Überschreibt die Bereiche für die aktuelle Seite anstatt diese über die Vererbungen zu generieren\n\n### Interne Suche tracken (etracker Pro oder Enterprise)\n\nAls Vorbereitung sind, wie in\nder [etracker-Dokumentation](https://www.etracker.com/docs/integration-setup/tracking-code-sdks/tracking-code-integration/onsite-kampagnen/)\nbeschrieben, \"in den Account-Einstellungen unter Einstellungen → Account → Automatische Erfassung → Interne Suche die\nBenennung der Suche vorzunehmen\". Der Wert für etcc_cmp_onsite ist bei der Contao-Konfiguration zu verwenden.\n\n![docs/03_search_setup.png](docs/03_search_setup.png)\n\n### Formulare tracken (zum Teil etracker Pro oder Enterprise)\nDie Messung von Formular-Aufrufen und -Absendungen ist mit allen etracker-Accounts möglich.\n\nUm die Formularanalyse zu verwenden, kann bei jedem Formular die entsprechende Option aktiviert werden. Ein abweichender\nFormularname, der in etracker verwendet werden soll, kann festgelegtwerden - ansonsten wird die Titel-Angabe verwendet.\n\nFür die detailierte Formularanalyse (etwa die Auswertung von Formularfeldern) ist etracker Pro oder Enterprise\nerforderlich. Für diese lässt sich bei jedem Formularfeld eine \"Sektion\" festlegen, ansonsten wird der Wert \"Standard\" \nverwendet. Dies ist beispielsweise bei Formularen mit mehreren Bereichen möglich - eine automatische Erkennung über die \nFieldsets ist (zumindest derzeit) nicht möglich. Für jedes Feld lässt sich auch eine für etracker abweichende Bezeichnung \nnutzen bzw. ein kompletter Ausschluss des Feldes festlegen.\n\n*Hinweis:* Für eine möglichst genaue Messung der Formular-Felder wird für jedes Feld ein Event ausgelöst, sobald\nes sichtbar wird. Bei Formularen mit vielen Feldern kann dies u. U. zu einer hohen Anzahl an \"Hits\" führen.\n\n### Ereignis-Tracking\n\nDer etracker tag manager unterstützt mittlerweile eine gute Konfiguration von Ereignissen. Da manche Ereignisse aber \nu. U. nicht via JavaScripts erkannt werden können oder einige Contao-spezifische Ereignisse über die Erweiterung\nschneller konfiguriert werden können (auch Startpunkt-abhängig), bietet die Erweiterung ein Ereignis-Tracking mit\nVorlagen an. Abgedeckt werden damit:\n\n* Klick auf E-Mail-Adressen (mailto-Links)\n* Klick auf Telefonnummern (tel-Links)\n* Ausklappen eines Accordion-Elements\n* Klick auf Galerie-Bild zur Vergrößerung\n* Datei-Download\n* Sprachwechsel (bei Standard-Template von contao-changelanguage)\n* erfolgreiche Logins\n* fehlgeschlagene Logins\n* Logouts\n* Benutzer-Registrierungen\n\nFür die schnelle Konfiguration sind jedoch Texte als Vorlage vorausgefühllt. Das Event-Objekt ist abhängig von der\ngewählten Vorlage hinterlegt und eingeschränkt, kann aber auch mit einem eigenen Textwert konfiguriert werden.\nDarüber hinaus sind benutzerdefinierte Ereignisse (nur click-Trigger) auch über die Contao-Oberfläche wähbar.\n\n**Hinweis:** Das Anlegen der Ereignisse erfolgt zunächst im Menüpunkt `etracker Events`. Die einzelnen Ereignisse müssen\nanschließend auf Root-Ebene (Startpunkt einer Website) explizit aktiviert werden. Dadurch ist es möglich, dasselbe Event\nmit unterschiedlichen Werten je Root-Ebene zu nutzen.\n\n## Nutzung im Contao Cookiebar\netracker bietet zwar einen [Cookie-Consent-Manager](https://www.etracker.com/consent-manager/), doch in etracker Basic\nist damit nur der etracker-Dienst abgedeckt. Bei Nutzung weiterer Dienste ist entweder etracker Pro oder Enterprise\nerforderlich oder die [Cookiebar-Erweiterung von Oveleon](https://github.com/oveleon/contao-cookiebar) empfehlenswert.\n\nHier sollte jedoch nicht der etracker-Typ gewählt werden, da der Trackingcode damit doppelt ausgeliefert würde. \nStattdessen sollte der Typ \"benutzerdefiniertes Script\" gewählt werden. Der Code für die Cookiebar kann dann wie \nfolgt aussehen:\n\n```js\nvar _etrackerOnReady = typeof _etrackerOnReady === 'undefined' ? [] : _etrackerOnReady;\n_etrackerOnReady.push(function(){ _etracker.enableCookies() });\n```\n\nEin besseres Zusammenspiel mit der Contao Cookiebar ist in Planung, aber noch nicht umgesetzt.\n\n## CSP-Header für etracker\n\nSeit Contao 5.13 können die CSP-Header direkt im Backend aktiviert werden. Dies empfiehlt sich, da Contao so auch \ndie Nonce für die Skripte generiert. So kann auf die CSP-Direktive 'unsafe-inline' verzichtet werden.\n\n```\nHeader set Content-Security-Policy \"script-src 'self' https://*.etracker.com https://*.etracker.de; connect-src https://*.etracker.de\"\n```\n\nBei Verwendung der Scrollmap sollte zudem noch das Einbetten in einen iframe erlaubt werden:\n\n```\nHeader set Content-Security-Policy \"frame-ancestors https://*.etracker.com; script-src 'self' https://*.etracker.com https://*.etracker.de; connect-src https://*.etracker.de\"\n```\n\n## Disclaimer\netracker und das etracker Logo sind Eigentum der etracker GmbH. Die etracker-Integration in Contao ist eine eigene,\ninoffizielle Erweiterung.\n\n[^1]: Dies ist ein Partnerlink. Wenn du über diesen Link ein etracker-Konto erstellst und etracker abonnierst, erhält\nXenbyte eine Provision. Für dich entstehen dadurch keine zusätzlichen Kosten.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxenbytecom%2Fcontao-etracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxenbytecom%2Fcontao-etracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxenbytecom%2Fcontao-etracker/lists"}