API ReferenceAnnouncementsCommunity Discussion
API ReferenceCommunity DiscussionAnnouncementsSubscribeLog In
API Reference

Performance Video Items (Motion Ads) - Flow

The following flows can be used for creating new video items (aka video sponsored content).

🚧

ALL flows are relevant for performance video items (motion ads) only*.

For more information, see: Performance Video Items (Motion Ads).

Upload assets separately

Flow 1 - Your own CDN

  1. Upload the following assets to your own CDN:
    • Video asset.
    • Default image (aka fallback image).
  2. Using the performance-video/items endpoint, create a new video item - or update an existing one.
    • Set video_url to the URL of the above video asset.
    • Set fallback_url to the URL of the above default image.

📘

Guidelines for Motion Ads

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 - Taboola CDN

  1. Using the operations/upload-image endpoint, upload the following assets to the Taboola CDN:
    • GIF (video is not supported).
    • Default image (aka fallback image).
  2. Using the performance-video/items endpoint, create a new video item - or update an existing one.
    • Set video_url to the URL of the above GIF
    • Set fallback_url to the URL of the above default image.

📘

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

Upload assets within the same endpoint

  1. Using the performance-video/items endpoint, create a new video item - or update an existing one.
  2. In your request(s), use:
    • multipart/form-data to upload assets.
    • JSON to update field values.

📘

See Create a Performance Video Item (Motion Ad) for examples using cURL.