Dispatch

This section describes how the dispatch process works with a Google Analytics UA property as a destination.

danger

Universal Analytics will no longer process new data in standard properties beginning July 1, 2023. Uniform for Sitecore now supports dispatching analytics data to Google Analytics 4.

Event mapping#

During the dispatch process, visit activity captured by the Uniform tracker is converted into non-interaction events. This section details the properties set on these events.

Page views#

Property	Value
Category	Sitecore Page View
Action	ID of the Sitecore item that represents the page
Label	Name of the Sitecore item that represents the page
Value	-

Page events#

Property	Value
Category	Sitecore Event
Action	Name of the Sitecore item that represents the page event
Label	-
Value	Page event points

Goals#

Property	Value
Category	Sitecore Goal
Action	Name of the Sitecore item that represents the goal^*
Label	-
Value	Goal points

^* Goals can be triggered by being included as a query string parameter. When a goal is triggered in this way, neither the name of the Sitecore item that represents the goal nor the points assigned to the goal are unavailable. In this case, the event action is set to the parameter value and no goal points are assigned.

Personalization#

Property	Value
Category	Uniform Personalization
Action	Combination of the name of the page and the name of the component that was personalized (values are separated by the \| character)
Label	Name of the rule that was triggered
Value	1 if visitor included in Uniform test; 0 otherwise

Visitor data mapping#

Visitor data is mapped from Uniform to Google Analytics using custom dimensions. This mapping is configured using the following Sitecore templates:

Contact Property Mapping - Associates a visitor property collected by the Uniform tracker with a specific custom dimension defined in Google Analytics.
Profile Pattern Mapping - Associates the pattern from a specific Sitecore profile that a visitor matches with a specific custom dimension defined in Google Analytics. By default, the pattern name is used as the value for the custom dimension.
Custom Dimension Mappings Folder - Collection of individual mapping items that are used during the dispatch process.
Tracking Configuration - Item that creates a relationship between the following objects:
- Sitecore sites
- Google Analytics properties
- Custom dimension mappings folder

Data shape for dispatch#

If you need to implement the OnBeforeDispatchDataHandler, the following defines the shape of the data that you transform.

info

In order for the dispatch process to work properly, you must return an object with this shape.

{  "type":"ga",  "data":{    "event":{      "category":"Sitecore Page View",      "action":"bdb0d562-cbcb-4e69-b363-81d2694fb50c",      "label":"Home",      "value":0    },    "fields":{      "nonInteraction":true    }  }}