Page events
Guide to the Page events in xDB Data Migration Tool.
In Sitecore 8.x, the page events for a specific page are captured on the page in the property PageEvents.
The following is an example of a page with the PageEvents property:
{
"DateTime" : ISODate("2018-01-01T12:00:00.000Z"),
"Duration" : 60,
"Item" : {
"_id" : NUUID("506dd1a2-2150-4062-abb8-e029d28af870"),
"Language" : "en",
"Version" : 1
},
"PageEvents" : [
{
"Name" : "Error",
"ItemId" : NUUID("506dd1a2-2150-4062-abb8-e029d28af870"),
"Timestamp" : 0,
"DataKey" : "Presentation error: Data source isn't set or have wrong template...",
"Text" : "Presentation error: Data source isn't set or have wrong template...",
"PageEventDefinitionId" : NUUID("c8bf254a-9ccc-4e16-9009-82b7cd33e4be"),
"DateTime" : ISODate("2018-01-01T12:00:00.000Z"),
"Value" : 0
}
],
}
In Sitecore 9, all events associated with an interaction are stored directly on the interaction. The events are stored in a property named Events.
Rules are used to determine how to convert a Sitecore 8.x page event to a Sitecore 9 event. These rules are called event mapping definitions. Event mapping definitions are configured in Sitecore under the following item:
Tenant Settings > Providers > xConnect > XObject Mapping Settings > XObject Mapping Definitions > Event Mappings for MongoDB Page Events
Each event mapping definition has several components:
Event object type - This object type is used to store the event data. The type inherits from
Sitecore.XConnect.Event.Conditions - Determines whether the mapping definition is appropriate for the page event, usually by checking the page event definition id. The mapping definition is only used if all of the selected conditions are true.
Field mapping set - The mappings in the specified mapping set are used populate the properties on the event object.
Important
Each page event has a property ParentEventId. This property is used to associate the page event with the page view event.
This property is set to the page view event that is created in Sitecore 9, but it is not a mapped value. Mapping is only used for values that come from outside of Sitecore 9.
All page events described on this page include the following mappings:
Value to write to event object | Property on event object |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
This section describes how campaign events are mapped from Sitecore 8.x to 9.
Source object | Member of the array located at |
Event mapping definition | Event Mappings for MongoDB Page Events > Campaign Event |
Event object type |
|
Conditions |
|
Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Campaign Event |
In addition to the common mappings that apply to all page events, the following event properties are also mapped:
Value to write to event object | Property on event object |
|---|---|
|
|
This section describes how download events are mapped from Sitecore 8.x to 9.
Source object | Member of the array located at |
Event mapping definition | Event Mappings for MongoDB Page Events > Download Event |
Event object type |
|
Conditions |
|
Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Event |
In addition to the common mappings that apply to all page events, the following event properties are also mapped:
Value to write to event object | Property on event object |
|---|---|
|
|
This section describes how goal events are mapped from Sitecore 8.x to 9.
Source object | Member of the array located at |
Event mapping definition | Event Mappings for MongoDB Page Events > Goal Event |
Event object type |
|
Conditions |
|
Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Event |
In addition to the common mappings that apply to all page events, the following event properties are also mapped:
Value to write to event object | Property on event object |
|---|---|
|
|
This section describes how search events are mapped from Sitecore 8.x to 9.
Source object | Member of the array located at |
Event mapping definition | Event Mappings for MongoDB Page Events > Search Event |
Event object type |
|
Conditions |
|
Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Search Event |
In addition to the common mappings that apply to all page events, the following event properties are also mapped:
Value to write to event object | Property on event object |
|---|---|
|
|
This section describes how general events are mapped from Sitecore 8.x to 9. A general event is any event is not matched to a specific event type.
Source object | Member of the array located at |
Event mapping definition | Event Mappings for MongoDB Page Events > General Event |
Event object type |
|
Conditions |
|
Field mapping definition | MongoDB to xConnect Event Mappings > MongoDB Page Event to xConnect Event |
Note
If there is a specific event that you do not want to migrate, the exclude condition can be configured on the event mapping definition. This is how the event long running operation is excluded from the migration process.
In addition to the common mappings that apply to all page events, the following event properties are also mapped:
Value to write to event object | Property on event object |
|---|---|
|
|