aesirx-analytics v2.4.0
AesirX Analytics JS Collector
A powerful and compliant web Analytics platform (1st-party alternative to Google Analytics) that only collects 1st-party data to deliver meaningful customer insights for your organization.
AesirX Analytics comes with a locally hosted JavaScript solution that gathers and stores data legally and compliantly in accordance with GDPR and other regional legislation including storage of citizens’ data in-country and 1st-party.
*Important Change: AesirX Consent was split to another packages https://github.com/aesirxio/consent
Setup instructions
Setup the 1st party server
Follow the instructions in: https://github.com/aesirxio/analytics-1stparty
Setup the JS Collector
Usage in SSR site:
- Download analytics.js from https://github.com/aesirxio/analytics/releases/latest
- copy
analytics.js
to your project - Add script to
<head>
:
<script>
window.aesirx1stparty = "https://example.com"
</script>
<script async defer src="YOUR_PROJECT_PATH/analytics.js"></script>
- (
https://example.com
is the link to your 1st party server which must be installed)
Usage in ReactJS
npm i aesirx-analytics
Add the environment variable file (.env
)
REACT_APP_ENDPOINT_ANALYTICS_URL=https://example.com
(https://example.com is the link to your 1st party server)
With react-router-dom v5:
Create AnalyticsContainer component:
import React from 'react';
import { useLocation, useHistory } from 'react-router-dom';
import { AnalyticsReact } from 'aesirx-analytics';
const AnalyticsContainer = ({children}) => {
const location = useLocation();
let history = useHistory();
return <AnalyticsReact location={location} history={history}>{children}</AnalyticsReact>;
};
export default AnalyticsContainer;
Wrap your component in <AnalyticsContainer><[YOUR-COMPONENT]/></AnalyticsContainer>
<AnalyticsContainer>
need to using inside <Router>
component
Usage in NextJS
npm i aesirx-analytics
Add the environment variable file (.env
)
NEXT_PUBLIC_ENDPOINT_ANALYTICS_URL=https://example.com
(https://example.com is the link to your 1st party server)
Disable Consent Popup:
add this environment variable to .env
NEXT_PUBLIC_DISABLE_ANALYTICS_CONSENT=true
With next/router:
Added in app.js:
import { useRouter } from "next/router";
import { AnalyticsNext } from "aesirx-analytics";
<AnalyticsNext router={useRouter()}>
<[YOUR-COMPONENT]/>
</AnalyticsNext>
Track events:
In SSR Site:
To track events, simply add special data-attribute to the element you want to track. For example, you might have a button with the following code:
<button class="button"
data-aesirx-event-name="sign up"
data-aesirx-event-type="login"
data-aesirx-event-attribute-a="value-a"
data-aesirx-event-attribute-b="value-b"
>
Sign Up
</button>
Add data-attribute with the following format:
data-aesirx-event-name="<event-name>"
data-aesirx-event-type="<event-type>"
data-aesirx-event-attribute-<attribute-name-1>="<attribute-value-1>"
data-aesirx-event-attribute-<attribute-name-2>="<attribute-value-1>"
Or you can use your own Javascript to Track events:
window.trackEventAnalytics(endpoint, referer, data)
(endpoint
is the link to your 1st party server which must be installed)
(referer
is the referer domain)
(data
is the data you want to track)
(event_type
should be conversion
if you want to track event as conversion)
For example:
trackEventAnalytics(
"https://example.com",
"https://aesirx.io",
{
event_name: "<event_name>",
event_type: "<event_type>",
attributes: [
{
name: "<name-1>",
value: "<value-1>"
},
{
name: "<name-2>",
value: "<value-2>"
},
],
}
);
In ReactJS:
import { trackEvent, AnalyticsContext } from "aesirx-analytics";
const CustomEvent = () => {
const AnalyticsStore = useContext(AnalyticsContext);
const initTrackEvent = async () => {
await trackEvent(endPoint, AnalyticsStore.visitor_uuid, referer, {
event_name: "Submit",
event_type: "submit",
attributes: [
{
name: "<name-1>",
value: "<value-1>"
},
{
name: "<name-2>",
value: "<value-2>"
},
],
});
};
return (
<button onClick={() => {initTrackEvent();}}> Search </button>
);
}
In NextJS:
import { trackEvent, AnalyticsContext } from "aesirx-analytics";
const CustomEvent = () => {
const AnalyticsStore = useContext(AnalyticsContext);
const initTrackEvent = async () => {
await trackEvent(endPoint, AnalyticsStore.visitor_uuid, referer, {
event_name: "Submit",
event_type: "submit",
attributes: [
{
name: "<name-1>",
value: "<value-1>"
},
{
name: "<name-2>",
value: "<value-2>"
},
],
});
};
return (
<button onClick={() => {initTrackEvent();}}> Search </button>
);
}
(endPoint
is the link to your 1st party server which must be installed)
(referer
is the referer domain)
7 months ago
7 months ago
7 months ago
7 months ago
9 months ago
9 months ago
9 months ago
9 months ago
10 months ago
10 months ago
11 months ago
11 months ago
11 months ago
11 months ago
12 months ago
12 months ago
12 months ago
12 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago