Skip to main content
5 min read

Google Tag Manager

Deploy Zenovay Analytics through Google Tag Manager without touching your website's source code.

The easiest path: install the Zenovay Analytics template directly from the GTM Community Template Gallery — just enter your tracking code and publish.


The official Zenovay template is available in the GTM Community Template Gallery. This is the fastest and most reliable setup method.

Time required: ~2 minutes

Step 1 — Find the Template

  1. Open Google Tag Manager and select your container
  2. Click Templates in the left sidebar
  3. In the Tag Templates section, click Search Gallery
  4. Search for Zenovay
  5. Click Zenovay AnalyticsAdd to workspace

Step 2 — Create the Tag

  1. Go to TagsNew
  2. Click Tag Configuration
  3. Under Custom (or search "Zenovay"), select Zenovay Analytics

Step 3 — Configure

Fill in the fields:

FieldWhat to enter
Tracking CodeYour tracking code from Settings → General in your Zenovay dashboard
Cookieless ModeTurn on for strict GDPR compliance (no consent banner needed)
Track Outbound LinksOptional — auto-tracks clicks to external sites
Custom API URLLeave blank unless you use a first-party proxy
Debug ModeTurn on while testing, off before publishing

Step 4 — Set the Trigger

  1. Under Triggering, click the + icon
  2. Select All Pages
  3. Click Save

Step 5 — Publish

  1. Click Submit in the top right corner
  2. Enter a version name, e.g. "Add Zenovay Analytics"
  3. Click Publish

Your Zenovay tracking is now live.


Method 2 — Custom HTML Tag (Manual)

Use this if the Community Template is not yet available in your region's gallery.

Step 1 — Create a New Tag

  1. In GTM, go to TagsNew
  2. Click Tag ConfigurationCustom HTML
  3. Name the tag Zenovay Analytics

Step 2 — Paste the Script

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Replace YOUR_TRACKING_CODE with your tracking code from Settings → General in your Zenovay dashboard.

Step 3 — Set Trigger and Publish

  1. Set trigger to All Pages
  2. Save, submit, and publish

First-Party Proxy (Ad-Blocker Bypass)

Available on all plans. If you have set up a first-party proxy on your own domain, enter the proxy URL in the Custom API URL field (GTM template) or change src to your proxy URL (Custom HTML method):

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://analytics.yourdomain.com/z.js">
</script>

See the First-Party Tracking guide for setup instructions.


Custom Events via Data Layer

Send custom events to Zenovay by pushing to the GTM Data Layer.

Push an Event

dataLayer.push({
  event: 'zenovay_event',
  zenovay_event_name: 'signup',
  zenovay_event_data: {
    plan: 'pro',
    source: 'pricing_page'
  }
});

Wire Up the GTM Tag

  1. VariablesNewData Layer Variable → name it DLV - Zenovay Event Name, variable name zenovay_event_name
  2. Repeat for zenovay_event_dataDLV - Zenovay Event Data
  3. TriggersNewCustom Event → event name zenovay_event → save as Zenovay Custom Event
  4. TagsNewCustom HTML, paste:
<script>
  if (window.zenovay) {
    window.zenovay('track', '{{DLV - Zenovay Event Name}}', {{DLV - Zenovay Event Data}});
  }
</script>
  1. Set trigger to Zenovay Custom Event, save, and publish

SPA Support (React, Next.js, Vue, Angular)

The Zenovay script detects SPA route changes automatically. The All Pages trigger is all you need — no History Change trigger required.

Do not load the Zenovay script both in GTM and directly in your &lt;head&gt;. Use one method only to avoid duplicate page views.


If you use a Consent Management Platform (CookieYes, OneTrust, Cookiebot):

  1. Edit your Zenovay Analytics tag → Advanced SettingsConsent Settings
  2. Set Require additional consent: analytics_storage

Or enable Cookieless Mode in the template — then no consent is required at all.


Troubleshooting

SymptomFix
Tag not firingOpen GTM Preview mode and check the tag fires on All Pages
No data in dashboardVerify the Tracking Code matches your dashboard exactly
Script blocked by ad-blockerSet up First-Party Proxy and use the Custom API URL field
Duplicate page viewsRemove any direct <script> tag for Zenovay from your HTML


Need help? Contact [email protected] or visit our Help Center.

Was this page helpful?