Represents a dynamic search ad. This ad will have its headline and destination URL auto-generated at serving time according to domain name specific information provided by DomainInfoExtension linked at the campaign level.

Your account must first be whitelisted for Dynamic Search Ads to use the feature in the API. Find out more and sign up for the beta.

Auto-generated fields: headline and destination URL (may contain an optional tracking URL)

Required fields: description1, description2, displayUrl

The url field must contain at least one of the following placeholder tags (URL parameters): {unescapedlpurl}, {escapedlpurl}, {lpurlpath}. If no URL is specified, {unescapedlpurl} will be used as default.

{unescapedlpurl} can only be used at the beginning of the url field. It 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.

{lpurlpath} will be replaced with the path and query part of the landing page URL and can be added to a different URL, e.g. "http://www.mygoodbusiness.com/tracking/{lpurlpath}".

There are also special rules that come into play depending on whether the destination URL uses local click tracking or third-party click tracking.

For more information, see the article Using dynamic tracking URLs. This is disabled for AdX when it is contained within Operators: ADD, SET. This is a beta feature.

Namespace

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

Fields

• id
• url
• displayUrl
• disapprovalReasons
• Ad.Type
• description1
• description2