diff --git a/_config.yml b/_config.yml index a032c41c56c3139b76175f49d32d96a4fbe50dcd..86706fb8d650817ba775a0911ac7fee2c0c285b2 100644 --- a/_config.yml +++ b/_config.yml @@ -147,7 +147,7 @@ callouts: color: red # Google Analytics Tracking (optional) -# e.g, UA-1234567-89 +# Supports a CSV of tracking ID strings (eg. "UA-1234567-89,G-1AB234CDE5") ga_tracking: UA-2709176-10 ga_tracking_anonymize_ip: true # Use GDPR compliant Google Analytics settings (true/nil by default) diff --git a/_includes/head.html b/_includes/head.html index 0added66a93bdb55d86f6db27b53719a7e56e5d3..f71e7ea5b1e2261e34f5c52b6f7e083b8ffe285d 100644 --- a/_includes/head.html +++ b/_includes/head.html @@ -5,15 +5,17 @@ <link rel="stylesheet" href="{{ '/assets/css/just-the-docs-default.css' | relative_url }}"> {% if site.ga_tracking != nil %} - <script async src="https://www.googletagmanager.com/gtag/js?id={{ site.ga_tracking }}"></script> + {% assign ga_tracking_ids = site.ga_tracking | split: "," %} + <script async src="https://www.googletagmanager.com/gtag/js?id={{ ga_tracking_ids.first }}"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); - gtag('config', '{{ site.ga_tracking }}'{% unless site.ga_tracking_anonymize_ip == nil %}, { 'anonymize_ip': true }{% endunless %}); + {% for ga_property in ga_tracking_ids %} + gtag('config', '{{ ga_property }}'{% unless site.ga_tracking_anonymize_ip == nil %}, { 'anonymize_ip': true }{% endunless %}); + {% endfor %} </script> - {% endif %} {% if site.search_enabled != false %} diff --git a/docs/configuration.md b/docs/configuration.md index 78f609ee404d3ea2128bb1a3797b796f1f85f5e1..c5c35ae5157eec9603992b9a996398b86d7196a4 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -210,11 +210,22 @@ See [Callouts]({{ site.baseurl }}{% link docs/ui-components/callouts.md %}) for ## Google Analytics +{: .warning } +> [Google Analytics 4 will replace Universal Analytics](https://support.google.com/analytics/answer/11583528). On **July 1, 2023**, standard Universal Analytics properties will stop processing new hits. The earlier you migrate, the more historical data and insights you will have in Google Analytics 4. + +Universal Analytics (UA) and Google Analytics 4 (GA4) properties are supported. + ```yaml # Google Analytics Tracking (optional) -# e.g, UA-1234567-89 -ga_tracking: UA-5555555-55 -ga_tracking_anonymize_ip: true # Use GDPR compliant Google Analytics settings (true by default) +# Supports a CSV of tracking ID strings (eg. "UA-1234567-89,G-1AB234CDE5") +ga_tracking: UA-2709176-10 +ga_tracking_anonymize_ip: true # Use GDPR compliant Google Analytics settings (true/nil by default) +``` + +This theme supports multiple comma-separated tracking IDs. This helps seamlessly transition UA properties to GA4 properties by tracking both for a while. + +```yaml +ga_tracking: "UA-1234567-89,G-1AB234CDE5" ``` ## Document collections