Skip to main content

Google Tag Manager (Web)

This guide shows how to install MoveoOne on the web using Google Tag Manager (GTM). The MoveoOne tag is available in the Community Template Gallery — see the listing: MoveoOne GTM template.

Prerequisites​

  • A published GTM Web container for your site.
  • Your MoveoOne token from the MoveoOne platform (Integrations page — the token is shown at the top).

1) Set up your GTM account and container (Web)​

  1. Create or sign in to your Google Tag Manager account.
  2. Create a new container and choose type Web.
  3. Note the container ID (e.g., GTM-XXXXXXX) for installation.

For details, see Google’s guide: Set up and install Google Tag Manager.

You can open the template page directly while signed in to Google Tag Manager: MoveoOne GTM template (gallery).

  1. In GTM, go to Tags → New.
  2. In Tag Configuration, open Discover more tag types in the Community Template Gallery (Community Template Gallery).
  3. Use the search (magnifying glass) and search for moveo.
  4. Choose the MoveoOne template → Add to workspace → Add.

3) Configure the MoveoOne tag​

  1. With Tag Configuration still open, set the following:

Moveo token (required)
Paste the token from the MoveoOne platform (Integrations page, at the top).

App version
You can leave the default on a first release; bump it when you ship new versions if you want to segment by release.

Deployment type
Choose how your site is built:

  • Web static — Use for mostly static sites (marketing pages, simple HTML, JAMstack without a rich client app). Tracking follows page loads and DOM behavior typical of static sites.
  • Web app — Use for single-page applications (SPAs) and other client-heavy apps where routes and UI update without full reloads. This mode aligns tracking with in-app navigation and dynamic views.

If you selected Web app, additional options appear for local storage and session storage:

  • MoveoOne needs a stable user identifier across sessions in apps. Your application should store something like a user id (or anonymous id) in localStorage or sessionStorage (or both, depending on your auth model).
  • Add one table row per key you want the tag to read from storage. Each row maps a storage key to the value MoveoOne should use (for example, the key your app uses for userId). Without at least one sensible id key, cross-session recognition in an app may be weak.

Exclude detailed tracking
When enabled, this reduces low-level UX signals (for example, appearance and disappearance of containers and similar DOM-level detail). Use it if you want a leaner stream and do not need that granularity.

Users who are more business-logic oriented and want to analyze and predict business metrics with richer behavioral context should leave this option off (do not exclude detailed tracking), so container and interaction-level signals remain available.

  1. Below Tag Configuration, open Triggering and choose All Pages so the tag runs on every page load GTM covers.

4) Publish your GTM container​

  1. Click Submit.
  2. Publish a new version of the container so the MoveoOne tag goes live.

5) Add the GTM snippet to your site​

If the snippet is not already on your site:

  1. In the Google Tag Manager main workspace, click your container ID (GTM-XXXXXXX).
  2. Choose Install Google Tag Manager and copy the snippets Google provides.
  3. Add them to your site’s HTML per Google’s instructions.

Important: Place the GTM snippet on every page you want to track. Pages without the snippet will not fire GTM tags, including MoveoOne.

Implementation details vary by platform (Shopify, WordPress, static hosting, etc.). See: Install Google Tag Manager.

Verify​

  • Use GTM Preview to load your site and confirm the MoveoOne tag fires on All Pages.
  • Check the browser Network tab for moveo-one-script.min.js requests.

Troubleshooting​

  • Tag not firing: ensure the trigger is All Pages and the container version is published.
  • Missing token: the tag requires Moveo token; leaving it blank will cause initialization to fail.
  • Ad blockers: script injection can be blocked by extensions; test in an incognito window with extensions disabled.

What the template does​

  • Loads the MoveoOne library and initializes it with your configuration (token, deployment type, app version, optional locale/tests, storage keys for web app mode, and optional exclusion of detailed tracking).
  • Template permissions (visible in GTM) include script injection for the MoveoOne library and running initialization in the page context.