Install CUX code with Google Tag Manager

You can install the CUX code using Google Tag Manager (GTM). This is the least troublesome and the fastest method to see data in CUX. If your site already has the GTM code implemented, you can gather insights in minutes. Installation via GTM saves you the woes of navigating through the code or admin panel of your site. Once you create a CUX tag and publish your GTM settings, the CUX database starts filling with insights.

Before you start

You need a set up and configured Google Tag Manager. Create a container for the site you want to monitor with CUX.

Installing CUX code with GTM

  1. Sign in to Google Tag Manager.

  2. Select the account and container for the site you want to monitor with CUX.

  3. Go to Tags and click New.

  4. Enter a name for the tag — for example, CUX insights.

  5. Click Tag Configuration and select Custom HTML.

  6. Copy the CUX code from your account. Make sure you select the right project if you have more than one.
    For more information, see Where can I find the CUX code?

  7. Paste your CUX code in the HTML field.

  8. Setup a trigger. Select All pages to ensure the best insight into your visitor behavior. You can optionally add exceptions for pages that you don't want to be monitored with CUX.

  9. Save your new GTM tag configuration.

  10. Use the GTM preview feature to see if the CUX code starts.
    a. Click Preview in GTM. It will inform you that the preview mode is on.

    Image caption: A Google Tag Manager banner showing that preview mode is on.
    b.  Open your site in a new browser tab.
    c. Once a page is loaded, GTM opens a panel in at the bottom of the browser window, where it shows all scripts that it triggered there. You should be able to see CUX on the list.

    Image caption: Google Tag Manager preview showing that CUX code has started operating.

  11. Navigate to GTM and switch off the preview mode. 

  12. Click Submit to publish the changes.
    That’s it! The tracking starts momentarily.

  13. Log in to CUX to verify if the code works. See, Checking if the CUX code works

Please note, we make sure to have this set of instructions as accurate as possible. It may happen that when Google redesign their tools, we may be slightly out of sync. It's always best to check Google's help for the most up-to-date description.

If you're still unsure how to install a custom HTML code in GTM, see the official Google documentation.

Data layer integration

Please note that this process won’t integrate your CUX project with Google Tag Manager events. It is, of course, possible you need to flick a single switch in the Integrations section. By default, the integration isn’t active. When you enable the integration, you’ll be able to search visits that triggered specific GTM events. For more information, see https://cuxio.atlassian.net/wiki/spaces/kb/pages/5832750.

Next steps

General instructions for CUX code installation