Image (AdImage)

Ads can be supplemented with images. Ads with images attract more attention and have a higher click-through rate.

One ad may have only one image associated with it. One image may be associated with multiple ads. The API allows you to associate an ad with any image belonging to the client.

Requirements for images uploaded via the API

  • Allowed image formats: JPG, PNG, GIF.

  • Image size:

    • When the aspect ratio is from 1:1 to 3:4/4:3 — from 450 to 5000 pixels on a side.

    • When the aspect ratio is 16:9, each side must be from 1080 × 607 to 5000 × 2812 pixels long.

  • When uploading a file by URL, the maximum file size is 10 MB.

    When uploading binary data, the maximum length of the base64 string is 120,000,000 characters.

Restriction on quantity of images

The maximum number of images stored on the server per client is 1000 + 2 × the number of ads.

To check how many images a client can upload and how many have already been uploaded or are being uploaded, use the GetLimits action for theAdImage (Live) method.