This topic describes how to install and configure tracking to Episerver Profile Store, the Episerver Customer Data Platform. You can install tracking to any source. See Install and configure tracking.
In this topic
As part of the onboarding for the tracking service, Episerver sends the required subscription keys and tracking URLs to the technical contact for your project. Use the keys to configure the tracking for your websites. Contact Episerver for questions regarding the onboarding process.
You need Visual Studio, and the Episerver Visual Studio extensions, to install the sample site used in the example. See also Installing Episerver to learn how to add the Episerver NuGet feed to Visual Studio.
This example creates an Episerver CMS sample site (Alloy), and adds tracking components using Visual Studio.
<add key="episerver:profiles.TrackingApiBaseUrl" value="" /> <add key="episerver:tracking.Enabled" value="true" /> <add key="episerver:profiles.ProfileStoreTrackingEnabled" value="true" /> <add key="episerver:profiles.TrackingApiSubscriptionKey" value="tracking subscription key for your profile store account" />
Note: Both episerver:tracking.Enabled and episerver:profiles.ProfileStoreTrackingEnabled values must be set to true to track data to Profile Store.
<add key="episerver:tracking.IgnoreDNT" value="true" />
The CMS integration package for Profile Store tracking contains some additions to tracking, for example scope handling. You should install this package on an Episerver CMS site.
Enter install-package EPiServer.Tracking.Cms at the Package Manager console prompt (PM>).
You can isolate tracking events and profiles using scopes.
A scope separates tracking requests to the site ID of the site where data was tracked. The default implementation for a scope when installing EPiServer.Tracking.Cms is the SiteId for the site from which the tracking event was sent. Tracking events sent from a multi-site therefore are isolated in its different sites.
You can modify this behavior by setting the scope in one of the following ways:
In web.config, go to the <appSettings> section, and change value of ProfileStoreTrackingEnable to true. Also, add a new key episerver:profiles.Scope.
Note: Keep the scope values lowercased.
<add key="episerver:profiles.ProfileStoreTrackingEnabled" value="true" /> <add key="episerver:profiles.Scope" value="defaultscope" />
Note: You can override the implementation for Scope in configuration file by setting episerver:profiles.Scope to the value you choose.
Last updated: Dec 27, 2017