Configuring Discovery in the Backlot UI

Learn how to configure personalized recommendations and how the Ooyala player displays recommendations when video playback ends or pauses.

Note: Certain settings on the Discovery tab affect only certain player versions. Each section in this topic indicates which player versions are supported. For Player V4, refer to Discovering Content in Player V4.

For information regarding Discovery on mobile platforms, see About Discovery for Android Native Apps and About Discovery for iOS Native Apps.

Select the Player to Configure

Note: This functionality applies to Ooyala Player V4 and Player V3.
  1. Sign in to your Backlot account.
  2. Click PUBLISH > Discovery.
  3. Select a player from the Player Selection list.
  4. Select the Discovery tab to configure Discovery settings.
Note: Any changes to Discovery settings will apply only to the selected player.

Enable Discovery for a Player in Player V3

Note: This functionality applies only to Player V3.
To display recommendations, a player must have Discovery enabled. To activate Discovery for the selected player, select Turn On Discovery For This Player.

Configure the Recommendations Engine

Note: This functionality applies to Ooyala Player V4 and Player V3.
Note: For native mobile applications, refer to your iOS or Android documentation instead.
Ooyala's patented video recommendations engine uses machine learning algorithms to make personalized recommendations. You can influence the recommendation results by changing settings in the Discovery Editorial Controls section.

Recommend content from

Setting Description
A Specified Label Select this option to restrict the results to specific labels. When this option is selected from the dropdown menu, the Select a Label button appears. Click the button to open the label selection dialog box.
Shared Labels Select this option to generate results from other content tagged with the same labels as the currently playing video.
Ooyala Discovery Select this option to configure a self-optimizing behavior (collaborative filtering) that allows users to discover content that other users (who have also consumed this video) may be consuming. The self-optimizing system uses one or more of the Discovery APIs. The pool of content from which to recommend can be restricted based on a whitelist or blacklist of labels.

Recommendation scope

  • To restrict the results to specific labels, select Only From Certain Labels from the Recommendation scope list box, then click Add Labels and select one or more labels.
  • To remove specific labels from the results, select Never From Certain Labels from the Recommendation scope list box, then click Add Labels and select one or more labels.

Promote content from a specific label to position

If you want to promote content, specify the label for the content and the position in which you want it to appear. For example, you might specify the label promo to appear in position number 2. This will cause a video with that label to automatically appear as the second recommendation.

Note: Before specifying content to promote, you must create the label and associate one or more videos with it. If no videos are associated with the label, Ooyala Discovery automatically chooses another video to recommend.

Promote sequential content from within the custom metadata key

If the video is part of a series, enter the custom metadata key that you use for sequential content in the Promote content from a specific label to position %{zero} field, and the position in which you want the recommendation to appear.

For example, if you have a custom metadata key called next_item that contains the embed code of the next video in the series, Ooyala Discovery can automatically recommend that video in the position you specify.

Note: Before configuring this option, you must set the custom metadata key for videos that appear in series. If the custom metadata key is not set for a video, Ooyala Discovery automatically chooses another video to recommend.
Note: Discovery configurations (called discovery profiles) are applied only for the player during configuration.

include sub-account assets

Select this option if you want to include assets from sub-accounts in the pool of assets to recommend from.

Configure Up Next Video Options for Flash Player V3

To change the Up Next behavior for the selected player, in the Discovery Interface section of the Discovery tab, configure the following settings.
Setting Description
immediately after the current video ends For videos in a series, the next video automatically plays unless the user hovers over Discovery recommendations.
Note: If this option is selected, you can also configure the Countdown Preview.
seconds after the current video ends To configure the next video in a series to play automatically and immediately after the current video ends, select this option and specify when it will automatically start (the default is 10 seconds).
Countdown Preview
Note: This option is available only if immediately after the current video ends is enabled.
If the length of the credits varies, you can specify a custom start time for the Up Next Countdown Preview screen for each video. Create a discovery:countown_seconds custom metadata entry for each video, and specify when you want the Up Next Countdown Preview screen to appear.
Note: Up Next does not appear during ad playback.

Configure Pause Screen Settings for Player V3

To change the display of discovery recommendations (for the selected player) when playback is paused, configure the Pause Screen settings.
Setting Description
Display Discover Tray in the Pause Screen Select this checkbox if you want the player to show recommendations when playback is paused.
Discover Tray Click Behavior
Note: This functionality applies only to Flash Player V3.
Select one of the following options from the dropdown menu.
  • Open in the Same Page
  • Open in the Same Player
  • Open in a New Page
Note: For HTML5 Player V3, Up Next Video recommendations will open in the same page as the original video.
Note: If you are serving mid-roll ads, Ooyala recommends that you avoid displaying Discovery recommendations on the pause screen because your video analytics metrics might become ambiguous. For example, it might be unclear whether a pause event is due to the pause screen or to a mid-roll ad.

Configure End Screen Settings for Player V3

Note: These settings are available only when Discovery is disabled for the selected player.
To change the display of Discovery recommendations (for the selected player) when playback has ended, configure the End Screen options.
Setting Description
Replay Select this checkbox to display a replay button at the end of the video.
Share Select this checkbox to enable viewers to share the video. To specify how customers can share, click options and select the check box for each supported sharing option (e.g., Facebook, Twitter, and so on).
Embed Select this checkbox to display an embed button that viewers can click to get an embeddable URL for the video. The embeddable URL can be used to display the video on the viewer's website, blog, and so on.
Info Select this checkbox to provide information about the video. To specify which information, click options and select the check box for each type of information.
Display Discover Tray Select this checkbox to display the Discovery recommendations before the video ends.

For more information

Was this article helpful?