Loading...
Area: Episerver Commerce, Episerver Product Recommendations
Applies to versions: EPiServer.Personalization.Commerce 1.0 and higher

Exporting your catalog to Episerver Product Recommendations

To provide accurate and valuable recommendations for Episerver Product Recommendations (formerly Perform), export your catalog to the Episerver Product Recommendations engine on a regular basis. You should schedule the export job to run every 24 hours.

To export a catalog, start your site, enter admin mode, and launch the Export Product Feed scheduled job. If the job finishes with a successful status, your catalog was successfully exported. 

The scheduled job has two parts:

  • Serialize the catalog to XML, compress it, and store it as a blob.
  • Notify Episerver Product Recommendations that a new catalog is available.

To notify Episerver Product Recommendations that a new catalog export is available, the scheduled job calls the Episerver Product Recommendations REST API (via HTTPS) and passes a callback address and an authorization token. When the Product Recommendations engine has the resources to handle downloading the catalog, it calls the specified callback method and passes the token. If the callback method determines that the passed token is valid, the download is allowed.

The callback address is formulated using SiteDefinition.SiteUrl as the host and a static path. It is recommended that the SiteUrl be set to use the HTTPS protocol.

Export overview

Incremental export of the catalog feed

Personalization Commerce version 3.2.7 introduces a scheduled job that exports added/updated products only: Export Catalog Feed Incrementally. This job keeps Episerver personalization up-to-date with product changes without exporting the entire catalog. Because the job exports fewer products, it runs more quickly and provides better performance than the full Export Catalog Feed job. But, the incremental job does not replace the Full Export Catalog Feed job because it does not include the deletion of products nor edits to asset or inventory information.

By default, a maximum of 10,000 products are processed when the Export Catalog Feed Incrementally job runs. You can increase the maximum number of products via the second setting below.

Export Catalog Feed Incrementally job settings

These web.config settings let you modify the Export Catalog Feed Incrementally scheduled job.

Setting Description
episerver:commerce.EnableEventDrivenCatalogFeed Indicates if Episerver Commerce tracks catalog changes for export via the Export Catalog Feed Incrementally scheduled job.
The default setting is false. If false, the job does not run.
episerver:commerce.MaxEntryProcessForIncrementalCatalogFeed The maximum number of products to be processed when the scheduled job is executed. The default setting is 10,000.

Related topics

Do you find this information helpful? Please log in to provide feedback.

Last updated: Jun 07, 2018