Skip to main content

Google Tag Manager

The Google Tag Manager connection allows agents to read and manage accounts, containers, workspaces, tags, triggers, variables, folders, versions, and environments in Google Tag Manager. It is a powerful tool that can change measurement and published settings on the website.

When to Use It​

Use it for auditing GTM configuration, preparing changes in the workspace, checking tags, triggers, and variables, or for controlled changes in measurement settings.

Setup​

  1. In Connections, click on Add Integration.
  2. Select Google Tag Manager.
  3. Log in with a Google account that has access to the appropriate GTM account and container.
  4. In the connection details, enable only the necessary features.
  5. For change features, enable confirmation.

What the Tool Can Do​

  • list accounts, containers, and workspaces,
  • read tags, triggers, variables, folders, and versions,
  • create, edit, delete, and revert GTM entities,
  • synchronize workspaces,
  • create versions and publish containers,
  • manage environments and clients.

Security and Confirmation​

Publishing a container, editing tags, triggers, variables, and deleting entities can directly affect measurement, marketing campaigns, and the production website. In production, always require confirmation and ideally use a separate workspace for proposing changes.

Example Usage​

Review the GTM container and find tags that do not have a clear trigger or appear to be duplicated. Only propose changes, do not make any edits.

Verify the results in Google Tag Manager in the specified workspace and in Tool Execution.

Technical Notes​

  • Implementation: The connection exposes a broad Google Tag Manager management surface.
  • Authentication/scopes: requests https://www.googleapis.com/auth/tagmanager.edit.containers; GTM account/container/workspace permissions determine what can be changed.
  • Functions: manage accounts, containers, workspaces, tags, triggers, variables, folders, versions, environments, clients, zones, templates, transformations, Google tag configs/destinations, and user permissions.
  • Write behavior: GTM changes can affect production tracking, consent, marketing pixels, and analytics. Require approvals and prefer workspace review/versioning before publishing.