Integrating Audience with Single Sign-On
This topic explains how to configure the Audience module for use with single sign-on.
The Audience module provides the ability to track viewing activity when the viewer has logged into a system using single sign-on (SSO). In this scenario, viewing data is not sent to a marketing automation platform. With an Audience SSO configuration, SAML attribute(s) are passed to Audience to identify the viewer. One common use case for this would be internal training videos. Employees might be required to login to watch videos and then their viewing activity can be tracked and then viewed inside the Audience module. To enable Audience for use with SSO, the following steps are required:
- Configure single sign-on software
- Configure your application to access SSO attributes
- Setup the Audience SSO connection
- Configure the integration
- Create an Audience-enabled player
- View video data
Configuring SSO software
The steps to install and configure SSO software is outside the scope of this topic. The SSO software should be configured so users have to authenticate themselves before they can view Video Cloud videos. The SSO software should be configured to expose some user attributes so they can be accessed from an external application. For example, this Okta SSO configuration exposes three attributes,
In this topic, the
Configuring an application to access SSO attributes
Note: For information on configuring Access Control Profiles in Gallery, see Configuring Access Control Profiles.
Setting up the connection
Follow these steps to setup the connection between Video Cloud and your SSO provider.
Establishing the connection between Video Cloud and SSO
- Open the Audience module and click Setup in the left navigation.
- Click Add New Connection.
- Select SSO as the integration.
Note: The integrations that are available are based upon your Video Cloud subscription.
- (Optional) Enter a Connection Name.
- Click Connect.
The SSO connection is now set up and ready to use.
Configuring the integration
Once the SSO connection has been made, you can configure the integration.
- Click the
In this topic, the Audience SSO integration will be used to track viewing activity. Click Save.
Note: It is also possible to leave the SSO Property empty and then use one of the additional options to identify viewers.
- By default, the Integration Status will be Enabled. The Integration Status determines if Video Cloud video engagement data is saved.
- Enabled - Data is collected
- Disabled - No data is collected (integration is disabled)
To remove the integration, click Disconnect. The bottom of the page will list all Audience-enabled players, the connections they are associated with and the associated lead forms.
The Audience module supports multiple connections to marketing platforms. Click Add New Connection to configure additional integrations.
Additional options for identifying viewers
If you don't specify a value for the SSO Property when the integration is configured, you are responsible for identifying viewers. The Audience module needs the following information:
|Description||URL Parameter||Embed Parameter||Value|
|What’s the GUID (needed for view event tracking)||
This parameter can be passed in via a URL parameter or through the player embed code. For viewer tracking to occur, this parameter should be passed as a URL parameter on the page that is displaying the video.
Note: In order for the player/plugin to read the URL parameter, the Advanced (in-page) embed code should be used. The Standard (iframe) embed code will not work as the plugin will be running inside of an iframe and therefore is unable to access the parent page URL which has the parameter.
samlAttributes and it has a property called
nameID. Audience will attempt to read that and use its value for the custom GUID.
Creating an Audience-enabled player
Video engagement data will only be tracked when you are using an Audience-enabled video player. For information on creating an Audience-enabled Brightcove Player, see Creating an Audience-enabled Player.
Viewing video data
There are several options available for viewing video data when using an SSO integration:
- Viewer Activities (Events) - Provided as part of the Audience module, this option can be used to view video data inside the Audience module. For information, see Viewing Player Events in the Audience Module.
- Viewer Profiles - Provided as part of the Audience module, this option can be used to view video data based upon a user profile value inside the Audience module. For information, see Viewing Viewer Profile Information.
- Export Data - Provided as part of the Audience module, this option can be used to export video view and lead data. For information, see Exporting Data from the Audience Module.
- Audience API - The Audience API can be used to programmatically retrieve video view and lead data. For information, see Overview: Audience API.