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
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 of this ad. This field is ignored when creating
ads using This field can be selected using the value "Id".
This field can be filtered on.
|
|
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.
|
|
Visible URL. This field can be selected using the value "DisplayUrl".
This field can be filtered on.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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. |
|
Indicates if this ad was added by AdWords. |
|
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
This field can be selected using the value "AdType".
This field can be filtered on.
|
|
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. |
|
The source of this system-managed ad. Enumerations
This field is read only and will be ignored when sent to the API.
|
|
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. 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. 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. |
|
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.
|
|
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.
|