Choose the events and dimensions that you want to track from Brightcove Player.
Any event name used by Brightcove player's analytics-beacon event can be used, but the following have special handling in the GTM plugin.
| Event | Description |
|---|---|
player_load |
Player has been loaded and is operational |
video_impression |
Video has been loaded into a player and is ready for playback |
video_view |
Video has started playing back either through auto-play or user interaction |
video_engagement |
A user watches a range of seconds of a video's timeline. This event is a heartbeat for tracking video engagement and will likely be sent many times during playback, depending on the user interaction and the length of the video. |
play_request |
Playback is initiated either by the user expressly clicking the play button, or automatically when the platform triggers playback in an auto-play scenario |
ad_mode_begin |
Control is handed over to an advertising agent by the playback platform |
ad_mode_complete |
Control is handed back from the advertising agent to the playback platform |
error |
A fatal error has occurred which disrupts the playback experience |
video_complete |
Video playback finishes
|
The following dimensions will be sent for all events(except error)
| Parameter | Description |
|---|---|
bcvideo_account |
Video Cloud Studio account ID |
bcvideo_destination |
Playback location |
bcvideo_platform_version |
Brightcove Player version |
bcvideo_player |
Brightcove Player ID |
bcvideo_player_name |
Brightcove Player name |
bcvideo_session |
Session associated with the player |
bcvideo_video |
Video ID |
bcvideo_video_name |
Video name |
bcvideo_tags |
List of tags associated with the video |
These custom dimensions will be sent in specific events.
| Parameter | Description |
|---|---|
bcvideo_video_playhead |
Sent in play_request and engagement events
|
bcvideo_video_duration |
Sent in engagement event
|
bcvideo_range |
Sent in engagement event
|
bcvideo_video_percent_viewed |
Sent in engagement event
|
bcvideo_video_seconds_viewed |
Sent in engagement event
|
bcvideo_video_milestone |
Sent in engagement event
|
These are Brightcove parameters you can create as GTM variables.
| Variable name | Description |
|---|---|
account |
Brightcove account ID |
player |
Player ID |
player_name |
Player Name |
platform_version |
Platform version number |
session |
Session identifier |
video |
Video ID |
video_name |
Name of the video |
range |
The range of seconds viewed in the format StartSecond..EndSecond |
seconds_viewed |
Count of watched seconds |
duration |
The duration of the video in seconds |
percent_viewed |
Percentage of video watched |
error |
Platform specific error code associated with the event |
milestone |
Milestone (25%,50%,75%,100%) completed by the video |
playhead |
The time in the video at which the event is triggered |
destination |
URI that originated the event |