Image Data Object - Campaign Management

Defines an image object that can be added to an account's media library.

The Image object derives from the Media object. For a list of the inherited elements, see the Media object.

Syntax

<xs:complexType name="Image" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Media">
      <xs:sequence>
        <xs:element minOccurs="0" name="Data" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element Description Data Type
Data A base64 string that represents the image or icon to add to the library. The base64 string can contain a maximum of 102,400 characters.

For information about restrictions and supported data types, see Remarks below.
string

The Image object has Inherited Elements.

Inherited Elements

Inherited Elements from Media

The Image object derives from the Media object, and inherits the following elements. The descriptions below are specific to Image, and might not apply to other objects that inherit the same elements from the Media object.

Element Description Data Type
Id The unique Bing Ads identifier of the media.

Add: Read-only
long
MediaType The type of media to add to the library.

For media that will be used with an ImageAdExtension, the supported values are Image16x9, Image15x10, Image4x3, and Image12x10.

For media that will be used with a ResponsiveAd, the supported values are Image1x1, Image191x100, and Image4x1.

For more information about supported aspect ratios, see the Remarks section below.

Add: Required
string
Type The media type. For more information about media types, see the Media Data Object Remarks.

Add: Read-only
string

Remarks

The following MIME types are supported for the Data element of the Image data object.

  • GIF
  • JPEG
  • PNG

Images with animation are not supported.

Image Ad Extension Image Media

The following restrictions apply to Media types (aspect ratios) that will be used with an ImageAdExtension.

MediaType Aspect Ratio Minimum Dimension Maximum Dimension
Image16x9 16:9 640 width x 360 height, in pixels 1778 width x 1000 height, in pixels
Image15x10 1.5:1 300 width x 200 height, in pixels 1500 width x 1000 height, in pixels
Image4x3 4:3 100 width x 75 height, in pixels 1333 width x 1000 height, in pixels
Image12x10 1.2:1 300 width x 250 height, in pixels 1200 width x 1000 height, in pixels

Note

The maximum file size is 5 MB, but the recommended maximum file size is 1MB.

Responsive Ad Image Media

The following restrictions apply to Media types (aspect ratios) that will be used with a ResponsiveAd.

Responsive Ad Property Media Type Dimensions in pixels
LandscapeImageMediaId Image191x100 Minimum: 600 width x 314 height
Maximum: Aspect radio 1.91:1 up to the maximum file size of 1MB.
Recommended: 1200 width x 628 height
LandscapeLogoMediaId Image4x1 Minimum: 512 width x 128 height
Maximum: Aspect radio 4:1 up to the maximum file size of 1MB.
Recommended: 1200 width x 300 height
SquareImageMediaId Image1x1 Minimum: 300 width x 300 height
Maximum: Aspect radio 1:1 up to the maximum file size of 1MB.
Recommended: 1200 width x 1200 height
SquareLogoMediaId Image1x1 Minimum: 128 width x 128 height
Maximum: Aspect radio 1:1 up to the maximum file size of 1MB.
Recommended: 1200 width x 1200 height

Note

The maximum file size is 5 MB. The maximum width and height in pixels are 2592 and 2048 independently, and you must still maintain one of the supported aspect ratios. For example if the image for your LandscapeImageMediaId is 2592 in width, then the height must be 1357.

Requirements

Service: CampaignManagementService.svc v12
Namespace: https://bingads.microsoft.com/CampaignManagement/v12