com.google.api.ads.adwords.jaxws.v201809.cm

Class DynamicSearchAd

java.lang.Object

com.google.api.ads.adwords.jaxws.v201809.cm.Ad

com.google.api.ads.adwords.jaxws.v201809.cm.DynamicSearchAd

public class DynamicSearchAd
extends Ad

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.

This is disabled for AdX when it is contained within Operators: ADD, SET.

Java class for DynamicSearchAd complex type.

The following schema fragment specifies the expected content contained within this class.

 <complexType name="DynamicSearchAd">
   <complexContent>
     <extension base="{https://adwords.google.com/api/adwords/cm/v201809}Ad">
       <sequence>
         <element name="description1" type="{http://www.w3.org/2001/XMLSchema}string" minOccurs="0"/>
         <element name="description2" type="{http://www.w3.org/2001/XMLSchema}string" minOccurs="0"/>
       </sequence>
     </extension>
   </complexContent>
 </complexType>
 

Field Summary

Fields

Modifier and Type	Field and Description
protected String	description1
protected String	description2

Fields inherited from class com.google.api.ads.adwords.jaxws.v201809.cm.Ad

adType, automated, devicePreference, displayUrl, finalAppUrls, finalMobileUrls, finalUrls, finalUrlSuffix, id, systemManagedEntitySource, trackingUrlTemplate, type, url, urlCustomParameters, urlData

Constructor Summary

Constructors

Constructor and Description
DynamicSearchAd()

Method Summary

Modifier and Type	Method and Description
String	getDescription1() Gets the value of the description1 property.
String	getDescription2() Gets the value of the description2 property.
void	setDescription1(String value) Sets the value of the description1 property.
void	setDescription2(String value) Sets the value of the description2 property.

Methods inherited from class com.google.api.ads.adwords.jaxws.v201809.cm.Ad

getAdType, getDevicePreference, getDisplayUrl, getFinalAppUrls, getFinalMobileUrls, getFinalUrls, getFinalUrlSuffix, getId, getSystemManagedEntitySource, getTrackingUrlTemplate, getType, getUrl, getUrlCustomParameters, getUrlData, isAutomated, setAdType, setAutomated, setDevicePreference, setDisplayUrl, setFinalUrlSuffix, setId, setSystemManagedEntitySource, setTrackingUrlTemplate, setType, setUrl, setUrlCustomParameters

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

description1

protected String description1

description2

protected String description2

Constructor Detail

DynamicSearchAd

public DynamicSearchAd()

Method Detail

getDescription1

public String getDescription1()

Gets the value of the description1 property.

Returns:

possible object is String

setDescription1

public void setDescription1(String value)

Sets the value of the description1 property.

Parameters:

value - allowed object is String

getDescription2

public String getDescription2()

Gets the value of the description2 property.

Returns:

possible object is String

setDescription2

public void setDescription2(String value)

Sets the value of the description2 property.

Parameters:

value - allowed object is String