makj
Jan 8, 2019
  3804
(2 votes)

Episerver Advance content recommendations block

As you probably have heard we launched Episerver Advance earlier this year. Advance is the latest addition to our personalization suite and is a service for content personalization and enables you to recommend content to your visitors at any given time that vary based on their experience and needs.

How it works

The process can be described with the following steps:

  1. Track – every interaction with your site is tracked back to Episerver Advance.
  2. Create – your editors create content, preferably lots of it and diverse.
  3. Analyze – the machine learning algorithms analyze tracking behavior and content.
  4. Visualize – the service sends recommendations back to the user based on the analysis.

Getting started

As an example and help you get stared with Episerver Advance we have created a block available on Github, https://github.com/episerver/ContentRecommendationBlock. The block shows a number of recommended pages set by the editor to the visitor. No styling has been added to the block but what that’s not a priority here.

I have set the content recommendations block up on a clean Alloy site. The first thing that needs to be done is getting an Advance account. When ordering Advance, you will get configs for both tracking and getting recommendations that need to add to your web.config.

The next step is to install nuget-packages. The packages needed are EPiServer.Tracking.PageView and Episerver.Personalization.CMS. EPiServer.Tracking.PageView is for tracking and Episerver.Personalization.CMS is the one used for getting the recommendations. The packages need the configs for your Advance account and can now be set.

EPiServer.Tracking.PageView:

<add key="episerver:profiles.TrackingApiBaseUrl" value="ChangeThis" />
<add key="episerver:profiles.TrackingApiSubscriptionKey" value="ChangeThis" />
<add key="episerver:profiles.ProfileStoreTrackingEnabled" value="false" />

Episerver.Personalization.CMS:

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

The tracking needed for Advance is, as you might have figured from the name of the package, pageviews. Using the package, we add [PageViewTracking] to the page controller methods we want to track, as below. Add tracking to all as many of your pages as possible, the more the better.

public class DefaultPageController : PageControllerBase<SitePageData>
    {
        [PageViewTracking]
        public ViewResult Index(SitePageData currentPage)
        {
		...
        }    

Next, I just added the project to my alloy site. The content recommendation block is using an API-call to get the recommendations, so I needed to add the following to the route config:

System.Web.Http.GlobalConfiguration.Configure(config =>
         {
	    config.MapHttpAttributeRoutes();
	    config.Routes.MapHttpRoute(name: “DefaultApi”, routeTemplate: “api/{controller}/{action}”, defaults: new { id = RouteParameter.Optional });
         });

That’s it! When creating the block on the site there is only one property available for the editor.

And then on the site the block containing the links.

Jan 08, 2019

Comments

Janne Kuusela Kuusela
Janne Kuusela Kuusela Nov 14, 2019 08:21 AM

It is great that I can install some ready-made package and get recommendations. However it would be really interesting to understand a bit more the added value of this, for example by getting answer to the following:

  • What is the logic behind the gives you the recommendations?
  • How if anyway can developer or content editor affect the recommendations?
  • Is this any how related to the personalization portal? If we have Advance and personalization portal provisioned for our customer, what should we expect to see on the personalization portal?

Episerver has ramped up a variety of personalization products and services, but most of the really good and well explained examples are related to commerce, where the logics behind recommendations are somewhat more clear and common (popular products, both together with currently browsed product etc.)

I am personally having really hard time to find any solid documentation, examples and explanations for Episerver personalization products for customer that just dont have commerce. Sure there is load of articles about setting up this and that, but still it is really difficult to create solid picture of what to expect from personalization of content, not products.

Please login to comment.
Latest blogs
How I Fixed DLL Conflicts During EPiServer CMS Upgrade to .NET Framework 4.8.1

We had a CMS solution of EPiServer 11.26.0, which was built on .NET Framework 4.7.1. We needed to update the target framework from .NET Framework...

calimat | Dec 12, 2024

Custom form element view in Optimizely CMS 12

Do you want full control over the form element markup? Create your own views!

Tomas Hensrud Gulla | Dec 11, 2024 | Syndicated blog

How to Elevate Your Experimentation - Opticon workshop experience

As a non-expert in the field of experimentation, I’d like to share my feedback on the recent Opticon San Antonio workshop session titled "How to...

David Ortiz | Dec 11, 2024

Persisting a Strawberry Shake GraphQL Client for Optimizely's Content Graph

A recent CMS project used Strawberry Shake to generate an up-to-date C# GraphQL client at each build. But what happens to the build if the GraphQL...

Nicholas Sideras | Dec 11, 2024 | Syndicated blog

Opti ID with Secure Cookies And Third Party AddOns

Opti ID has revolutionised access to the Optimizely One suite and is now the preferred authentication method on all PAAS CMS websites that I build....

Mark Stott | Dec 9, 2024

AsyncHelper can be considered harmful

.NET developers have been in the transition to move from synchronous APIs to asynchronous API. That was boosted a lot by await/async keyword of C#...

Quan Mai | Dec 4, 2024 | Syndicated blog