Guides
Start typing to search…

Pause Ads (VAST)

What are Pause Ads

Pause Ads display brand messages during natural breaks in playback on Roku devices. When a viewer pauses live or on-demand content, a promotional overlay is displayed after a brief delay. This format provides a high-visibility, non-interruptive surface that integrates naturally with the viewing experience.

On Roku, Pause Ads can be delivered via an externally hosted VAST XML from any VAST-compliant ad server (e.g., Google Ad Manager) and are rendered by the StreamLayer Roku SDK.

Pause Ads are effective for driving brand awareness while respecting user-initiated playback behavior.


Key Characteristics

  • Trigger The viewer manually pauses live or on-demand content.

  • Delay The Pause Ad is displayed after a short delay (approximately 5 seconds) to avoid accidental pause-and-resume actions. The delay and display trigger are controlled by the host player integration.

  • Display The ad is rendered as a promotional overlay managed by the StreamLayer SDK.

  • Resume Resuming playback automatically dismisses the Pause Ad.

  • Delivery Ad content can be delivered via an externally hosted VAST XML.

SDK Initialization Mode (Roku)

On Roku, Pause Ads use VAST XML as the ad source and support multiple SDK initialization modes depending on the integration.

When VAST-only mode is enabled, the StreamLayer SDK is initialized specifically for Pause Ad delivery, rendering, and VAST analytics tracking. In this mode:

  • Only Pause Ad–related functionality and VAST analytics event processing are loaded
  • The SDK fetches and renders ads from a VAST XML
  • Full StreamLayer platform features (such as real-time feeds, moderation configuration, and live data subscriptions) are not initialized

This mode is designed to support lightweight, ad-only integrations where Pause Ads are required without enabling the full StreamLayer platform experience.


Configuration

Pause Ads on Roku are enabled via application-level configuration and player integration behavior.

Key configuration fields include:

  • isVastModeEnabled
    Enables or disables VAST-based Pause Ads.
    When set to true, the SDK is initialized in VAST-only mode.

  • vastUrl
    A URL pointing to the VAST XML used for Pause Ads.

Pause Ad Display Timing

The host application is responsible for triggering Pause Ad display after a pause event. It is recommended that Pause Ads are shown after a short delay (for example, ~5 seconds), although the exact delay duration is controlled by the host application and may vary by integration.

The following example shows a typical host-side timer configuration:

   <Timer id="PauseAdTimer" duration="5" repeat="false"/>

Once triggered, the StreamLayer SDK renders the Pause Ad and tracks its lifecycle and analytics.

Example configuration:

{
  "isVastModeEnabled": true,
  "vastUrl": "<external VAST XML URL>"
}

Notes on VAST XML:

  • The current VAST XML used for Pause Ads is an internal mock created for early validation.
  • The final XML schema is not yet finalized and may evolve as cross-platform requirements

Updated 8 days ago