IP info facet

Abstract

Guide to how information about the location of a visitor are mapped from Sitecore 8.x to 9 in xDB Migration Tool.

In Sitecore 8.x, settings that store information about the location of the visitor are associated with the interaction. Most of the information is stored in a property named GeoData on the interaction. Some of the information is stored directly on the interaction.

The following is an example of an interaction with the GeoData property:

"GeoData" : {
    "AreaCode" : "N/A",
    "BusinessName" : "The Garrison",
    "City" : "Birmingham",
    "Country" : "GB",
    "Dns" : "N/A",
    "Isp" : "Birmingnet",
    "Latitude" : 52.489471,
    "Longitude" : -1.898575,
    "MetroCode" : "N/A",
    "PostalCode" : "7DA",
    "Region" : "B4",
    "Url" : "N/A"
},
"Ip" : { "$binary" : "fwAAAQ==", "$type" : "00" },
"Language" : "en",

In Sitecore 9, visitor location information is associated with an interaction through an interaction facet:

Facet Name

IpInfo

Facet Type

Sitecore.XConnect.Collection.Model.IpInfo

Mapping definition

MongoDB to xConnect Interaction Mappings > MongoDB Interaction to xConnect Interaction IpInfo Facet

Value to write to target object

Property on target object

GeoData.AreaCode from source object

AreaCode

GeoData.BusinessName from source object

BusinessName

GeoData.City from source object

City

GeoData.Country from source object

Country

GeoData.Dns from source object

Dns

IpAddress from source object

IpAddress

LocationId from source object

LocationId

GeoData.MetroCode from source object

MetroCode

GeoData.PostalCode from source object

PostalCode

GeoData.Region from source object

Region

GeoData.Url from source object

Url