Content Recommender module

Edition

Incubator (services)

Issues

Git

Git

Latest

2.0.4

Compatible with Magnolia 6.2, 6.1, 5.7, 5.6.

The Content Recommender module provides relevant content based on the user’s journey in real time. It allows for assigning scores based on page visits or how the user interacts with your content, such as clicking links or playing media.

This module is at the INCUBATOR level.

Installing with Maven

Maven is the easiest way to install the module. Add the following to your bundle:

<dependency>
  <groupId>info.magnolia.recommendation</groupId>
  <artifactId>magnolia-recommender</artifactId>
  <version>2.0.4</version>
</dependency>

Usage

Scoring helps to identify interest in certain products, product groups, services, or topics. The identified interest scores help you to display personalized experiences.

This section is a general introduction to usage. For version-specific usage, please see:

Understanding score models

Score models identify a customer’s interest when they browse your site. Their interest is captured in the form of interest points. For example, events like clicking links or page visits indicate interest on certain topics. Watching a video or interacting with the page may indicate even higher interest. These important events make up a dimension of the score model.

Not every interaction indicates the same amount of interest. Therefore you can adjust the number of value points to be assigned per specific event. Score assignment can be fine-tuned by first visit, recency, and frequency. For example, frequent and recent visits normally indicate a strong interest in a topic and should be weighted higher than points assigned for a first time visit.

Together these events, their weights, and frequencies make up the score model.

Assigning score models

Score models can be assigned in a couple different ways. They can be applied directly in the Pages app or in your custom content apps.

  • Page view scoring is handled in the browser subapp. Click Edit Score Model, then assign points for visiting that page.

  • Scoring interactions with components is handled in the page editor. Use the Score model assignment tab in the component dialog.

Using centralized analytics

The module does not collect any analytics data. However, integration into your existing analytics solution is straightforward. Extend the recommender.js file and add custom tracking events in the MgnlScoreModel#trackEvent() method.

Here are some links that should help determine how to add the events.

Changelog

Version Notes

2.0.4

2.0.3

No changes.

2.0.2

Migration demo to mtk2.

2.0.1

Migration to Magnolia 6.2.

1.0.5-SNAPSHOT

1.0.3

Skip

1.0.2

Centralized score model assignment.

1.0.1

Initial release of the extensions version of the module.

Feedback

Incubators

×

Location

This widget lets you know where you are on the docs site.

You are currently perusing through the Content Recommender module docs.

Main doc sections

DX Core Headless PaaS Legacy Cloud Incubator modules