Google Tag Manager

​

Before you start

• Access to your Google Tag Manager account. The container must be installed on your site.
• Your tenant alias from the dashboard. It is the alias shown at the top of the dashboard, not the UUID.
• 10 minutes.

​

1. Create a tag

1. Log in to Google Tag Manager.
2. Select your container.
3. Click Tags, then New.
4. Click Tag Configuration.
5. Select Custom HTML.

​

2. Add the code

<script src="https://tag.grainql.com/v4/your-tenant-id.js"></script>

​

3. Set the trigger

1. Scroll to Triggering.
2. Click the trigger area.
3. Click + to create a new trigger.
4. Select Initialization - All Pages.
5. Name the trigger “All Pages - Initialization”.
6. Click Save.

​

4. Name and save the tag

1. Name the tag “Grain Analytics”.
2. Click Save.

​

5. Test the tag

1. Click Preview (top right).
2. Enter the URL of your website. Google Tag Manager opens your site with a debug panel.
3. Make sure that “Grain Analytics” is in Tags Fired.
4. Open the browser console (F12).
5. Type window.GrainTag. The console shows the GrainTag object.

​

6. Publish

1. Click Submit (top right).
2. Name the version, for example “Added Grain Analytics”.
3. Add a description. This step is optional.
4. Click Publish.

​

Track custom events

​

Button clicks

1. Create a new Custom HTML tag.
2. Add this code:

<script>
  GrainTag.track('button_clicked', {
    button_text: {{Click Text}},
    button_url: {{Click URL}}
  });
</script>

3. Set the trigger to All Elements - Click.
4. Add filters to select the buttons that you want to track.

​

Form submissions

1. Create a new Custom HTML tag.
2. Add this code:

<script>
  GrainTag.track('form_submitted', {
    form_name: {{Form ID}},
    form_url: window.location.pathname
  });
</script>

3. Set the trigger to Form Submission.

​

Link clicks

1. Create a new Custom HTML tag.
2. Add this code:

<script>
  GrainTag.track('link_clicked', {
    link_text: {{Click Text}},
    destination: {{Click URL}}
  });
</script>

3. Set the trigger to Just Links - All Elements.

​

Troubleshooting

​

Next steps