In this tutorial we will demonstrate how to configure the OnSign TV to work with Quividi VidiReports.
Requirements for this demonstration
- OnSign TV Player version 10.3.x or installed on a media player
- VidiReports properly configured and running on a Windows PC.
- The IP address of the VidiReports PC
1- Configure Quividi plugin
In order to obtain audience metrics information from VidiReports and populate APC data, OnSign TV uses a plugin that exchanges information with VidiReports.
In your "Content" page, start by clicking on the "New" button and choosing “Plugin”
From the "Third Party" pane, chose "Quividi Audience Tracking"
Start by giving it a name that uniquely identifies this plugin instance.
In order to configure the plugin you need to set the name of the player attributes that will be set with the audience data. These attributes can be used later on to trigger content or impose restrictions based on the attribute value.
The plugin asks you to connect 6 attributes. You can connect them to an existing attribute or choose to create a new one.
- Total Audience
- Watching Audience
- Audience Male Percentage
- Audience Female Percentage
- Audience Age 0-19 Percentage
- Audience Age 20-29 Percentage
- Audience Age 30-39 Percentage
- Audience Age 40-49 Percentage
- Audience Age 50+ Percentage
The next step is to configure the Quividi Device IP address and ports.
If you did not change the default ports on the Quividi device, there will be no need to change these values.
Once the plugin is properly configured, click on the Save button.
2- Install the Quividi plugin on the player
Once the plugin is created, you need to add it to your player. Please note that this plugin can be added on more than one player. In this case all the players that have this plugin, will try to get audience information from the configured VidiReports device.
In order to install the plugin, on the player page chose the Plugins tab and click on "Add Plugin"
Search for the plugin instance in your content area and add it to the player.
3- Test the plugin
Publish your signage content to the player as usual.
Once you have some content playing we are ready to test the plugin.
If the plugin is properly configured and VidiReports is running, you will see in the "Player Status" page the following event:
If you receive an error event like shown below, please double check the IP address, network access and if VidiReports is running on the device:
If the plugin is properly configured, it will start retrieving information from VidiRepors and storing in the player attributes. This can be checked in the player settings pane, where all attributes are shown:
Important: Please note that attributes are changed on the player in real time and can be used to change the content being played. On the server side this is updated every 5 minutes, so the values shown on the settings page will not necessarily reflect the current state of the player.
The plugin will also automatically report content playback information to VidiReports in order to allow APC dashboards.
4- Install the Quividi Audience Overlay App (Optional)
If you want to display audience information in real time on your media player, you can publish the Quividi Audience App.
This app retrieves information from the attributes set by the Quividi plugin and displays it on the player.
This app can be found in the "Third Party" section of our app selection dialog.
In order to configure it, give it a name and connect it to the same attributes you configured in the plugin app:
Once configured, publish it to the player.
Note that this app is designed to be used as an overlay on top of other content. Using it in a campaign with overlapping regions will give you best results.
Once published it will show audience changes in real time.
5- Add restrictions based on audience data (Optional)
Once the player attributes are being set with real time audience data from the Quividi plugin, you can use it to customize the playback of your content in many different ways.
You can add content playback restrictions based on the specific value of an attribute, like shown below:
Alternatively, you can also trigger content when an attribute value reaches a specific threshold.
In the example below, the content will be triggered, interrupting the current content, when "Watching Audience" becomes greater than 2.