vavolta
Sign In

Command Palette

Search for a command to run...

Google Tag Manager Setup

Connect Google Tag Manager to track Vavolta events in your analytics stack.

Overview

Google Tag Manager (GTM) integration lets you track Vavolta events in Google Analytics, Facebook Pixel, or any other tool connected to your GTM container.

GTM integration is available on Pro and Team plans.

Prerequisites

  • Pro or Team plan
  • A Google Tag Manager account
  • Your GTM Container ID (format: GTM-XXXXXXX)

Setting Up GTM

Step 1: Get Your Container ID

  1. Log into Google Tag Manager
  2. Open your container (or create one)
  3. Find your Container ID at the top (GTM-XXXXXXX)

Step 2: Add to Vavolta

  1. Go to Settings > Tracking in Vavolta
  2. Enter your GTM Container ID
  3. Click Save

Step 3: Configure Events

Toggle which events to send to GTM:

EventDescriptionDefault
leadmagnet_viewLead magnet openedOn
leadmagnet_page_changePage navigationOn
leadmagnet_downloadDownload clickedOn
leadmagnet_email_verifiedEmail verifiedOn
leadmagnet_durationSession time trackedOff
leadmagnet_email_requestedForm submissionOn

Step 4: Create GTM Tags

In Google Tag Manager, create tags to handle these events.

Events Reference

leadmagnet_view

Fired when someone opens a lead magnet.

javascript

leadmagnet_page_change

Fired when viewer navigates to a new page.

javascript

leadmagnet_download

Fired when download button is clicked.

javascript

leadmagnet_email_verified

Fired when email is verified (for Generic Links with email verification).

javascript

leadmagnet_email_requested

Fired when someone submits a Generic Link form.

javascript

Setting Up in GTM

Basic Google Analytics 4 Setup

  1. In GTM, go to Tags > New
  2. Tag type: Google Analytics: GA4 Event
  3. Configuration tag: Your GA4 configuration
  4. Event name: Use the variable {{Event}}
  5. Trigger: Create a custom trigger

Creating a Trigger

  1. Go to Triggers > New
  2. Trigger type: Custom Event
  3. Event name: leadmagnet_view (or use regex for all: leadmagnet_.*)
  4. Save

Passing Event Data

To pass additional data (like lead magnet name):

  1. Create a Data Layer Variable

    • Variable type: Data Layer Variable
    • Data Layer Variable Name: leadmagnet_name

  2. Add to your GA4 tag as an event parameter

Use Cases

Track in Google Analytics

See Vavolta events alongside your website analytics:

  • Compare traffic sources
  • Track conversion paths
  • Build audiences

Facebook Pixel

Track lead magnet views as Facebook events:

  • Build retargeting audiences
  • Optimize ad delivery
  • Track conversions

Custom Integrations

Send events anywhere GTM can reach:

  • CRM platforms
  • Marketing automation
  • Custom dashboards

Testing

GTM Preview Mode

  1. In GTM, click Preview
  2. Enter a Vavolta viewer URL
  3. Open a lead magnet
  4. See events in the preview panel

Debug in Browser

  1. Open browser developer tools
  2. Go to Console
  3. Look for dataLayer pushes

Best Practices

Event Naming

Keep events prefixed with leadmagnet_ for easy filtering.

Don't Over-Track

Only enable events you'll actually use. More events = more noise.

Test Before Publishing

Always use GTM's preview mode before publishing changes.

Troubleshooting

Events Not Firing

  • Verify Container ID is correct
  • Check event toggles are on
  • Ensure you're on Pro or Team plan
  • Test in GTM preview mode

Events in GTM But Not GA4

  • Check your GA4 tag configuration
  • Verify trigger is correct
  • Check GA4 DebugView

Container Not Loading

  • Verify Container ID format (GTM-XXXXXXX)
  • Check for typos
  • Ensure container is published

Next Steps