Google Analytics provides a number of powerful features that allows you to get a good understanding of the user journey across all of your digital properties. The Datazoom Google Analytics Connector helps fill in the blanks when it comes to video consumed on your digital properties.

This document assumes you have a Google Analytics account and have deployed the requisite Global Site Tag (gtag.js) as per Google's instructions.

Datazoom → Google Analytics

Datazoom passes collected FluxData and Metadata data points to Google Analytics via custom mappings that you will need to configure in your account to enhance the data collected. Event data points get passed automatically. In addition, if you don't already have this configured, you'll need to enable the User-ID feature in order to align user sessions with player sessions.

User-ID

You'll need Administrative rights to enable the User-ID feature of Google Analytics.

The following screens are displayed when clicking on User-ID:

Please review the User-ID policy then enable if you agree. Click "Next step"

Scroll to the bottom of the page then click "Next step"

Click "Create"

Give the reporting view a name. It's good practice to include the term "User ID" in the name to help you remember that this is a special User-ID view.

Set the location and time zone.

Enable "Show User-Id Reports"

Scroll down and click "Create View"

Custom Dimensions:

You'll need Administrative rights to setup your Custom Dimensions.

The following screens are displayed when clicking on Custom Dimensions.

Example Custom Dimensions:

Setting up Custom Dimensions:

Navigate to the Custom Dimensions screen. When you click the + New Custom Dimension button you will see the following item:

Building the Custom Dimension Index Mapping:

Using the both Custom Dimension names and Custom Metrics names along with their related Index values, you'll need to setup a text file that follows the formatting illustrated below where "Custom_Dimension" is the name that you copied from the Datazoom Dictionary, and "1" is the Index number assigned to that Name within Google Analytics.

Example:

{
  "dimensions": {
	"session_id": "1",
	"googleAnalyticsClientId": "2",
	"timestamp": "3",
	"configuration_id": "4",
	"dzSdkVersion": "5",
	"viewId": "6",
	"milestonePercent": "7",
	"adId": "8",
	"autoStart": "9",
	"playerName": "10",
	"playerVersion": "11",
	"playerState": "12",
	"streamingType": "13",
	"device_id": "14",
	"deviceType": "15",
	"os": "16",
	"osVersion": "17",
	"user_agent": "18",
	"title": "19",
	"videoType": "20"
  },
  "metrics": {
  }
}

Creating the Connector:

If you are not familiar with the process to add a Connector, follow the directions here on How to Add a Connector.

Select the Google Analytics integration from the Connector setup screen. Be sure to have your Google Analytics Tracking Id and the Custom Configuration created above handy.

Enter your Tracking ID and copy/paste the Custom Dimension Index Mapping from the text file as created above, then Save Changes

Once complete you can add Google Analytics to a Data Pipe as covered in the How to Configure a Data Pipe document.

Please do select the User Agent data point when configuring your Data Pipe. This will ensure your data is attributed to the correct browser in Google Analytics.

googleAnalyticsClientId

In some cases you may want to attribute the events and data points that Datazoom collects with a specific user.  In order to do so you will need to include a custom metadata item on your page or app. Please review our Sending Custom Events and Custom Metadata doc at the section titled "Custom Metadata Reserved Names" for more info.