Represents a dynamic search ad. This ad will have its headline and final URL auto-generated at serving time according to domain name specific information provided by DynamicSearchAdsSetting at the campaign level.
Auto-generated fields: headline and final URL.
Note: we recommend using the ExpandedDynamicSearchAd type, introduced in v201705, rather than the DynamicSearchAd type.
Required fields:
description1
, description2
, displayUrl
.
The tracking URL field must contain at least one of the following placeholder tags (URL parameters):
- {unescapedlpurl}
- {escapedlpurl}
- {lpurl}
- {lpurl+2}
- {lpurl+3}
- {unescapedlpurl} will be replaced with the full landing page URL of the displayed ad. Extra query parameters can be added to the end, e.g.: "{unescapedlpurl}?lang=en".
- {escapedlpurl} will be replaced with the URL-encoded version of the full landing page URL. This makes it suitable for use as a query parameter value (e.g.: "http://www.3rdpartytracker.com/?lp={escapedlpurl}") but not at the beginning of the URL field.
- {lpurl} encodes the "?" and "=" of the landing page URL making it suitable for use as a query parameter. If found at the beginning of the URL field, it is replaced by the {unescapedlpurl} value. E.g.: "http://tracking.com/redir.php?tracking=xyz&url={lpurl}".
- {lpurl+2} and {lpurl+3} will be replaced with the landing page URL escaped two or three times, respectively. This makes it suitable if there is a chain of redirects in the tracking URL.
Note that finalUrls
and finalMobileUrls
cannot be set for dynamic search
ads.
For more information, see the article Using dynamic tracking URLs.
- 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. This field can be selected using the value "UrlData".
|
|
Indicates if this ad was added by AdWords. This field can be selected using the value "Automated".
This field can be filtered on.
|
|
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. This field can be selected using the value "DevicePreference".
This field can be filtered on.
|
|
The source of this system-managed ad. Enumerations
This field can be selected using the value "SystemManagedEntitySource".
This field can be filtered on.
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. |
DynamicSearchAd
|
|
|
The first description line. This field can be selected using the value "Description1".
This field can be filtered on.
|
|
The second description line. This field can be selected using the value "Description2".
This field can be filtered on.
|