CreativeTech Wiki (internal)

Explore

Reference

Building a Flex Frame Video Unit

Flex Frames

We've refactored the video units to fix several stability-related issues and made some quality of life improvements in how video units are built.

Video units are now:

Backwards compatible — will not have issues with previous versions of video ads.

Intelligent streaming — when possible, the video units will automatically stream.

Autoplay guard — regardless of which video type you choose or whether autoplay is set to on (true) or off (false), the ad unit will only autoplay when allowed.

HLS guard — since this is an auto-streaming unit, the software will always choose the correct HLS file.

Easy to build — you only need to add a single Scoop .mp4 OR a self-hosted .mp4.

NEW docs — robust video docs to come.

Video units:

⁠

Flex Frame (Desktop/Mobile)⁠

⁠

Flex XL (Desktop/Mobile)⁠

⁠

FlexXL Nested (Desktop)⁠

⁠

Flex Frame 1x1, 2col (Desktop)⁠

⁠

Flex Frame 1x1, 3col (Desktop)⁠

⁠

Adding video to a video unit

Scoop-hosted Video

Build the unit as you normally would.

⁠

UPLOAD your video to Scoop⁠

and copy/paste the best .mp4 URL into to the MediaURL field in GAM.

Add your cover and set the autoplay to be on (true) or off (false).

That’s it.

⁠

Scoop

Scoop

⁠

GAM

GAM

⁠

Scoop-hosted Video Behavior

MP4 NON-AUTOPLAY — Will play streaming video.

MP4 AUTOPLAY — Will play a specific .mp4 version of the video.

NOTES:

Entries where both .mp4 and .m3u8 videos were added will still work.

⁠

All scenarios tested on each unit⁠

You DO NOT need to add both the .mp4 and .m3u8 to the mediaURL field in GAM.

Self-hosted Video

Build the unit as you normally would.

UPLOAD an .mp4 video to your bucket and copy/paste it’s URL into the MediaURL field in GAM. (See images above.)

Add your cover and set the autoplay to be on (true) or off (false).

That’s it.

Self-hosted Video Behavior

MP4 NON-AUTOPLAY — Will play the hosted version of the video.

MP4 AUTOPLAY — Will play the hosted version of the video.

⁠

Backward compatibility notes

The player is designed to work with the following previous use case:

non scoop mp4 urls

HLS or HLSMpeg url

video url in “Mp4VideoUrl” instead of “MediaURL”

Some Common Mistakes

Don’t leave the VideoCover field empty. The video needs a poster image to work properly.

The AutoPlay field will be false by default. If you find that field empty, set it. Leaving it empty will cause issues.

If you are using any external video, make sure it’s a Google Bucket hosted URL.

When adding the MediaURL, a space before or after the url will cause issues.

⁠

Heavy Ad Warning

4mb ads or larger will cause Google Chrome browsers to flag your ad as “heavy” and block it from displaying. Please choose a video file that is less than 4mb (ideally 3mb or less).

⁠