Huy Ngo
May 30, 2019
(1 votes)

EPiServer.Personalization.CMS.UI.1.0.0 has been released

We've released the EPiServer.Personalization.CMS.UI.1.0.0 (Strategy Container Block) a few days ago. Here is some information regarding it.

EPiServer Strategy Container Block is added in to retrieve recommendation data from Advance API. I’m assuming you want to create a block on the page that has a mission to provide users suggestions which is the most suited to their strategy (popular content, most viewed…).

· Go to Episerver edit mode, add a new page (for example a standard page) and add a new block

In block type listing view, chose Strategy Block

  • In All Properties, you can modify the block settings:
    1. Default Strategy: Set a strategy as default.
    2. The number of recommendations: The maximum number of recommendation items you want to show in the block (the actual number may be fewer).
  • Click create in order to add the block to the page

  • If successfully, the block should be added as below

  • In On-Page Editing view, you can choose another strategy for current page only (other than the default one which is set in “All Properties” of block, this change will remain in the current page only)

Note: In order to make it work, Advance API must have input for its tracking and analyzing. Make sure that your site has installed EPiServer.Tracking.PageView and config as the following guideline:

And config tracking as the following guideline


In order to use Advance service, please update RecommendationServiceKey, RecommendationServiceSecret and RecommendationServiceUri in your web.config

 For example, change those in your web.config:

 <add key="episerver:RecommendationServiceKey" value="ChangeThis" />

<add key="episerver:RecommendationServiceSecret" value="ChangeThis" />

<add key="episerver:RecommendationServiceUri" value="ChangeThis" />

 with your Advance keys, like this:

<add key="episerver:RecommendationServiceKey" value="PlhPaQNJaB3F0kesWXubaK5Y2cVJb7WequvmOVyvCjRzpZAc" />

<add key="episerver:RecommendationServiceSecret" value="PygCfBib47wx+tGThNWU0sy67dwztDbmUc4lKcLLvlyO5bDGIYDBVf9o7ZQijINC" />

<add key="episerver:RecommendationServiceUri" value="" />


Tech note: Advance API will remove recommendations for in-active content once a day. (Content which is permanently deleted, move to trash or no one visited for a day will not appear in Recommendations). To avoid the missing number of recommendations, we will get 5 more recommendations to replace/backup for invalid (deleted) contents.

When no strategy is chosen for the strategy block, the recommendations are suggested by the Advance default strategy.

Known issue:  Currently, Advance service recommended by contentId. If a site has too many untranslated pages, the number of recommending pages might not enough or don’t have any recommendation at all.

May 30, 2019


Please login to comment.
Latest blogs
Optimizely community meetup - Sept 29 (virtual + Melbourne)

Super excited to be presenting this Thursday the 29th of September at the Optimizely community meetup. For the full details and RSVP's see the...

Ynze | Sep 27, 2022 | Syndicated blog

Preview multiple Visitor Groups directly while browsing your Optimizely site

Visitor groups are great - it's an easy way to add personalization towards market segments to your site. But it does come with it's own set of...

Allan Thraen | Sep 26, 2022 | Syndicated blog

The Report Center is finally back in Optimizely CMS 12

With Episerver.CMS.UI 12.12.0 the Report Center is finally re-introduced in the core product.

Tomas Hensrud Gulla | Sep 26, 2022 | Syndicated blog

Dynamic Route in ASP.NET Core When MapDynamicControllerRoute Does Not Work

Background Creating one of the add-on for Optimizely I had to deal with challenge to register dynamically route for the API controller. Dynamic rou...

valdis | Sep 25, 2022 | Syndicated blog

404 Error on Static Assets Within an Optimizely plugin

Background With the move to CMS 12 and .NET 5/6, developers are now able to build Plugins and Extensions using Razor Class Libraries (RCL).  These...

Mark Stott | Sep 23, 2022

How to bypass the content creation view in Optimizely

Something that has come up a couple of times in the last few year is feedback from content editors about the editing view that comes up when creati...

Ynze | Sep 23, 2022 | Syndicated blog