Represents an ExpandedDynamicSearchAd. This ad will have its
headline, final URLs and display URL auto-generated at serving time
according to domain name specific information provided by
DynamicSearchAdsSetting linked at the campaign level.

Auto-generated fields: headline, final URLs and display URL.

Required fields:description.

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.

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

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.