From 07bea1e36e9b8f719a8ae4d502e2062cec48c4aa Mon Sep 17 00:00:00 2001 From: Garrett Date: Thu, 4 Nov 2021 15:58:03 -0400 Subject: [PATCH] Added support for site search tracking with GA4 (#3184) * Send search analytics events for GA4 * move docs into content tabs --- docs/setup/setting-up-site-analytics.md | 23 +++++++++++-------- .../integrations/analytics/google.html | 2 +- .../integrations/analytics/google.html | 8 +++++++ 3 files changed, 23 insertions(+), 10 deletions(-) diff --git a/docs/setup/setting-up-site-analytics.md b/docs/setup/setting-up-site-analytics.md index dda65c36c..95ad071d2 100644 --- a/docs/setup/setting-up-site-analytics.md +++ b/docs/setup/setting-up-site-analytics.md @@ -51,18 +51,23 @@ following lines to `mkdocs.yml`: understand how people use your documentation and what they expect to find. In order to enable site search tracking, the following steps are required: - 1. Go to your Google Analytics __admin settings__ - 2. Select the property for the respective tracking code - 3. Go to the __view settings__ tab - 4. Scroll down and enable __site search settings__ - 5. Set the __query parameter__ to `q` + === ":material-google-analytics: Google Analytics 4" - Note that currently, site search tracking is not supported with Google - Analytics 4 due to the more complicated manual setup. If you want to set up - site search tracking yourself, [this tutorial][tutorial] is a good start. + 1. Go to your Google Analytics __admin settings__ + 2. Select the property for the respective tracking code + 3. Select the __Data Streams__ tab and click the corresponding URL + 4. Click the gear icon within the __Enhanced measurement__ section + 5. Ensure that __Site search__ is enabled + + === ":material-google-analytics: Universal Analytics" + + 1. Go to your Google Analytics __admin settings__ + 2. Select the property for the respective tracking code + 3. Go to the __view settings__ tab + 4. Scroll down and enable __site search settings__ + 5. Set the __query parameter__ to `q` [site search]: setting-up-site-search.md - [tutorial]: https://www.analyticsmania.com/post/track-site-search-with-google-tag-manager-and-google-analytics/ ### Was this page helpful? diff --git a/material/partials/integrations/analytics/google.html b/material/partials/integrations/analytics/google.html index ed5e6bcfd..cebfd298e 100644 --- a/material/partials/integrations/analytics/google.html +++ b/material/partials/integrations/analytics/google.html @@ -8,7 +8,7 @@ {% set property = config.extra.analytics.property | d("", true) %} {% endif %} {% if property.startswith("G-") %} - + {% elif property.startswith("UA-") %} diff --git a/src/partials/integrations/analytics/google.html b/src/partials/integrations/analytics/google.html index 632558e4b..685d3c756 100644 --- a/src/partials/integrations/analytics/google.html +++ b/src/partials/integrations/analytics/google.html @@ -42,6 +42,14 @@ /* Register virtual event handlers */ document.addEventListener("DOMContentLoaded", function() { + if (document.forms.search) { + var query = document.forms.search.query + query.addEventListener("blur", function() { + if (this.value) { + gtag("event", "search", {search_term: this.value}) + } + }) + } /* Send page view on location change */ if (typeof location$ !== "undefined")