Video (AdVideo)
The Video object (AdVideo) contains a video.
An ad can only have one video (or none at all). You can assign the same video to multiple ads. For more information, see Video extensions in Yandex Direct Help.
Service
The AdVideos service is designed for operations with videos.
To synchronously upload videos by their URL links or as binary data, use the AdVideos method add operation.
The Get operation returns the processing status of uploaded videos.
Video editing is not supported. If you need to edit a video, upload a new video and create a new video extension from it.
You can a create a video extension from a video using the Creatives service. To add a video extension to an ad or remove it from an ad, use the Ads service. See Ad extensions.
A video undergoes moderation only when it is assigned to an ad. See Result of reviewing extensions.
Requirements for videos uploaded via the API
| Format | MP4, WebM, MOV, QT, FLV, AVI |
| Size | 100 MB maximum |
| Duration | Between 5 and 60 sec For non-skippable ads, max video duration is 15 seconds. |
| Aspect ratio | 3:1, 2:1, 1.9:1, 16:9, 4:3, 1.91:1, 1:1, 3:4, 4:5, 9:16, 1:2, 1:3 |
| Minimum resolution | 360p |
| Recommended resolution | 1080p |
| Video frame rate | between 20 and 30 frames/second |
| Video codecs | H.264, VP6F, VP8, Theora |
| Number of video tracks | 1 |
| Minimum quality | 44 kHz, 16 Kbit/s, stereo |
| Audio codecs | AAC, MP3, Vorbis |
| Number of audio tracks | 0 or 1 |
| File codec | avc1, F4V, isom, M4A, M4V, mp4, mp41, mp42, qt |
| Cover | No |
| Format | MP4, WebM, MOV, QT, FLV, AVI |
| Size | 100 MB maximum |
| Duration | Between 5 and 60 sec For non-skippable ads, max video duration is 15 seconds. |
| Aspect ratio | 3:1, 2:1, 1.9:1, 16:9, 4:3, 1.91:1, 1:1, 3:4, 4:5, 9:16, 1:2, 1:3 |
| Minimum resolution | 360p |
| Recommended resolution | 1080p |
| Video frame rate | between 20 and 30 frames/second |
| Video codecs | H.264, VP6F, VP8, Theora |
| Number of video tracks | 1 |
| Minimum quality | 44 kHz, 16 Kbit/s, stereo |
| Audio codecs | AAC, MP3, Vorbis |
| Number of audio tracks | 0 or 1 |
| File codec | avc1, F4V, isom, M4A, M4V, mp4, mp41, mp42, qt |
| Cover | No |