Install and configure the native integration package
The native integration provides the product-specific setup when implementing personalization for Optimizely solutions.
The native integration package is available via the Optimizely NuGet feed. See also Install and configure recommendations.
After installing it, you must modify the configuration to include settings for your Product Recommendations environment. Recommendations reads its configuration from the<appSettings> section. The following keys are used.
Recommendation keys
Key | Description |
|---|---|
`episerver:tracking.Enabled` | Indicates if the Tracking system will execute tracking. |
`episerver:personalization.BaseApiUrl` | The URL of the Optimizely Product Recommendations environment to use. This should only contain the protocol and host name. Note: Never use UAT endpoints in production for this key. |
`episerver:personalization.Site` | The site name used to identify requests to the tracking server. |
`episerver:personalization.ClientToken` | The token used to authenticate tracking requests to the REST API. |
`episerver:personalization.AdminToken` | The token used to authenticate admin requests to the REST API. |
`episerver:personalization.RequestTimeout` | * \* native in \*\*Timeout for the REST calls. The default value is 30 seconds. |
`episerver:personalization.TrackingMode` | * \* native inThe tracking mode to use. Acceptable values areServerSide andClientSide.\ The default value is ServerSide.\ To use the client side (JavaScript) tracking APIs, set the value to ClientSide\*\*. |
`episerver:personalization.SkipUserHostTracking`\ c setup when implementing personalization for O | * \* native inLets you exclude user IP address from tracking data. Set toTrueto omit IP address from tracking, which may reduce recommendation accuracy. Default value isFalse\*\*. |
`episerver:personalization.UsePseudonymousUserId`\ setup when implementing personalization for Op | * \* native in Controls whether the pseudonymous user identifier is used instead of user email address in tracking data. Set toTrue to omit email address from tracking and use Contact Id instead. Default value isFalse\*\*. |
`episerver:personalization.CatalogFeedBatchSize` | * \* native in \*\*The number of products processed in one batch when the product feed is generated. A higher value can be faster but puts more pressure on the memory. The default value is 50. |
`episerver:personalization.CatalogNameForFeed` | * \* native in\*\* Select the catalog used to generate the product feed if you have multiple catalogs. If this value is not set, the first catalog is used. * \*Note: \*\*This property will be removed when Product feed support for multiple catalogs is added. |
The export function has a few settings in addition to those above. Apply them via code on the default CatalogFeedSettings instance.
var catalogFeedSettings = ServiceLocator.Current.GetInstance<CatalogFeedSettings>();
catalogFeedSettings.DescriptionPropertyName = "...";Property | Description |
|---|---|
ExcludedAttributes | Names of product properties to exclude from the catalog feed. |
DescriptionPropertyName | The product feed requires each product to have a description. Set this to a property name you want to use as description. Default value is Description. |
AssetGroupName | The first asset (ordered by SortOrder) in this group is used for the item's image link. The default value is default. |
Note Differences between the authentication mechanism of EPiServer.ServiceAPI and EPiServer.Personalization.Commerce may lead to the incorrect functioning of user change tracking or catalog feed download. To avoid these problems, it is recommended to install EPiServer.ServiceAPI in a separate application.