Points of Sale reference

Note

This beta release of Hotel Ads is available to select participants only. For information about participating in the beta release program, please contact your account manager.

If you create hotel ads in Bing, you must use a Points of Sale feed to provide Bing the point of sale URLs to include in ads. You must define and import your points of sale feed prior to sending Bing Transaction Messages.

For information about creating a points of sale feed, see Creating a Points of Sale Feed.

Note

The elements must be specified in the order defined by the PointsOfSale XSD (and as listed in this topic).

Note

Bing ignores any element or attribute not included below.


PointsOfSale

Defines the top-level element of a points of sale feed.

Element Description Children
PointsOfSale The top-level element in a points of sale feed. PointsOfSale Type

PointsOfSale Type

Defines a list of points of sale.

Element Description Children
PointOfSale Defines a point of sale (POS) where users book rooms. Include a PointOfSale element for each POS you offer. You must define at least one POS, and all points of sale must be for a single partner.

Attributes:
  • id—Required. An opaque, user-defined ID that uniquely identifies the POS in the feed.

    If you want to limit booking to a specific POS for specific itineraries in your transaction message, use this ID in the PointOfSale element of your transaction message.
PointOfSale Type

PointOfSale Type

Defines a point of sale.

Element Description Children
DisplayNames Optional.

The name of the partner or partner's domain to display in the ad. Specify a DisplayNames element for each language you support.

Attributes:
  • display_text—Required. The name of the partner to display in the ad.
  • display_language—Required. The language that the display name is specified in. Specify the language using the two-letter ISO 639 language code. For example, use en for English.

Notes:
  • Bing supports only English. The display_language attribute must be set to en.
  • Include DisplayNames only for online travel agencies. Don't include DisplayNames for central reservations system (CRS) suppliers (also known as integration partners) and direct suppliers (such as hotel owners or chains). For CRS suppliers and direct suppliers, Bing uses the hotel's name from the hotel feed.
  • The POS must specify a Match element with the same language that you specify for the display name.
  • Bing uses the display name and the URL in the URL element to create a hyperlink that Bing includes in the ad.
None
Match Required.

The criteria used to determine if the POS is used in the ad.

Attributes:
  • country—Optional. The publishing country of the Bing site used by the user. To use the POS in the ad, the user must use the site with the specified publishing country. Specify the country using a two-letter ISO 3166 country code. For example, use US for United States.
  • language—Optional. The language that the user must use for Bing to use the POS in the ad. Specify the language using a two-letter ISO 639 language code. For example, use en for English.
  • currency—Optional. The currency that the user or hotel must use for Bing to use the POS in the ad. Specify the currency using a three-character ISO 4217 currency code. For example, USD for US Dollar.
  • device—Optional. The type of device the user must use for Bing to use the POS in the ad. The following are the possible case-insensitive values.
    • Desktop
    • Mobile
    • Tablet
  • sitetype—Optional. The type of site where the ad request originated. The following are the possible case-insensitive values.
    • LocalUniversal—The ad request originated from a web search results page.
    • MapResults—The ad request originated from a map site.
  • status—Optional. The condition used to match the criterion. The following are the possible case-insensitive values.
    • Yes—Use the POS if the criteria matches.
    • Never—Don't use the POS if the criteria matches.
Notes:
  • The language attribute must be set to en.
  • The country attribute must be set to US.
  • The currency attribute must be set to USD.
  • You cannot set status to never if device is set to tablet.
For more information, see POS Matching Rules.
None
URL Optional.
Data type is string.

The URL of the site where the user books the room.

Notes:
  • The POS may specify only one URL.
  • The URL may include one or more dynamic query parameter. For information about dynamic query parameters, see Using Dynamic Query Parameters.
  • If the URL includes special characters, you must replace the special characters with encoded entities. For example, if the URL includes query parameters, you must encode ampersands (&) as &.
None