Skip to content

Commit f24f857

Browse files
Merge pull request #834 from plausible/cms/articles/how-to-set-up-plausible-analytics-using-google-tag-manager
Automatically generated. Merged on Netlify CMS.
2 parents 67967f9 + dcfff8d commit f24f857

File tree

1 file changed

+14
-19
lines changed

1 file changed

+14
-19
lines changed

_articles/how-to-set-up-plausible-analytics-using-google-tag-manager.md

Lines changed: 14 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -9,37 +9,32 @@ This document walks through how you can set up Plausible Analytics using Google
99

1010
## Google Tag Manager Template
1111

12-
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))
12+
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.
1313

14-
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.
14+
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).
1515

16-
Alternatively, the template can be manually imported with the following steps:
17-
* Download the template.tpl file
18-
* Open a Google Tag Manager Web container inside Google Tag Manager
19-
* In Google Tag Manager browse to the Templates section and in the box titled Tag Templates click the blue New button.
20-
* Once the Template Editor is open, click the menu (three vertical dots) in the top-right corner of the window and choose Import.
21-
* Select the template.tpl file you downloaded previously
16+
Once you’ve installed the template, you should create a new "**Tag**" that uses it. To do this:
2217

23-
Once you’ve installed the template, either manually or through the template gallery, you should create a new Tag that uses it. To do this:
24-
* In the main Google Tag Manager dashboard, browse to Tags and click New to create a new tag
18+
* In the main Google Tag Manager dashboard, browse to "**Tags**" and click "**New**" to create a new tag
2519
* From the list of available tag templates, choose the Plausible Analytics tag template you just installed
26-
* 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)
27-
* For the tag trigger, you should select All Pages - Page View, which will ensure that Plausible will capture data on all pages
20+
* 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**"
21+
* Other optional configuration options are described below in the section "**Tag Configuration**"
22+
* For the tag trigger, you should select "**All Pages** - "**Page View**", which will ensure that Plausible will capture data on all pages
2823

2924
## Tag Configuration
3025

3126
The tag has the following optional configuration options:
3227

3328
| **Optional Configuration** | **Explanation** |
3429
|---------------------------|-----------------|
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-
| **File Downloads** | Automatically [track file downloads](https://plausible.io/docs/file-downloads-tracking) (enabled by default) |
38-
| **Form Submissions** | Whether to track form submissions (enabled by default) |
39-
| **Hash Based Routing** | Automatically track page paths that use a `#` in the URL, [described here](https://plausible.io/docs/hash-based-routing) (enabled by default) |
40-
| **Logging** | Whether to log on ignored events (enabled by default) |
41-
| **Outbound Links** | Automatically [track clicks on outbound links](https://plausible.io/docs/outbound-link-click-tracking) (enabled by default) |
30+
| **File Downloads** | Whether to automatically [track file downloads](https://plausible.io/docs/file-downloads-tracking) |
31+
| **Form Submissions** | Whether to automatically [track form submissions](https://plausible.io/docs/form-submissions-tracking) |
32+
| **Outbound Links** | Automatically [track clicks on outbound links](https://plausible.io/docs/outbound-link-click-tracking) |
33+
| **Hash Based Routing** | Automatically track page paths that use a `#` in the URL, [described here](https://plausible.io/docs/hash-based-routing) |
4234
| **Custom Properties** | Allows you to attach [custom properties](https://plausible.io/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. |
35+
| **Capture on Localhost** | Whether to capture events on localhost |
36+
| **Logging** | Whether to log on ignored events. When enabled, any ignored events are logged to the browser console with a warning |
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 |
4338

4439
## Testing
4540

0 commit comments

Comments
 (0)