Skip to Content

Recommendations

Version 9.1 by steven@one-count_com on 2018/07/06 15:29
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

Before setting up your content recommendations please be sure to complete the step-by-step initial configuration process in Config Manager.

 

Let’s Create a Content Recommendation Template! To access the Content Recommendation function click Utilities, and then click Recommendations.    image2018-6-27 21:35:54.png

Your web browser will load a new where you can start the content recommendation process. To begin, click the button Create Recommendation. If you did not mean to arrive at this page click Go back to go back to the last page viewed, otherwise proceed by clicking the Create Recommendation button. 

image2018-6-27 21:36:30.png


You will now see a Create Recommendation screen, with three subheadings underneath for each step, Definition, Algorithms, and Design. All steps are required!

 image2018-6-27 21:37:39.png

Definition

Starting from the Definition tab, fill in the Title box. Enter a title (i.e: Sports Entertainment).  This describes the type of content ads, or articles ONEcount will recommend to known or unknown users browsing content. Next, if desired, type a brief summary in the Description box to describe what tactics will be used in this recommendation widget.

If you want to limit the widget to a specific domain or domains, the domain name (i.e: one-count.com).

Status can be Active or Disabled, when Status is Active this Content Recommendation will be visible to your users. When Disabled, it will not. If you are planning to use this recommendation now, make the Status Active. Proceed to the next phased by clicking the subheading Algorithm, do not click Save yet.

Algorithm

Algorithm prioritizes content based onuser behavior and or behavior of other users in regards to the content being recommended (i.e: a user). Boosting level sets the priority, or “weight” of recommended content based on the specific algorithm chosen. A definition of the different algorithms used is below:

 

image2018-7-5 17:20:23.png

Click Add to define the algorithms that will be used in this widget. Choose from one of the following options:

  1. Trending – Content that is being viewed the most during a given time period, ie., most-popular
  2. Look Alike Content– This algorithm recommends content to a user based on what other users with similar profiles are reading.
  3. Latest – Refers to content from newest pages being created.
  4. Collaborative Filtering – This is based on the amount of content read by the user on a specific topic, combined with the behavior of similar users (ie., look-alikes) on similar topics.
  5. Similar Interest – Content is based on the user’s past reading history. Recommendations are produced based on the articles that the user has already read.

Other Options: If “Ignore previously read items” is switched to “On”, all previously read items will not be recommended to the user again. If switched to “Off”, content may be recommended to the user again despite if they have read it before.

Proceed to the next phased by clicking the subheading Design, do not click Save yet.

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

Failed to execute the [include] macro. Cause: [Current user [null] doesn't have view rights on document [xwiki:Licenses.Code.VelocityMacros]]. Click on this message for details.

Design

Design will allow real-time styling using CSS and a real-time view of changes styling made to content that will be presented to users.

 

The Number of items will set the number/limit of articles that will be presented as recommended content per page the user views.

Display title is a phrase (i.e: “You might also like”, “People like you also liked”, “Trending articles on our site”) emphasizing additional content the user may like.

 

Lastly, the styling of articles (CSS) can be modified by changing/adding/removing text within the CSS box on the right side.

 

For example, locate the “.cr-item-title {” text starting at line 23. Click the end of the text “line-height: 1.5rem;” and hit enter so you land on a new blank line. Type “ background-color: yellow; ” exactly as underlined and you will see that your new code will resemble all other code within the CSS box. 

You will also see your Preview articles change below.  If your feeling ambitious, create another new line after “width: 250px” and enter “box-shadow: 10px 5px 10px 5px; “ and observe changes you’ve made below.

You can only modify CSS here, the HTML code on the left will be generated by ONEcount.. You may now click Save to complete the content recommendation creation process.

You will be presented with this message: Successfully added a recommendation.

 image2018-6-27 21:41:52.png

You can view information about your content recommendation:

1. Search: Allows you to search for a Content Recommendation you’ve created in the past.

2. Sort By: Allows you to sort through your Content Recommendations by Title or ID.

3. Desc/Asc: Allows you to sort your recommendations in ascending or descending order.

4. Rows: Will set the number of recommendations visible on-screen, the options are 10, 50, 100, and 150.

5. Apply: Will execute the search criteria you’ve set in Search, Sort by and Rows.

6. Reset: Will reset the search criteria back to default settings (Search is blank, Sort by is Title and Asc, and Rows are 10)

7. Expansion Arrow: (Click this icon) Will expand into the Known/Unknown Recommendation Hit Ratio window.

Known hit ratio: This is Content Recommendations made to users who are known.

Unknown hit ratio: This is Content Recommendations made to users who are unknown.

8. Edits: Will allow changes to be made to a Content Recommendation in its entirety with exception to its IDs which is automatically created.

9. Delete: Will delete a Content Recommendation.