Define a client-side ad schedule

A manual ad schedule defines how ad breaks are explicitly placed within your video content.

By manually inserting ad breaks and configuring ad rules, timing, and bidding settings, you control when ads are eligible to play during playback.

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 a VPAID ad is requested.

   
   
3. Click + (plus icon) to create a Preroll, Midroll, or Postroll ad break. A configuration panel appears.
4. Enter an 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. (VAST - Optional) Click + Add waterfall tag to enter an additional Ad tag URL.

   💡

   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.
      Timecode	Enter the video location as a timecode in hh:mm:ss.mmm format. Example: 00:15:25.001
      % of video	Enter the video location as a percentage of the video. Example: Enter 15 for 15%.



9. Click Done.
10. (Optional) Repeat steps 3-9 to configure an additional ad break.
11. Expand the Advanced ad rules section and set the 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	(VAST) 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	(VAST) 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.

A VMAP ad schedule defines how ad breaks are scheduled using a VMAP ad tag.

By configuring ad rules, timing, and bidding settings, you control when ads are eligible to play throughout video playback.

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 a VPAID ad is requested.

   
   
3. Enter an 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.

4. Expand the Advanced ad rules section and set the 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	(VAST) 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	(VAST) 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.

A Dynamic Ads schedule defines how ad breaks are scheduled using playback rules that control ad frequency, timing, and eligibility during playback.

This approach allows you to balance monetization and viewer experience without manually placing ad breaks.

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

Follow these steps to configure Dynamic Ads:

1. Under Configure ad breaks, choose Dynamic Ads.

   📘

   When JWX Ad Server has been chosen, Dynamic Ads is automatically selected and greyed out.

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. Add Ad events to your content.
   VAST, Google IMA

   1. Click + Add next to Preroll or Midroll. The configuration panel appears.
   2. 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.

   3. Click Done
   4. (Optional) Repeat steps i-iii to add another ad event.

   
   

   ---

   JWX Ad Server

   1. Click the toggle to ON for the ad events to enable for your content.

      📘

      You can enable one or both types of ad events.

   
   


4. Define Ad rules that allow your ad events to adapt to your goals in real time.

   Rule	Description
   Presets	Defines how ads are scheduled relative to content Possible options: 1:1 Balanced Sets 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 Maximized Sets 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. Custom Enables setting a specific content-to-ads ratio
   Ratio Type	(Custom) 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	(Custom) 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	(Custom) 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.