Schedule ad breaks


Video advertisements allow you to monetize the videos that your viewers watch. An ad schedule enables you to add video advertisements (preroll, midroll, and postroll ads) into your video content.

You can create ad breaks with one of several approaches:

  • Add breaks manually based on traditional ad settings
  • VMAP ad breaks based on the settings configured in the VMAP ad tag
  • Dynamic Ads based on your goals and end user experience

Advertising features are based on how you configure your ad breaks. The following table compares each type of ad break.

FEATURE Manually-configured Ad Breaks VMAP Dynamic Ads
Ad Clients:
  • Google IMA
  • VAST
Ad Rules:
  • Content to ads ratio
  • Minimum time between ads
  • Minimum time before first ad
  • Minimum content duration for midrolls
Google Publisher Provided Signals
Non-Linear Advertising
Player Bidding
VPAID (Google IMA}:
  • Insecure
  • Secure
  • Disabled

🔑

If you are a developer or have developer resources, you can programmatically schedule VAST ads.



Define an advertising configuration

Follow these steps to schedule an ad break:

  1. From the Advertising page, on the Web (ad schedule) tab, click Create ad schedule. The ad schedule settings appear.
  2. Enter a name for the ad schedule.
  3. Click a radio button to Select your Ad Client.
  4. Configure the advertising breaks.
  5. (Add breaks manually, VMAP) Expand the Advanced ad rules section and set the ad rules.
    Advanced ad rules
    Rule Description
    Start on playlist item # Set the playlist item number after which the first ad will appear

    Example: If set to 2, the first ad plays before the second video in the playlist.

    Learn more about ad frequency rules.
    Repeat on interval Set how many playlist items must be viewed before another ad is shown

    Example: If set to 3, an ad plays before every third video in the playlist.

    Learn more about ad frequency rules.
    Time between ads Set the minimum elapsed clock time (in seconds) required between ads during playback

    Example: If set to 300 seconds (5 minutes), an ad will not play until at least 5 minutes have passed since the previous ad was watched.

    Learn more about long-form ad engagement rules.
    Ad seen on subsequent visit Set whether a pre-roll is shown when a viewer resumes a partially-watched video

    Example: If enabled, a pre-roll ad will play when the viewer returns, before playback resumes at their previous point.

    Learn more about long-form ad engagement rules.

  6. (Optional) Enable Player bidding.
  7. Click Save.


Advertising breaks

You can define an advertising break through one of the following approaches.

Add breaks manually
Configure ad breaks for VAST

Configure ad breaks for VAST


Follow these steps to configure ad breaks:
  1. Under Configure ad breaks, choose Add breaks manually.
  2. (Google IMA) Select a VPAID Mode for the ad.
    VPAID Mode Description
    Insecure Loads in a friendly iFrame

    This allows the ad access to the site via JavaScript.
    Secure Enabled using a cross domain iFrame

    VPAID ads cannot access the site. A VPAID ad that depends on friendly iFrame access may not play.
    Disabled No ad

    VPAID ads will not play. An error will be returned if VPAID ad is requested.

  3. Click + icon to create a Preroll, Midroll, or Postroll ad break. The configuration panel appears.
  4. In the text box, enter the URL of the ad tag.

    💡

    Macros can be added to each ad tag to target the ads returned. These macros are replaced in real time. It is common to add 10+ macros to a single ad tag.

  5. (VAST - Optional) Click + Add waterfall tag to enter additional ad tag URLs.

    💡

    Creating an ad tag waterfall helps you to maximize ad revenue by attempting to show a valid ad to your viewers during an ad break.

  6. (VAST - Optional) To increase viewer engagement, click Skippable after ___ seconds and enter the length of time in seconds a viewer must watch an ad before having the ability to skip the ad.
  7. (Optional) Click Non-linear overlay ad to allow an ad banner to display over video content without disrupting the video.

  8. (Midroll) Define the Break timing:
    1. Select an option from the Break timing dropdown menu.
    2. Next to the Break timing dropdown menu selection, enter the location in the video where a midroll ad break occurs.
      Option Guidance
      Seconds into video Enter the video location in seconds.
      % of video Enter the video location as a percentage of the video.

      Example: Enter 15 for 15%.
      Timecode Enter the video location as a timecode in hh:mm:ss.mmm format.

      Example: 00:15:25.001

  9. Click Done after configuring each ad break.

VMAP
Configure ad breaks for Google IMA VMAP

Configure ad breaks for Google IMA VMAP


Follow these steps to configure ad breaks:
  1. Under Configure ad breaks, choose VMAP.
  2. (Google IMA) Select a VPAID Mode for the ad.
    VPAID Mode Description
    Insecure Loads in a friendly iFrame

    This allows the ad access to the site via JavaScript.
    Secure Enabled using a cross domain iFrame

    VPAID ads cannot access the site. A VPAID ad that depends on friendly iFrame access may not play.
    Disabled No ad

    VPAID ads will not play. An error will be returned if VPAID ad is requested.

  3. Enter the ad tag URL.

    💡

    Macros can be added to each ad tag to target the ads returned. These macros are replaced in real time. It is common to add 10+ macros to a single ad tag.


Dynamic Ads

The Dynamic Ads approach lets you customize ad experience rules that are based on your goals and the end user experience.

Configure ad breaks for Google IMA Dynamic Ads

Configure ad breaks for Google IMA Dynamic Ads


Key Benefits:

  • Tailor the viewing experience with intuitive, non-technical ad rules
  • Set ad rules based on customer goals
  • Boost monetization through increased opportunities for ad fill and impressions
  • Use preset rules to easily align your ad strategy with industry specifications

🚧

If you plan to use Dynamic Ads with the Keep Watching Player, read this FAQ.


Follow these steps to configure Dynamic Ads:

  1. Under Configure ad breaks, choose Dynamic Ads.
  2. (Google IMA) Select a VPAID Mode for the ad.
    VPAID Mode Description
    Insecure Loads in a friendly iFrame

    This allows the ad to access the site via JavaScript.
    Secure Enabled using a cross-domain iFrame

    VPAID ads cannot access the site. A VPAID ad that depends on friendly iFrame access may not play.
    Disabled No ad

    VPAID ads will not play. An error will be returned if a VPAID ad is requested.

  3. Under Ad events, click + Add next to Preroll or Midroll. The configuration panel appears.
  4. Enter the Ad tag URL.

    💡

    Macros can be added to each ad tag to target the ads returned. These macros are replaced in real time. It is common to add 10+ macros to a single ad tag.

  5. Define the Ad rules.
    Rule Description
    Presets Defines how ads are scheduled relative to content

    Possible options:
    1:1 BalancedSets ads to appear in real time with content watched, maintaining a continuous one-to-one ratio of ad time to content time

    Example: Watching 30 seconds of ads requires at least 30 seconds of content playback before another ad is eligible.

    1:1 MaximizedSets ads based on the full duration of the media item, allowing up to a one-to-one ratio of ad time to content time across the entire playback

    Example: A 5-minute item can include up to 5 minutes of ads.

    NOTE: Ad concentration may vary or be front-loaded.

    CustomEnables setting a specific content-to-ads ratio

    Ratio Type Defines how the content-to-ads ratio is calculated

    This option is automatically set for 1:1 Balanced and 1:1 Maximized, and only selectable when using Custom.

    Possible options:
    • Balanced: Calculates ad eligibility based on content already watched, ensuring the ratio is maintained throughout playback
    • Maximized: Calculates ad eligibility across the full duration of the media item, which can result in more ad time than content time if playback is abandoned before completion
    Content to ads ratio Sets the desired balance of content time to ad time

    Example: A 5-to-1 ratio will play about 5 minutes of content for every 1 minute of ads.
    Minimum time between ads Sets the minimum playback duration required between consecutive ads, in seconds

    Example: If the threshold is 15, ads will not appear more frequently than once every 15 seconds.
    Minimum time before first ad Sets the minimum playback duration required before the first ad can be inserted, in seconds

    Example: If the threshold is 45, the first ad will not appear until at least 45 seconds of content has played.
    Minimum content duration for midrolls Sets the minimum media item duration required before midroll ads can be inserted, in minutes

    Example: If the threshold is 3 minutes, a 2-minute item will not include midroll ads.


Player bidding

Enable player bidding panel

Enable player bidding panel

Follow these steps to enable Player bidding:

  1. Under Player bidding, click Enable. The Enable player bidding panel appears.
  2. Select a template from the dropdown menu.

    📘

    If do not have a template, you can create a new one. Otherwise, skip to step 4.

  3. Click Import from template to populate all the fields.

    📘

    If no additional changes are needed. skip to step 13. Otherwise, continue to step 4 to adjust the Player bidding settings.

  4. From the Mediation option dropdown menu, select a mediation option.
  5. (JW Player) In the Floor price text box enter a floor price.

    📘

    Not all mediation options accept a floor price.

    💡

    Determining the best floor price depends upon various factors. If you need assistance determining the best floor price, please consult with your JW Player representative or SSP partner.

  6. (JW Player) Choose your Ad partners:
    1. From the dropdown menu, select an ad partner.
    2. Click Add. The partner's name appears in a list on the lower part of the panel.
    3. (Optional) Repeat this steps i-ii to add another ad partner.

  7. Enter your ad partner information, such as publisher ID, section ID, or channel ID.
  8. From Placement type dropdown menu, select the IAB plcmt attribute.
  9. Enter the GPID.

    📘

    The publisher-defined global placement ID (imp.ext.gpid) represents a specific ad placement across different SSPs or platforms.

  10. From the POS type dropdown menu, select the IAB 5.4 Ad Position value.
  11. Choose whether or not CCPA Applies. If you select Yes, you can click Advanced settings to set the Timeout(ms).

    🚧

    When enabling CCPA, you must have a recognized consent management platform (CMP). Otherwise, Prebid will reject the bid request and a bid error will occur.

  12. Choose whether or not GDPR Applies. If you select Yes, you can click Advanced settings to reveal additional options.
    GDPR Advanced Settings

    Enter your advanced settings for GDPR using either method below.

    Option Description
    Manually configure
    1. Under the Manually configure tab, enter a Timeout interval in milliseconds (ms).
    2. Click the Yes or No radio button to Treat as GDPR as Default.
    3. Select a CMP TCF Version.
    4. Click the Yes or No radio button to Disable Consent Management when No CMP.

    See our Advertising configuration options for more information on disabling consent management when there is no CMP.
    Use existing content block
    1. Under the Use existing content block tab, paste the GDPR object that you are using in your Prebid.js implementation.

    📘

    When enabling GDPR, you must have a recognized consent management platform (CMP). Otherwise, Prebid will reject the bid request and a bid error will occur.


  13. Click Select. The panel closes.


© 2007- Longtail Ad Solutions, Inc.