update to GA4

Author: whimsicallyson

docs/mkdocs.yml

@@ -1,6 +1,14 @@
 site_name: 'Posit Connect: rsconnect-python'
 copyright: Posit Software, PBC. All Rights Reserved
 
+# We activate GA only when hosted on our public docs site
+# and not when installed.
+#
+# See overrides/partials/integrations/analytics.html
+google_analytics:
+  - 'GTM-KHBDBW7'
+  - 'auto'
+
 markdown_extensions:
   - toc:
       permalink: "#"

docs/overrides/partials/integrations/analytics.html

@@ -0,0 +1,41 @@
+{% set property = config.google_analytics %}
+<!-- Google Analytics 4 (G-XXXXXXXXXX) -->
+<script>
+    /* Use GA when hosted by our public docs site, not when installed. */
+    if (location.href.indexOf("docs.posit.co") >= 0) {
+        window.dataLayer = window.dataLayer || []
+        function gtag() { dataLayer.push(arguments) }
+        /* Set up integration and send page view */
+        gtag("js", new Date())
+        gtag("config", "{{ property[0] }}")
+
+        /* 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")
+                location$.subscribe(function (url) {
+                    gtag("config", "{{ property[0] }}", {
+                        page_path: url.pathname
+                    })
+                })
+        })
+        /* Create script tag */
+        var script = document.createElement("script")
+        script.async = true
+        script.src = "https://www.googletagmanager.com/gtag/js?id={{ property[0] }}"
+
+        /* Inject script tag */
+        var container = document.getElementsByTagName("head")[0]
+        var firstChild = container.firstChild
+        container.insertBefore(script, firstChild)
+    }
+</script>