Add Google Analytics custom dimension for institution names
|Target version:||Release 2.5.0|
|Google Code Legacy ID:||Tested version:|
This feature enhancement will add support for Google Analytics code to record institution names as a custom dimension in Google Analytics pageview reports. By doing so, users who set up an Analytics account will be able to collect data on a per-institution basis, making this useful for multi-repository installations.Deliverables: Add Google Analytics custom dimension to record institution name on the archival description, authority record, and archival institution view pages when:
- the AtoM site is configured with a valid Google Analytics tracking id.
- the resource is linked the an archival institution (e.g. an archival description, or one of its ancestors, is linked to an archival institution).
#4 Updated by José Raddaoui Marín about 1 year ago
Notes for test and documentation:
As a good side effect, we have moved from the old 'ga.js' deprecated method to Universal Analytics with this changes, it doesn't require any change in the configuration and the old method doesn't allow custom dimensions. See:
To enable the custom dimension for institutions:
In the Google Analytics property used to track the AtoM site, the one with the key that's is set in 'config/app.yml', create a custom dimension to track repository related views. Use 'Hit' as the scope and set it to active while following:
Set the created dimension index number in 'config/app.yml' bellow the API key and un-comment that setting. Clear the Symfony cache and restart PHP-FPM.
This will set the source culture authorized form of name from the repository (or related repository) as the dimension value before sending the page view hit in the following pages:
- IOs inde page (all templates): repository value (direct or inherited)
- Actors index page: maintaining repository
- Repository index page
#10 Updated by Dan Gillean about 1 month ago
- Requires documentation deleted (
Sara Allain added docs for 2.5 for this feature in https://github.com/artefactual/atom-docs/commit/c49b192160fdf598ad6cb6e5176ee12675354daf (plus a couple typo commits after)