Populating Piano content from web pages
Ensure the Piano Insight JavaScript snippet is added to sites that will deliver recommendations. This will allow us to:
-
Update the Piano Content engine with new content.
-
Track user behavior to deliver personalized recommendations.
-
Monitor page traffic to support trending recommendations.
The sections on document parsing and content refinement explain how to set up your published content to ensure your recommendation experience is optimal.
There is also a "push API" that can be used to notify Piano Content of new or updated content that is otherwise unlikely to be quickly discovered and visited by end users (which is how Piano Content usually becomes aware of new content).
Deliver recommendations to end users
To deliver content recommendations on a site, you need four things:
-
a content configuration that says what kind of recommendations you want, from which sites, etc.,
-
a template (and style) for presenting the widget,
-
a widget object representing the widget,
-
and a a few lines of code on your site.
See also: Using Piano Content without a template object and Piano Content API
Example
This shows how to render recommendations as a basic result list: http://cdn.cxpublic.com/newsrecs-2014.html
Notice how you can provide a visual representation of your recommendations by using the thumbnail images extracted by Piano when processing your content.
Tracking user clicks
By tracking user clicks, the recommendations engine can both learn more about the individual user's profile to provide better recommendations in the future, affect global ranking of recommendations, and provide the site owner with metrics to see which types of recs are most effective in different parts of the site. Hence, it is important to use the "click_url" field as the destination when the user selects a click, see the page on render templates.
The click reports are available in the Piano Insight user interface and through the Piano Content API.