# Setup Guide


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-config >}}

{{< info >}}
In the web device mode integration, that is, using [JavaScript SDK]({{< ref "sources/event-streams/sdks/rudderstack-javascript-sdk/_index.md" >}}) 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]({{< ref "sources/event-streams/sdks/rudderstack-javascript-sdk/load-js-sdk.md#allowlist-destination-domain" >}}) to load the Google Tag Manager SDK successfully.
{{< /info >}}

## Setup

In your [RudderStack dashboard](https://app.rudderstack.com/), add a source. Then, from the list of destinations, select **Google Tag Manager**.

### Connection settings

| Setting | Description |
| :----| :-----|
| Container ID | Your Google Tag Manager [container ID](#faq). You can get it by going to the **Admin** section of your [Google Tag Manager dashboard](https://tagmanager.google.com/#/admin/). |
| Custom Domain URL | Specify your domain URL (for example, `https://your-domain.com`) used to load the Tag Manager scripts instead of Google's domain (`https://www.googletagmanager.com/`). |
| Environment ID | Specify the ID of the [environment](https://support.google.com/tagmanager/answer/6311518?hl=en) used for the Tag Manager container. |
| Authorization Token |  Specify the authorization token for the above environment.<br /><br />See [FAQ](#env-id-token) for more information on obtaining the environment ID and token. | 
| Client-side Events Filtering | This setting lets you specify which events should be blocked or allowed to flow through to Google Tag Manager.<br /><br /> For more information on this setting, see the [Client-side Events Filtering]({{< ref "sources/event-streams/sdks/event-filtering.md" >}}) guide. | 

### Web SDK settings

| Setting | Description |
| :----| :-----|
| Use device mode to send events | This setting is turned on by default as this is a web device mode-only integration. |
| Consent management settings  | Configure the consent management settings for the specified source by choosing the **Consent management provider** from the dropdown and entering the relevant consent category IDs. See [Consent Management in RudderStack]({{< ref "data-governance/consent-management/overview.md" >}}) for more information on this feature. | 

{{< info >}}
You can load Google Tag Manager on any page where you initialize the RudderStack snippet and call the [`page`](#page) event.
{{< /info >}}

## 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:

{{< image src="images/event-stream-destinations/rudderstack-custom-html-gtm.webp" alt="RudderStack as a custom tag" >}}

## Next steps

- [Send events in device mode]({{< ref "destinations/streaming-destinations/google-tag-manager/device-mode.md" >}})

## FAQ 

#### Where can I find the Google Tag Manager Container ID?

You can find your Tag Manager container ID in the admin section of your [Google Tag Manager dashboard](https://tagmanager.google.com/#/admin/). It is present in the format `GTM-XXXXXXX`.

{{< image src="images/event-stream-destinations/rudderstack-container-id.webp"  >}}

#### How can I obtain the Environment ID and Authorization Token fields for the Google Tag Manager destination? {#env-id-token}

1. Define your environment in the Google Tag Manager dashboard. Click the  **Environments** option in the **Container** menu to get started. See [Define environments in Google Tag Manager](https://support.google.com/tagmanager/answer/6311518?hl=en#defineEnvironments) for the detailed steps.

{{< image src="images/event-stream-destinations/gtm-env-id-token-1.webp" alt="Environments option in GTM dashboard" >}}

2. Go to **Custom Environments** and select the environment you created above.
3. Click **Actions** > **Get Snippet**.

{{< image src="images/event-stream-destinations/gtm-env-id-token-2.webp" alt="Get snippet option in GTM dashboard" >}}

4. Copy the `gtm_auth` and `gtm_preview` values in the snippet.

{{< image src="images/event-stream-destinations/gtm-env-id-token-3.webp" alt="Auth token and Environment ID fields in GTM snippet" >}}

5. Specify the values for `gtm_auth` and `gtm_preview` in the  **Authorization Token** and **Environment ID** [destination settings](#connection-settings) in the RudderStack dashboard, respectively.

#### 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](https://support.google.com/tagmanager/answer/6107163?hl=en) for more information.

<br />