Brightcove enables cloud-based publishing and distribution of digital media. You can use Treasure Data with Brightcove to store digital media events and raw data about media access and usage.

You can create a connector so that every time a video event occurs in browsers, Treasure Data is notified. Treasure Data stores the data, and allows you to analyze the data via SQL.

This topic includes:

Configure Player Settings

  1. Open the Brightcove Admin console.

  2. Select the App menu.

  3. Select Players.
    The Player is the object that feeds data to Treasure Data.


  4. Select New Player or an existing player in the Players section.


  5. In the Player Information section, select Plugins.


  6. Select Add a Plugin and select Custom Plugin.


  7. In the Javascript URL section, you must specify the plugin library used to import the data from the Brightcove player into Treasure Data as shown in the following example.

    Plugin Name
    td
    JavaScript URL
    https://cdn.treasuredata.com/videojs/0.6.0/videojs-plugin-td.min.js
    Options (JSON)

    {
     "writeKey": "YOUR_API_KEY",
     "database": "DATABASE_NAME",
     "table": "TABLE_NAME",
     "host": "in.treasuredata.com",
     "trackCrossDomain": true,
     "startInSignedMode": true,
     "useServerSideCookie": true,
     "sscDomain": "YOUR_SSC_DOMAIN",
     "sscServer": "YOUR_SSC_SERVER"
    }


  8. In the Options section, specify the following parameters:

Key Name

require

default

Ref.

writeKey



database



table



host


in.treasuredata.com

JS/Mobile SDK/Postback in the Sites and Endpoints page

trackCrossDomain


false


startInSignedMode


false


useServerSideCookie


false

See: Server Side Cookie

sscDomain


(null)

sscServer


(null)





Treasure Data SDK

  1. In addition to the plugin library, you must specify the Treasure Data SDK library in the Scripts tab.

    When entering the Treasure Data SDK library in the Scripts tab, you can use v2.2.0 or v1.9.2Treasure Data SDK Library v2.2.0

    https://cdn.treasuredata.com/videojs/sdk/2.2.0-for-videojs.js

    We also support the old version. You can use that version as well if you want.

    Treasure Data SDK Library v1.9.2

    https://cdn.treasuredata.com/videojs/sdk/1.9.2-for-videojs.js


  2. After saving the settings, select Publish & Embed.


  3. Select Publish Changes.

Obtain the Media Code

After the player is configured and ready, you can get media code.

  1. In the Brightcove admin console, select the App menu and select Media.


  2. Select a video you want to use with the player.


  3. Select Publish > Web Player.



  4. Select the player that is configured to work with the plugin.


  5. Copy the code from the code area and embed this code into your web page.


  6. You can confirm for data import by embedding the code into your web page and then some interactions with the player (play, seek, etc.).

Confirm Import in Treasure Data

In Treasure Data, you can create a query to track the events coming in from the Brightcove player. It usually takes 3-5 minutes before events appear in the TD Console.

Parameters

You can use the following parameters, which are provided as part of the embed code.

  • bc_video_id: Unique ID for a video content

  • bc_video_name: the video content name

  • bc_event: A value is set for each event type that has occurred

    • Player Loaded

    • Contents Loaded

    • Play

    • Pause

    • Error

    • FullScreen Start: Start full-screen mode

    • FullScreen Exit: Exit full-screen mode

    • Volume Change: Change Volume

    • Complete: Video is completed

    • Percent of View: % of video completion

    • Elapsed of View: Elapsed time (sec) of the video
    • Seek: Move seek

  • bc_duration: length of a video content

  • bc_session_id: unique id for session

  • bc_volume:

    • 0 is mute, 1 is maximum volume.

  • bc_percent

    • percent of view completion

  • bc_elapsed *

    • the elapsed time of the video

  • bc_seek_start, bc_seek_end: If a user skips from 5 seconds point to 10 seconds point, bc_seek_start and bc_seek_end will be set 5 and 10.

bc_elapsed – It's fired every 5 seconds. For the Live video, it indicates the elapsed time the user viewed the video. For a recorded video (for which the length of the content has already been determined), it refers to the playback location of that content, such as 5 seconds, 10 seconds, 15 seconds, etc.

Obtain the Information Associated with the Domain of the Video Playback Site

When you use TD's SSC feature with Brightcove, you should use a recommended JS tag of
'Gallery (Grid In-Page)' or an advanced video tag of 'Media', not the iframe tag.
Because the source domain fired by the iframe tag is Brightcove's domain,
the expected SSC (cookie associated with the 1st party domain of the video playback site)
cannot be obtained. Because the TD tag fired by the Gallery Grid In-Page's JS tag
or Media's advanced video tag is linked to the domain of the video playback site, SSC can be obtained.


You can import event data from the Gallery in page format, which Brightcove provides as a multi-video experience within one creative.

The following Gallery formats are supported:

  • Carousel

  • Grid

  1. Create a gallery in page creative.


  2. Next, you can set the player for the creative.


  3. Publish the change and copy the code displayed.
    The experience is captured as an event that can be imported into Treasure Data. For example, when a viewer views a video and then selects the next video in the creative to watch, the data connector captures the change and starts to track events with the next video.


  • No labels