|
| 1 | +<!DOCTYPE html> |
| 2 | +<html lang="en" class="govuk-template "> |
| 3 | + |
| 4 | +<head> |
| 5 | + <meta charset="utf-8"> |
| 6 | + <title>Development approach | GOV.UK GA4 Implementation record</title> |
| 7 | + <link rel="stylesheet" type="text/css" href="/stylesheets/screen.css"/> |
| 8 | + <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover"> |
| 9 | + <meta name="theme-color" content="#0b0c0c"> |
| 10 | + |
| 11 | + <meta http-equiv="X-UA-Compatible" content="IE=edge"> |
| 12 | + |
| 13 | + <meta name="twitter:card" content="summary" /> |
| 14 | + <meta name="twitter:domain" content="docs.publishing.service.gov.uk" /> |
| 15 | + <meta name="twitter:image" content="https://docs.publishing.service.gov.uk/assets/govuk/assets/images/govuk-opengraph-image.png" /> |
| 16 | + <meta name="twitter:title" content="GOV.UK Developer Documentation" /> |
| 17 | + <meta name="twitter:url" content="https://docs.publishing.service.gov.uk/analytics/approach.html" /> |
| 18 | + |
| 19 | + <meta property="og:image" content="https://docs.publishing.service.gov.uk/assets/govuk/assets/images/govuk-opengraph-image.png" /> |
| 20 | + <meta property="og:site_name" content="GOV.UK Developer Documentation" /> |
| 21 | + <meta property="og:type" content="object" /> |
| 22 | + <meta property="og:url" content="https://docs.publishing.service.gov.uk/analytics/approach.html" /> |
| 23 | + <meta name="description" content="Our development approach for implementing GA4 on GOV.UK Publishing."> |
| 24 | +</head> |
| 25 | + |
| 26 | +<body class="govuk-template__body "> |
| 27 | + <script> |
| 28 | + document.body.className = ((document.body.className) ? document.body.className + ' js-enabled' : 'js-enabled'); |
| 29 | + </script> |
| 30 | + |
| 31 | + <a href="#main-content" class="govuk-skip-link" data-module="govuk-skip-link">Skip to main content</a> |
| 32 | + |
| 33 | + <header class="govuk-header " role="banner" data-module="govuk-header"> |
| 34 | + <div class="govuk-header__container"> |
| 35 | + <div class="govuk-width-container"> |
| 36 | + <div class="govuk-header__logo"> |
| 37 | + <a href="/analytics/" class="govuk-header__link govuk-header__link--homepage"> |
| 38 | + <svg |
| 39 | + focusable="false" |
| 40 | + role="img" |
| 41 | + class="govuk-header__logotype" |
| 42 | + xmlns="http://www.w3.org/2000/svg" |
| 43 | + viewBox="0 0 148 30" |
| 44 | + height="30" |
| 45 | + width="148" |
| 46 | + aria-label="GOV.UK" |
| 47 | + > |
| 48 | + <title>GOV.UK</title> |
| 49 | + <path d="M22.6 10.4c-1 .4-2-.1-2.4-1-.4-.9.1-2 1-2.4.9-.4 2 .1 2.4 1s-.1 2-1 2.4m-5.9 6.7c-.9.4-2-.1-2.4-1-.4-.9.1-2 1-2.4.9-.4 2 .1 2.4 1s-.1 2-1 2.4m10.8-3.7c-1 .4-2-.1-2.4-1-.4-.9.1-2 1-2.4.9-.4 2 .1 2.4 1s0 2-1 2.4m3.3 4.8c-1 .4-2-.1-2.4-1-.4-.9.1-2 1-2.4.9-.4 2 .1 2.4 1s-.1 2-1 2.4M17 4.7l2.3 1.2V2.5l-2.3.7-.2-.2.9-3h-3.4l.9 3-.2.2c-.1.1-2.3-.7-2.3-.7v3.4L15 4.7c.1.1.1.2.2.2l-1.3 4c-.1.2-.1.4-.1.6 0 1.1.8 2 1.9 2.2h.7c1-.2 1.9-1.1 1.9-2.1 0-.2 0-.4-.1-.6l-1.3-4c-.1-.2 0-.2.1-.3m-7.6 5.7c.9.4 2-.1 2.4-1 .4-.9-.1-2-1-2.4-.9-.4-2 .1-2.4 1s0 2 1 2.4m-5 3c.9.4 2-.1 2.4-1 .4-.9-.1-2-1-2.4-.9-.4-2 .1-2.4 1s.1 2 1 2.4m-3.2 4.8c.9.4 2-.1 2.4-1 .4-.9-.1-2-1-2.4-.9-.4-2 .1-2.4 1s0 2 1 2.4m14.8 11c4.4 0 8.6.3 12.3.8 1.1-4.5 2.4-7 3.7-8.8l-2.5-.9c.2 1.3.3 1.9 0 2.7-.4-.4-.8-1.1-1.1-2.3l-1.2 4c.7-.5 1.3-.8 2-.9-1.1 2.5-2.6 3.1-3.5 3-1.1-.2-1.7-1.2-1.5-2.1.3-1.2 1.5-1.5 2.1-.1 1.1-2.3-.8-3-2-2.3 1.9-1.9 2.1-3.5.6-5.6-2.1 1.6-2.1 3.2-1.2 5.5-1.2-1.4-3.2-.6-2.5 1.6.9-1.4 2.1-.5 1.9.8-.2 1.1-1.7 2.1-3.5 1.9-2.7-.2-2.9-2.1-2.9-3.6.7-.1 1.9.5 2.9 1.9l.4-4.3c-1.1 1.1-2.1 1.4-3.2 1.4.4-1.2 2.1-3 2.1-3h-5.4s1.7 1.9 2.1 3c-1.1 0-2.1-.2-3.2-1.4l.4 4.3c1-1.4 2.2-2 2.9-1.9-.1 1.5-.2 3.4-2.9 3.6-1.9.2-3.4-.8-3.5-1.9-.2-1.3 1-2.2 1.9-.8.7-2.3-1.2-3-2.5-1.6.9-2.2.9-3.9-1.2-5.5-1.5 2-1.3 3.7.6 5.6-1.2-.7-3.1 0-2 2.3.6-1.4 1.8-1.1 2.1.1.2.9-.3 1.9-1.5 2.1-.9.2-2.4-.5-3.5-3 .6 0 1.2.3 2 .9l-1.2-4c-.3 1.1-.7 1.9-1.1 2.3-.3-.8-.2-1.4 0-2.7l-2.9.9C1.3 23 2.6 25.5 3.7 30c3.7-.5 7.9-.8 12.3-.8m28.3-11.6c0 .9.1 1.7.3 2.5.2.8.6 1.5 1 2.2.5.6 1 1.1 1.7 1.5.7.4 1.5.6 2.5.6.9 0 1.7-.1 2.3-.4s1.1-.7 1.5-1.1c.4-.4.6-.9.8-1.5.1-.5.2-1 .2-1.5v-.2h-5.3v-3.2h9.4V28H55v-2.5c-.3.4-.6.8-1 1.1-.4.3-.8.6-1.3.9-.5.2-1 .4-1.6.6s-1.2.2-1.8.2c-1.5 0-2.9-.3-4-.8-1.2-.6-2.2-1.3-3-2.3-.8-1-1.4-2.1-1.8-3.4-.3-1.4-.5-2.8-.5-4.3s.2-2.9.7-4.2c.5-1.3 1.1-2.4 2-3.4.9-1 1.9-1.7 3.1-2.3 1.2-.6 2.6-.8 4.1-.8 1 0 1.9.1 2.8.3.9.2 1.7.6 2.4 1s1.4.9 1.9 1.5c.6.6 1 1.3 1.4 2l-3.7 2.1c-.2-.4-.5-.9-.8-1.2-.3-.4-.6-.7-1-1-.4-.3-.8-.5-1.3-.7-.5-.2-1.1-.2-1.7-.2-1 0-1.8.2-2.5.6-.7.4-1.3.9-1.7 1.5-.5.6-.8 1.4-1 2.2-.3.8-.4 1.9-.4 2.7zM71.5 6.8c1.5 0 2.9.3 4.2.8 1.2.6 2.3 1.3 3.1 2.3.9 1 1.5 2.1 2 3.4s.7 2.7.7 4.2-.2 2.9-.7 4.2c-.4 1.3-1.1 2.4-2 3.4-.9 1-1.9 1.7-3.1 2.3-1.2.6-2.6.8-4.2.8s-2.9-.3-4.2-.8c-1.2-.6-2.3-1.3-3.1-2.3-.9-1-1.5-2.1-2-3.4-.4-1.3-.7-2.7-.7-4.2s.2-2.9.7-4.2c.4-1.3 1.1-2.4 2-3.4.9-1 1.9-1.7 3.1-2.3 1.2-.5 2.6-.8 4.2-.8zm0 17.6c.9 0 1.7-.2 2.4-.5s1.3-.8 1.7-1.4c.5-.6.8-1.3 1.1-2.2.2-.8.4-1.7.4-2.7v-.1c0-1-.1-1.9-.4-2.7-.2-.8-.6-1.6-1.1-2.2-.5-.6-1.1-1.1-1.7-1.4-.7-.3-1.5-.5-2.4-.5s-1.7.2-2.4.5-1.3.8-1.7 1.4c-.5.6-.8 1.3-1.1 2.2-.2.8-.4 1.7-.4 2.7v.1c0 1 .1 1.9.4 2.7.2.8.6 1.6 1.1 2.2.5.6 1.1 1.1 1.7 1.4.6.3 1.4.5 2.4.5zM88.9 28 83 7h4.7l4 15.7h.1l4-15.7h4.7l-5.9 21h-5.7zm28.8-3.6c.6 0 1.2-.1 1.7-.3.5-.2 1-.4 1.4-.8.4-.4.7-.8.9-1.4.2-.6.3-1.2.3-2v-13h4.1v13.6c0 1.2-.2 2.2-.6 3.1s-1 1.7-1.8 2.4c-.7.7-1.6 1.2-2.7 1.5-1 .4-2.2.5-3.4.5-1.2 0-2.4-.2-3.4-.5-1-.4-1.9-.9-2.7-1.5-.8-.7-1.3-1.5-1.8-2.4-.4-.9-.6-2-.6-3.1V6.9h4.2v13c0 .8.1 1.4.3 2 .2.6.5 1 .9 1.4.4.4.8.6 1.4.8.6.2 1.1.3 1.8.3zm13-17.4h4.2v9.1l7.4-9.1h5.2l-7.2 8.4L148 28h-4.9l-5.5-9.4-2.7 3V28h-4.2V7zm-27.6 16.1c-1.5 0-2.7 1.2-2.7 2.7s1.2 2.7 2.7 2.7 2.7-1.2 2.7-2.7-1.2-2.7-2.7-2.7z"></path> |
| 50 | + </svg> |
| 51 | + </a> |
| 52 | + </div> |
| 53 | + <div class="govuk-header__content"> |
| 54 | + <a href="/analytics/" class="govuk-header__link govuk-header__service-name"> |
| 55 | + Implementation record |
| 56 | + </a> |
| 57 | + </div> |
| 58 | + </div> |
| 59 | + </div> |
| 60 | + </header> |
| 61 | + |
| 62 | + <div class="govuk-width-container "> |
| 63 | + <main class="govuk-main-wrapper"> |
| 64 | + <div class="govuk-grid-row"> |
| 65 | + <div class="govuk-grid-column-one-third"> |
| 66 | + <ul class="govuk-list"> |
| 67 | + <li> |
| 68 | + <a href="/analytics/" class="govuk-link">Implementation record</a> |
| 69 | + </li> |
| 70 | + </ul> |
| 71 | + |
| 72 | + <hr class="govuk-section-break govuk-section-break--m govuk-section-break--visible"> |
| 73 | + |
| 74 | + <ul class="govuk-list"> |
| 75 | + <li> |
| 76 | + <a href="/analytics/data.html" class="govuk-link">Data</a> |
| 77 | + </li> |
| 78 | + <ul class="govuk-list govuk-list--bullet"> |
| 79 | + <li> |
| 80 | + <a href="/analytics/events.html" class="govuk-link">Events</a> |
| 81 | + </li> |
| 82 | + <li> |
| 83 | + <a href="/analytics/attributes.html" class="govuk-link">Attributes</a> |
| 84 | + </li> |
| 85 | + <li> |
| 86 | + <a href="/analytics/schema.html" class="govuk-link">Data schemas</a> |
| 87 | + </li> |
| 88 | + </ul> |
| 89 | + </ul> |
| 90 | + |
| 91 | + <hr class="govuk-section-break govuk-section-break--m govuk-section-break--visible"> |
| 92 | + |
| 93 | + <ul class="govuk-list"> |
| 94 | + <li> |
| 95 | + <a href="/analytics/docs.html" class="govuk-link">Documentation</a> |
| 96 | + </li> |
| 97 | + <ul class="govuk-list govuk-list--bullet"> |
| 98 | + <li> |
| 99 | + <a href="/analytics/approach.html" class="govuk-link">Development approach</a> |
| 100 | + </li> |
| 101 | + <li> |
| 102 | + <a href="/analytics/consent.html" class="govuk-link">Consent handling</a> |
| 103 | + </li> |
| 104 | + <li> |
| 105 | + <a href="/analytics/pii.html" class="govuk-link">Personally identifiable information</a> |
| 106 | + </li> |
| 107 | + <li> |
| 108 | + <a href="/analytics/trackers.html" class="govuk-link">Trackers</a> |
| 109 | + </li> |
| 110 | + <li> |
| 111 | + <a href="/analytics/further_docs.html" class="govuk-link">Further reading</a> |
| 112 | + </li> |
| 113 | + </ul> |
| 114 | + </ul> |
| 115 | + |
| 116 | + <hr class="govuk-section-break govuk-section-break--m govuk-section-break--visible"> |
| 117 | + |
| 118 | + <ul class="govuk-list"> |
| 119 | + <li> |
| 120 | + <a href="/analytics/progress.html" class="govuk-link">Implementation progress</a> |
| 121 | + </li> |
| 122 | + </ul> |
| 123 | + </div> |
| 124 | + <div class="govuk-grid-column-two-thirds" id="main-content" role="main"> |
| 125 | + <h1 class="govuk-heading-l"> |
| 126 | + Development approach |
| 127 | +</h1> |
| 128 | + |
| 129 | +<p class="govuk-body">This is our high-level approach to implementing tracking across our applications.</p> |
| 130 | + |
| 131 | +<ul class="govuk-list govuk-list--bullet"> |
| 132 | + <li> |
| 133 | + For elements that are consistent from page to page (such as the header, footer and breadcrumbs) tracking should be enabled by default. |
| 134 | + </li> |
| 135 | + |
| 136 | + <li> |
| 137 | + For elements within the content of a page, tracking should be controllable. Specifically, tracking should be enabled on <a href="https://components.publishing.service.gov.uk/component-guide" class="govuk-link">components</a> by default but disabled with a ‘disable_ga4’ option. This provides the flexibility to disable tracking in the unforeseen event of some kind of tracking collision or duplication. |
| 138 | + </li> |
| 139 | + |
| 140 | + <li> |
| 141 | + For elements that are inside content coming from a publishing interface, such as <a href="https://components.publishing.service.gov.uk/component-guide/govspeak" class="govuk-link">govspeak</a> elements, tracking should be decided on a case by case basis. The most likely approach would be to enable tracking by default. This removes the need to provide publishers with an option to enable tracking on their content, which could get much more complex. |
| 142 | + </li> |
| 143 | +</ul> |
| 144 | + |
| 145 | +<p class="govuk-body">Enabling tracking should be as simple as possible. For this reason, tracking should be handled internally by components unless external data is required, that is, unless something unique must be passed from the application to the component to track it correctly.</p> |
| 146 | + |
| 147 | +<p class="govuk-body">During the development phase of the GA4 migration our approach with components was not to enable tracking by default, but to have a ‘ga4_tracking’ option that allowed tracking to be enabled. This allowed us greater control during testing and deployment.</p> |
| 148 | + |
| 149 | + </div> |
| 150 | + </div> |
| 151 | + </main> |
| 152 | + </div> |
| 153 | + |
| 154 | + <footer class="govuk-footer " role="contentinfo"> |
| 155 | + <div class="govuk-width-container "> |
| 156 | + <div class="govuk-footer__meta"> |
| 157 | + <div class="govuk-footer__meta-item govuk-footer__meta-item--grow"> |
| 158 | + <h2 class="govuk-visually-hidden">Support links</h2> |
| 159 | + <svg aria-hidden="true" focusable="false" class="govuk-footer__licence-logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 483.2 195.7" height="17" width="41"> |
| 160 | + <path fill="currentColor" d="M421.5 142.8V.1l-50.7 32.3v161.1h112.4v-50.7zm-122.3-9.6A47.12 47.12 0 0 1 221 97.8c0-26 21.1-47.1 47.1-47.1 16.7 0 31.4 8.7 39.7 21.8l42.7-27.2A97.63 97.63 0 0 0 268.1 0c-36.5 0-68.3 20.1-85.1 49.7A98 98 0 0 0 97.8 0C43.9 0 0 43.9 0 97.8s43.9 97.8 97.8 97.8c36.5 0 68.3-20.1 85.1-49.7a97.76 97.76 0 0 0 149.6 25.4l19.4 22.2h3v-87.8h-80l24.3 27.5zM97.8 145c-26 0-47.1-21.1-47.1-47.1s21.1-47.1 47.1-47.1 47.2 21 47.2 47S123.8 145 97.8 145" /> |
| 161 | + </svg> |
| 162 | + <span class="govuk-footer__licence-description"> |
| 163 | + All content is available under the |
| 164 | + <a class="govuk-footer__link" href="https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/" rel="license">Open Government Licence v3.0</a>, except where otherwise stated |
| 165 | + </span> |
| 166 | + </div> |
| 167 | + <div class="govuk-footer__meta-item"> |
| 168 | + <a class="govuk-footer__link govuk-footer__copyright-logo" href="https://www.nationalarchives.gov.uk/information-management/re-using-public-sector-information/uk-government-licensing-framework/crown-copyright/">© Crown copyright</a> |
| 169 | + </div> |
| 170 | + </div> |
| 171 | + </div> |
| 172 | + </footer> |
| 173 | + |
| 174 | + <script src="/javascripts/application.js"></script> |
| 175 | + <script> |
| 176 | + window.GOVUKFrontend.initAll() |
| 177 | + </script> |
| 178 | +</body> |
| 179 | +</html> |
0 commit comments