Skip to main content

Data stored in the viewer's browser

This page lists everything the VdoCipher web player stores in the viewer's browser, so that you can include it in your website's cookie declaration or privacy policy.

The player sets one cookie, which can be disabled, and, depending on how the embed is configured, a few localStorage entries. The player uses no advertising or tracking cookies and loads no third-party analytics scripts.

In summary:

  • Two functional entries are short-lived and only appear under specific conditions. One is written and deleted immediately. The other lasts at most one hour and only after a DRM playback error.
  • One diagnostics cookie, vdo_id, can be fully disabled from the embed code.
  • Five entries depend on your player configuration. Auto-resume, which stores the last watched position, is enabled by default and can be turned off. The four preference entries for volume, speed, quality and caption language are saved only if you enable those options.

Complete list​

EntryDetails
vdo_id
cookie
Indefinite
Purpose: Random anonymous identifier attached to playback error reports, so that playback failures on the same browser can be traced and debugged. Not used to count viewers.
When it appears: Every playback, unless disabled with the noCookie option (see below)
vdo-test
localStorage
Written and deleted immediately
Purpose: Checks whether localStorage is available
When it appears: Every playback
vdo/{videoId}/lastViewedTime
vdo/{videoId}/lastViewUpdated
localStorage
Indefinite
Purpose: Resume playback from where the viewer left off
When it appears: Only if auto-resume is enabled in your player configuration
vdo/{websiteHostName}/volume
localStorage
Indefinite
Purpose: Remember volume
When it appears: Only if volume persistence is enabled in your player configuration
vdo/{websiteHostName}/rate
localStorage
Indefinite
Purpose: Remember playback speed
When it appears: Only if speed persistence is enabled in your player configuration
vdo/{websiteHostName}/qualityTrackId
localStorage
Indefinite
Purpose: Remember chosen video quality
When it appears: Only if quality persistence is enabled in your player configuration
vdo/{websiteHostName}/selectedCaptionId
localStorage
Indefinite; removed when captions are turned off
Purpose: Remember caption language
When it appears: Only if caption language persistence is enabled in your player configuration
@vdocipher/TBL1
localStorage
1 hour
Purpose: Depending on your security configuration, a timestamp that makes the player fall back to software DRM after a hardware DRM failure
When it appears: Only after a DRM playback error

The player does not use sessionStorage. VdoCipher's backend services (metadata, license and analytics) set no cookies.

  • vdo_id is a functional or diagnostics cookie.
  • All localStorage entries are functional or preference storage.

Add noCookie=true to the iframe src to stop the player from setting the cookie:

<iframe
src="https://player.vdocipher.com/v2/?otp=[[REPLACE_WITH_OTP]]&playbackInfo=[[REPLACE_WITH_PLAYBACKINFO]]&noCookie=true"
style="border:0;width:720px;height:405px"
allow="encrypted-media"
allowfullscreen
></iframe>

For the web component, use the nocookie attribute:

<vdocipher-player
otp="[[REPLACE_WITH_OTP]]"
playbackInfo="[[REPLACE_WITH_PLAYBACKINFO]]"
nocookie="true"
></vdocipher-player>

When the cookie is disabled, or when the viewer's browser has cookies disabled, error reports are sent without a browser identifier.

Player settings that use localStorage​

These settings are in the custom player configuration in the VdoCipher dashboard.

Dashboard settingDefaultStores
Enable Local ResumeOnvdo/{videoId}/lastViewedTime
vdo/{videoId}/lastViewUpdated
Remember last volume levelOffvdo/{websiteHostName}/volume
Remember last player speedOffvdo/{websiteHostName}/rate
Remember last qualityOffvdo/{websiteHostName}/qualityTrackId
Remember last caption languageOffvdo/{websiteHostName}/selectedCaptionId

If you want to honour the viewer's cookie consent for these preferences, create two players in the VdoCipher dashboard: one with these settings enabled and one with them disabled. Then embed the player that matches the viewer's choice.

Data sharing​

  • The localStorage entries are read only by the player on the viewer's device. They are never sent to any server.
  • The vdo_id cookie value is sent only to servers operated by VdoCipher, as part of playback error reports.
  • None of this information is shared with any external vendor, analytics provider or advertising network.
Where the data is stored

With the iframe embed, the cookie and localStorage entries are stored under the player.vdocipher.com origin. With the web component rendering directly in your page, they are stored under your website's origin.

Android and iOS apps​

If you need similar control over identifiers and analytics in your Android or iOS apps, contact us at support@vdocipher.com.