0 out of 1 rated this helpful - Rate this topic

TextAd Data Object

Defines a text ad.

<xs:complexType name="TextAd">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element name="DisplayUrl" nillable="true" type="xs:string" />
        <xs:element name="Text" nillable="true" type="xs:string" />
        <xs:element name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elements

Element	Description	Data Type	Add	Update
DestinationUrl	The URL of the webpage to take the user to when they click the ad. The URL can contain a maximum of 1,024 characters. This URL is used only if the keyword does not specify a destination URL. For more information, see Keyword Destination URL.	string	Required	Optional
DisplayUrl	The URL to display in the ad. The maximum input length of the URL is 200 characters, and can contain dynamic text strings. However, the ad will fail to display if the URL exceeds 35 characters after dynamic text substitution occurs.	string	Required	Optional
Text	The ad copy. The copy must contain at least one word. The ad’s copy and title combined must total at least three words. The maximum input length of the copy is 300 characters, and can contain dynamic text strings. However, the ad will fail to display if the copy exceeds 71 characters after dynamic text substitution occurs. Note that for ad groups that use Traditional Chinese, the text is limited to 38 characters after substitution. The text cannot contain the newline (\n) character.	string	Required	Optional
Title	The title of the ad. The title must contain at least one word. The ad’s copy and title combined must total at least three words. The maximum input length of the title is 80 characters, and can contain dynamic text strings. However, the ad will fail to display if title exceeds 25 characters after dynamic text substitution occurs. Note that for ad groups that use Traditional Chinese, the title is limited to 15 characters after substitution. The title cannot contain the newline (\n) character.	string	Required	Optional

The TextAd object derives from the Ad object. For a list of the inherited elements, see the Ad object.

Remarks

The combination of the DisplayUrl, Text, and Title elements make the ad unique.

The ad’s text, title, display URL, and destination URL can include dynamic text strings that you use to customize the ad based on the user’s search query. For more information, see Dynamic Text Substitution.

To decorate the ad with additional information such as deep links or the phone number and address of your business, see Managing Ad Extensions.

Note
If the URL specifies the HTTP protocol when you add an ad, the service will remove the http:// protocol string (the HTTP protocol string does not count against the 1,024 character limit); however, the service will not remove an HTTPS protocol string (https://) from the URL. If the URL does not specify a protocol, the system uses the HTTP protocol when a user clicks the ad.

Note

If the URL specifies the HTTP protocol when you add an ad, the service will remove the http:// protocol string (the HTTP protocol string does not count against the 1,024 character limit); however, the service will not remove an HTTPS protocol string (https://) from the URL.

If the URL does not specify a protocol, the system uses the HTTP protocol when a user clicks the ad.

Requirements

CampaignManagementService.svc v8

Namespace: https://adcenter.microsoft.com/v8

Community Additions

ADD

TextAd Data Object

Elements

Requirements

See Also

Reference

Community Additions