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
Follow the instructions in: https://github.com/aesirxio/analytics-1stparty
- Download analytics.js from https://github.com/aesirxio/analytics/releases/latest
- copy
analytics.jsto 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.comis the link to your 1st party server which must be installed)
npm i aesirx-analytics
REACT_APP_ENDPOINT_ANALYTICS_URL=https://example.com
(https://example.com is the link to your 1st party server)
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;
npm i aesirx-analytics
NEXT_PUBLIC_ENDPOINT_ANALYTICS_URL=https://example.com
(https://example.com is the link to your 1st party server)
add this environment variable to .env
NEXT_PUBLIC_DISABLE_ANALYTICS_CONSENT=true
Added in app.js:
import { useRouter } from "next/router";
import { AnalyticsNext } from "aesirx-analytics";
<AnalyticsNext router={useRouter()}>
<[YOUR-COMPONENT]/>
</AnalyticsNext>
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>"
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>"
},
],
}
);
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>
);
}
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)