Deploy RUM JS (Google Tag Manager)

🚀 Deploy GermainUX RUM JavaScript with Google Tag Manager

Deploy GermainUX RUM JavaScript through Google Tag Manager (GTM) to monitor the performance and experience of real users without changing the application’s source code directly.

Once deployed, GermainUX can capture performance, errors, user interactions, journeys, and session-replay data according to the selected UX monitoring profile.

✅ Before you begin

You need:

Confirm that browsers can send HTTPS traffic from the monitored application to the GermainUX environment.

🗺️ Deployment overview

The deployment consists of four stages:

1. Create the application and UX monitoring profile in GermainUX.

2. Retrieve the installation script generated by GermainUX.

3. add the script to a GTM Custom HTML tag.

4. Preview, validate, and publish the GTM container.

⚙️ 1. Configure the application in GermainUX

1. Sign in to Germain Workspace.

2. Go to Wizards.

   

3. Open Google Tag Manager.

4. Enter the application name.

5. Enter the application URL.

   

6. Select or create the appropriate UX monitoring profile.

7. Configure the requested application and environment information.

8. Complete the wizard.

Use a name that identifies both the application and environment, such as:

Use separate configurations when QA and production send telemetry to different GermainUX environments or require different privacy settings.

📁 2. Retrieve the installation script

The wizard displays the deployment instructions after creating the configuration.

You can return to these instructions at any time:

1. Go to Analytics > UX Monitoring Profiles.

2. Select the profile assigned to the monitored application.

   

3. Open the profile in the Configuration Editor.

4. Select Installation.

5. Locate the Google Tag Manager deployment instructions.

6. Copy the complete script generated for the application.

Use the script provided by your GermainUX environment. Do not manually reconstruct URLs, identifiers, or configuration values from another application or environment.

🏷️ 3. Create the GTM tag

In Google Tag Manager:

1. Open the container used by the monitored application.

2. Go to Tags.

3. Select New.

4. Enter a descriptive name, such as GermainUX RUM – Production.

5. Select Tag Configuration.

6. Choose Custom HTML.

7. Paste the complete GermainUX installation script into the HTML field.

8. Configure the appropriate trigger.

9. Save the tag.

🛠️ 4. Configure the trigger

For complete application monitoring, use an initialization or page-view trigger that runs on every monitored page.

Choose the trigger according to your application:

Do not configure the tag to run repeatedly for every virtual route change unless the GermainUX deployment instructions explicitly require it. Initializing RUM JavaScript more than once can create duplicate sessions, events, or requests.

📝 Consent configuration

If the application uses a consent-management platform, align the GTM trigger with the organization’s approved consent policy.

Depending on your legal basis and configuration, you may need to:

Technical deployment through GTM does not replace the organization’s responsibility to provide appropriate notices and obtain consent where required.

🔒 Privacy configuration

Before publishing the tag, configure and test the UX monitoring profile to ensure that sensitive information is not captured.

Review:

Do not collect passwords, authentication tokens, payment information, health information, or other restricted data.

Whenever possible, exclude sensitive information before it leaves the user’s browser.

🛡️ Content Security Policy

An application using Content Security Policy may block the Custom HTML tag, the GermainUX script, or its outbound connections.

Review the browser console for violations involving:

Allow only the specific GermainUX origins required by your deployment. Coordinate policy changes with the application-security team and avoid broad wildcard permissions.

If your policy does not permit inline scripts, the standard GTM Custom HTML approach may require an approved nonce, hash, or alternative deployment method.

👀 Preview and test the tag

Do not publish the container immediately.

1. Select Preview in Google Tag Manager.

   

2. Enter the application URL.

3. Connect Tag Assistant to the application.

4. Confirm that the GermainUX tag fires on the intended pages.

5. Confirm that it does not fire on excluded pages.

6. Open the browser developer tools.

7. Check the console for JavaScript, CSP, certificate, or network errors.

8. Confirm that the GermainUX script loads successfully.

9. Perform several representative user actions.

10. Confirm that telemetry is sent to the expected GermainUX environment.

If consent is required, test both consent states:

☑️ Validate the data in GermainUX

After completing the browser test:

1. Open Germain Workspace.

2. Search for the monitored application.

3. Locate the test session.

4. Confirm that page views and navigation were captured.

5. Review performance measures and user interactions.

6. Confirm that JavaScript and network errors are reported.

7. Open the session replay, if enabled.

8. Verify that sensitive fields and elements are masked or excluded.

9. Confirm that the application and environment names are correct.

10. Check that only one session and one set of events were generated.

Repeat the validation using every browser and application workflow that is important to the deployment.

☁️ Publish the GTM container

After validation:

1. Return to Google Tag Manager.

2. Select Submit.

3. Enter a version name, such as Add GermainUX RUM monitoring.

4. Describe the application, environment, trigger, and UX profile included in the change.

5. Review all container changes.

6. Select Publish.

For high-traffic applications, consider limiting the initial production deployment to a small percentage of users or a controlled audience before enabling it for everyone.

✅ Verify the production deployment

After publishing:

🔁 Updating the deployment

When the GermainUX installation script or destination changes:

1. Retrieve the current script from the UX monitoring profile.

2. Create a new GTM container version.

3. Update the Custom HTML tag.

4. Test the change using GTM Preview.

5. Validate incoming data in GermainUX.

6. Publish the updated container.

7. Retain the previous GTM version for rollback.

Configuration changes made entirely within the centrally managed UX monitoring profile may not require a new GTM deployment.

🔧 Troubleshooting

The GermainUX tag does not fire

Check that:

Use GTM Preview to determine why the tag did not fire.

📈 The tag fires, but no data appears

Confirm that:

🔁 Data is duplicated

Check whether:

A page should normally initialize the applicable GermainUX RUM configuration only once.

🔍 Some routes are missing

For a single-page application, confirm that the selected GermainUX integration detects client-side route changes. Also verify that GTM is not reinitializing the complete RUM script for every virtual navigation.

⛔ Session replay contains sensitive information

Disable or restrict the affected monitoring profile immediately. Correct the masking or exclusion rules, validate them in a non-production environment, and only then re-enable the affected capture.

ℹ️ Feature information