Creating Responsive Display Ads
Stay organized with collections
Save and categorize content based on your preferences.
As with other ads, ad creation is accomplished using
AdGroupAdService.MutateAdGroupAds.
You can then add the responsive display ad to standard Display
campaigns.
Ad creation
To create a responsive display ad, you need to populate the following required
fields of ResponsiveDisplayAdInfo:
marketing_imagessquare_marketing_imagesheadlineslong_headlinedescriptionsbusiness name
All other fields and images' specifications can be found in the
reference page and the
Help Center article.
Advanced features
- Color controls
- You can customize colors for your responsive display ads to fit your branding
needs by specifying
main_color and
accent_color. Set
allow_flexible_color
to true when you want to let ads serve with different colors than what
you've specified, when necessary.
- Display ad format setting
Responsive display ads can run as both native and non-native formats. The
difference between the two formats is that native format rendering is
controlled by publishers, whereas non-native format rendering is optimized by
Google models, with advertisers' inputs—for example, color information
from main_color and accent_color.
You can set the
format_setting
field to select the format that the ads should run as. However, you cannot
set the format_setting to
NATIVE
when
allow_flexible_color
is false, as the coloring needs to be controlled by publishers in the case
of native formats.
- Ad controls
Responsive display ads can tell you if they've been opted in to generated
videos or asset enhancements through their
control_spec.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-03 UTC.
[null,null,["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eResponsive display ads are created using \u003ccode\u003eAdGroupAdService.MutateAdGroupAds\u003c/code\u003e and can be added to standard Display campaigns.\u003c/p\u003e\n"],["\u003cp\u003eTo create a responsive display ad, you must populate required fields like marketing images, headlines, descriptions, and business name within the \u003ccode\u003eResponsiveDisplayAdInfo\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eCustomize ad colors using \u003ccode\u003emain_color\u003c/code\u003e and \u003ccode\u003eaccent_color\u003c/code\u003e, with \u003ccode\u003eallow_flexible_color\u003c/code\u003e controlling color variations.\u003c/p\u003e\n"],["\u003cp\u003eControl ad format with \u003ccode\u003eformat_setting\u003c/code\u003e, choosing between native (publisher-controlled rendering) and non-native (Google-optimized rendering).\u003c/p\u003e\n"],["\u003cp\u003eResponsive display ads provide insights into generated videos and asset enhancements through their \u003ccode\u003econtrol_spec\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Creating Responsive Display Ads\n\nAs with other ads, ad creation is accomplished using\n[`AdGroupAdService.MutateAdGroupAds`](/google-ads/api/reference/rpc/v21/AdGroupAdService#mutateadgroupads).\nYou can then add the responsive display ad to [standard Display\ncampaigns](//support.google.com/google-ads/answer/2404190).\n\nAd creation\n-----------\n\nTo create a responsive display ad, you need to populate the following required\nfields of [`ResponsiveDisplayAdInfo`](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo):\n\n- `marketing_images`\n- `square_marketing_images`\n- `headlines`\n- `long_headline`\n- `descriptions`\n- `business name`\n\nAll other fields and images' specifications can be found in the\n[reference page](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo) and the\n[Help Center article](//support.google.com/google-ads/answer/7005917).\n\nAdvanced features\n-----------------\n\nColor controls\n: You can customize colors for your responsive display ads to fit your branding\n needs by specifying\n [`main_color`](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo#main_color) and\n [`accent_color`](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo#accent_color). Set\n [`allow_flexible_color`](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo#allow_flexible_color)\n to `true` when you want to let ads serve with different colors than what\n you've specified, when necessary.\n\nDisplay ad format setting\n\n: Responsive display ads can run as both native and non-native formats. The\n difference between the two formats is that native format rendering is\n controlled by publishers, whereas non-native format rendering is optimized by\n Google models, with advertisers' inputs---for example, color information\n from `main_color` and `accent_color`.\n\n You can set the\n [`format_setting`](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo#format_setting)\n field to select the format that the ads should run as. However, you cannot\n set the `format_setting` to\n [`NATIVE`](/google-ads/api/reference/rpc/v21/DisplayAdFormatSettingEnum.DisplayAdFormatSetting#native)\n when\n [`allow_flexible_color`](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo#allow_flexible_color)\n is `false`, as the coloring needs to be controlled by publishers in the case\n of native formats.\n\nAd controls\n\n: Responsive display ads can tell you if they've been opted in to generated\n videos or asset enhancements through their\n [`control_spec`](/google-ads/api/reference/rpc/v21/ResponsiveDisplayAdInfo#control_spec)."]]
