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.

Tip

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 set_env.sh script.

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

    Variable

    Required/Optional

    Description

    java_homeRequired

    JRE installation path.

    tenant_config_tool_jar
    RequiredPath to the tenant-config-20.08.00.000-BUILD-SNAPSHOT-jar-with-dependencies.jar file.
    myit_server_url
    Requiredhttp://DigitalWorkplaceServer/dwp.
    api_token
    RequiredDWP server API token.
    api_secret
    RequiredDWP server API secret value.
    tenant_name
    RequiredTenant name. You should see a default tenant with the name 000000000000001.
  5. Save and close the set_env.bat  or set_env.sh script.

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

    • (Linux) list_tenants.sh

    • (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 enable_analytics.sh script and enter the following values for the different variables:

VariableRequired/OptionalDescription
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 enable_analytics.sh script.

        4. Run the enable_analytics.bat  or enable_analytics.sh script.


To disable Mixpanel Analytics in BMC Digital Workplace

Important

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

Comments