Vertical Video Discovery ᴮᴱᵀᴬ

Learn how to create a vertical video experience

👍


This is a beta offering. You can request access to this beta feature through your JWP Account Manager.

By using this documentation, you are agreeing to abide by the terms of the JWP Beta Program Agreement.


A vertical video discovery experience allows you to create an interactive and swipeable vertical video experience activated through Dynamic Strategy Rules placements with native monetization options.

Vertical Video Discovery carousel

Vertical Video Discovery carousel

🚧

Before integrating Vertical Video Discovery into your strategy, consider these limitations:

  • Vertical Video Discovery should not be embedded in an iFrame, as this may lead to performance issues.
  • Motion thumbnails are not supported by Vertical Video Discovery.


Prerequisites

Item Description
Vertical Videos Videos with a 9:16 aspect ratio

Follow these steps to upload vertical videos to your JWP account:
  1. Upload the vertical videos to your JWP account.
  2. On the Basic information tab for each video, apply a tag to identify it as a vertical video.

🚧

Videos with a width greater than or equal to their height, such as 4:3 or square aspect ratios, will be automatically filtered out.

Vertical Video Playlist Playlist of vertical videos

Follow these steps to create a playlist:
  1. Create one of the following playlists:
  2. (Article Matching, Dynamic) Filter the Dynamic or Article Matching playlist by the tag applied to the vertical videos.

📘

We strongly recommend building a playlist with a minimum of 10 videos.

Ads Video or display ads to play in a vertical video

Video
Ad tag URL that returns ads in a vertical aspect ratio

📘

If vertical aspect ratio ads are not available, horizontal ads can be used instead. They will render at their standard dimensions and will not be rotated vertically.


Display

Google Ad Manager (GAM) ad unit path configured to serve creatives in one of the following dimensions

  • 300x225
  • 300x250
  • 300x600
  • 320x240
  • 336x280
  • 400x350
  • 480x320
Learn more about creating or configuring a GAM ad unit.
<DIV> Height Requirement <div> element for the placement with a height between 320px and 460px


Define a vertical video discovery experience

Follow these steps to create a vertical video discovery experience:

  1. On the strategy tree, click + Add Experience > Vertical Video Discovery. The Vertical Video Discovery details page appears.
  2. Under Vertical Video Discovery, enter a Name.
  3. Customize media curation.
  4. Choose the user experience.
  5. Customize advertising settings.
  6. Click Done. The experience appears on the decision tree.

Now a vertical video discovery experience have been defined as part of a strategy, you can link the strategy to a placement.



Media Curation

Configure playlist settings, enable recommendations to boost engagement, and pin videos to specific positions.

1 Media curation tab

1. Media curation tab


Follow these steps to curate media:

  1. On the 1. Media curation tab, under Playlist settings, choose a Playlist or single media option.
  2. Select a single media or playlist from the dropdown menu.
  3. (Optional) Select Use a key for media if available (for a single media) or Use a key for playlist if available (for playlist) and enter the key for custom data in the field that appears.

    📘

    If the key is present on the page, the value of the key determines the single media or playlist to use. The selected single media or playlist will be used if the key is not found on the page.

  4. (Optional) Define the Recommendations settings:
    1. Click the Show recommendations toggle to ON.
    2. Select a Recommendations playlist.
    3. Select Use key for playlist if available and enter the key for custom data in the field that appears.

      📘

      If the key is present on the page, the value of the key determines the Recommendations playlist to use. The selected playlist will be used if the key is not found on the page.

  5. (Optional) Under Advanced curation (Optional), curate videos by pinning media to a playlist position.

    Single media
    Follow these steps to pin a single media:
    1. Under Type, choose Single media.
    2. Choose the media to display through one of the following approaches:
      • Select Use Key for media if available and enter the key for custom data in the field that appears.
      • Select a media item from the dropdown menu.
    3. (Optional) To curate more content beyond the Second play settings, click + Subsequent Play and repeat steps 1-2.

    Playlist
    Follow these steps to pin a playlist:
    1. Under Type, choose Playlist.
    2. Choose the media to display through one of the following approaches:
      • Select Use Key for playlist if available and enter the key for custom data in the field that appears.
      • Select a playlist from the dropdown menu.
    3. (Optional) To curate more content beyond the Second play settings, click + Subsequent Play and repeat steps 1-2.

    None
    Follow these steps to not pin media:
    1. Under Type, choose None.
    2. (Optional) To curate more content beyond the Second play settings, click + Subsequent Play and repeat steps 1-2.



UX

Configure video behavior and fullscreen button layout for your vertical video carousel, including autoplay settings, button position, and orientation.

2. UX tab

2. UX tab

  1. On the 2. UX tab, choose the Carousel behavior in desktop.
  2. (Optional) Define the Fullscreen player buttons playout:
    1. Choose the Buttons layout position for the mute and captions button.
    2. Choose the Buttons stack orientation.

      🚧

      Button layout position and button stack orientation cannot be customized through the vertical video CSS.



Advertising

Configure ad delivery for your vertical video playlist, including client selection, ads, and ad frequency.

3. Advertising tab

3. Advertising tab

Follow these steps to define advertising settings:

  1. On the 3. Advertising tab, Select your ad client.
  2. Define the ad.
    Video
    Follow these steps to define a video ad:
    1. Select your ad client.
    2. (VAST, Google IMA) From the Placement type dropdown menu, select the IAB plcmt attribute.

      📘

      Instream placements (1 - Instream, 2 - Accompanying Content) play ads in the same player as the video content, so swiping past skips both.

      Outstream placements (3 - Interstitial, 4 - No Content / Standalone) play ads in a separate player, so swiping past skips only the ad.

    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.

    4. (Optional) Click Use key for ad tag.

    Display
    Follow these steps to define a display ad:
    1. From the Placement type dropdown menu, select the IAB plcmt attribute.
    2. Enter the Google Ad unit path.
    3. (Optional) In the how Display Ad for X seconds, enter a value between 2 to 30.

  3. Under Ad frequency rule, in the Start on full-screen item # field, set the full-screen vertical video before which the first pre-roll ad appears.

    📘

    For example, if you enter 3, the first pre-roll ad appears before the 3rd vertical video.

  4. In the Repeat every 'x' videos field, define how frequently subsequent pre-roll ads appear.


FAQ

How does Vertical Video Discovery decide the number of videos to display?

The number of videos displayed by Vertical Video Discovery depends on the format.

FormatVideos Rendered
Carousel ViewFirst 10 videos from the playlist
Full-screen ViewUp to the playlist limit


© 2007- Longtail Ad Solutions, Inc.