This documentation supports the 20.08 version of BMC Digital Workplace Basic, which is available only to BMC Helix subscribers (SaaS).
To view an earlier version, select the version from the Product Version menu.

Using Google Analytics and Mixpanel Analytics to collect and analyze usage data

You can use Google Analytics and Mixpanel Analytics to collect and analyze usage data. Google Analytics enables BMC customers to track their activity in BMC Digital Workplace without sharing it with third parties. Mixpanel Analytics enables BMC support to track end users' activity in BMC Digital Workplace. The following data is currently available for analytics:

  • Technology data such as browser, operating system, and devices used.
  • User-specific data such as location, traffic by time of day, source of traffic, and search keywords.

Before you begin

To enable Google Analytics, you must specify the Tracking ID. For an overview on Google Analytics, and to get a tracking ID, see Get started with Analytics .

To set up data collection by using your Google Analytics account

After you create your Google Analytics account, configure your account by clicking  on the Analytics page.


BMC recommends using separate Tracking IDs for your test and production environments. This will help segregate the data used for analytics.

To enable Google Analytics

By default, Google Analytics is disabled. To enable Google Analytics in BMC Digital Workplace:

  1. In the BMC Digital Workplace Admin console, click Configuration.
  2. In the left panel, click Analytics.
  3. On the Analytics page, turn on the Google Analytics toggle key.
  4. Specify your Google Analytics Tracking ID.
  5. Click Save.
    To disable Google Analytics, turn off the Google Analytics toggle.

The following screenshot displays the Digital Workplace Analytics page:

To verify Google Analytics data collection

  1. Use two or more accounts and log in to BMC Digital Workplace.
  2. Use the search bar to enter various search terms, and go to various screens in the user interface.

  3. Wait for approximately 30 minutes to allow the analytics data to be populated in your account.

  4. Log in to your Google Analytics account, and view the following information:

    • From the Google Analytics Home page, view the summary of the number of users, log in time, locations, Page visit, and devices.
    • From the left pane, click Behavior > Site Search > Search Terms to view the search terms.

To enable Mixpanel Analytics 

To enable and configure Mixpanel Analytics, you must first update your BMC Digital Workplace environment script.

To update your BMC Digital Workplace environment script

Update your environment script before using the script to enable Mixpanel Analytics for BMC Digital Workplace. 

If you have a multitenant environment, see Configuring multitenancy.
  1. On the BMC Digital Workplace server, move the tenant-config.jar file from DWP_HOME/tenant-config to a folder with scripts:
    • (LinuxDWP_HOME/tenant-config/scripts/linux
    • (WindowsDWP_HOME\tenant-config\scripts\win
  2. (Optional) To run the tenant configuration utility on a server other than the BMC Digital Workplace server, copy the scripts/linux or scripts\win folders from the BMC Digital Workplace server to the server that will run the utility.
  3. In the \scripts directory, locate the set_env.bat or script.

  4. Use a text editor such as Notepad, edit the set_env.bat or script and enter the following values for the different variables:





    JRE installation path.

    RequiredPath to the tenant-config- file.
    RequiredDWP server API token.
    RequiredDWP server API secret value.
    RequiredTenant name. You should see a default tenant with the name 000000000000001.
  5. Save and close the set_env.bat  or script.

  6. (Optional) Test the utility by running the following command:

    • (Linux)

    • (Windows) list_tenants.bat

To enable Mixpanel Analytics in BMC Digital Workplace

After updating your BMC Digital Workplace environment script, you must run the script to enable Mixpanel Analytics .

  1. Navigate to the tenant-config scripts folder:
    • (LinuxDWP_HOME/tenant-config/scripts/linux
    • (WindowsDWP_HOME\tenant-config\scripts\win

2. Use a text editor such as Notepad, edit the enable_analytics.bat or script and enter the following values for the different variables:

set analytics_nameRequiredCustomer/tenant name.
set analytics_global_keyRequired

Mixpanel Analytics global key.

set analytics_customer_keyOptionalMixpanel Analytics customer key.

        3. Save and close the enable_analytics.bat  or script.

        4. Run the enable_analytics.bat  or script.

To disable Mixpanel Analytics in BMC Digital Workplace


Only BMC DevOps team can enable Mixpanel Analytics.

  1. In the BMC Digital Workplace Admin console, click Configuration.
  2. In the left panel, click Analytics.
  3. On the Digital Workplace Analytics page, turn off the Help Improve Digital Workplace toggle.
  4. Click Save.

Was this page helpful? Yes No Submitting... Thank you