Analytics
Out of the box, Open SDG sends information to Google Analytics for certain events:
- All page loads
- User changes data tabs (Table, Chart, etc.)
- User changes metadata tabs (National, Global, etc.)
- User changes the contrast setting
- User downloads a CSV file
Google Analytics ID¶
In order to turn on the analytics functionality, you must set the Google Analytics ID in the site repository's _config_prod.yml
like so:
analytics:
ga_prod: 'paste ID here'
It is recommend to only put this in _config_prod.yml
, and not in _config.yml
, because you would not want to confuse your metrics by mixing staging and production together.
Customising the Google Analytics parameters¶
If you would like to change the Google Analytics parameters (category/action/label) that Open SDG sends, you can create a data file at this path in your site repository: data/autotrack.yml
The contents of this YAML file can override any tracked event, according to their "preset" value. For example:
my_preset:
category: My category
action: My action
label: My label
Tracking new click events¶
You can track a new click event using either HTML or Javascript.
Tracking a click event with HTML¶
Here is an example of tracking a new click event using HTML, in a Jekyll page or layout:
Below is a call-to-action that we would like to track.
<a href="/my-url" {% include autotrack.html preset="my_preset" category="My category" action="My action" %}>
My link
</a>
Tracking a click event with Javascript¶
Here is an example of tracking a new click event using Javascript:
<a href="/my-url" id="my-link">My link</a>
<script>
var attributes = opensdg.autotrack('my_preset', 'My category', 'My action');
$('#my-link').attr(attributes);
</script>