Field Name

Modifier & Defaults

Type

Description

creative_crop

Optional

Object

Contains crop_data array.

Allows you to provide different images for specific aspect ratios.

Use this field to upload tailored images for different placements (e.g. 16:9, 1:1).

crop_data array

Each entry in the crop_data array specifies an image for a particular aspect ratio.

Field	Type	Description
ratio	Object	The aspect ratio for this image. Contains `width` and `height` integers.
area	Object	Optional. Cropping coordinates within the image. Contains `top_left_x`, `top_left_y`, `width`, `height`.
url	String	The URL of the replacement image for this aspect ratio.

ratio object

Field	Type	Description
width	Integer	The width component of the aspect ratio (e.g. 16 for 16:9).
height	Integer	The height component of the aspect ratio (e.g. 9 for 16:9).

area object

Field	Type	Description
top_left_x	Integer	X coordinate of the crop area's top-left corner.
top_left_y	Integer	Y coordinate of the crop area's top-left corner.
width	Integer	Width of the crop area in pixels.
height	Integer	Height of the crop area in pixels.

Example

{
  "creative_crop": {
    "crop_data": [
      {
        "ratio": { "width": 16, "height": 9 },
        "url": "https://cdn.example.com/wide-image.jpg"
      },
      {
        "ratio": { "width": 1, "height": 1 },
        "url": "https://cdn.example.com/square-image.jpg"
      }
    ]
  }
}

📘
When to use creative_crop

Use creative_crop when your image contains logos or text that may be cropped awkwardly at certain aspect ratios.

Provide a dedicated image for each aspect ratio where precise control is needed.

The system serves the appropriate image based on the placement's aspect ratio requirements.

🚧
Limitations

Multi-image cropping is not supported for motion ads. If included in a motion ad request, the creative_crop field is ignored.

Supported on create and update endpoints only.