Skip to main content

Google Tag Manager (Web)

This guide shows how to install MoveoOne on the web using Google Tag Manager (GTM) with our custom tag template.

Prerequisites​

  • A published GTM Web container for your site.
  • Your MoveoOne token.
  • Download the MoveoOne GTM template: template.tpl
    • Required: You cannot integrate without downloading this template first.

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.

2) Import the MoveoOne template​

  1. In GTM, go to Templates → Tag Templates → New.
  2. Click Options (⋮) → Import.
  3. Select the downloaded template.tpl and Save the template.

3) Create a MoveoOne tag​

  1. Go to Tags → New → Tag Configuration → select MoveoOne.
  2. Configure fields:
    • Moveo Token (required): your MoveoOne token.
    • App Version (optional): e.g., 1.0.0.
    • Locale (optional): e.g., en-US.
    • A/B Test (optional): A, B, or No Test.
  3. Set Trigger to All Pages.

Notes:

  • The template safely injects the MoveoOne library and initializes via MoveoOne.init with your configuration.
  • Template permissions (visible in GTM): script injection for the MoveoOne library and executing MoveoOne.init in the page context.

4) Publish your GTM container​

  • Click Submit → Publish to make the new tag live.

5) Add the GTM snippet (if not already)​

  • Add Google’s GTM code snippet to your website per Google’s guide.
    • Important: Place the GTM code snippet on every page you want to track. If a page does not include the snippet, no tags (including MoveoOne) will fire on that page.
    • Note: Implementation steps can vary by platform (e.g., Shopify, WordPress, nopCommerce, plain JS, static sites). Refer to Google’s docs for platform-specific installation guidance: Install Google Tag Manager.

Verify​

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

Troubleshooting​

  • Tag not firing: ensure the trigger is set to All Pages and the container 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:
    • Required: moveoToken
    • Optional: appVersion, locale, test (A/B/No Test)