Edit

Share via

PriceTableRow Data Object - Campaign Management

  • Article

Defines pricing information by currency and unit that you can use with price ad extensions.

Syntax

<xs:complexType name="PriceTableRow" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="CurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
    <xs:element xmlns:q54="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q54:ArrayOfstring" />
    <xs:element xmlns:q55="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q55:ArrayOfstring" />
    <xs:element minOccurs="0" name="Header" nillable="true" type="xs:string" />
    <xs:element name="Price" type="xs:double" />
    <xs:element name="PriceQualifier" type="tns:PriceQualifier" />
    <xs:element name="PriceUnit" type="tns:PriceUnit" />
    <xs:element minOccurs="0" name="TermsAndConditions" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TermsAndConditionsUrl" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elements

The PriceTableRow object has the following elements: CurrencyCode, Description, FinalMobileUrls, FinalUrls, Header, Price, PriceQualifier, PriceUnit, TermsAndConditions, TermsAndConditionsUrl.

Element Description Data Type
CurrencyCode The currency code for the listed price.

The supported currency codes are ARS, AUD, BRL, CAD, CHF, CLP, CNY, COP, DKK, EUR, GBP, HKD, INR, MXN, NZD, PEN, PHP, PLN, SEK, SGD, USD, TWD, and VEF.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.		 string
Description The description must provide further information about the header that is also defined in this object.

The description can contain a maximum of 25 characters.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.		 string
FinalMobileUrls The landing page URL for mobile devices.

The following validation rules apply to Final URLs and Final Mobile URLs.
- The length of the URL is limited to 2,048 characters. The HTTP or HTTPS protocol string does count towards the 2,048 character limit.
- You may specify up to 10 list items for both FinalUrls and FinalMobileUrls; however, only the first item in each list is used for delivery. The service allows up to 10 list items for potential forward compatibility.
- Usage of '{' and '}' is only allowed to delineate tags, for example {lpurl}.
- Final URLs must each be a well-formed URL starting with either http:// or https://.
- If you specify FinalMobileUrls, you must also specify FinalUrls.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed.		 string array
FinalUrls The landing page URL.

The following validation rules apply to Final URLs and Final Mobile URLs.
- The length of the URL is limited to 2,048 characters. The HTTP or HTTPS protocol string does count towards the 2,048 character limit.
- You may specify up to 10 list items for both FinalUrls and FinalMobileUrls; however, only the first item in each list is used for delivery. The service allows up to 10 list items for potential forward compatibility.
- Usage of '{' and '}' is only allowed to delineate tags, for example {lpurl}.
- Final URLs must each be a well-formed URL starting with either http:// or https://.
- If you specify FinalMobileUrls, you must also specify FinalUrls.
- If the TrackingUrlTemplate or UrlCustomParameters elements are set, then at least one final URL is required.

Add: Optional
Update: Optional. If no value is set for the update, this setting is not changed.		 string array
Header The header that precedes the pricing data.

The header can contain a maximum of 25 characters.

The header must tie directly to the priceextensiontype that you defined for the PriceAdExtension.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.		 string
Price The price that you are advertising.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.		 double
PriceQualifier The price qualifier for a given product or service e.g., starting from a specific price and up to a maximum price.

Possible values include: Average, From, UpTo, None, and Unknown.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.		 PriceQualifier
PriceUnit The price unit allows you to specify the cost in terms of hour, day, week, etc. The price qualifier for a given product or service e.g., starting from a specific price and up to a maximum price.

Possible values include: PerDay, PerHour, PerMonth, PerNight, PerWeek, PerYear, None, and Unknown.

Add: Required
Update: Optional. If no value is set for the update, this setting is not changed.		 PriceUnit
TermsAndConditions Reserved for future use. string
TermsAndConditionsUrl Reserved for future use. string

Requirements

Service: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Used By

PriceAdExtension