Create a motion ad

📍

UPDATE

The Bulk Create Items endpoint now supports both static ads and motion ads. Accordingly, the motion-specific create endpoint has been deprecated. For detailed guidance, see the overview.

These 2 flows can be used for creating new video items (aka video sponsored content).

Flow 1 - 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.
   • Set video_url to the URL of the above video file.
   • Set fallback_url to the URL of the above default image.

📘

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

1. Using the operations/upload-image endpoint, upload the following assets to the Taboola CDN:
   • Video file (GIF, MOV, or MP4 - the system will optimize to MP4 format).
   • Default image (aka fallback image).
2. Using the unified items/bulk endpoint, create new video items.
   • Set video_url to the URL of the above video file.
   • Set fallback_url to the URL of the above default image.

📘

Supported Video Formats

The Taboola CDN accepts GIF, MOV, and MP4 files. All formats are automatically optimized to MP4 for optimal playback performance.

📘

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

• Upload Image From Local Device.
• Campaign Items > End-To-End Flow.

Update a motion ad

• For updating individual motion ads, use the motion-specific update endpoint.
• For bulk updates, use the unified bulk update endpoint.

📘

For detailed examples and usage, see Update a Performance Video Item (Motion Ad).