Export (0) Print
Expand All
Ad
Bid
Expand Minimize

SiteLink Data Object

Defines a site link to include in an ad. The link should take the user to content in your website that is relevant in the context of the ad.

<xs:complexType name="SiteLink">
  <xs:sequence>
    <xs:element name="Description1" type="xs:string" nillable="true" minOccurs="0" >
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/" EmitDefaultValue="false"/>
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element name="Description2" type="xs:string" nillable="true" minOccurs="0" >
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/" EmitDefaultValue="false"/>
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element name="DestinationUrl" type="xs:string" nillable="true"  />
    <xs:element name="DevicePreference" type="xs:long" nillable="true" minOccurs="0" >
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue xmlns="http://schemas.microsoft.com/2003/10/Serialization/" EmitDefaultValue="false"/>
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element name="DisplayText" type="xs:string" nillable="true" />
  </xs:sequence>
</xs:complexType>

Elements

Element

Description

Data Type

Add

Update

Description1

System_CLiX_noteNote

This element is available for pilot customers.

The site link description line 1.

The description may contain a maximum of 35 characters.

System_CLiX_noteNote

If you specify Description1 then Description2 is required.

The description will only be displayed if both Description1 and Description2 elements are specified for all site links of a SiteLinksAdExtension Data Object.

string

Optional

Optional

Description2

System_CLiX_noteNote

This element is available for pilot customers.

The site link description line 2.

The description may contain a maximum of 35 characters.

System_CLiX_noteNote

If you specify Description2 then Description1 is required.

The description will only be displayed if both Description1 and Description2 elements are specified for all site links of a SiteLinksAdExtension Data Object.

string

Optional

Optional

DestinationUrl

The URL of the webpage that users are taken to when they click the site link. The URL can contain a maximum of 1,024 characters.

If the URL specifies the HTTP protocol at the time you add the extension, the service will remove the http:// protocol string from the URL.

The URL can contain dynamic text strings such as {keyword}. For more information, see Dynamic Text for Site Links.

string

Required

Optional

DevicePreference

System_CLiX_noteNote

This element is available for pilot customers.

This element determines whether the preference is for site links to be displayed on mobile devices or all devices.

To specify a preference for mobile devices, set this element to 30001.

To specify all devices, set this element to 0 (zero) or leave the element nil. By default, this element will be nil.

long

Optional

Optional

DisplayText

The site-link text displayed in the ad. The text can contain a maximum of 35 characters.

string

Required

Optional

Requirements

CampaignManagementService.svc v9

Namespace: https://bingads.microsoft.com/CampaignManagement/v9

Community Additions

ADD
Show:
© 2014 Microsoft