HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideLegal TermsGitHubNuGetDev CommunitySubmit a ticketLog In

Use Tracking.Core API with Profile Store

Describes how to use the EPiServer.Tracking.Core API with Optimizely Profile Store, including installation and configuration of the tracking.


Configure the API URLs and subscription keys:

<add key="episerver:profiles.TrackingApiBaseUrl" value="https://" ... >
    <add key="episerver:profiles.TrackingApiSubscriptionKey" value="..." ... >
    <add key="episerver:profiles.ProfileStoreTrackingEnabled" value="true" ... >
    <add key="episerver:tracking.Enabled" value="true">
    <add key="episerver:tracking.IgnoreDNT" value="true">



See Do Not Track and Turn "Do not track" on or off for information about Do not Track (DNT)

Install EPiServer.Profiles.Client

  1. Install the EPiServer.Profiles.Client NuGet package from Optimizely NuGet source to your site by entering the following command at the Package manager prompt (PM>).

    install-package episerver.profiles.client
  2. In web.config, fill tracking baseUrl and subscriptionKey values in appsetting section.

    <add key="episerver:profiles.TrackingApiBaseUrl" value="ChangeThis" />
    <add key="episerver:profiles.TrackingApiSubscriptionKey" value="ChangeThis" />
  3. Set the following:

  4. Optionally, specify episerver:profiles.Scope = <default scope you want to send>. The default Scope must be lowercase and cannot include special characters such as: + - _ \ / # < > ...

  5. Verify your tracking data in Insight UI.

Install EPiServer.Tracking.Core

Install the EPiServer.Tracking.Core NuGet package from the Optimizely NuGet source to your site.

Track data

See Tracking for information about how to track data.