Dispatch

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

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#

Dimension	Value
event_category	Sitecore Page View
event_data	A pipe-separated combination of: ID of the Sitecore item that represents the page Name of the Sitecore item that represents the page

Page events#

Dimension	Value
event_category	Sitecore Event
event_data	A pipe-separated combination of: Name of the Sitecore item that represents the page event Page event points

Goals#

Dimension	Value
event_category	Sitecore Goal
event_data	A pipe-separated combination of: Name of the Sitecore item that represents the goal^* 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#

Dimension	Value
event_category	Uniform Personalization
event_data	A pipe-separated combination of: Name of the Sitecore item that represents the page Name of the component that was personalized Name of the rule that was triggered 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

Custom dimensions are included in eventParams.

info

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

{  "type":"ga4",  "data":{    "eventName":"uniform_event",    "eventParams":{      "event_category":"Sitecore Page View",      "event_data":"bdb0d562-cbcb-4e69-b363-81d2694fb50c|Home"    }  }}