Setup Guide

Set up and configure Google Tag Manager as a destination in RudderStack.

This guide will help you set up Google Tag Manager as a destination in the RudderStack dashboard. It also lists the configuration settings required to correctly send data from the supported sources to Google Tag Manager.

Connection compatibility

Destination info
  • Status: Generally Available
  • Supported sources: Web
  • Refer to it as GTM in the Integrations object.

Connection modes
SourceCloud modeDevice modeHybrid mode
Webnot supportedsupportednot supported
Supported message types
SourceIdentifyPageTrackScreenGroupAlias
Device mode
Websupportedsupportedsupportednot supportednot supportednot supported
info

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Google Tag Manager native SDK from the https://www.googletagmanager.com/ domain.

Based on your website’s content security policy, you might need to allowlist this domain to load the Google Tag Manager SDK successfully.

Setup

In your RudderStack dashboard, add a source. Then, from the list of destinations, select Google Tag Manager.

Connection settings

The connection settings required to configure Google Tag Manager as a destination in RudderStack are listed below:

SettingDescription
Container IDYour Google Tag Manager container ID. You can get it by going to the Admin section of your Google Tag Manager dashboard.
Server Container URLYour Tag Manager server container URL. Use this setting when you want RudderStack to load the Tag Manager scripts from your specified server container URL instead of Google’s domain (https://www.googletagmanager.com/).

See Send data to server-side Tag Manager for more information.
info
You can load Google Tag Manager on any page where you initialize the RudderStack snippet and call the page event.

Load RudderStack as a custom HTML tag

You can also load RudderStack as a custom tag in Google Tag Manager. However, loading Google Tag Manager through RudderStack is recommended, by following the steps described in the above section.

The following image demonstrates how you can add RudderStack as a custom HTML tag which can then be called through Google Tag Manager:

RudderStack as a custom tag

Next steps

FAQ

Where can I find the GTM Container ID?

You can find your Tag Manager container ID in the admin section of your GTM dashboard. It is present in the format GTM-XXXXXXX.

Where can I find the server container URL?

  1. Click your server container and go to the Admin tab.
  2. Click Container Settings. You can find the container URL listed here.

I am getting a 404 error when using Google Tag Manager. What should I do?

If you are getting a 404 error on the JavaScript console of your web page related to the Google Tag Manager, verify if you have published your Google Tag Manager Container. Follow this guide for more information.



Questions? Contact us by email or on Slack