Hotel Feed 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 hotel feed to provide Bing information about the hotels that you advertise. You must define and import your hotel feed prior to sending Bing Transaction Messages.

For information about creating a hotel feed, see Creating a Hotel Feed.

Note

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


Listings

Defines the top-level element of a hotel feed.

Element Description Children
listings The top-level element in a hotel feed. Listings Type

Listings Type

Defines a list of hotels in the feed.

Element Description Children
language Required.
Data type is string.

The language that the hotel data in the feed is written in. Specify the language using the two-letter ISO 639 language code. For example, use en for English.

Notes:
  • The language element must be set to en.
None
listing Defines a hotel listing. Include a listing element for each hotel in the feed. Listing Type

Listing Type

Defines a hotel.

Element Description Children
id Required.
Data type is string.

An opaque, user-defined ID that uniquely identifies the hotel in the feed.

When you create your transaction message, use this ID in the Property element of your transaction message to identify the hotel.
None
name Required.
Data type is string.

The hotel's name. The name may contain a maximum of 200 characters.
None
address Required.
Data type is string or Component Type.

The street address of the hotel.

Notes:
  • You may specify the address using free-form text in the body of the address element or using component child elements to specify the components of the address (see Component Type).
  • You're encouraged to use component elements to specify the address' components.
  • If you use free-form text, separate each component of the address with a comma. For example, 1234 Billings Way, Redmond, WA, 98030.
Component Type
country Required.
Data type is string.

The country where the hotel is located. Specify the country using the two-letter ISO 3116 country code. For example, use US for United States.
None
latitude Required.
Data type is decimal.

The latitude of the hotel's geographical coordinates.

Notes:
  • The latitude and longitude are required only if you don't specify phone. It's preferred that you specify both the phone and geographical coordinates.
  • The latitude must be in the range -90.0 through 90.0.
  • Use Location API or another GeoCoding tool to generate the coordinates.
None
longitude Required.
Data type is decimal.

The longitude of the hotel's geographical coordinates.

Notes:
  • The latitude and longitude are required only if you don't specify phone. It's preferred that you specify both the phone and geographical coordinates.
  • The longitude must be in the range -180.0 through 180.0.
  • Use Location API or another GeoCoding tool to generate the coordinates.
None
phone Required.
Data type is string.

A list of telephone numbers that customers use to contact the hotel.

Attributes:
  • type—Required. The type of telephone number specified. The following are the possible values.
    • main—Required. The hotel's main voice telephone number.
    • tollfree—Optional. The hotel's toll-free voice telephone number.
    • fax—Optional. The hotel's fax telephone number.
    • tdd—Optional. The hotel's telecommunications device for the deaf telephone number.
    • mobile—Optional. The hotel's mobile telephone number.
Notes:
  • A phone number is required only if you don't specify latitude and longitude. It's preferred that you specify both the phone and geographical coordinates.
  • Provide unique telephone numbers for the listing.
  • Use dashes, spaces, or parentheses in the phone number to make it easier to read. For example, use “610-222-3333” or “(610) 222-3333” rather than “6102223333”.
  • Specify only one telephone number in each phone element. Do not specify multiple numbers, such as 650-123-2222/33.
  • The telephone number may contain an extension of up to 7 digits. Precede extensions with one of the following abbreviations: "ext", "extn", and "x". For example, "408-555-1111x12345" or "408-555-1111 x12345".
  • The telephone number may not include alphabetical characters.
  • Each listing should specify one of each type of phone number: "main", "mobile", "tollfree", "fax", or "tdd", if applicable.
  • If the telephone number includes the country code, precede it with a "+". For example, “+65 6722-2323” for a number in Singapore where the country code is 65, or “+001 (408) 555-1111” for a number in the United States where the country code is 001.
None

Component Type

Defines a component of a street address.

Element Description Children
component Optional.
Data type is string.

Specify a component element for each component of the address.

Attributes:
  • name—Required. The name of the address component. The following are the possible values.
    • addr1—Required. The hotel's street address.
    • addr2—Optional. Second street address line.
    • addr3—Optional. Third street address line.
    • city—Required. The name of the city where the hotel is located.
    • province—Required. The name of the state, region, or province where the hotel is located.
    • postal_code—Required. The address' postal code.
None