extend changelog and readme
This commit is contained in:
parent
306af0f7bd
commit
00f76d9908
25
CHANGELOG.md
25
CHANGELOG.md
@ -4,27 +4,6 @@ All notable changes to this project will be documented in this file.
|
|||||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||||
|
|
||||||
## [Unreleased](https://git.d3data.de/D3Public/MyModule/compare/1.1.0.0...rel_1.x)
|
## [1.0.0.0](https://git.d3data.de/D3Public/GoogleAnalytics4/compare/1.0.0.0...1.1.0.0) - 2022-07-26
|
||||||
|
|
||||||
## [1.1.0.0](https://git.d3data.de/D3Public/MyModule/compare/1.0.0.0...1.1.0.0) - 2022-07-26
|
|
||||||
### Added
|
### Added
|
||||||
- another feature
|
- publication of app features
|
||||||
|
|
||||||
### Changed
|
|
||||||
- changed old code
|
|
||||||
|
|
||||||
### Deprecated
|
|
||||||
- ...
|
|
||||||
|
|
||||||
### Removed
|
|
||||||
- ...
|
|
||||||
|
|
||||||
### Fixed
|
|
||||||
- ...
|
|
||||||
|
|
||||||
### Security
|
|
||||||
- ...
|
|
||||||
|
|
||||||
## [1.0.0.0](https://git.d3data.de/D3Public/MyModule/releases/tag/1.0.0.0) - 2022-07-25
|
|
||||||
### Added
|
|
||||||
- implemented features
|
|
||||||
18
README.md
18
README.md
@ -58,6 +58,12 @@ Tragen Sie die nötige sog. 'Container ID' ein. Diese sieht in etwa so aus: 'GTM
|
|||||||
|
|
||||||
Aktivieren Sie GA4 selbst, indem Sie dieses direkt darunter anhaken.
|
Aktivieren Sie GA4 selbst, indem Sie dieses direkt darunter anhaken.
|
||||||
|
|
||||||
|
### GA4 Events / Customizing
|
||||||
|
Für alle implementierten GA4 Events existieren Templates unter `source/modules/d3/googleanalytics4/Application/views/ga4/`, dabei entspricht der Dateiname dem Eventnamen in GA4.
|
||||||
|
Die Einbindung dieser Event-Templates erfolgt über TPL-Blöcke unter `source/modules/d3/googleanalytics4/Application/views/blocks/`.
|
||||||
|
*Hinweis: nicht alle templates sind bereits gefüllt. Wünschen Sie die Implementierung eines unausgefüllten templates?
|
||||||
|
Kommen Sie auf uns zu unter https://www.d3data.de/
|
||||||
|
|
||||||
### Blöcke
|
### Blöcke
|
||||||
Für den geregelten Ablauf sind folgende Blöcke nötig:
|
Für den geregelten Ablauf sind folgende Blöcke nötig:
|
||||||
- Suchergebnisse
|
- Suchergebnisse
|
||||||
@ -85,6 +91,18 @@ Für den geregelten Ablauf sind folgende Blöcke nötig:
|
|||||||
- Datei: page/checkout/thankyou.tpl
|
- Datei: page/checkout/thankyou.tpl
|
||||||
- GA4 Event: purchase
|
- GA4 Event: purchase
|
||||||
|
|
||||||
|
### Verfügbare Datalayer Variablen
|
||||||
|
Für die einfachste Übersicht der enthaltenen Daten empfehle ich den Vorschau-Modus vom Google Tag Manager.
|
||||||
|
|
||||||
|
Bei jedem Seitenaufruf wird die Datenschicht mit einigen wenigen Infos erstellt, die man zum reinen Erfassen der Seitenaufrufe benötigt:
|
||||||
|
+ **page.type** - Seitentyp: default / cms / product / listing / checkout (an google analytics angelehnt)
|
||||||
|
+ **page.title** - Seitentitel (außer Startseite, sie hat keinen Titel)
|
||||||
|
+ **page.cl** - OXID Controller Klasse (start, search, etc)
|
||||||
|
+ **userid** - oxId vom Benutzer bzw `false` falls nicht eingeloggt
|
||||||
|
+ **sessionid** - session iD
|
||||||
|
|
||||||
|
Alle für Ecommerce Tracking relevanten Daten werden mit speziellen Ecommerce Events in die Datenschicht eingefügt.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
Sie nutzen einen eigenen, als Modul im Shop installierten, Cookie-manager? Dann tragen Sie in den Folgeeinstellungen
|
Sie nutzen einen eigenen, als Modul im Shop installierten, Cookie-manager? Dann tragen Sie in den Folgeeinstellungen
|
||||||
|
|||||||
67
__README.md
67
__README.md
@ -1,67 +0,0 @@
|
|||||||
# [D3] Google Tag Manager
|
|
||||||
Google Tag Manager integration for OXID eShop v6.x
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
* ``composer require vanilla-thunder/oxid-module-gtm --no-update``
|
|
||||||
* Modul aktivieren und Moduleinstellungen konfigurieren
|
|
||||||
|
|
||||||
## Tag Manager konfigurieren:
|
|
||||||
+ https://support.google.com/tagmanager/answer/9442095
|
|
||||||
|
|
||||||
## Google Analytics 4 Einrichtung
|
|
||||||
|
|
||||||
## GA4 Events / Customizing
|
|
||||||
für alle implementierten GA4 Events existieren Templates unter `source/modules/GoogleTagManager/Application/views/ga4/`, dabei entspricht der Dateiname dem Eventnamen in GA4.
|
|
||||||
Die Einbindung dieser Event-Templates erfolgt über TPL-Blöcke unter `source/modules/GoogleTagManager/Application/views/blocks/`.
|
|
||||||
|
|
||||||
### aktuell zu beachtende Blöcke
|
|
||||||
- Suchergebnisse: search_results
|
|
||||||
- (muss hinzugefügt werden) aList: d3Ga4_view_item_list
|
|
||||||
- Detailseite: details_productmain_title
|
|
||||||
- add_to_basket-button: details_productmain_tobasket
|
|
||||||
- Warenkorb: checkout_basket_main
|
|
||||||
- Purchase | abgeschlossener Kauf: checkout_thankyou_main
|
|
||||||
|
|
||||||
## Universal Analytics Events
|
|
||||||
|
|
||||||
**"EE-Trigger" für Ecomemrce-Tags (Beispiel für Google Tag Manager):**
|
|
||||||
+ Triggertyp: Benutzerdefiniertes Ereignis
|
|
||||||
+ Ereignisname: ``ee\..*``
|
|
||||||
+ Übereinstimmung mit regulärem Ausdruck verwenden
|
|
||||||
+ Diesen Trigger auslösen bei: Alle benutzerdefinierten Ereignisse
|
|
||||||
|
|
||||||
**"EE-Tag" für Google Analytics Enhanced Ecommerce:**
|
|
||||||
+ Tag-Typ: Google Analytics - Universal Analytics
|
|
||||||
+ Tracking-Typ: Ereignis
|
|
||||||
+ Aktion: {{Event}}
|
|
||||||
+ Label: {{Event Label}}
|
|
||||||
+ Trigger : EE-Trigger
|
|
||||||
|
|
||||||
## Verfügbare Datalayer Variablen
|
|
||||||
Für die einfachste Übersicht der enthaltenen Daten empfehle ich den Vorschau-Modus vom Google Tag Manager.
|
|
||||||
|
|
||||||
Bei jedem Seitenaufruf wird die Datenschicht mit einigen wenigen Infos erstellt, die man zum reinen Erfassen der Seitenaufrufe benötigt:
|
|
||||||
+ **page.type** - Seitentyp: default / cms / product / listing / checkout (an google analytics angelehnt)
|
|
||||||
+ **page.title** - Seitentitel (außer Startseite, sie hat keinen Titel. Danke OXID...)
|
|
||||||
+ **page.cl** - OXID Controller Klasse (start, search, etc)
|
|
||||||
+ **userid** - oxID vom Benutzer bzw `false` falls nicht eingeloggt
|
|
||||||
+ **sessionid** - session iD
|
|
||||||
|
|
||||||
Alle für Ecommerce Tracking releavanten Daten werden mit speziellen Ecommerce Events in die Datenschicht eingefügt.
|
|
||||||
Hier ist ein Beispiel für die Einrichtung von Enhanced Ecomemrce Tracking über Google Tag Manager:
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
### LICENSE AGREEMENT
|
|
||||||
[vt] google-tag-manager
|
|
||||||
Copyright (C) 2021 Marat Bedoev
|
|
||||||
info: info@mb-dev.pro oder so /** @todo: überarbeiten, wenn ich wieder nüchtern bin */
|
|
||||||
|
|
||||||
This program is free software;
|
|
||||||
you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation;
|
|
||||||
either version 3 of the License, or (at your option) any later version.
|
|
||||||
|
|
||||||
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
|
|
||||||
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
|
||||||
You should have received a copy of the GNU General Public License along with this program; if not, see <http://www.gnu.org/licenses/>
|
|
||||||
Loading…
x
Reference in New Issue
Block a user