Similar to how we track unique webpages of your site by accessing the page's canonical URL or "page path", it is also a requirement for our video tracking integration to access a unique video ID value, and these values must be consistent for all visitors on your site watching the same video from different page locations. We use this unique video ID or "video path" to group engagement data from all active viewers on your site into unique content entries within your Chartbeat Video Dashboard. This creates a one-to-many relationship between this one piece of content and its unique locations across multiple players on your site, so if you see duplicate entries for the same video within our dashboard, it means that our tracking script is accessing inconsistent video paths from certain viewer locations on your site.
For example, if your video on article 1 returns a different ID than the same video embedded on article 2, we will see an entry for each in the Video Dashboard. This issue is especially common when tracking the same video across Desktop and Mobile platforms.
To better understand our unique content ID requirement, it may be helpful to read through our Duplicate articles or landing pages appearing in Top Pages FAQ article which explains a similar integration issue in detail. For help diagnosing this problem in your video tracking integration and/or your player metadata settings, the individual(s) responsible for video analytics at your organization can get in touch with us at firstname.lastname@example.org with a description of the issue including the following details:
- Screenshots of the issue occurring
- Name of the player being tracked (e.g. JW Player, Brightcove, custom player, etc)
- Links to pages of your site where our tracking code is returning inconsistent video path values
Tip: In our custom player video SDK, Chartbeat identifies unique videos using the getVideoPath() method. To resolve duplicate issues within your custom player integration, ensure the getVideoPath() method returns a unique ID for each piece of video content, across all video players where it loads.