Collecting data with Trackers and Webhooks

  1. Home
  2. Docs
  3. Collecting data with Trackers and Webhooks
  4. Trackers – collecting data from your own applications
  5. JavaScript Trackers (Web and Node.js)
  6. JavaScript Tracker
  7. Google Tag Manager Custom Template
  8. Template for JavaScript Tracker v3
  9. Settings Guide

Settings Guide

The Snowplow Analytics Settings custom variable template is meant to be used with the Snowplow Analytics tag template.

With this template, you can compile a tracker configuration object, which you can then load into your Snowplow Analytics tags to avoid the need to manually enter the same tracker settings across all your tags.

Install the template

To install the template, browse to Templates in the Google Tag Manager user interface.

Under Variable Templates, click Search Gallery, and type snowplow analytics v3 into the gallery overlay search bar.

Click the Snowplow Analytics v3 Settings template name, and then click Add to Workspace in the next screen. Review the permissions and click Add to finalize the import.

After importing the template, you can follow the normal process of creating a new variable in Google Tag Manager, and the Snowplow Analytics Settings template will be listed among the Custom variable types you can choose from.

Instructions

The fields in the template provide a UI for setting the tracker configuration parameters. You are thus encouraged to follow this link to understand what each individual field does.

Tracker Name

It is important to set the tracker name. The reason you might have more than one tracker name generated on the site is if you have different configuration objects or tracking endpoints to which you want to send commands.

When the tag runs, it first checks if a tag with this name has already been initialized. If it has, it then proceeds to send the command to this tracker name. If a tracker with this name has not been initialized, a new tracker is initialized with the tracker configuration from this settings variable.

This means that a tracker configuration is applied only once to the tracker. Thus if you have more than one tag running on the site, each with the same tracker name but different tracker configurations, only the configuration of the tag that fires first will be applied to the tracker.

Collector Endpoint Hostname

This needs to be set to the hostname (e.g. www.domain.com) on which you’ve configured the Snowplow Analytics collector.

Acknowledgements

Thanks to Simo Ahava for building the intial release of this template.

If you’d like to learn more about Snowplow BDP you can book a demo with our team, or if you’d prefer, you can try Snowplow technology for yourself quickly and easily.