Brightcove is a high-performance, cross-platform HTML5-first video player that loads quickly, delivers high-quality video across desktop and mobile platforms. Our integration with Brightcove enables video event collection and targeting.This integration is both a Source and Destination:
Source: Permutive is able to track video events from the Brightcove player.
Destination: Permutive is able to activate your cohorts for video ads served in the player.
Use cases include:
Track video events in Permutive, for insights, advanced segmentation or modeling.
Add Permutive cohorts to your Google Ad Manager (GAM) ad requests so that they can be used for decisioning and targeting in realtime.
Public API key: This can be found in the Permutive dashboard, in your project settings. We recommend provisioning a new one, by clicking Add Key and choosing Public.
Brightcove Video Player: You should already have a Brightcove video player installed on your site. You must also have access to the Brightcove Cloud Studio dashboard, where you can configure your player.
You must enable the Brightcove Video Player integration in the Permutive Dashboard, if this has not already be done.
In the Permutive dashboard, navigate to your workspace’s integrations page. Click Add Integration and select Brightcove Video Player.
There is nothing to configure in the Permutive Dashboard for this integration.
2
Install the Player Plugin
The Permutive plugin for Brightcove can be installed into your player using the Brightcove Cloud Studio dashboard. The following steps must be performed for every player where you want Permutive enabled:
Show detailed steps
Open the player in Brightcove Cloud Studio.
Scroll down to Plugins and press Edit.
Click on JavaScript and paste our plugin URL: https://cdn.permutive.com/integrations/videojs-permutive-1.4.2.js
Select the ’+’ to the right.
Click on Name, Options (JSON) and paste in the following configuration:
Replace <PUBLIC_API_KEY> with your Permutive public API key.
Replace <PLATFORM> with either web, amp or fia, based on whether your player is to be deployed on Web, AMP or Instant Articles.
Click Save.
3
Configure Video Ad Targeting
You can now configure the player to make Permutive cohorts available for targeting video ads served in your the player via the GAM ad server.
Show detailed steps
Open the player in Brightcove Cloud Studio
Go to Advertising
Modify the URL in the Ad Tag section to include &cust_params=permutive%3D{permutive} in its query part
Be aware that cust_params may already be part of the URL, if you are already appending custom targeting data to ad requests. In this case just prepend the cust_params value with permutive%3D{permutive}%26.
Targeting for pre-roll ads is only supported when using the “on play” Brightcove Request Ads setting. If “on load” is used, Permutive cohorts will not be included on the ad request.
4
Verify Setup
In the Permutive Dashboard, navigate to your events page. Having completed the above steps, plugin installation is now complete. You should start seeing video event data appear in the Permutive Dashboard.For your cohorts with a GAM activation configured, you should now see these cohorts available for targeting on video ad requests from the player.
Returns the minimum suggested duration in seconds that the nonlinear creative should be displayed. Returns -2 if the minimum suggested duration is unknown. For linear creative it returns the entire duration of the ad.
Returns the minimum suggested duration in seconds that the nonlinear creative should be displayed. Returns -2 if the minimum suggested duration is unknown. For linear creative it returns the entire duration of the ad.
Datetime for when the video content was first published.
VideoAdEvent
Tracks additional events emitted by the player whilst an ad is being watched, such as when a user enters full screen mode, pressed pause or resumed play.
Returns the minimum suggested duration in seconds that the nonlinear creative should be displayed. Returns -2 if the minimum suggested duration is unknown. For linear creative it returns the entire duration of the ad.
Returns the minimum suggested duration in seconds that the nonlinear creative should be displayed. Returns -2 if the minimum suggested duration is unknown. For linear creative it returns the entire duration of the ad.
Targeting for pre-roll video ads not working as expected
Targeting for pre-roll ads is only supported when using the “on play” Brightcove Request Ads setting. If “on load” is used, Permutive targeting will not be included on the ad request. Check your settings in Brightcove Cloud Studio.
