General player integration

Dejacast offers a fully featured video player, enabling publishers with a wide variety of options and configurations.

There are two ways of getting your video content up and running in the Dejacast player:

Using Dejacast Publisher API

The complete documentation regarding Dejacast API can be accessed here.

Using Dejacast Dashboard

• Step 1: Login using your account credentials into Dejacast Dashboard, that can be accessed at app.dejacast.com
• Step 2: Go to Media Library by using the left-side menu bar
• Step 3: If no videos were uploaded to your account, click Upload video files or Upload from URL. See Upload Videos.
• Step 4: Soon after uploading the video, it will become visible in the media library list.
  Once the status is FINISHED the video can be embedded in the website
• Step 5: Click the video and open the Embed Video tab
• Step 6: In Choose player, select the player to use. Click Preview in player to check how it looks.
• Step 7: Keep Include SEO on to add the video's SEO metadata to the embed code automatically.
• Step 8: Click Copy embed code and paste the script tag in your website.

If the selected player is configured for OmniFocus, click Show OmniFocus code to get the embed code for an OmniFocus unit. See Floating OmniFocus video ad units.

To embed a whole show instead of a single video, see Use Show as a Playlist.

Configuring player behavior

All player options can be configured via the Dashboard, by navigating to Settings > Players and selecting the desired player to be configured, or clicking Add new player. Some of the options are also available as query parameters, passed in the embed script URL.

Each player has a Player ID, shown in the ID column of the players list and at the top of the player's settings. You use it in embed codes. A player can be available to All publishers or to a single publisher.

The following options are available:

Player config	Description	Options available as dashboard config	Options available as query param
Player type	Sets the responsive behaviour of the player.	• Responsive • Fixed	n/a
Player aspect ratio	Enforces a specific aspect ratio for a Responsive player.	• Auto (keep video aspect ratio) • 16:9 • 9:16 • 1:1	n/a
Player width	The width of a Fixed player, in pixels. The height is calculated from the video's aspect ratio.	Numeric (pixels)	n/a
Allow advertising	Enables the player to play video ads within the video content.	• unchecked - false • checked - true	n/a
Use .mp4 video sources	Uses MP4 files as the video source. Suitable for direct video ads hosted by Dejacast.	• unchecked - false • checked - true	n/a
Float on scroll	Enables the player to become sticky and float in one of the corners of the screen whenever its original position moves outside the visible window.	• unchecked - false • checked - true	n/a
Floating position	Defines the corner of the screen where the player will appear when floating mode is active.	• top-right • top-left • bottom-right • bottom-left	n/a
Controls	Toggles the visibility of player controls.	• unchecked - false • checked - true	name: controls values: • 0 - false • 1 - true
Loop content	Enables video playing in loop.	• unchecked - false • checked - true	name: loop values: • 0 - false • 1 - true
Playlist Mode	At the end of the video, play videos from the same show.	• Disabled • Same Show	n/a
Mute on start	Player to start muted.	• unchecked - false • checked - true	name: mute values: • 0 - false • 1 - true
Autoplay	Video autoplay can: • be disabled (OFF) • start only when the player gets in browser window view (INVIEW) • start as soon as the page and player load (ON), regardless of player’s position. ⚠️ Autoplay INVIEW or ON requires Mute on start to be enabled.	• OFF • INVIEW • ON	name: autoplay values: • 0 - OFF • 1 - ON
Custom player theme	Allows player theme customization.	See Custom Player Themes	n/a
Enforce player styles	Prevents websites from altering the player's appearance using global CSS rules.	• unchecked - false • checked - true	n/a
Third Party Trackers	Adds third-party analytics trackers to the player. Shown only if enabled for your account.	One checkbox per available tracker	n/a

Ad Blocker behaviour

In the player's Advertising tab, you can choose what happens when a viewer uses an ad blocker:

• Disable player if Ad Blocker is present: the player doesn't load.
• Disable autoplay if Ad Blocker is present: the player loads, but the viewer has to start the video.

For the ad settings of the player, see Standard video ad units and the other Monetization guides.