Track websites with Sitefinity Insight
Turn on tracking
When you have Sitefinity Insight subscription, your Insight account is connected to your Sitefinity Cloud project and initial tracking is enabled for the Staging environment only.
To enable tracking of your Production environment, perform the following:
- Open Sitefinity Cloud Management portal.
- Navigate to Pipelines » Library.
- Open _CUSTOMER_Production_Variables group and set the
sf-env:digitalExperienceCloudConnectorConfig:disableTracking key to False:
By default, it is set to True.
Data centers configuration
Initially, in Sitefinity Cloud two Sitefinity Insight data centers are configured – Staging and Production with different Access keys.
The key for each data center is referenced in the _CUSTOMER_Production_Variables and _CUSTOMER_Staging_Variables and is set appropriately for each environment’s
web.config transformation file during deployment. The actual values are pulled up securely from Azure Key Vault, so that the access keys values are not displayed.
The following screenshot displays the Access key and its value for the Production environment:
Each website name must be mapped to the proper API key for the Sitefinity Insight data center where the site will send data to. It is important that this mapping is set in the
web.config transformation file for each environment.
In the continuous delivery pipeline,
web.config file transformations are used, so that Sitefinity Cloud can support different configurations for the Staging and Production environments. The
Web.Production.config file holds the configurations that are applicable to the Production environment only and the
Web.Staging.config file holds configurations that are applicable for the Staging environment only.
EXAMPLE: The following part of the
web.config demonstrates how to map the API key:
NOTE: The proper mappings for the already existing websites will be added to the project in the initial configuration, provided by the Sitefinity Cloud team.
Tracking a new website
If you want to add another website for tracking, you must map it to the Production or the Staging data center.
To do this perform the following:
- Download the project for development and set it up locally.
For continuous delivery process to work, Sitefinity configurations are read-only in the Cloud and can be edited only locally.
- In Sitefinity CMS backend, navigate to Administration » Settings » Advanced » DigitalExperienceCloudConnector » Mappings Site name <-> API key.
- Click the (?) icon of DataCenterApiKey input field.
- Copy the path to the configuration property.
- Use the copied path to build the string that you must add in the
appSettings section of the
Web.Production.config or the
Web.Staging.config transformation files.
Use the following example: