Google Tag Manager

Use Google Tag Manager (GTM) if you already manage your website's tracking tags through GTM. Riddle sends all events directly to your dataLayer, so you can route them to any analytics provider configured in GTM — no extra pixel installation needed.

GTM tracking requires a Business or Enterprise Riddle plan.

  1. Set up and install Google Tag Manager.
  2. Go to the Publish section.
  3. Go to Tracking.
  4. Click on Google Tag Manager to enable tracking.
    enable gtm
  5. As long as you embed the Riddle on a page where you run your standard Google Tag Manager Tag, all standard Riddle events will be sent to the GTM tag.
  6. If you have customized your tracking code and are not using dataLayer as your object variable, you can enable the Custom Google Tag Manager configuration and change the default from "dataLayer" to whatever you are using. Please make sure to only change this value if you know what you are doing.
    custom gtm config
  7. If you only want to track certain events, open Custom event configuration and uncheck events that you do not want to track. The default setting is that all Riddle events are sent to GTM. See JS Events for a complete list of events and their payloads.
    gtm custom event config
  8. Create handling inside GTM to react to the events sent to Tag Manager by Riddle.
    This is the default event we send to Google Tag Manager:
window.dataLayer

dataLayer.push({    
eventCategory: riddleEvent.category,    
eventAction: riddleEvent.action,    
eventName: riddleEvent.name
});