Represents a dynamic search ad. This ad will have its headline and
tracking URL auto-generated at serving time according to domain
name specific information provided by DomainInfoExtension linked at the campaign
level.
Auto-generated fields: headline and optional tracking URL.
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.
This is disabled for AdX when it is contained within Operators: ADD, SET.- Namespace
-
https://adwords.google.com/api/adwords/cm/v201506 - Fields
| Field | Type | Description |
|---|---|---|
| Ad (inherited) | ||
| id |
xsd:long
|
ID of this ad. This field is ignored when creating
ads using AdGroupAdService.
|
| 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 |
| displayUrl |
xsd:string
|
Visible URL. |
| finalUrls CollectionSize
|
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 The maximum size of this collection is 10. |
| finalMobileUrls CollectionSize
|
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 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 |
| 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 |
| 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 |
| devicePreference |
xsd:long
|
The device preference for the ad. |
| 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. |
| DynamicSearchAd | ||
| description1 Filterable
Selectable
|
xsd:string
|
The first description line. This field can be selected using the value "Description1". This field can be filtered on. |
| description2 Filterable
Selectable
|
xsd:string
|
The second description line. This field can be selected using the value "Description2". This field can be filtered on. |
