PriceTableRow Data Object - Campaign Management

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

Syntax

XML

<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:q55="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q55:ArrayOfstring" />
    <xs:element xmlns:q56="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q56: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>

JSON

{
  "CurrencyCode": "ValueHere",
  "Description": "ValueHere",
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "Header": "ValueHere",
  "Price": DoubleValueHere,
  "PriceQualifier": "ValueHere",
  "PriceUnit": "ValueHere",
  "TermsAndConditions": "ValueHere",
  "TermsAndConditionsUrl": "ValueHere"
}

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