Submitting motion assets

Creating motion ads

When creating a motion ad, you must provide 2 URLs:

  1. A URL for the video.
  2. A URL for the static fallback image.

In return, the Taboola solution generates 3 new assets in the Taboola CDN:

  1. An optimized video file, in MP4 format.
  2. A GIF, based on the above MP4.
  3. An optimized fallback image.

Serving motion ads

When serving your motion ad, Taboola will serve the appropriate asset, based on the publisher account settings:

SettingFile served
Publisher allows video?Video (MP4) is served
Else - publisher allows animatedGIF?GIF is served
Else...The default image (aka fallback image) is served.

Submitting motion ad assets

Flow 1 - Use your own CDN

  1. Upload the following assets to your own CDN:
    • Video file.
    • Default image (aka fallback image).
  2. Using the unified items/bulk endpoint, create new video items, passing the above URLs.
📘

Motion Ad Guidelines

For guidelines and best practices, refer to the Help Center, or sync with your Taboola Account Manager.

📘

Image Guidelines

For thumbnail image guidelines and best practices, refer to the Help Center, or sync with your Taboola Account Manager.

Flow 2 - Use the Taboola CDN

  1. Using the operations/upload-image endpoint, upload the following assets to the Taboola CDN:
    • Animated GIF file (the system converts it to MP4). MOV and MP4 files aren't supported by this endpoint; use Flow 1 for those.
    • Default image (aka fallback image).
  2. Using the unified items/bulk endpoint, create new video items, passing the above URLs.
📘

Supported formats

operations/upload-image accepts image files only, so for motion assets it supports GIF. GIFs are automatically converted to MP4. To submit an MP4 or MOV video, host it on your own CDN and use Flow 1.

📘

Uploading to the Taboola CDN

For more information about the operations/upload-image endpoint see:



Did this page help you?