Web visit facet

Abstract

Guide to how information about web visits are mapped from Sitecore 8.x to 9 in xDB Migration Tool.

Format in Sitecore 8.x

In Sitecore 8.x, information about the web visit represented by the interaction is stored in a variety of places on the interaction.

The following is an example of an interaction with the web visit data:

"Browser" : {
    "BrowserVersion" : "51.0",
    "BrowserMajorName" : "Chrome",
    "BrowserMinorName" : "51.0"
},
"OperatingSystem" : {
    "_id" : "WinNT",
    "MajorVersion" : 6,
    "MinorVersion" : 1
},
"Screen" : {
    "ScreenHeight" : 480,
    "ScreenWidth" : 640
},
"Language" : "en",
"Referrer" : "https://www.sitecore.com/",
"SiteName" : "www",

Format in Sitecore 9

In Sitecore 9, web visit information is associated with an interaction through an interaction facet:

Facet Name	`WebVisit`
Facet Type	`Sitecore.XConnect.Collection.Model.WebVisit`

Mapping facet properties

Mapping definition

MongoDB to xConnect Interaction Mappings > MongoDB Interaction to xConnect Interaction WebVisit Facet

Value to write to target object	Property on target object
`Language` from source object	`Language`
`Referrer` from source object	`Referrer`
`SiteName` from source object	`SiteName`

The following facet properties are objects that require their own mappings:

Facet Property	Description
`Browser`	see Mapping Browser Data Properties
`OperatingSystem`	see Mapping Operating System Data Properties
`Screen`	see Mapping Screen Data Properties

Mapping Browser Data Properties

Source object	The field located at `Browser` on the interaction document
Target object	`Sitecore.XConnect.Collection.Model.BrowserData`
Mapping definition	MongoDB to xConnect Interaction Mappings > MongoDB Interaction to xConnect Browser Data

Value to write to target object	Property on target object
`Browser.BrowserVersion` from source object	`BrowserVersion`
`Browser.BrowserMajorName` from source object	`BrowserMajorName`
`Browser.BrowserMinorName` from source object	`BrowserMinorName`

Mapping operating system data properties

Source object	The field located at `OperatingSystem` on the interaction document
Target object	`Sitecore.XConnect.Collection.Model.OperatingSystemData`
Mapping definition	MongoDB to xConnect Interaction Mappings > MongoDB Interaction to xConnect Operating System Data

Value to write to target object	Property on target object
`OperatingSystem._id` from source object	`Name`
`OperatingSystem.MajorVersion` from source object	`MajorVersion`
`OperatingSystem.MinorVersion` from source object	`MinorVersion`

Mapping screen data properties

Source object	The field located at `Screen` on the interaction document
Target object	`Sitecore.XConnect.Collection.Model.ScreenData`
Mapping definition	MongoDB to xConnect Interaction Mappings > MongoDB Interaction to xConnect Screen Data

Value to write to target object	Property on target object
`Screen.ScreenHeight` from source object	`ScreenHeight`
`Screen.ScreenWidth` from source object	`ScreenWidth`