Absorb allows the usage of Google Analytics 4 tags for the purposing of tracking page navigation of users across the Learner Interface of the LMS. Utilizing this feature requires Google Analytics 4 to be used alongside Google Tag Manager.
Limitations
Absorb offers a specific scope of functionality when utilizing Google Analytics and Google Tag Manager. Please advise the following limitations in consideration of your use-case:
-
Absorb LMS currently blocks GTM's custom code/HTML functionality. Only the history tracking functionality showcased in the below configuration, or the custom absorbPageview event will interact with Google Analytics / Google Tag Manager.
-
Please ensure your Ad Blocker is disabled as it interferes with GTM tracking.
-
The Absorb GTA/GTM integration only supports default properties and functions applied automatically when enabling this on your organization's LMS instance. Any custom properties, tags, code, or implementation of Analytics and Tag Manager associated with the LMS beyond this is not supported by Absorb.
-
Utilizing Google Analytics 4 requires using Google Tag Manager. Google Analytics 4 tags cannot be implemented without Google Tag Manager.
-
Components of ‘Enhanced Measurements’ such as scrolling or outbound clicks will not be captured if enabled on the data stream.
Configuring GA4 & GTM in Absorb LMS
The following series of steps showcase the order of operations to configure a functional GA4 tag and implement the tracking of history in the learner interface of Absorb LMS. As GA4 requires both Google Analytics and Google Tag Manager in order for Absorb LMS to retain current tracking behavior, this article will walk through the required setup for both of these elements.
Google Analytics 4 Setup
-
Login to your Google Account.
-
Login to your Analytics account.
-
Navigate to the 'Admin' section and click on the ‘Create Property’ button.
-
Enter the following values:
-
Property Name
-
Reporting Time Zone (country and time zone)
-
Currency
-
-
Click ‘Next’.
-
Select details which correspond to your use-case:
-
Industry Category
-
Business Size
-
-
Click ‘Next’.
-
Select the ‘business objective’ which corresponds to your use-case.
-
Click ‘Create’.
-
You will be presented with a choice of platforms. Select ‘Web’ for the platform.
-
You will land on a ‘Set up data stream’ page. Here you must enter your primary LMS route as the ‘Website URL’. The ‘Stream Name’ can be titled as per your preference/use-case.
-
Click ‘Create Stream’.
-
A panel will appear titled 'Installation Instructions'. Close ‘Installation Instructions’.
-
Close ‘Web stream details’.
-
You will land on a page titled ‘Start Collecting Data’. Click ‘Next’.
-
You will land on a page which indicates ‘Data collection is pending’. Select ‘Continue to Home’.
-
On the ‘Home’ page there is a Measurement ID. Copy this value somewhere you can use it in the future as this is one of the values required in your LMS portal. Alternatively following this article to locate your measurement ID.
-
Next we will configure the required Google Tag Manager container.
Google Tag Manager Setup
- Navigate to Google Tag Manager from your Google Account.
- Create a Google Tag Manager account (if you don’t have an existing one).
-
Capture your Google Tag Manager ID; it will be required for later steps. (GTM-XXXXX).
-
In the left hand side menu click on ‘Variables’.
-
Click ‘Configure’ in the ‘Built-in Variables’ section.
-
On the ‘Configure Built-In Variables’ page, scroll down to the ‘History’ section and select all check boxes.
-
Close ‘Configure’ in ‘Built-In Variables’.
-
Click ‘New’ in the ‘User Defined Variables’ section.
-
Set Name to ‘Page Location’.
-
Mouse over the panel in the center of the screen and click on the pencil in the top right to edit the variable.
-
Choose ‘JavaScript Variable’.
-
Enter ‘window.location.href’ as ‘Global Variable Name’.
-
Click ‘Save’.
-
Click on ‘Triggers’ from the left hand side menu.
-
Click ‘New’.
-
Enter ‘Page View Trigger’ as the name.
-
Mouse over the panel in the center of the screen and click the pencil to edit the trigger.
-
Choose ‘Custom Event’ as a trigger type.
- Enter “absorbPageview“ as “Event name”.
-
Make sure that “All Custom Events“ is selected.
-
Click ‘Save’.
-
Click ‘Tags’ from the left hand side menu.
-
Click ‘New’.
-
Enter ‘Google Analytics GA4 Event’ as the name.
-
Mouse over the panel in the center of the screen and click on the pencil to edit the tag configuration.
-
Choose “Google Analytics" and then "Google Analytics: GA4 Event“ as a tag type.
-
Enter the following values:
-
Measurement ID: Paste the measurement ID created in step 17 of the GA4 setup above.
-
Event Name: page_view (case sensitive)
-
-
Expand ‘Event Parameters’, click ‘Add Parameter’ and add the following values
-
Event Parameter: page_location
-
Value: {{Page Location}}
-
-
Scroll down to the ‘Triggering’ section mouse over the panel and select the pencil icon to edit.
-
Select ‘Page View Trigger’.
-
Click ‘Save’.
- Delete “History Change Trigger“ if it exists.
-
Navigate to the current workspace.
-
Click ‘Submit’.
-
Click ‘Publish’.
-
Enter an optional name and description and click ‘Continue’.
Absorb LMS Setup
Navigate to the Admin Interface in your Absorb LMS as a System Administrator.
- Navigate to ‘Portal Settings’.
-
Under the 'Info' tab. Scroll down to ‘Enable Google Tag Manager and/or Google Analytics’. Confirm the toggle is ON.
-
Enter Measurement ID as generated in Step 17 of the GA4 setup under 'Google Analytics Tracking ID'.
-
Enter Google Tag Manager ID as generated in Step 3 of the GTM setup.
-
Click ‘Save’.
-
Login to the LMS as a learner.
-
Open Google Analytics and confirm the data stream is receiving information.
Output in Google
Once the Google Analytics 4 tag has been configured in both Google Analytics and Google Tag Manager. You should start to observe user counts and locations appear in your analytics home page for the GA4 property which has been configured.
You will be able to observe how many users have navigated the learner interface during certain periods of time, as well as the platform they accessed from.
Google Analytics will capture which country the user navigated to your learner interface from. As well as different pages in the learner interface.
Comments
Please sign in to leave a comment.