Task: Adjust documentation

KaufmannDigital · Apr 19, 2024 · e70a09d · e70a09d
1 parent 5bade6d
commit e70a09d
Show file tree

Hide file tree

Showing 10 changed files with 37 additions and 4 deletions.
diff --git a/Documentation/GoogleTagManager.md b/Documentation/GoogleTagManager.md
@@ -1,5 +1,38 @@
 # KaufmannDigital.GDPR.UserManagement
-## React to User-Decision using Google Tag Manager
+(Sorry for screenshots in german. Tag-Manager ignored the browser-settings for language while creating them. Feel free to contribute some in english language.)
+## Use Google Tag-Manager's Consent-Mode
+
+### 1. Enable Consent-Mode in Tag-Manager. 
+Consent mode is currently (Q1/2024) still a beta feature, but it works perfectly. However, the feature must be activated once for the tag container. This is simply done via the settings in the Tag Manager login:![Google Tag-Manager Container settings](Images/GoogleTagManager/gtm_container_settings.png)
+![Google Tag-Manager Container settings](Images/GoogleTagManager/gtm_container_settings_detail.png)
+(this step may no longer be necessary after the beta phase)
+### 2. Configure needed consents in relevant tags
+The consent must then be configured in the relevant tags. For tags from Google's templates, Google already provides its own consents. These can be supplemented with your own consents:  
+![Google Tag-Manager Tag settings](Images/GoogleTagManager/gtm_tag_settings.png)  
+For individual tags, only the individual consent is available and must be configured accordingly.
+
+"Consent Initialization" (exists as a template) can then be used as a trigger for the tags. If required, this can be extended to include further conditions (such as URL match):  
+![Google Tag-Manager Trigger settings](Images/GoogleTagManager/gtm_trigger_settings.png)
+
+
+### 3. Configure Consents in Neos
+GTM clients can also be configured in the cookie or cookie group inspector. Settings for this can be found both in the groups and in the individual cookies.
+First, the consents specified by Google can be selected. You can then activate your own consents in the field below.  
+![Neos Cookie consent-settings](Images/GoogleTagManager/neos_gtm_consent_settings.png)  
+All consents that are configured in Neos are assigned the status "denied" by default. After the user has made a decision, the corresponding consents are updated and overwritten with the user decision.
+
+
+### 4. Test via Tag-Manager
+The preview mode in the Tag Manager can be used to test whether everything is working. Information about the status of the consents is now available here. You can also see why individual tags have not been fired.  
+![Debugging in Tag-Manager](Images/GoogleTagManager/gtm_debugging_1.png)  
+![Debugging in Tag-Manager](Images/GoogleTagManager/gtm_debugging_2.png)
+![Debugging in Tag-Manager](Images/GoogleTagManager/gtm_debugging_3.png)
+
+
+
+<hr />
+
+## React to a custom event (also supported with alternative Tag-Managers or other tools)
 Only a few configurations are necessary to use the Tag Manager. The necessary steps are described in detail below.
 
 ### 1. Create custom variable

diff --git a/Documentation/Images/GoogleTagManager/gtm_container_settings.png b/Documentation/Images/GoogleTagManager/gtm_container_settings.png
diff --git a/Documentation/Images/GoogleTagManager/gtm_container_settings_detail.png b/Documentation/Images/GoogleTagManager/gtm_container_settings_detail.png
diff --git a/Documentation/Images/GoogleTagManager/gtm_debugging_1.png b/Documentation/Images/GoogleTagManager/gtm_debugging_1.png
diff --git a/Documentation/Images/GoogleTagManager/gtm_debugging_2.png b/Documentation/Images/GoogleTagManager/gtm_debugging_2.png
diff --git a/Documentation/Images/GoogleTagManager/gtm_debugging_3.png b/Documentation/Images/GoogleTagManager/gtm_debugging_3.png
diff --git a/Documentation/Images/GoogleTagManager/gtm_tag_settings.png b/Documentation/Images/GoogleTagManager/gtm_tag_settings.png
diff --git a/Documentation/Images/GoogleTagManager/gtm_trigger_settings.png b/Documentation/Images/GoogleTagManager/gtm_trigger_settings.png
diff --git a/Documentation/Images/GoogleTagManager/neos_gtm_consent_settings.png b/Documentation/Images/GoogleTagManager/neos_gtm_consent_settings.png
diff --git a/README.md b/README.md
@@ -173,9 +173,9 @@ So just check *consents* and load the needed JavaScript.
 
 
 
-#### React to datalayer event in Google Tag Manager
-
-In order to react to the user's decision in the Google Tag Manager, not much is needed. You can easily listen to an custom event. [We provided a full Guide here.](Documentation/GoogleTagManager.md)
+#### Google Tag Manager Integration
+There are two ways to interact between CookieConsent and Google's Tag-Manager. Also the new "Consent Mode" is supported. [We provided a full Guide here.](Documentation/GoogleTagManager.md)
+You can use the "old" way (also described in the link above) in alternative Tag-Managers, too.