We’ve migrated our documentation to a new site, which means some URLs have changed.
Audience

Platform primer

The Piano Insight platform is a real-time platform that allows you to combine the following core elements and gain actionable insights into how they relate to each other:

  • Deep knowledge about your content. The platform operates not only on the level of URLs, but provides statistics also on the level of individual semantic entities and concepts found within or computed from the actual content.

  • Knowledge about how this content is consumed. Obtain real-time statistics about what's popular.

  • Knowledge about the users that consume the content. As users consume and interact with your content, interest profiles are built and updated in real-time. See where your users come from, how they access your content, and what else they've consumed and are interested in.

Furthermore, the platform provides powerful query mechanisms that allow you to pose queries that combine all of these elements and yield results that provide immediate value in applications. The data for your sites is available 31 days back in time by default, and if you would like the data to remain available longer, you can purchase a feature named LTS (long term storage).

The following section outlines a typical web setting where JavaScript is the primary mechanism for capturing and reporting event data. The platform can equally well be used in a non-web setting, though, e.g., from mobile devices and applications.

In brief, there are three simple steps you need to do to start using the Piano Insight platform:

  • Sign up to the service by visiting https://insight.cxense.com and create a user account.

  • Create a Site Group and register a Site. This registration process will generate a JavaScript snippet for you. Make the snippet part of your site template.

  • When you log in to the Piano Insight application, you will see a dashboard showing your site's real-time traffic statistics.

This JavaScript snippet is sometimes referred to as the "Piano Insight script" or the "tracking pixel".

Placing the snippet on your site's pages will trigger a couple of things to happen:

  • Your site will be visited by the web robot. This ensures that your content is downloaded and made available for further analysis.

  • Content profiles and user profiles will be built. This ensures that "profiles" are available for use by applications, and that advanced Audience insights are available in the Piano Insight application's dashboard.

  • The crawled content is indexed and made searchable.

Although crawling is the most common scenario for having your content ingested by the platform, the platform also provides content push APIs both for structured and unstructured data.

In some case you might have first-party data about your users, e.g., because they have logged in to your site/application and provided you with information about themselves as part of the sign-up process. The platform provides APIs so that such user data can be uploaded and put to use by Piano’s set of applications.


Last updated: