By enabling user identification, you will send unique user IDs for your end users dynamically to have persisted user data for your end-users at UserGuiding.
Implementing User Identification requires access to your web platform or site's source code which is one of the 3 environments you will take certain action to succeed.
- Go to settings > user identification
- Here, you'll find the directions for adding the identify snippet.
- Copy the example snippet given here(1), that soon, you will use it inside your Custom Tag at GTM.
See image 1:
2) Google's Tag Manager
- Login to your Google Tag Manager account where you'll utilize the identify snippet copied from UserGuiding's dashboard.
🍪 Next, you will create a Trigger, a Variable, and a Tag in your GTM account.
To demonstrate, we will use example variables that could be different in your implementation. You can name and configure these variables as you need.
a) Create a Trigger: Here, you should create a Custom Event Trigger.
The function of this custom event Trigger is to tell the Tag (having the identify snippet) to fire when the specified event is detected.
Important: Inside your web platform's source code, you should have a code that will push the Trigger's custom event into the Data Layer.
See image 2: We created a Custom Event Trigger named "identifyUser".
This way, the Tag Manager can detect identifyUser as a custom event value, and will proceed to fire the Tag.
b) Create a Variable: You should create a Data Layer Variable.
Each user ID you want to send to UserGuiding is an individual value. Thus, the Data Layer Variable you create will be the placeholder for these values.
Important: Inside your web platform's source code, you should push data (user IDs) to the data layer to set values for the data layer variable. Learn more.
See image 3: We created a variable named "userId".
The value will be set when data is pushed to the data layer.
c) Create a Tag: You should create a Custom HTMLTag.
This is where you will utilize the identify snippet copied from panel.userguiding.com and your configurations so far.
See image 4: We created a Tag named "UserGuiding - User Identification".
With this tag, we are ready to send user IDs to UserGuiding via GTM.
- After adding your tag, SAVE it and publish changes in your GTM account.
🍪 To make sure your tag configurations function as expected, you can preview and debug containers while at GTM.
- Finally, return to your UserGuiding account and click Enable Identification button at the left-bottom. Then, click Publish Changes button on the top-right.
3) Your Source Code:
[actions below are previously mentioned]
Implementing user identification requires access to your platform's source code. As you might recall, we already shared two Important notes with you.
1*Important: Inside your web platform's source code, you should have a code that will push the custom event into the Data Layer.
2*Important: Inside your web platform's source code, you should push data (user IDs) to the data layer to set values for the data layer variable. Learn more.
User Identification Enabled:
Once it is enabled and active, you will be able to access your API Key (API Access Token) in the section shown below:
You can use our API Documentation to see how to utilize the User API.
We recommend you get support from your development team and use an API Development Environment to access this data. Postman is a great alternative for this task.
How to test if user IDs are being sent successfully?
You can utilize the User API to check if the user IDs you sent to UserGuiding have successfully arrived.
Alternatively, as a current and one of the identified users (a unique ID is sent for you), you can access one of your platform pages where UserGuiding's container code is installed.
Here, open the Troubleshooter and view Current User Information to find your unique ID.
As you can see from the image below, User Identification is Completed ✅. for the current user. Because a unique ID is assigned to them.
Their unique User ID is 9659.