[object Object] Icon

Encoding
Learn how to create, start, manage and modify Encodings

[object Object] Icon

Player
Learn how to create, start, manage and modify Players

[object Object] Icon

Analytics
Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Tue Jun 11 2019

Changing metadata when switching Videos with Web Collector and Bitmovin Player

OverviewLink Icon

Whenever the player is switching to a new video source the Analytics Collector will automatically detect the switch and start a new impression for the new video.

Unfortunately one key information will be missing and can't be automatically detected by the collector: Which videoId and human readable title of the video (videoTitle) along with other relevant metadata that might be important to you.

Obviously this kind of information is important and the metadata change should also be tracked, so this guide will explain how to set the data correctly.

Setting new MetadataLink Icon

With Analytics Web Collector 2.0 we added support for the embedded analytics configuration API where the Analytics metadata is part of the player configuration to more closely convey the relationship between the analytics metadata and the source being played.

To change the metadata of the vide when switching sources you simply add a analytics section to your source configuration.

1player.load({
2 hls: 'https://your-stream.com/playlist.m3u8',
3 analytics: {
4 videoId: '<new videoId>',
5 videoTitle: 'The new video title'
6 }
7})

The embedded configuration supports all the same values that can otherwise be put into the analytics config when starting up the player (eg. cdnProvider, customUserId, customData1-5 etc..).

Give us feedback