https://github.com/snowplow-archive/snowplow-gtm-custom-template-settings
GTM Custom Template Settings for the Snowplow JavaScript Tracker (v2)
https://github.com/snowplow-archive/snowplow-gtm-custom-template-settings
gtm gtm-custom-template snowplow snowplow-javascript-tracker template
Last synced: about 1 month ago
JSON representation
GTM Custom Template Settings for the Snowplow JavaScript Tracker (v2)
- Host: GitHub
- URL: https://github.com/snowplow-archive/snowplow-gtm-custom-template-settings
- Owner: snowplow-archive
- License: apache-2.0
- Archived: true
- Created: 2020-05-12T15:41:40.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-04-22T17:29:53.000Z (about 3 years ago)
- Last Synced: 2025-02-23T10:15:46.551Z (3 months ago)
- Topics: gtm, gtm-custom-template, snowplow, snowplow-javascript-tracker, template
- Language: Smarty
- Homepage:
- Size: 23.4 KB
- Stars: 0
- Watchers: 9
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
# GTM Custom Template for JavaScript Tracker Settings
## Overview
This is the Google Tag Manager [custom template](https://developers.google.com/tag-manager/templates) for the settings of the [Snowplow Analytics JavaScript tracker](https://github.com/snowplow/snowplow-javascript-tracker).
The **Snowplow Analytics Settings** variable template is a template interface for building and bundling tracker settings to be used in the Snowplow Analytics tag template.
It has been designed to be used with the [Snowplow Analytics custom tag template](https://github.com/snowplow/snowplow-gtm-custom-template).
## Quickstart
Work on the template should be done in Google Tag Manager's native **template editor**. This is to ensure the template has access to all the latest features of the template editor, and to make sure it passes GTM's own validation when exporting the changes.
To **import** the template into Google Tag Manager:
1. In a Google Tag Manager **web** container (any container will do), browse to **Templates** and click to create a new template.
2. From the template action menu, choose **Import**.
3. Locate the `template.tpl` file from this repo, and import it into the template editor.
Make the changes you wish. Make sure the unit tests pass (in the **Tests** tab of the editor). Update the tests if necessary.
Once you're done, follow these steps:
1. **Save** the template in the template editor.
2. From the action menu, choose **Export**.
3. Replace the `template.tpl` file in this repo with the exported file (make sure to keep `template.tpl` as its name)..
4. **Commit** the changes to the `template.tpl` file.
5. Copy the **commit hash**.
6. Edit `metadata.yaml` in the template folder, and add the hash with its `changeNotes` as the latest version.
7. Move the previous latest version into the list of `Older versions`.
8. Save changes to `metadata.yaml` and **commit** them.
9. Finally, push the changes to the repo (should include the commit to `template.tpl` and the commit to `metadata.yaml`).
After pushing the changes, Google Tag Manager should update the template in the [community gallery](https://tagmanager.google.com/gallery/#/) within some hours to some days.
## Find out more
| Variable Template |
|----------------------------------|
![il][techdocs-image]
| **[Technical Docs](https://www.simoahava.com/custom-templates/snowplow-analytics-settings/)** |
## Copyright and license
Significant portions copyright 2020 Simo Ahava. Remainder copyright 2020-2022 Snowplow Analytics Ltd. All rights reserved.
Licensed under the **[Apache License, Version 2.0][license]** (the "License");
you may not use this software except in compliance with the License.
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
[techdocs-image]: https://d3i6fms1cm1j0i.cloudfront.net/github/images/techdocs.png