Integrate Google Analytics with HCL Digital Experience

1. Add the DX GoogleAnalyticsAggregator.js to the HCL DX theme profile.
   In HCL DX 9.5 CF19 and higher, the GoogleAnalyticsAggregator.js file is located in the PortalServer_root/doc/js-samples directory.

   • If using a WebDAV-based theme, copy the GoogleAnalyticsAggregator.js file to mycontenthandler/dav/fs-type1/theme/{your-custom-theme}/js.
   • If using a WAR-based theme, include the GoogleAnalyticsAggregator.js file in the static theme WAR file.

   For example, when using a WAR-based theme, the location of the GoogleAnalyticsAggregator.js file after installing to the <YourTheme> WAR file will be deployed under wp_profile:

   wp_profile/installedApps/<cell>/<YourTheme.ear>/<YourTheme.war>/themes/<YourTheme>/js

   Refer to the file tree below how the custom theme app will be deployed:

   wp_profile
       ---> installedApps
           ---> <cell>
               ---> <YourTheme.ear>
                   ---> <YourTheme.war>
                       ---> themes
                           ---> <YourTheme>
                               ---> js
                                   ---> GoogleAnalyticsAggregator.js

2. Add the DX GoogleAnalyticsAggregator.js to the HCL DX theme profile.
   Note: The theme profile used by the page(s) needs to include wp_analytics or at least wp_analytics_aggregator.

   HCL DX without Practitioner Studio installed:

   a. On Site Manager, select Page > Page Settings > Page Properties > Advanced

   b. Go to Manage Pages portlet, click the Administration menu icon. Then, select Portal User Interface > Manage Pages.

   HCL DX 9.5 with Practitioner Studio installed:

   a. Select Administration > Site Management > Pages to access the Manage Pages interface.

   

   b. Locate the page to which you want to assign the aggregator. Use the Manage Pages portlet to locate the page.

   Note: The page must be located as a child of the portal content root.

   c. Select Edit Page Properties for the page that you selected.

   Note: You cannot add an Active Site Analytics aggregator to the content root. Edit Page Properties is not available for the content root.

   d. To expand the available choices, click the plus sign (+) icon next to Advanced Options.

   e. Click I want to set parameters.

   f. In the field New parameter, type a string that starts with asa_aggregator or asa_dependency. Values that correspond to names that start with the string asa_aggregator are added to the page body, names that start with asa_dependency are added to the head. Both the aggregators and dependencies are added to the portal page in alphabetical order according to the Java method Collections.sort().

   g. In the New value field, type the name of the aggregator script file, in this case: GoogleAnalyticsAggregator.js.

   h. Click Add.

   i. Verify that the new parameter is added to the list.

   j. Repeat steps F - I for all aggregators and dependencies.

   k. Click OK to return to the main Page Properties screen.

   l. Click OK to save your changes and return to the Manage Pages screen.

   Note: Child pages inherit the script that is set on the parent page. If you want to use a different aggregator on a child page, follow the same procedure that is previously addressed for the child page to make the appropriate assignment. If you want to block inheriting the aggregator setting from the parent page, follow the same procedure, but leave the value empty. As a result, the page has no aggregator that is assigned any longer, and all child pages of the parent page inherit the new setting.
3. Log in to your Google Analytics account and obtain the GA_MEASUREMENT_ID in your Google Analytics Dashboard. It is also referred to as Tracking ID.
   Example:

   

4. Add the following metadata in your target HCL DX page(s) properties:
   • asa_dependency: https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID
   • asa_aggregator: GoogleAnalyticsAggregator.js
   • asa_js_ga_measurement_id: GA_MEASUREMENT_ID
   Example:

   

   Optionally, you can register the Active Site Analytics tags/microformats as custom dimensions or metrics in the Google Analytics Dashboard and configure the aggregator to use your custom map. See Google Analytics Custom Dimensions & Metrics.

   For a list of Active Site Analytics tags associated with HCL DX site pages that can be tracked by the Google Analytics Aggregator, see How Active Site Analytics data is represented in the portal and Supported aggregator tags.

   

5. Access the HCL Digital Experience site page analytics from Google Analytics analyze HCL DX site activity.

   After installing and configuring the aggregator to track analytics from specific HCL DX site pages using the steps above, DX content authors and site owners with access to Google Analytics can view the DX site activity tracked and reflected in Google Analytics Dashboard's real-time reports as an increase in the pageviews and active users.

   See the following example:

   

   Refer to the Analytics tags and site promotions topics for more information on how to add additional tags and site promotions in addition to the out-of-the-box ones.

asa_js_ga.optout: true

window['ga-disable-GA_MEASUREMENT_ID']  = true