diff --git a/docs/custom-domain.md b/docs/custom-domain.md index 7e07f04e..c2a3f6a2 100644 --- a/docs/custom-domain.md +++ b/docs/custom-domain.md @@ -5,5 +5,5 @@ title: Serve the script from your domain as a first-party connection import useBaseUrl from '@docusaurus/useBaseUrl'; :::note -Custom domains are deprecated. We now recommend the proxy instead of the custom domain. [Here are the proxy instructions](/proxy/introduction.md) +We now recommend the proxy instead of the custom domain. [Here are the proxy instructions](/proxy/introduction.md) ::: diff --git a/docs/proxy/guides/akamai.md b/docs/proxy/guides/akamai.md index af917fdd..b2a3754d 100644 --- a/docs/proxy/guides/akamai.md +++ b/docs/proxy/guides/akamai.md @@ -4,9 +4,11 @@ title: Proxying Plausible through Akamai import useBaseUrl from '@docusaurus/useBaseUrl'; -Proxying Plausible through your own property on Akamai is easy, fast and privacy-friendly. +Here's how to proxy Plausible through your own property on Akamai. The instructions assume you use the default paths ``/js/script.js`` and ``/api/event``. You can change these based on your preferences. -The instructions assume you use the default paths ``/js/script.js`` and ``/api/event``. You can change these based on your preferences. +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: ## Step 1: Proxy Analytics Script diff --git a/docs/proxy/guides/apache.md b/docs/proxy/guides/apache.md index 60f7dff7..64ac23f2 100644 --- a/docs/proxy/guides/apache.md +++ b/docs/proxy/guides/apache.md @@ -2,8 +2,11 @@ title: Proxying Plausible through Apache HTTP Server --- -If you're already running Apache HTTP Server as your main web server or reverse -proxy, you can also configure it to proxy your analytics. Start by adjusting your configuration as shown in the next step. +If you're already running Apache HTTP Server as your main web server or reverse proxy, you can also configure it to proxy your analytics. Start by adjusting your configuration as shown in the next step. + +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: ## Step 1: Enable the required modules diff --git a/docs/proxy/guides/caddy.md b/docs/proxy/guides/caddy.md index d74a65e6..f11574b9 100644 --- a/docs/proxy/guides/caddy.md +++ b/docs/proxy/guides/caddy.md @@ -2,9 +2,11 @@ title: Proxying Plausible through Caddy --- -If you're already running Caddy as your main web server or reverse -proxy, you can also configure it to proxy your analytics. Start by adjusting your -configuration as shown in the next step. +If you're already running Caddy as your main web server or reverse proxy, you can also configure it to proxy your analytics. Start by adjusting your configuration as shown in the next step. + +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: ## Step 1: Update your Caddyfile diff --git a/docs/proxy/guides/cloudflare.md b/docs/proxy/guides/cloudflare.md index 5fbd6e9a..3577a18c 100644 --- a/docs/proxy/guides/cloudflare.md +++ b/docs/proxy/guides/cloudflare.md @@ -5,9 +5,11 @@ title: Proxying Plausible through Cloudflare import useBaseUrl from '@docusaurus/useBaseUrl'; You can use Cloudflare Workers to proxy your Plausible Analytics requests. Cloudflare Workers offers free service for up to 100,000 requests per day. -All you need to set it up is a free Cloudflare account. +All you need to set it up is a free Cloudflare account. Here's the step-by-step process for creating a proxy. -Here's the step-by-step process for creating a proxy. It takes only a few minutes and requires no tech know-how or prior experience. +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: Step 0: Sign up for a free Cloudflare account if you don't have an account already and add your site. diff --git a/docs/proxy/guides/cloudfront.md b/docs/proxy/guides/cloudfront.md index 7b2bc86e..ee736001 100644 --- a/docs/proxy/guides/cloudfront.md +++ b/docs/proxy/guides/cloudfront.md @@ -6,6 +6,10 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; You can use CloudFront to proxy your Plausible Analytics requests. Here's the step-by-step process for creating a proxy. +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: + Step 0: Sign up for a free AWS account if you don't have an account already and create a CloudFront distribution. ## Step 1: Create new origin diff --git a/docs/proxy/guides/deno.md b/docs/proxy/guides/deno.md index 94b0fdc5..556ce5e6 100644 --- a/docs/proxy/guides/deno.md +++ b/docs/proxy/guides/deno.md @@ -2,6 +2,10 @@ title: Proxying Plausible through Deno Deploy --- +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: + ## Step 1: Deploy proxy code Start by getting a [Deno Deploy](https://deno.com/deploy) account if you don't have one already. diff --git a/docs/proxy/guides/fastly.md b/docs/proxy/guides/fastly.md index 75bf648f..2b92b248 100644 --- a/docs/proxy/guides/fastly.md +++ b/docs/proxy/guides/fastly.md @@ -6,6 +6,10 @@ import useBaseUrl from '@docusaurus/useBaseUrl'; You can use Fastly to proxy your Plausible Analytics requests. Here's the step-by-step process for creating a proxy. +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: + ## Step 1: Create the Backend for Plausible First, set up a Plausible backend: diff --git a/docs/proxy/guides/fresh.md b/docs/proxy/guides/fresh.md index ab7533fa..aa298a7c 100644 --- a/docs/proxy/guides/fresh.md +++ b/docs/proxy/guides/fresh.md @@ -2,6 +2,10 @@ title: Proxying Plausible through Fresh --- +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: + ## Step 1: Add the script proxy Create a file `routes/js/script.js.ts` in your project. diff --git a/docs/proxy/guides/netlify.md b/docs/proxy/guides/netlify.md index 2212fd48..9d8e690f 100644 --- a/docs/proxy/guides/netlify.md +++ b/docs/proxy/guides/netlify.md @@ -2,6 +2,10 @@ title: Proxying Plausible through Netlify --- +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: + ## Step 1: Add URL rewrite rules If you don't already have a `_redirects` file at the publishing directory of your site, create one. You can learn more about Netlify redirects and rewrites [here](https://docs.netlify.com/routing/redirects/). Here's the setup for proxying Plausible Analytics: diff --git a/docs/proxy/guides/nextjs.md b/docs/proxy/guides/nextjs.md index ec04c36b..6c0ff0b1 100644 --- a/docs/proxy/guides/nextjs.md +++ b/docs/proxy/guides/nextjs.md @@ -4,6 +4,10 @@ title: Proxying Plausible through Vercel with Next.js There are two ways you can proxy Plausible through Next.js / Vercel. One is using the next-plausible npm package and the other is using the raw Next.js config. Here are the instructions: +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: + ## Using next-plausible [next-plausible](https://github.com/4lejandrito/next-plausible) is an npm package that makes it easier to include Plausible Analytics in your Next.js site. diff --git a/docs/proxy/guides/nginx.md b/docs/proxy/guides/nginx.md index 70ab7ff3..e778a776 100644 --- a/docs/proxy/guides/nginx.md +++ b/docs/proxy/guides/nginx.md @@ -2,8 +2,11 @@ title: Proxying Plausible through Nginx --- -If you're already running Nginx as your main web server or reverse -proxy, you can also configure it to proxy your analytics. Start by adjusting your configuration as shown in the next step. +If you're already running Nginx as your main web server or reverse proxy, you can also configure it to proxy your analytics. Start by adjusting your configuration as shown in the next step. + +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: ## Step 1: Update your Nginx config diff --git a/docs/proxy/guides/vercel.md b/docs/proxy/guides/vercel.md index 0922932d..a81baf63 100644 --- a/docs/proxy/guides/vercel.md +++ b/docs/proxy/guides/vercel.md @@ -2,6 +2,10 @@ title: Proxying Plausible through Vercel --- +:::tip Don't want to manage your own proxy? We can handle it for you +Our managed proxy lets you send analytics through your own domain name as a first-party connection. All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. [Contact us for details](https://plausible.io/contact). +::: + If you are hosting a **Next.js** application, see [Proxying Plausible through Next.js / Vercel](/proxy/guides/nextjs.md). ## Step 1: Add configuration file diff --git a/docs/proxy/introduction.md b/docs/proxy/introduction.md index 91526f79..4c1bc993 100644 --- a/docs/proxy/introduction.md +++ b/docs/proxy/introduction.md @@ -38,9 +38,7 @@ This is the simplest way to install Plausible Analytics but it will also be bloc ### Are you concerned about missing data? -Proxy our script. This is the option for those who want to get more accurate stats. With our step-by-step instructions, the setup is straightforward even for those who don't have any coding experience. - -A proxy basically maps certain URLs from your domain to the Plausible domain: +Proxy our script. This is the option for those who want to get more accurate stats. A proxy basically maps certain URLs from your domain to the Plausible domain: ``` https:///js/script.js -> https://plausible.io/js/script.js @@ -49,18 +47,33 @@ https:///api/event -> https://plausible.io/api/event When the browser requests a file at `https://yourdomain.com/js/script.js` it will actually be fetched from `https://plausible.io/js/script.js`. The analytics will work exactly the same but the script will be served without being flagged. -We used to have a CNAME/DNS custom domain approach in the past, but it's no longer effective, so we now recommend a proxy as it's a much more flexible and powerful solution. +## How to proxy requests to Plausible + +You can proxy requests to Plausible in several ways depending on your setup. If you'd rather not handle it yourself, we also offer a managed proxy option. + +### Managed proxy + +Don't want to manage your own proxy? We can handle it for you. Our managed proxy lets you send analytics through your own domain name as a first-party connection. This helps bypass adblockers and count more traffic without any setup or maintenance on your end. + +All you need to do is set up a CNAME record using the instructions we'll send you and update the snippet on your site. We'll take care of everything else. + +Managed proxy is available on our Enterprise plans. [Contact us for details](https://plausible.io/contact). + +### Standalone proxy -There are many ways you can proxy requests to Plausible depending on your hosting situation. We've divided our guides to *standalone* and *integrated* proxies. A standalone proxy can be set up on its own and it does not matter what hosting provider or tech stack you are using. Integrated proxy setups are dependent on how you've deployed your app. +A standalone proxy works with any tech stack or hosting provider. You're responsible for setting it up and keeping it running. You can use one of these options: -Standalone proxy setups: * [Akamai](/docs/proxy/guides/akamai) * [Cloudflare Workers](/docs/proxy/guides/cloudflare) * [Fastly](/docs/proxy/guides/fastly) * [CloudFront](/docs/proxy/guides/cloudfront) * [Google Cloud Platform](https://github.com/mtlynch/plausible-proxy) +* [How to send events directly to our API](/docs/events-api) + +### Integrated proxy + +These setups depend on how your app is deployed. You'll need to handle the proxy setup and maintenance yourself. Here are the available options: -Integrated proxy setups: * [WordPress](/docs/proxy/guides/wordpress) * [Netlify](/docs/proxy/guides/netlify) * [Vercel](/docs/proxy/guides/vercel) @@ -70,9 +83,3 @@ Integrated proxy setups: * [Apache](/docs/proxy/guides/apache) * [Caddy](/docs/proxy/guides/caddy) * [Django](https://github.com/imankulov/django-plausible-proxy) - -Events API as a server side alternative: -* [How to send events directly to our API](/docs/events-api) - -NPM package as another alternative: -* [NPM standalone package](https://github.com/plausible/plausible-tracker).