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.
Method 1 — GTM Community Template (Recommended)
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
- Open Google Tag Manager and select your container
- Click Templates in the left sidebar
- In the Tag Templates section, click Search Gallery
- Search for Zenovay
- Click Zenovay Analytics → Add to workspace
Step 2 — Create the Tag
- Go to Tags → New
- Click Tag Configuration
- Under Custom (or search "Zenovay"), select Zenovay Analytics
Step 3 — Configure
Fill in the fields:
| Field | What to enter |
|---|---|
| Tracking Code | Your tracking code from Settings → General in your Zenovay dashboard |
| Cookieless Mode | Turn on for strict GDPR compliance (no consent banner needed) |
| Track Outbound Links | Optional — auto-tracks clicks to external sites |
| Custom API URL | Leave blank unless you use a first-party proxy |
| Debug Mode | Turn on while testing, off before publishing |
Step 4 — Set the Trigger
- Under Triggering, click the + icon
- Select All Pages
- Click Save
Step 5 — Publish
- Click Submit in the top right corner
- Enter a version name, e.g. "Add Zenovay Analytics"
- 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
- In GTM, go to Tags → New
- Click Tag Configuration → Custom HTML
- 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
- Set trigger to All Pages
- 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
- Variables → New → Data Layer Variable → name it
DLV - Zenovay Event Name, variable namezenovay_event_name - Repeat for
zenovay_event_data→DLV - Zenovay Event Data - Triggers → New → Custom Event → event name
zenovay_event→ save as Zenovay Custom Event - Tags → New → Custom HTML, paste:
<script>
if (window.zenovay) {
window.zenovay('track', '{{DLV - Zenovay Event Name}}', {{DLV - Zenovay Event Data}});
}
</script>
- 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 <head>. Use one method only to avoid duplicate page views.
Consent Mode
If you use a Consent Management Platform (CookieYes, OneTrust, Cookiebot):
- Edit your Zenovay Analytics tag → Advanced Settings → Consent Settings
- Set Require additional consent:
analytics_storage
Or enable Cookieless Mode in the template — then no consent is required at all.
Troubleshooting
| Symptom | Fix |
|---|---|
| Tag not firing | Open GTM Preview mode and check the tag fires on All Pages |
| No data in dashboard | Verify the Tracking Code matches your dashboard exactly |
| Script blocked by ad-blocker | Set up First-Party Proxy and use the Custom API URL field |
| Duplicate page views | Remove any direct <script> tag for Zenovay from your HTML |
Related Resources
Need help? Contact [email protected] or visit our Help Center.