> For the complete documentation index, see [llms.txt](https://attr.sygnal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://attr.sygnal.com/sa5-analytics/about.md).

# About SA5's Analytics Lib

This this lib is designed to support analytics tracking using GTM and the dataLayer to capture data from your site.  

It c

Most of the examples here are focused on capturing the end data in Google Analytics ( GA4 ), however Facebook and other data targets are equally viable.

It can also be used to supportsupports detection of your visitor characteristics, and actions based on them.

Initially we are focused on geo-detection using a GEOIP methodology. 

* Route users to specific pages depending on their location 

Coming soon; 

* Conditionally display elements depending on location  

## Future

User-agent detection, with accordant routing and conditional-vis;

* Language
* Device type
* Browser type
* etc. 

First time visitor detection. 

Referral detection. 

Onready callback 

Data binding 

### Detection Overrides

E.g. use case

dropdown showing countries

detected country selected 

changing forces a change on the country setting

*reloads page* to reapply detect with override setting 

Explicit overrides on detected UserInfo, such as the country, city, browser type... 

Set by script, 

window\.user-info-overrides 

set directly on overrides objects, via detect 

Saved data binds 

\>$detect.geo.country

Override Detects UserInfo? 

* Override country
* Override city
* Override language
* Override browser type

And remember - cache overrides? 

### Filter defaulting

Support for queries, like UserInfo load triggers, and the ability to e.g. trigger FS filters depending on those details automatically. 

Initialization only, once.