Page events - personalization

Abstract

Guide to how personalization events are mapped from Sitecore 8.x to 9 in xDB Migration Tool.

This section describes how events triggered by personalization are mapped from Sitecore 8.x to 9.

Note

For background information on page events, see the Page events page.

Format in Sitecore 8.x

In Sitecore 8.x, the information about the personalized elements that were included when a specific page view was rendered is represented on the page.

The following is an example of a page view with MV test information from an interaction:

{
    "DateTime" : ISODate("2018-01-01T09:00:00.000Z"),
    "Duration" : 0,
    "Item" : {
        "_id" : NUUID("d8983ebf-6557-4af1-ace3-38e04a746bfa"),
        "Language" : "en",
        "Version" : 3
    },
    "SitecoreDevice" : {
        "_id" : NUUID("3d18c8d7-e96e-4e7f-bf28-edbd39428568"),
        "Name" : "Default"
    },
    "PersonalizationData" : {
        "ExposedRules" : [
            {
                "RuleSetId" : NUUID("b2e9c0b8-092e-4ea9-ae21-f3f86c90c463"),
                "RuleId" : NUUID("00000000-0000-0000-0000-000000000000")
            },
            {
                "RuleSetId" : NUUID("74316c30-a234-472b-8311-7b563c7832f4"),
                "RuleId" : NUUID("00000000-0000-0000-0000-000000000000")
            },
        ]
    },
    "Url" : {
        "Path" : "/Home/Locations"
    },
    "VisitPageIndex" : 1
}

Format in Sitecore 9

In Sitecore 9, personalization information is associated with a page view event through an event:

Source object	Member of the array located at `Pages` on the interaction document
Event mapping definition	Personalization Event Mappings for MongoDB Page Events > Personalization Event
Event object type	`Sitecore.ContentTesting.Model.xConnect.PersonalizationEvent`
Conditions	The event matching process does not apply to this event because the event data is not included in the `PageEvents` array on the page
Field mapping definition	MongoDB to xConnect Event Mappings > MongoDB Personalization Data to xConnect Personalization Event

Mapping event properties

Value to write to event object	Property on event object
`PersonalizationData.ExposedRules` from source object	`ExposedRules`

Mapping exposed rules

The property ExposedRules on the event is a list of personalization rule data objects.

Source object	Member of the array located at `PersonalizationData.ExposedRules` on the interaction document
Data object type	`Sitecore.ContentTesting.Model.xConnect.PersonalizationRuleData`
Field mapping definition	MongoDB to xConnect Event Mappings > MongoDB Exposed Rule to xConnect Personalization Rule Data

Value to write to event object	Property on event object
`RuleId` from source object	`RuleId`
`RuleSetId` from source object	`RuleSetId`