Export (0) Print
Expand All
Ad
Bid
Expand Minimize

Ad Data Object

Defines the base object of an ad.

<xs:complexType name="Ad">
  <xs:sequence>
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdEditorialStatus" />
    <xs:element minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q1:ArrayOfKeyValuePairOfstringstring" xmlns:q1="http://schemas.datacontract.org/2004/07/System.Collections.Generic" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:AdType" />
  </xs:sequence>
</xs:complexType>

Elements

Element

Description

Data Type

Add

Update

DevicePreference

This element determines whether the preference is for text ads 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.

System_CLiX_noteNote

Applicable for the TextAd object, which inherits all elements from the Ad object. This element will be ignored if specified for other ad types.

long

Optional

Optional

EditorialStatus

The editorial review status of the ad, which indicates whether the ad is pending review, has been approved, or has been disapproved.

AdEditorialStatus

Read-only

Read-only

ForwardCompatibilityMap

The list of key and value strings for forward compatibility. This element can be used to avoid otherwise breaking changes when new elements are added in future releases.

System_CLiX_noteNote

Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for the Ad object.

KeyValuePairOfstringstring array

Read-only

Read-only

Id

The system generated identifier of the ad.

long

Read-only

Required

Status

The status of the ad.

AdStatus

Optional

Optional

Type

The type of the ad. For more information, see Remarks.

AdType

Read-only

Read-only

Do not instantiate this object. Instead you can instantiate the TextAd, MobileAd, or ProductAd object that derives from this object.

For Java and the .NET languages, do not set the Type element because the value is determined by whether you instantiate a text ad or mobile ad.

If you generate the SOAP manually, use the type attribute of the <Ad> node as shown in the following example, to specify whether the ad is a text ad or another type of ad.

<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Ad i:type="TextAd">
    <DevicePreference i:nil="true" />
    <EditorialStatus i:nil="true" />
    <ForwardCompatibilityMap i:nil="true" />
    <Id i:nil="true" />
    <Status i:nil=”true” />
    <DestinationUrl>www.alpineskihouse.com</DestinationUrl>
    <DisplayUrl>AlpineSkiHouse.com</DisplayUrl>
    <Text>Alpine Ski House has a great ski selection.</Text>
    <Title>Alpine Ski House</Title>
  </Ad>
</Ads>

Requirements

CampaignManagementService.svc v9

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

Community Additions

ADD
Show:
© 2014 Microsoft