Wiki source code of Recommendations

Version 8.1 by steven@one-count_com on 2018/07/05 17:20
Show last authors
1 Before setting up your content recommendations please be sure to complete the step-by-step initial configuration process in **[[Config Manager>>doc:Utilities - Configuration Manager (v12\.x)]].**
2
3
4
5 Let’s Create a Content Recommendation Template! To access the Content Recommendation function click **Utilities, **and then click **Recommendations. ** ** [[image:attach:image2018-6-27 21:35:54.png||height="150"]]
6 \\**
7
8 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.** [[image:attach:image2018-6-27 21:36:30.png||height="150"]]
9 \\**
10
11 **
12 **
13
14 You will now see a **Create Recommendation **screen,** **with three subheadings underneath for each step, **Definition, Algorithms, **and **Design. All steps are required!**
15
16 **~ [[image:attach:image2018-6-27 21:37:39.png||height="400"]]**
17
18 = Definition =
19
20 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.
21
22 If you want to limit the widget to a specific domain or domains, the domain name (//i.e: [[one-count.com>>url:http://one-count.com||shape="rect"]])//.
23
24 **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.
25
26 = Algorithm =
27
28 **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:
29
30
31
32 [[image:attach:image2018-7-5 17:20:23.png]]
33
34 Click **Add** to define the algorithms that will be used in this widget. Choose from one of the following options:
35
36 1. **Trending** – Content that is being viewed the most during a given time period, ie., most-popular
37 1. **Look Alike Content**– This algorithm recommends content to a user based on what other users with similar profiles are reading.
38 1. **Latest **– Refers to content from newest pages being created.
39 1. **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.
40 1. **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.
41
42 **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.
43
44 Proceed to the next phased by clicking the subheading **Design**, do not click **Save **yet.
45
46 = Design =
47
48 **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.
49
50
51
52 The **Number of items** will set the number/limit of articles that will be presented as recommended content per page the user views.
53
54 **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.
55
56
57
58 Lastly, the styling of articles (**CSS**) can be modified by changing/adding/removing text within the CSS box on the right side.
59
60
61
62 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.
63
64 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.
65
66 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.
67
68 You will be presented with this message: **Successfully added a recommendation.**
69
70 [[image:attach:image2018-6-27 21:41:52.png||height="400"]]
71
72 You can view information about your content recommendation:
73
74 1.** Search:** Allows you to search for a Content Recommendation you’ve created in the past.
75
76 2. **Sort By:** Allows you to sort through your Content Recommendations by Title or ID.
77
78 3. **Desc/Asc**: Allows you to sort your recommendations in ascending or descending order.
79
80 4. **Rows:** Will set the number of recommendations visible on-screen, the options are 10, 50, 100, and 150.
81
82 5. **Apply:** Will execute the search criteria you’ve set in Search, Sort by and Rows.
83
84 6. **Reset:** Will reset the search criteria back to default settings (Search is blank, Sort by is Title and Asc, and Rows are 10)
85
86 7. **Expansion Arrow:** (Click this icon) Will expand into the Known/Unknown Recommendation Hit Ratio window.
87
88 **Known hit ratio:** This is Content Recommendations made to users who are known.
89
90 **Unknown hit ratio:** This is Content Recommendations made to users who are unknown.
91
92 8. **Edits:** Will allow changes to be made to a Content Recommendation in its entirety with exception to its IDs which is automatically created.
93
94 9. **Delete:** Will delete a Content Recommendation.