Ad Data Object

 

Defines the base object of an ad.

Do not try to instantiate an Ad. You can create one or more following objects that derive from it.

<xs:complexType name="Ad">
  <xs:sequence>
    <xs:element minOccurs="0" name="AdFormatPreference" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="DevicePreference" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdEditorialStatus" />
    <xs:element xmlns:q1="http://schemas.datacontract.org/2004/07/Microsoft.AdCenter.Advertiser.CampaignManagement.Api.DataContracts.V11" minOccurs="0" name="FinalAppUrls" nillable="true" type="q1:ArrayOfAppUrl"/>
    <xs:element xmlns:q2="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q2:ArrayOfstring"/>
    <xs:element xmlns:q3="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q3:ArrayOfstring"/>
    <xs:element xmlns:q4="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q4:ArrayOfKeyValuePairOfstringstring"/>
    <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="TrackingUrlTemplate" nillable="true" type="xs:string"/>
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:AdType" />
    <xs:element xmlns:q5="http://schemas.datacontract.org/2004/07/Microsoft.AdCenter.Advertiser.CampaignManagement.Api.DataContracts.V11" minOccurs="0" name="UrlCustomParameters" nillable="true" type="q5:CustomParameters"/>
  </xs:sequence>
</xs:complexType>

ElementDescriptionData Type
AdFormatPreferenceThe Ad Format Preference is used to indicate whether or not you prefer the ad copy to be shown to users as a search or native ad. Search ads tend to be written as a call to action, whereas native ads should be written in more of an informational style.

By defining at least one ad that should be used as native, the search ads will only be shown in search results.

Possible values are Native and All. If set to All, the ad will be eligible for both search and native ad formats. If set to Native, the ad will only be eligible for the native ad format.

Ad Format Preference is only supported for ExpandedTextAd and TextAd objects.
string
DevicePreferenceDetermines the device preference for showing the ad.

Device preference is only supported for AppInstallAd and TextAd objects.
long
EditorialStatusThe editorial review status of the ad, which indicates whether the ad is pending review, has been approved, or has been disapproved.AdEditorialStatus
FinalAppUrlsReserved for future use.AppUrl array
FinalMobileUrlsThe mobile landing page URL.

Final mobile URLs is only supported for text ads. For more details see TextAd.
string array
FinalUrlsThe last or final URL where a user is ultimately taken, whether or not the click to final URL path included any redirects.

Final URLs are only supported for AppInstallAd, ExpandedTextAd, and TextAd objects.
string array
ForwardCompatibilityMapThe 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.

Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for this object.
KeyValuePairOfstringstring array
IdThe unique Bing Ads identifier for the ad.long
StatusThe status of the ad.AdStatus
TrackingUrlTemplateThe tracking template to use as a default for all landing page URLs.

Tracking template is only supported for AppInstallAd, DynamicSearchAd, ExpandedTextAd, and TextAd objects. It is not supported for the ProductAd object.
string
TypeThe type of the ad. For more information about ad types, see the Remarks.AdType
UrlCustomParametersYour custom collection of key and value parameters for URL tracking.

Custom parameters are only supported for AppInstallAd, DynamicSearchAd, ExpandedTextAd, and TextAd objects. They are not supported for the ProductAd object.
CustomParameters

For Java and the .NET languages, do not set the Type element because the value is determined by whether you instantiate an expanded text ad or another type of 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 an expanded text ad or another type of ad.

<Ads xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Ad i:type="ExpandedTextAd">
    <DevicePreference i:nil="true" />
    <EditorialStatus i:nil="true" />
    <ForwardCompatibilityMap i:nil="true" />
    <Id i:nil="true" />
    <Status i:nil="true" />
    <FinalUrls xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <a:string>http://www.contoso.com/womenshoesale</a:string>
    </FinalUrls>
    <Path1>seattle</Path1>
    <Path2>shoe sale</Path2>
    <Text>Find New Customers & Increase Sales! Start Advertising on Contoso Today.</Text>
    <TitlePart1>Contoso</TitlePart1>
    <TitlePart2>Fast & Easy Setup</TitlePart2>
  </Ad>
</Ads>

CampaignManagementService.svc v11

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

AddAds
DeleteAds
GetAdsByAdGroupId
GetAdsByEditorialStatus
GetAdsByIds
UpdateAds

Show: