GA4 Implementation Record
The GOV.UK GA4 implementation record holds information about our Google Analytics 4 data schemas, as well as other related information about our GA4 implementation.
Updating the record
The implementation record should be kept up to date with any changes made to the GA4 implementation. For changes to existing content this will be possible if:
- you have a locally running version of this site
- you understand how to edit YML files
- you have access to the git repository for this site and can push changes
For more complex changes such as adding a new page or changing how existing data is displayed, a developer may be required.
How to make changes
Static page templates are stored in /source/analytics. They include pages like the Documentation pages and are written using standard HTML/CSS using styles from the Design System.
Dynamic pages such as the events, attributes and trackers pages are generated automatically from the YAML files stored in /data/analytics/.
When editing events and attributes please note the following.
- YML files rely on specific indenting, if the page breaks during editing check that you have indented the YML correctly
- new events require a
datasection, including the minimum attributes:eventandevent_data.event_datamust containevent_name. See existing events for examples - attributes added to events in events.yml will only appear if a corresponding entry for the attribute is added to attributes.yml
- new attributes should have the same detail provided as existing attributes, although the minimum requirement is a
nameand atype - if no value is provided in
events.ymlfor an attribute, thetypeof the attribute will be shown - the values of
implementedfor events are used to calculate the details on the implementation progress page