Tealium Plugin for Brightcove Player

Overview

The Tealium plugin allows you to integrate the Tealium iQ tag manager with Brightcove Player. With this, you can track Brightcove Player events using your Tealium Universal Data Hub.

Tag managers allow you to add and publish tags without having to use code. Because they are a client-side solution, tag managers enable you to collect data across different marketing technologies. This empowers marketers by giving them the ability to collect user and player data across a diverse set of collection points.

Since Tealium iQ is not designed for a specific platform, you can use it with the product of your choice. With Tealium iQ, you have access to a tag marketplace, where you can find tag templates for most of your needs.

The Tealium Tag Manager Plugin is supported with the Brightcove Player version 6.36.5 and later.

Getting started

Review the Tealium iQ Tag Management documentation to setup your account. The setup will include the following:

• Define tag configurations
• Define triggers to fire beacons

• Create variables for events and custom dimensions

Using the Brightcove plugin

Like other Brightcove Player plugins, the Tealium plugin must be loaded into the player.

Using Studio

The following steps detail using Video Cloud Studio to load the plugin.

1. Open the PLAYERS module and either create a new player or locate the player to which you wish to add the plugin.
2. Select the link for the player to open the player's properties.
3. Select Plugins in the left navigation menu.

4. Next, select the Add a Plugin button, and then select Brightcove Plugin.

   

5. Expand the Brightcove Plugin dropdown and select Tealium.

   

6. Now, you are now ready to configure your analytics platform (Google Analytics for example) with the dimensions that you want to track. Review the dimensions that are available, see the Events and attributes section of this document.

7. In the Options(JSON) text box, enter the events and attributes you would like to track. Field descriptions:

   • paramsToTrack - List of attributes you want to track
   • eventsToTrack - List of events you want to track
   • account - Tealium account name
   • profile - Tealium profile name
   • env - Tealium environment name
    

   Here is an example:

   {
     "paramsToTrack": {
       "video_playhead": "video_playhead",
       "video_platform": "video_platform",
       "video_length": "video_length",
       "video_name": "video_name",
       "video_id": "video_id",
       "video_milestone": "video_milestone"
     },
     "eventsToTrack": {
       "video_load": "video_load",
       "video_play": "video_play",
       "video_complete": "video_complete",
       "video_watch": "video_watch",
       "video_pause": "video_pause",
       "ad_start": "ad_start",
       "ad_end": "ad_end"
     },
     "env": "your environment",
     "profile": "your profile",
     "account": "your account"
   }

8. Select the Save button. You will now see the Tealium plugin added to the list of plugins for your player.

   

9. To publish the player, select Publish & Embed > Publish Changes.
10. To close the dialog, select Close.

11. Return to the MEDIA and publish your video or playlist using the player you just updated for Tealium.

    When your player loads and the user interacts with the player, the specified events and parameters will be tracked.

Events and attributes

The following events and attributes are available to send to Tealium iQ.

Events

These events come from your player. All of these events send the common attributes. Some events may send additional attributes.

Notes

The following notes refer to the table above.

^[1] The video_watch event is sent at the following milestones:

• 25% Milestone – When the video has been watched in the range of 25% to 50% of the total video duration
• 50% Milestone - When the video has been watched in the range of 50% to 75% of the total video duration
• 75% Milestone - When the video has been watched in the range of 75% to 95% of the total video duration
• 100% Milestone - When the video has been watched for 100% of the total video duration

The video watched percentage (video_watch) can be calculated as follows (similar to video_engagement event in Google and Adobe analytics):

Video watched percentage = duration the user actually watched / total video duration

For example, in a 20 second video, the 25% milestone can be achieved in both of the below cases

• User watches from 0-5 seconds
• User watches from 0-1st second and skip to 11th second and watch to 15th second

In both of the above cases, the user watched 5 seconds, so milestone will be reported as 25%.

Common attributes

These attributes are common across all events.

Event-specific attributes

These attributes are related to a specific event.

Displaying data in Tealium

Player actions trigger the plugin to send analytical data to your Tealium Universal Data Hub. To view the events and attributes, follow these steps:

1. Go to https://my.tealiumiq.com
2. Login to Universal Data Hub using your credentials.
3. In the left navigation, expand EventStream.

4. In the left navigation, select Live Events.

   

5. You should see the dashboard with real-time event data.

   

6. Select an event to see the attributes associated with that event.

Changelog

See the Tealium Plugin Release Notes.

For historical release notes, see the changelog here.