Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 10 additions & 14 deletions docs/carrd-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,13 +37,15 @@ We display your snippet during the process of adding a new site to your account.

* Then paste your Plausible tracking script in the **Code** field

* In the snippet, update `plausible.init()` to `plausible.init({ hashBasedRouting: true })`. This allows plausible to track hashed page paths that Carrd uses during navigation.
* In your copied snippet, set `hashBasedRouting` to `true` in the `plausible.init()` call. Keep the rest of your snippet, including its site-specific script URL, unchanged:

* Do click on the **Done** button and then **Publish** your changes. After you change the tracking snippet on your site, all the hash-based page paths on your Carrd website will start being tracked and will be displayed in the **Top Pages** tab of your Plausible Analytics dashboard.
```js
plausible.init({ hashBasedRouting: true });
```

<div class="browser">
<img alt="Add Plausible Analytics script to Carrd" src={useBaseUrl('img/add-plausible-script-to-carrd.png')} />
</div>
If your `plausible.init()` call already contains other options, keep them and add `hashBasedRouting: true`. This allows Plausible to track hashed page paths that Carrd uses during navigation.

* Do click on the **Done** button and then **Publish** your changes. After you change the tracking snippet on your site, all the hash-based page paths on your Carrd website will start being tracked and will be displayed in the **Top Pages** tab of your Plausible Analytics dashboard.

Now you can go to your Carrd website and verify that Plausible script has been added and to your Plausible account to see whether the stats are being tracked. See here [how to verify the integration](troubleshoot-integration.md).

Expand Down Expand Up @@ -71,6 +73,8 @@ To be sure of your element's ID, you can use your browser's dev tool to inspect

### 2. Trigger custom events with JavaScript on your site

Keep your [current Plausible tracking snippet](plausible-script.md) installed. Add the code below alongside it; it does not replace your tracking snippet.

Here's the code you will need to insert in the `<head>` section of the page where the element ID that you want to track is located. You can use the **Custom Code** feature to do this similarly to how you've inserted the Plausible snippet into your site.

Make sure to change the `elementId` line in the code below to include the ID attribute of the element you want to track (`buttons01` in our example).
Expand All @@ -97,11 +101,7 @@ Also do change the `classes` line to include the goal name in this format: `plau
</script>
```

<div class="browser">
<img alt="Modify Plausible script Carrd" src={useBaseUrl('img/modify-plausible-script-carrd.png')} />
</div>

Do click on the **Save Changes** button and then **Publish** your changes.
Click **Done**, then **Publish** your changes.

### 3. Create a custom event goal in your Plausible account

Expand Down Expand Up @@ -147,10 +147,6 @@ If you want to trigger multiple custom events on the same site, you don't need t
</script>
```

<div class="browser">
<img alt="track multiple elements in Carrd" src={useBaseUrl('img/track-multiple-elements-carrd.png')} />
</div>

## What's next?

- [Create goals](custom-event-goals.md) in your Plausible site settings to match the custom events you set up. They won't appear in your dashboard until you do
Expand Down
10 changes: 3 additions & 7 deletions docs/ghost-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,9 @@ In Ghost you can inject code across your entire site or on an individual post or
linkText="Start free trial"
/>

* In the **Menu**, click **Settings**, and then **Code Injection**.
* In Ghost Admin, open **Settings → Advanced → Code Injection**. You can also follow [Ghost's current code injection guide](https://ghost.org/help/code-injection-styles/).

<div class="browser">
<img alt="Ghost code injection" src={useBaseUrl('img/ghost-code-injection.png')} />
</div>

* Add your Plausible Analytics script to the **Site Header** text box. Code added into the **Site Header** field is injected into the `<head>` tag on every page of your site.
* Paste your [Plausible tracking snippet](plausible-script.md) to the **Site Header** text box. Code added into the **Site Header** field is injected into the `<head>` tag on every page of your site.

* After adding your code, click on the **Save** button.

Expand All @@ -38,7 +34,7 @@ The Sign In/Sign up flows are part of Ghost's [Portal](https://ghost.org/help/se

However, you can bypass this and customize your sign up flows by using a custom theme on the "[Creator plan](https://ghost.org/pricing/)" or higher. 

If you're using a custom theme, you can simply add the tagged events extension to your script and CSS class to the element that you want to track as explained in [this doc](https://plausible.io/docs/custom-event-goals).
If you're using a custom theme, you can keep your Plausible tracking snippet installed and add the event CSS class to the element that you want to track as explained in [this doc](https://plausible.io/docs/custom-event-goals).

## What's next?

Expand Down
6 changes: 1 addition & 5 deletions docs/google-search-console-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,11 +115,7 @@ Google samples its keyword data heavily. The sampling is why your keyword visito

## Plausible Analytics will be listed in your Google account settings

You can check if Plausible Analytics is integrated with and has the right permissions to your Search Console properties in your Google account within the section **Apps with access to your account**. Here's the [direct link to that section](https://myaccount.google.com/permissions). Here's how it looks.

<div class="browser">
<img alt="Third-party apps with account access" src={useBaseUrl('img/v2/third-party-apps.webp')} />
</div>
Open your Google Account's [connections page](https://myaccount.google.com/connections) and select **Plausible Analytics**. Under the section describing Plausible's access to your Google Account, open **See details** to review its Search Console permissions. Google's [linked-apps guide](https://support.google.com/accounts/answer/13533235) explains how to review or remove access.

## Remove the Google Search Console integration

Expand Down
8 changes: 2 additions & 6 deletions docs/shopify-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -286,6 +286,8 @@ Your form or button element should have an ID attribute assigned by default. You

### 2. Trigger custom events with JavaScript on your site

Keep your [current Plausible tracking snippet](plausible-script.md) installed. Add the code below alongside it; it does not replace your tracking snippet.

Here's the code you will need to insert in the `<head>` section of the page where the element ID that you want to track is located. You can do this the same way as you've inserted the Plausible snippet into your site.

Make sure to change the `elementId` line in the code below to include the ID attribute of the element you want to track (`ContactForm` in our example).
Expand Down Expand Up @@ -316,9 +318,6 @@ To represent a space character in goal names, you can use a `+` sign. For exampl
</script>
```

<div class="browser">
<img alt="Modify Plausible script" src={useBaseUrl('img/modify-plausible-script-shopify.png')} />
</div>

Do click on the **Save** button to save your changes.

Expand Down Expand Up @@ -366,9 +365,6 @@ If you want to trigger multiple custom events on the same site, you don't need t
</script>
```

<div class="browser">
<img alt="track multiple elements in Shopify" src={useBaseUrl('img/track-multiple-elements-shopify.png')} />
</div>
</details>

## What's next?
Expand Down
14 changes: 4 additions & 10 deletions docs/squarespace-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@ Here's how to add Plausible Analytics to your Squarespace site

## How to add Plausible to your Squarespace website

* On your site's settings page, click on **Advanced** and then click on **Code Injection**
* Open the **Code Injection** panel for your site. See [Squarespace's code injection guide](https://support.squarespace.com/hc/en-us/articles/205815908-Customize-parts-of-your-site-with-code-injection) for the navigation for your site version.

* You can use the **[Custom Code](https://university.Squarespace.com/lesson/custom-code-in-the-head-and-body-tags)** feature in Squarespace to add Plausible tracking code to your website. Site-wide JavaScript code injection is a premium Squarespace feature so you need to upgrade your Squarespace account to a paid subscription plan.
* You can use the **[Custom Code](https://support.squarespace.com/hc/en-us/articles/205815908-Customize-parts-of-your-site-with-code-injection)** feature in Squarespace to add Plausible tracking code to your website. Site-wide JavaScript code injection is a premium Squarespace feature so you need to upgrade your Squarespace account to a paid subscription plan.

* [Paste your Plausible snippet](https://plausible.io/docs/plausible-script) in the **Header Code** section. We display your snippet during the process of adding a new site to your account. You can also see the snippet within the **Site Installation** area of the **General** section in your [site settings](website-settings.md).

Expand Down Expand Up @@ -54,15 +54,9 @@ The easiest way to track form submissions on your Squarespace site is to track t
<img alt="Edit the form in Squarespace" src={useBaseUrl('img/Edit-form-squarespace.png')} />
</div>

* In the "Content" section, click on "Post-submit". Make sure you select the "Redirect" option and in the "Redirect URL" field type in the path to the thank you page ( i.e. **/thank-you** ).
* In the **Content** tab, open **Edit Post-Submit**, choose **Redirect**, then click **Attach Link**. Select your thank-you page or enter its URL, then click **Save**. See [Squarespace's form block guide](https://support.squarespace.com/hc/en-us/articles/206566737-Form-blocks) for the current controls.

<div class="browser">
<img alt="Add redirect URL to your form in Squarespace" src={useBaseUrl('img/add-redirect-url-to-form-in-Squarespace.png')} />
</div>

<div class="browser">
<img alt="Add redirect URL to your form in Squarespace" src={useBaseUrl('img/redirect-url.png')} />
</div>
Test the redirect while logged out of Squarespace or in a private browser window. Post-submit redirects do not work while you are logged into your site.

### 3. Create a pageview goal in your Plausible account

Expand Down
39 changes: 6 additions & 33 deletions docs/webflow-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@ description: "Add Plausible Analytics to Webflow via Custom Code and track butto
---

import CtaBox from '@site/src/components/CtaBox';
import useBaseUrl from '@docusaurus/useBaseUrl';

Here's how to add Plausible Analytics to your Webflow site and set up the tracking of custom events such as button clicks and form submissions.

Expand All @@ -18,20 +17,12 @@ Here's how to add Plausible Analytics to your Webflow site and set up the tracki

## How to add Plausible to your Webflow website

* On your project's page, click on the Webflow logo (**W**) in the left-hand side menu and choose **Project Settings**.
* Open your site's **Site settings** from the Webflow Dashboard, then select **Custom code**.

<div class="browser">
<img alt="Add custom code to Webflow" src={useBaseUrl('img/add-custom-code-to-webflow.png')} />
</div>

* You can use the **[Custom Code](https://university.webflow.com/lesson/custom-code-in-the-head-and-body-tags)** feature in Webflow to add Plausible tracking code to your website. Site-wide JavaScript code injection is a premium Webflow feature so you need to upgrade your Webflow account to a paid subscription plan.
* You can use the **[Custom Code](https://help.webflow.com/hc/en-us/articles/33961357265299-Custom-code-in-head-and-body-tags)** feature in Webflow to add Plausible tracking code to your website. Your site or Workspace needs a plan that supports custom code; see Webflow's requirements in the linked guide.

* Choose **Custom Code** from the menu and [paste your Plausible snippet](https://plausible.io/docs/plausible-script) in the **Head Code** section. We display your snippet during the process of adding a new site to your account. You can also see the snippet within the **Site Installation** area of the **General** section in your [site settings](website-settings.md).

<div class="browser">
<img alt="Add Plausible Analytics script to Webflow" src={useBaseUrl('img/add-plausible-script-to-webflow.png')} />
</div>

* Do click on the **Save Changes** button and then **Publish** your changes.

Now you can go to your Webflow website and verify that Plausible script has been added and to your Plausible account to see whether the stats are being tracked. See here [how to verify the integration](troubleshoot-integration.md).
Expand All @@ -44,17 +35,9 @@ The easiest way to track form submissions on your Webflow site is to track the "

First you'll need to create a "thank you" page by clicking on the "Pages" panel and creating the page by clicking on the "Create New Page" button.

<div class="browser">
<img alt="Create the form submission thank you page in Webflow" src={useBaseUrl('img/create-a-thank-you-page-in-webflow.png')} />
</div>

### 2. Set the redirect URL on form submission

Go to the page that contains your form, select the form and click on the gear icon to access the form settings. In the "Redirect URL" field type in the path to the thank you page ( i.e. **/thank-you** )

<div class="browser">
<img alt="Add redirect URL to your form in Webflow" src={useBaseUrl('img/add-redirect-url-to-form-in-webflow.png')} />
</div>
Select your form and open its **Settings** panel. Set the post-submit redirect to your thank-you page, either by selecting the page or entering its path, such as `/thank-you`. Save and publish your changes. See [Webflow's form settings guide](https://help.webflow.com/hc/en-us/articles/33961347548563-How-do-I-add-forms-in-Webflow) for the current controls.

### 3. Create a pageview goal in your Plausible account

Expand All @@ -72,14 +55,12 @@ Your goal should now be set up. When you navigate back to your Plausible Analyti

### 1. Set an ID to the element you want to track

In Webflow, link and button elements don't have a default ID. You'll need to assign an ID by selecting the element and clicking on the settings gear. In the **Designer View**, you'll be able to set the ID.

<div class="browser">
<img alt="Add an ID to link and button elements in Webflow" src={useBaseUrl('img/add-id-to-link-and-button-webflow.png')} />
</div>
Select the link or button in Webflow and open its **Element settings**. Set its **ID** to a unique value, such as `button-click`. Use that same value in the code below.

### 2. Trigger custom events with JavaScript on your site

Keep your [current Plausible tracking snippet](plausible-script.md) installed. Add the code below alongside it; it does not replace your tracking snippet.

Here's the code you will need to insert in the `<head>` section of the page where the element ID that you want to track is located. You can use the **Custom Code** feature to do this similarly to how you've inserted the Plausible snippet into your site.

Make sure to change the `elementId` line in the code below to include the ID attribute of the element you want to track (`button-click` in our example).
Expand Down Expand Up @@ -108,10 +89,6 @@ To represent a space in a goal name, use a `+` sign. For example: `plausible-eve
</script>
```

<div class="browser">
<img alt="Modify Plausible script webflow" src={useBaseUrl('img/modify-plausible-script-webflow.png')} />
</div>

Do click on the **Save Changes** button and then **Publish** your changes.

### 3. Create a custom event goal in your Plausible account
Expand Down Expand Up @@ -158,10 +135,6 @@ If you want to trigger multiple custom events on the same site, you don't need t
</script>
```

<div class="browser">
<img alt="track multiple elements in Webflow" src={useBaseUrl('img/track-multiple-elements-webflow.png')} />
</div>

## Custom event not showing up?

### Did you publish your changes?
Expand Down
4 changes: 0 additions & 4 deletions docs/wordpress-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,10 +29,6 @@ Then install the plugin from your WordPress dashboard:
2. Click **Add Plugin** and search for "Plausible Analytics".
3. Open the official listing, then **Install** and **Activate**.

<div class="browser">
<img alt="Search and install the official Plausible Analytics WordPress plugin" src={useBaseUrl('img/search-for-plugin.png')} />
</div>

You can also install it from the [official plugin directory](https://wordpress.org/plugins/plausible-analytics/). After activation, the plugin walks you through a Get Started guide. Every option there is also available later in the plugin settings screen, described below.

<div class="browser">
Expand Down
Loading