Create a Landing pages feed (formerly Points of Sale (POS) feed)

To provide Bing your Landing pages data, create an XML document that contains a point of sale (POS) for each booking site you support. A POS describes the POS's display name, URL, and criteria for matching the user to a POS.

The document must use UTF-8 encoding and must conform to the PointsOfSale XSD.

The top-level element in your feed

The Landing pages feed contains a single, top-level PointsOfSale element. The PointsOfSale element requires a PointOfSale child element for each site that users can use to book a room.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <PointOfSale>
    . . .
  </PointOfSale>
  ...
</PointsOfSale>

The PointOfSale element describes the POS's display name, URL, and criteria for matching the user to a POS. For information about defining a POS, see Defining a point of sale.

Defining a point of sale

The PointsOfSale element contains a list of PointOfSale elements, one for each POS site that users can use to book rooms. The list must contain Landing pages for a single partner.

The following shows PointOfSale elements that define Landing pages for English speaking users. The first PointOfSale element defines a POS for English speaking end users on any device, and the second PointOfSale element defines a POS for English speaking end users on mobile devices. The POS URL includes details about the transaction, such as the check-in and check-out dates, hotel ID, and user language. Bing uses the display name and POS URL to create a hyperlink that's added to the ad. When the user clicks the link, they're taken to the booking site. If you are using Tracking Templates for performance tracking, then the Landing Page URL LPURL element needs to be configured in the POS feed file in order for tracking to work. Bing uses the display name and POS URL or LPURL to create a hyperlink that's added to the ad. When the user clicks the link, they're taken to the booking site.

  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
    <LPURL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</LPURL>
  </PointOfSale>

Include the DisplayNames element 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 property feed.

If you include DisplayNames, you must include a Match element that has the language criterion set to the same language.

Bing uses the POS that best matches the user based on the POS's matching criteria. Based on the above matching criteria, users on mobile devices will use the English-Mobile POS and everyone else will use the English POS. For information about how Bing matches users to a POS, see Matching Landing pages. For a list of criterion that you can match on, see the Match element.

The URL element specifies the link to the site where the user can book the room. The example shows using dynamic query parameters. Bing substitutes values for the dynamic variables at runtime. For information about using dynamic query parameters, see Using dynamic query parameters.

The following shows a complete Landing pages XML document.

<?xml version="1.0" encoding="UTF-8"?>
<PointsOfSale xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <PointOfSale id="English">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" />
    <URL>http://contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
  <PointOfSale id="English-Mobile">
    <DisplayNames display_text="ContosoTravel.com" display_language="en" />
    <Match status="yes" language="en" device="mobile" />
    <URL>http://mobile.contoso.com/landing?hid=(PARTNER-HOTEL-ID)&amp;checkin=(CHECKINYEAR)-(CHECKINMONTH)-(CHECKINDAY)&amp;checkout=(CHECKOUTYEAR)-(CHECKOUTMONTH)-(CHECKOUTDAY)&amp;language=(USER-LANGUAGE)</URL>
  </PointOfSale>
</PointsOfSale>

Matching Landing pages

Landing pages include a Match element that contains the criteria that Bing uses to match a user to a POS. The following are the criterion that Bing uses to match users to Landing pages. The list is in order of preference.

• country
• currency
• language
• device
• sitetype

Bing uses the following rules to find the best POS match.

• Bing gives the highest preference to country matches and the least preference to device matches.

• If Match does not specify one of the criterion, Bing implicitly matches all values for the criterion. For example, if Match specifies language and currency, Bing implicitly matches any country and device.

• If Match specifies one or more criterion, Bing uses the POS with the most explicit matches.

• If there is no explicit rule match, the selection of POS is nondeterministic. We recommend that you add an explicit rule for match criterion.

The Match element's status attribute determines whether to include or exclude the POS based on matching. If status is never and Bing matches all criterion, Bing will not use the POS. To exclude a POS, all criterion must match. In the following example, Bing explicitly excludes the POS if the user is from the United States or France, and implicitly includes it if the user is from any other country.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='never' country='US' />
  <Match status='never' country='FR' />
  . . .
</PointOfSale>

If status is yes, Bing will not eliminate any Landing pages from consideration that do not explicitly match all criterion, but preference is given to the POS that matches the most criterion. In the following example, Bing explicitly matches the user to the POS if the user's country is France. If the user's country is not France, the POS will still be considered until a better match is found. If a better match is not found, Bing will use the POS.

<PointOfSale id='exclude-example'>
  . . .
  <Match status='yes' country='FR' />
  . . .
</PointOfSale>

Bing recommends using the same matching criteria for each POS. This minimizes the complexity in determining why one POS matched over another.

Using dynamic query parameters

A point of sale (POS) contains a URL element that identifies the site where users can book rooms. The URL may contain dynamic query parameters, which are user-defined parameters that contain a predefined token for its value. Bing then substitutes the token with a value before adding the URL to the ad. By using dynamic query parameters, you can include the hotel's ID, check-in date, length of stay, and more in the URL.

The following shows the syntax that you use to specify dynamic query parameters in your POS URL. Because dynamic query parameters are query parameters, they must follow the question mark symbol (?) in the URL.

http://domain.com/path?param-name=(dynamic-variable-name)

The following are the possible case-sensitive dynamic variable names that you may specify in the URL.

All dates, such as CHECKINDAY, are in the hotel's timezone.

The following shows an example URL that contains dynamic query parameters and encoded entities.

<URL>http://www.partnerdomain.com?hotelID=(PARTNER-HOTEL-ID)
  &amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)
  &amp;checkinYear=(CHECKINYEAR)&amp;nights=(LENGTH)</URL>

Before Bing uses the URL in the ad, it substitutes values for the dynamic variable names. For example, if the user books a room for 6 nights starting on 6/7/2021 for hotel #42, Bing renders the URL as:

http://www.partnerdomain.com?hotelID=42&checkinDay=07&checkinMonth=05&checkinYear=2021&nights=6

Bing gets values for the dynamic parameters from your Price feed and Property feed, as well as user-specific settings. For example, the value of the LENGTH variable comes from the Nights element in the Price feed, and the value of the PARTNER-HOTEL-ID variable comes from the id element in the Property feed.

Some variables are subsets of Price feed elements. For example, the CHECKINDAY, CHECKINMONTH, and CHECKINYEAR variables are extracted from the Checkin element. Other variables are calculated based on the user's locale and other client settings.

General URL rules

The following are general rules to follow when using dynamic variables.

• All dynamic parameters are optional. You are not required to insert any dynamic parameters in your POS URL. However, using variables to pass itinerary- and user-specific information generally creates a better experience for the end-user.

• Surround dynamic variable names with open and close parentheses.

• Use encoded entities for special characters. For example, replace ampersands (&) with &, space with %20, and forward slash (/) with %2F.

• Values for a single parameter may be constructed from multiple variables. For example, you may construct the value of a checkinDate query parameter from the CHECKINDAY, CHECKINMONTH, and CHECKINYEAR variables.

  <URL>http://www.partnerdomain.com?checkinDate=(CHECKINDAY)%2F;(CHECKINMONTH)%2F;(CHECKINYEAR)</URL>  
  

• For dynamic variables that Bing recognized but does not support, Bing replaces the variable string with an empty string.

• Because dynamic query parameters are query parameters, they must follow the question mark symbol (?) in the URL.

Using conditional directives

In addition to the variables listed above, you can also use the following directives to create conditional logic.

• IF-DEFAULT-DATE—Resolves to true if the user clicked on a hotel ad that used default dates (the user did not pick the dates). If true, Bing inserts the values that follow this directive into the URL. Otherwise, Bing inserts the values following the ELSE directive.

• ELSE—If the previous condition is not met, Bing inserts the values that follow this directive.

• ENDIF—Ends the conditional block.

For example, the following URL sets the popup_datepicker query parameter to true if the user used default dates instead of specifying dates.

<URL>http://partner.com?hotelID=(PARTNER-HOTEL-ID)
&amp;checkinDay=(CHECKINDAY)&amp;checkinMonth=(CHECKINMONTH)&amp;checkinYear=(CHECKINYEAR)
&amp;nights=(LENGTH)(IF-DEFAULT-DATE)&amp;popup_datepicker=true(ELSE)
&amp;popup_datepicker=false(ENDIF)</URL>

If true, Bing renders the URL as:

http://partner.com?hotelID=123&checkinDay=01&checkinMonth=05&checkinYear=2021&nights=1&popup_datepicker=true

Otherwise, Bing renders the URL as:

http://partner.com?hotelID=123&checkinDay=23&checkinMonth=05&checkinYear=2021&nights=2&popup_datepicker=false

General rules

• Use the PointsOfSale XSD to validate your Landing pages feed file before sending it to Bing.

• The Landing pages feed document must use UTF-8 encoding.

• The feed must include Landing pages for all sites that users use to book rooms— the feed process does not support partial updates.

• Bing ignores any element or attribute that it does not support.

• Elements must be in the order specified in the PointsOfSale XSD.

• If your data includes special characters such as apostrophes or quotes, escape them or use CDATA sections. If you escape them, you may use entity codes or character codes. For example, you can escape Paul's as Paul's or Paul's.

• Do not include elements that do not contain data. For example, if you do not provide a display name for a hotel, do not include an empty <DisplayNames> element.

• Do not use HTML in your XML elements.

Next steps

After creating your feed file, use the PointsOfSale XSD to validate it.

Ask your account manager to import the feed file.

Be sure to also import your hotel data. For information about creating your property feed file, see Property Feed (formerly Hotel feed).

After successfully importing your Landing pages feed and property feed, you may begin sending your hotel pricing and availability data. For information, see Price feeds.