Commerce Interactions Cache

Abstract

Overview of the Commerce Interactions Cache and the Commerce data it stores.

The Commerce Interactions Cache is represented by the CommerceInteractionsCache class and is similar to the Interactions Cache. It is a calculated facet that stores information about a contact’s commerce interactions and events. The Commerce Interactions Cache is used for behavioral searches when the underlying search provider does not support joins, which is useful when performing segmentation. It is also useful as a caching mechanism when creating personalization rules for use on the storefront site.

The following configuration options are available in the \App_data\config\sitecore\Collection\sc.XConnect.Collection.Model.Commerce.Plugins.xml configuration file, located on the xConnect server role.

You must configure both of the following entries: IContactMergeHandler.CommerceInteractionsCacheHandler and ICalculatedFacetHandler.CommerceInteractionsCacheHandler.

Property

Description

MaximumInteractionCount

Specifies the maximum number of interactions that xDB examines during cache rebuilds or updates.The default value is 42 interactions.

MaximumCacheEntryCount

Specifies the maximum number of items in the cache for a given category, such as goals, page events, and so on.The default value is 50 entries.

MaximumInteractionPeriod

Specifies the maximum period for interactions that xDB uses during cache rebuilds or updates. The default value is 30 days.

Important

The Commerce Interactions Cache is used by the Segmentation Engine. Conditions that rely on interaction data that exceeds MaximumInteractionPeriod might not evaluate correctly. You must configure the interactions cache to suit your automation plan conditions. It is the IContactCommerceInteractionProvider that is used to read and return values from the Commerce Interactions Cache.

The Commerce Interaction Cache contains the following properties.

Property

Description

Orders

Contains a list of the last orders placed by the contact, ordered by order date and time.

AbandonedCarts

Contains a list of the last carts abandoned by the contact.

VisitedCategories

Contains a list of the latest product categories viewed by the contact.

VisitedProducts

Contains a list of the latest products viewed by the contact.

Important

Currently, due to limitations in Azure Search, the following three properties and two models are set to DoNotIndex. This means it is not be possible to query them through xConnect. If you are using SOLR, you can change the configuration and have them searchable.

  • CommerceInteractionsCache.AbandonedCarts

  • CommerceInteractionsCache.VisitedCategories

  • CommerceInteractionsCache.VisitedProducts

  • VisitedCategory

  • VisitedProduct

For more information, see Deploy a custom model.