type ResponsiveSearchAd (v201809)

Service

AdGroupAdService AdService

Inheritance

Ad

▼

CallOnlyAd DeprecatedAd DynamicSearchAd ExpandedDynamicSearchAd ExpandedTextAd GmailAd ImageAd MultiAssetResponsiveDisplayAd ProductAd ResponsiveDisplayAd ResponsiveSearchAd RichMediaAd ShowcaseAd TemplateAd TextAd UniversalAppAd

Represents a responsive search ad.

Important

• Responsive search ads are in beta. Make sure to regularly monitor the performance and status of your ads.
• Assets can be shown in any order, so make sure that they make sense individually or in combination, and don't violate our policies or local law.
• During the beta, make sure to have at least two expanded text ads in the same ad group with your responsive search ad.
• If you have text that should appear in every ad, then you must pin it to either Headline position 1, Headline position 2, or Description position 1.
• To increase the likelihood that your ad shows, be sure to provide at least 5 distinct headlines that don't repeat the same or similar phrases, and leverage the feedback from Ad strength to improve the effectiveness of the ad. Providing redundant headlines will restrict the system's ability to generate combinations. Examples.

Help center documentation

• About responsive search ads
• Create a responsive search ad (check out the examples)

Caution: Responsive search ads do not use url, displayUrl, finalAppUrls, or devicePreference; setting these fields on a responsive search ad will cause an error.

---

Namespace

https://adwords.google.com/api/adwords/cm/v201809

Field
Ad (inherited)
id	xsd:long ID of this ad. This field is ignored when creating ads using AdGroupAdService. This field can be selected using the value "Id". This field can be filtered on.
url	xsd:string Destination URL. Do not set this field if you are using upgraded URLs, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected using the value "Url". This field can be filtered on.
displayUrl	xsd:string Visible URL. This field can be selected using the value "DisplayUrl". This field can be filtered on.
finalUrls	xsd:string[] A list of possible final URLs after all cross domain redirects. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected using the value "CreativeFinalUrls". This field can be filtered on. The maximum size of this collection is 10.
finalMobileUrls	xsd:string[] A list of possible final mobile URLs after all cross domain redirects. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected using the value "CreativeFinalMobileUrls". This field can be filtered on. The maximum size of this collection is 10.
finalAppUrls	AppUrl[] A list of final app URLs that will be used on mobile if the user has the specific app installed. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected using the value "CreativeFinalAppUrls". This field can be filtered on.
trackingUrlTemplate	xsd:string URL template for constructing a tracking URL. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected using the value "CreativeTrackingUrlTemplate". This field can be filtered on.
finalUrlSuffix	xsd:string URL template for appending params to Final URL. On update, empty string ("") indicates to clear the field. This field can be selected using the value "CreativeFinalUrlSuffix". This field can be filtered on.
urlCustomParameters	CustomParameters A list of mappings to be used for substituting URL custom parameter tags in the trackingUrlTemplate, finalUrls, and/or finalMobileUrls. This field is used for upgraded urls only, as described at: https://developers.google.com/adwords/api/docs/guides/upgraded-urls This field can be selected using the value "CreativeUrlCustomParameters". This field can be filtered on.
urlData	UrlData[] Additional urls for the ad that are tagged with a unique identifier. Currently only used for TemplateAds for specific template IDs. For all other ad types, use finalUrls, finalMobileUrls and finalAppUrls instead.
automated	xsd:boolean Indicates if this ad was added by AdWords.
type	Ad.Type Type of ad. Indicates that this instance is a subtype of Ad. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead. Enumerations DEPRECATED_AD IMAGE_AD PRODUCT_AD TEMPLATE_AD TEXT_AD THIRD_PARTY_REDIRECT_AD DYNAMIC_SEARCH_AD CALL_ONLY_AD EXPANDED_TEXT_AD RESPONSIVE_DISPLAY_AD SHOWCASE_AD GOAL_OPTIMIZED_SHOPPING_AD EXPANDED_DYNAMIC_SEARCH_AD GMAIL_AD RESPONSIVE_SEARCH_AD MULTI_ASSET_RESPONSIVE_DISPLAY_AD UNIVERSAL_APP_AD UNKNOWN This field can be selected using the value "AdType". This field can be filtered on.
devicePreference	xsd:long The device preference for the ad. You can only specify a preference for mobile devices (CriterionId 30001). If unspecified (no device preference), all devices are targeted.
systemManagedEntitySource	SystemManagedEntitySource The source of this system-managed ad. Enumerations UNKNOWN AD_VARIATIONS Generated ad variations experiment ad. This field is read only and will be ignored when sent to the API.
Ad.Type	xsd:string Indicates that this instance is a subtype of Ad. Although this field is returned in the response, it is ignored on input and cannot be selected. Specify xsi:type instead.
ResponsiveSearchAd
headlines	AssetLink[] Headlines. When the Ad serves, the headlines will be selected from this list. This field can be selected using the value "ResponsiveSearchAdHeadlines". This field is required and should not be null when it is contained within Operators : SET.
descriptions	AssetLink[] Descriptions. When the Ad serves, the descriptions will be selected from this list. This field can be selected using the value "ResponsiveSearchAdDescriptions". This field is required and should not be null when it is contained within Operators : SET.
path1	xsd:string Text that appears in the ad with the displayed URL. This field can be selected using the value "ResponsiveSearchAdPath1". This field can be filtered on.
path2	xsd:string In addition to path1, more text that appears with the displayed URL. This field can be selected using the value "ResponsiveSearchAdPath2". This field can be filtered on.