Skip to content

Commit b06f278

Browse files
Update google-tag-manager.md
1 parent c912c6a commit b06f278

File tree

1 file changed

+18
-14
lines changed

1 file changed

+18
-14
lines changed

docs/google-tag-manager.md

Lines changed: 18 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,40 +5,44 @@ This document walks through how you can set up Plausible Analytics using Google
55

66
## Google Tag Manager Template
77

8-
In order to make the process easier, we have published a template that makes setting up Plausible Analytics with Google Tag Manager simple and code free. (You can find the source code for the Google Tag Manager template used [here](https://github.com/plausible/plausible-gtm-template))
8+
In order to make the process easier, we have published a template that makes setting up Plausible Analytics with Google Tag Manager simple and code free.
99

10-
The simplest way to install the custom template is to locate it in the [Google Tag Manager template gallery](https://tagmanager.google.com/gallery/#/) where you can install it directly from your Google Tag Manager dashboard.
10+
The simplest way to install the custom template is to locate it in the [Google Tag Manager template gallery](https://tagmanager.google.com/gallery/#/) where you can install it directly from your Google Tag Manager dashboard. Here's the direct link to the [Plausible Analytics GTM template](https://tagmanager.google.com/gallery/#/owners/plausible/templates/plausible-gtm-template).
1111

1212
Once you’ve installed the template, you should create a new Tag that uses it. To do this:
13-
* In the main Google Tag Manager dashboard, browse to Tags and click New to create a new tag
13+
14+
* In the main Google Tag Manager dashboard, browse to "**Tags**" and click "**New**" to create a new tag
1415
* From the list of available tag templates, choose the Plausible Analytics tag template you just installed
15-
* The only mandatory field in the tag configuration is the Script ID that can be found in the Plausible Analytics dashboard under Site Settings > Site Installation > Google Tag Manager (other optional configuration options are described below in the section Tag Configuration)
16-
* For the tag trigger, you should select All Pages - Page View, which will ensure that Plausible will capture data on all pages
16+
* The only mandatory field in the tag configuration is the "**Script ID**" that can be found in the Plausible Analytics dashboard under "**Site Settings**" > "**Site Installation**" > "**Google Tag Manager**"
17+
* Other optional configuration options are described below in the section "**Tag Configuration**"
18+
* For the tag trigger, you should select "**All Pages**" - "**Page View**", which will ensure that Plausible will capture data on all pages
1719

1820
## Tag Configuration
1921

2022
The tag has the following optional configuration options:
2123

2224
| **Optional Configuration** | **Explanation** |
2325
|---------------------------|-----------------|
24-
| **File Downloads** | Automatically [track file downloads](/docs/file-downloads-tracking) (enabled by default) |
25-
| **Form Submissions** | Whether to [track form submissions](/docs/form-submissions-tracking.md) (enabled by default) |
26-
| **Outbound Links** | Automatically [track clicks on outbound links](/docs/outbound-link-click-tracking) (enabled by default) |
27-
| **Hash Based Routing** | Automatically track page paths that use a `#` in the URL, [described here](/docs/hash-based-routing) (disabled by default) |
28-
| **Custom Properties** | Allows you to attach [custom properties](/docs/custom-props/introduction) (also known as custom dimensions in Google Analytics) when sending a pageview event. These can be configured using Google Tag Manager variables. |
26+
| **File Downloads** | Automatically [track file downloads](/docs/file-downloads-tracking) |
27+
| **Form Submissions** | Whether to [track form submissions](/docs/form-submissions-tracking.md) |
28+
| **Outbound Links** | Automatically [track clicks on outbound links](/docs/outbound-link-click-tracking) |
29+
| **Hash Based Routing** | Automatically track page paths that use a `#` in the URL, [described here](/docs/hash-based-routing) |
30+
| **Custom Properties** | Allows you to attach [custom properties](/docs/custom-props/introduction) (also known as custom dimensions in Google Analytics) when sending a pageview event. These can be configured using Google Tag Manager variables |
2931

3032
<details>
3133
<summary>Advanced configuration options</summary>
3234

3335
| **Optional Configuration** | **Explanation** |
3436
|---------------------------|-----------------|
35-
| **Auto Capture Pageviews** | Whether to automatically capture pageviews (enabled by default) |
36-
| **Capture on Localhost** | Whether to capture events on localhost (disabled by default) |
37-
| **Logging** | Whether to log to console on ignored events (enabled by default) |
37+
| **Auto Capture Pageviews** | Whether to automatically capture pageviews. If this is unchecked, the script will be loaded and ready to receive events but no pageviews will be sent. You would need to recreate pageview events by creating another tag with the trigger Page View or similar to send the event manually |
38+
| **Capture on Localhost** | Whether to capture events on localhost |
39+
| **Logging** | Whether to log to console on ignored events. When enabled, any ignored events are logged to the browser console with a warning |
3840

3941

4042
</details>
4143

4244
## Troubleshooting
4345

44-
You can test that everything is working as expected by using Google Tag Manager’s Preview mode. You can enter Preview mode by clicking the blue Preview button in the Google Tag Manager dashboard. This opens a new tab with your website running the GTM container where you can see if Plausible Analytics is running and capturing data properly. In the Tag Assistant Preview tab, you can see additional information about the events that trigger the tag and the data that is being sent.
46+
You can test that everything is working as expected by using Google Tag Manager’s Preview mode. You can enter Preview mode by clicking the blue Preview button in the Google Tag Manager dashboard. This opens a new tab with your website running the GTM container where you can see if Plausible Analytics is running and capturing data properly. In the Tag Assistant Preview tab, you can see additional information about the events that trigger the tag and the data that is being sent.
47+
48+
For more details on the Plausible Analytics Google Tag Manager template, please [see our guide](https://plausible.io/gtm-template).

0 commit comments

Comments
 (0)