Configure Sites and Site Groups
By default, one site and one site group automatically created upon registration. You can manually add more sites and site groups, following the instructions below.
To add another site:
- On the Adenty Portal, Go to the Admin tab – > Sites
- Create your site or multiple managed sites by clicking the button «Add site» and filling in the form.
To add additional site group:
- On the Adenty Portal, go to the Admin tab – > Site groups.
- Create your site group or multiple site groups by clicking the button «Add a site group» and filling in the form.
Integrate Adenty with Google Analytics
Export JSON files with tags from Adenty portal
Download two JSON files:
- "Adenty_GTM_tags": contains custom Adenty tags specifically designed for Google Tag Manager (GTM) to track Adenty events in Google Analytics.
- "Configuration_tag" (optional): contains tag that connects Google Analytics with GTM.
Import the files to your Google Tag Manager container
- Import "Adenty_GTM_tags" to your GTM to track and display custom Adenty events in your Google Analytics.
- Optional: Use "Configuration_tag" if your Google Analytics and GTM are not yet connected.
- After the import is completed, you will see a list of Adenty tags in your GTM workspace.
Update tags with the Measurement ID of your Google Analytics
- Update the "Measurement ID" field with your Google Analytics ID (GA-ID) for each Adenty tag imported from "Adenty_GTM_tags".
- If using "Configuration_tag", replace the Configuration Tag ID with your Google Analytics ID (GA-ID).
Click "Publish" to apply changes
After that, you will start getting Adenty events on your Google Analytics account.
Please, use official Google Instructions for more details.
As a result, your Google Analytics will display Adenty events in addition to standard ones.
Install Adenty on Your Web Resource(s)
To start running Adenty on your web resource(s), complete the following steps:
On the Adenty Portal, go to the Implementation Tab.
To generate installation scripts for all sites that you manage, click the button «Generate script». Note, that each initialization script refers to a particular site and should be applied to it for correct analytics.
We recommend creating a separate site in the Admin Portal for each web resource environment, such as development or test, as well as for subdomains. This ensures accurate insights and visitor identification for each site.
To generate an installation script for a specific site, click on the filter button, then choose appropriate site group and site. Then click the button «Generate script».
Depending on the selected plan opt for one of three installation options:
- HTML (available for all pricing plans)
- GTM (available for Identity Pro, Identity Enterprise)
- White Label (JS) (available for Identity Pro, Identity Enterprise)
Placement of the Adenty code
After acquiring the installation script or its manual copying, add it to each page of your site (for example, within a common header).
For HTML type implementation put the script at the end of HTML body of every page.
For GTM type implementation put the script to the appropriate Tag that runs on every page.
Activating or deactivating Adenty
To comply with data privacy standards, you should place the code generated for Adenty installation in the code part of your web resource where the user's consent is processed. Therefore:
- If the user clicks "Yes" and agrees to tracking, recording, and storing cookies, you can activate Adenty.
- If the user clicks "No" and refuses tracking, recording, and storing cookies, you shouldn’t activate Adenty.
This option implies you should add two pieces of Adenty installation code separately (which is recommended for the performance purposes):
- To download Adenty, place the first code piece at the beginning of the web resource JavaScript run flow.
- To initialize Adenty, place the second code piece in the code of your web resource where the user's consent is processed.
Alternatively, you can add two pieces of installation code as one. For this, place the whole piece of Adenty code in the code of your web resource where the user's consent is processed.
Congratulations, you have successfully set up the Adenty Plugin!
Furtherdown, you don’t need to worry about Adenty plugin updates — it happens automatically.
Events Adenty Fires
Based on visitor activity, Adenty generates the following events:
- VisitorNew: visitor appeared on a web resource first time
- VisitorReturned: visitor returned to a web resource after some time (after the first visit)
- VisitorRestored: visitor was recognized (restored) as returned even though he appeared with empty local storage (e.g. due to local storage cleaning or activation of incognito mode, etc)
- VisitorFingerprintChanged: Fingerprint id got changed due to any device parameter changed (e.g. due to IP change or browser version, etc)
VisitorSwitchedFrom: the fact that the visitor switched to current ID from a previously used ID
VisitorSwitchedTo: the fact that the visitor switched from this ID to the updated ID
For authorized users, Adenty generates three additional events:
- AccountLogin: all subsequent logins of a visitor to one’s regular account
AccountSwitchedFrom: the fact that the visitor switched to current account from a previously used one
AccountSwitchedTo: the fact that the visitor switched from this account to the new account
To help detect fraudulent activity, Adenty generate such events as:
- VisitorVPNDetected: visitor navigated web resource under VPN
- AccountFraudDetected: visitor is likely to share single account with multiple users
- AccountNewDeviceDetected: access to account was carried out from a new device
All those events are generated and gathered by Adenty, and they are also sent to GA to extend existing Client’s analytics in GA.
Consume / Integrate Adenty Data
Once the Adenty plugin is launched on your site(s), you can access Adenty public object through console (JS code) — here you can get anonymous and authenticated visitors information as per below
To get anonymous visitor information, use the following commands:
- adenty.getVisitorId()
- adenty.getRecognitionId()
To get authenticated user information, use the following commands:
- adenty.getAccountInfo()
To subscribe to the public Adenty event, use the following command:
- adenty.listenTo(‘EventName’, function())
To subscribe to any other Adenty event, use the following command, replacing "EventName" with your target event. See the full list of available events below:
visitorIdResolved
recognitionIdResolved
accountInfoResolved
VisitorNew
VisitorReturned
VisitorRestored
VisitorFingerprintChanged
VisitorSwitchedFrom
AccountLogin
AccountIdentityLogin
AccountSwitchedFrom
VisitorVPNDetected
AccountFraudDetected
AccountNewDeviceDetected
Example of subscribing to an Event “visitorIdResolved”:
adenty.listenTo(‘ visitorIdResolved’, function(){
alert(“Hello! AccountIdentityLogin”);
})
Adenty passes arguments within the following events:
visitorIdResolved contains argument “visitorId”
recognitionIdResolved contains argument “recognitionId”
Along with firing events Adenty collects the following parameters:
VisitorId
RecognitionId
VisitorIP (hashed on the server)
Country
City
UserAgent
AcountID (for authorized visitors)
Browser settings
Device settings
Share your feedback
We value your opinion! Please, share your feedback on using Adenty as well as your questions and proposals to improve.
