ResponsiveDisplayAdInfo

  • Responsive display ads use various assets like images, text, and videos to dynamically create ads.

  • Specific dimensions and aspect ratios are required for different image types, and there are limits on the number of images and videos that can be used.

  • Headlines and descriptions have character limits, and there are both short and long headline options available.

  • Optional elements include YouTube videos, color specifications, call-to-action text, price prefixes, and promo text.

A responsive display ad.

Fields

marketing_images[]

AdImageAsset

Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15.

square_marketing_images[]

AdImageAsset

Square marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15.

logo_images[]

AdImageAsset

Logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5.

square_logo_images[]

AdImageAsset

Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with logo_images, the maximum is 5.

headlines[]

AdTextAsset

Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.

long_headline

AdTextAsset

A required long format headline. The maximum length is 90 characters.

descriptions[]

AdTextAsset

Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.

youtube_videos[]

AdVideoAsset

Optional YouTube videos for the ad. A maximum of 5 videos can be specified.

format_setting

DisplayAdFormatSetting

Specifies which format the ad will be served in. Default is ALL_FORMATS.

control_spec

ResponsiveDisplayAdControlSpec

Specification for various creative controls.

business_name

string

The advertiser/brand name. Maximum display width is 25.

main_color

string

The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.

accent_color

string

The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well.

allow_flexible_color

bool

Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set.

call_to_action_text

string

The call-to-action text for the ad. Maximum display width is 30.

price_prefix

string

Prefix before price. For example, 'as low as'.

promo_text

string

Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.