Room Bundles let you define multiple room types for a single property, or combine an itinerary of a room with additional services and conditions of sale to your users beyond a standard price.
Key concepts and workflow
With Room Bundles, you can offer additional combinations of physical room types with different service packages.
The following image shows examples of Room Bundles:
In this example, the first bundle is likely the base room, with a discount for only one adult occupant. The second is a different room type which is available for upto 3 adult occupants. The third is another room type within the same property. The fourth is a "premium" package of the base room, which might include amenities such as free breakfast or a later checkout.
Displaying Room Bundles in search results is governed by the same selection process as standard room rates. For information about the benefits of Room Bundles, see Using Room Bundles to boost performance.
Defining Room Bundles
You define Room Bundles in Transaction messages. The root element of a
Transaction message is
The structure of the Transaction message depends on what you are doing: defining the metadata about the Room Bundle or updating the Room Bundle's pricing/availability.
Metadata: Define Room Bundle metadata with the
<PackageData> in a
<Result>. For more information, see
Defining room and package metadata. Room Bundles use
<RoomData> elements for their physical room
Pricing and availability: Define Room Bundle pricing
and availability with the
<RoomBundle> element in a
<Result> for each
package/itinerary combination. For more information, see
Defining pricing and availability.
Room Bundle metadata
When defining Room Bundles, you typically define the description, amenities, and other information about the Room Bundle ahead of time. This information is known as the Room Bundle metadata. You then reference this metadata in your pricing updates, but don't include it in the pricing update messages.
When you define Room Bundles, use existing
elements for the physical room descriptions and
<PackageData> elements for the amenities and terms that are
not part of the physical room description.
<PackageData> elements can significantly
reduce the size of your Hotel List Feed and
Hotel Price Feed
because it reduces the amount of repetitive data sent in Transaction
For example, data such as a room name and description is typically repeated
for every itinerary. You can use the
<PackageData> elements to define this type of data once.
Itinerary-specific Room Bundle data is then merged with the stored room and
package definitions for display to the end user.
Google matches your metadata with your itinerary-specific data to render the
contents of your ads. There is special
processing to combine the names and descriptions from the
allowing the physical room to be described in
and package details to be in
If you define both the room data and package data for a single room or Room Bundle, Google includes both in the ad output, separated by a hyphen.
Room Bundle data is gathered from all sources and combined, using precedence rules, to produce the final data for a given hotel, itinerary, and Room Bundle. The ordering is as follows, from lowest to highest precedence:
- (Lowest) Partner data
- Property data
<RoomData>, where the
<PackageData>, where the
Defining pricing and availability
To define Room Bundle pricing and availability, use a
<RoomBundle> element in a Transaction message for each
package/itinerary combination. The
should be inside the
Note that when you use Room Bundles, you must include one that matches the
room's base rate, taxes, and fees (specified in the
child element of
<Result>, the contained set of Room Bundles
overwrites the existing set for that property/itinerary combination. If you do
not define any Room Bundles in the
<Result> element, then all Room Bundles
are removed and only the basic room for that hotel/itinerary shows up in search
Be sure to use elements such as
<Name> to make your Room
Bundles more attractive to potential customers and be sure they match the
hotel's landing page. In this example, you would define names and other
descriptive information in the metadata.
Defining room and package metadata
You define room and package metadata in a Transaction message that is separate from the pricing and availability data. By defining this data ahead of time, your pricing updates do not need to include repetitive information such as descriptions, photo URLs, amenities, and other data about each and every room/package for each and every itinerary.
Google stores the metadata for you and inserts it into your ads when they are displayed. You can update room and package metadata at any time with a new Transaction message.
In the Transaction message, you set a package ID and a room ID on each block
that you then reference in your
<Result> blocks of pricing updates.
If the room and package data changes (for example, if you add a new room type in a property), send a new Transaction message that contains the updated room and package data. Google replaces the existing metadata about a room or package with the new data.
Google recommends that you define metadata during your initial setup.
After pre-defining the metadata, you only need to reference the
<PackageID> values in your
pricing updates rather than include all that
information again. Google uses those IDs to match rooms
and Room Bundles with the stored metadata. This can greatly reduce
the overall size of your Transaction messages.
Because prices for room/itinerary combinations change much more frequently than the room or package descriptions, defining metadata once and then referring to it is a much more efficient use of Transaction messages. In addition, errors such as mismatching room descriptions can be eliminated by using metadata rather than defining data inline.
You can also define the room and package data inline, in a pricing Transaction message, as the following example shows. This approach is not recommended, however, because it is less efficient than defining the metadata and the pricing data separately.
<?xml version="1.0" encoding="UTF-8"?> <Transaction timestamp="2017-07-18T16:20:00-04:00" id="42"> <Result> <Property>1234</Property> <Checkin>2015-06-07</Checkin> <Nights>2</Nights> <Baserate currency="USD">199.99</Baserate> <Tax currency="USD">25.12</Tax> <OtherFees currency="USD">2.00</OtherFees> <AllowablePointsOfSale> <PointOfSale id="bookingsite1.com"/> </AllowablePointsOfSale> <!-- Less efficient method of defining Room Bundles is shown here --> <!-- Base Rate Room Bundle --> <RoomBundle> <RoomData> <Name> <Text text="Single Queen Room - Non-Smoking" language="en"/> <Text text="Chambre de la Roi Premium - Pas de Fumeurs" language="fr"/> </Name> <!-- Room can accommodate 4, but bundle is for 3 --> <Capacity>4</Capacity> </RoomData> <PackageData> <Occupancy>3</Occupancy> <ChargeCurrency>web</ChargeCurrency> <Refundable available="1" refundable_until_days="7" refundable_until_time="18:00:00"/> <ParkingIncluded>1</ParkingIncluded> <InternetIncluded>1</InternetIncluded> </PackageData> <!-- Price for 3 ("occupancy") --> <Baserate currency="USD">199.99</Baserate> <Tax currency="USD">25.12</Tax> <OtherFees currency="USD">10.00</OtherFees> </RoomBundle> <!-- Premium Room Bundle --> <RoomBundle> <RoomData> <Name> <Text text="Premium King Room - Non-Smoking" language="en"/> <Text text="Chambre de le Roi Premium - Pas de Fumeurs" language="fr"/> </Name> <!-- Room can accommodate 4 and bundle is for 4 --> <Capacity>4</Capacity> </RoomData> <PackageData> <Occupancy>4</Occupancy> <ChargeCurrency>web</ChargeCurrency> <Refundable available="1" refundable_until_days="1" refundable_until_time="18:00:00"/> <BreakfastIncluded>1</BreakfastIncluded> <ParkingIncluded>1</ParkingIncluded> <InternetIncluded>1</InternetIncluded> </PackageData> <!-- Price for 4 ("occupancy") --> <Baserate currency="USD">298.88</Baserate> <Tax currency="USD">42.12</Tax> <OtherFees currency="USD">10.00</OtherFees> </RoomBundle> </Result> </Transaction>
Comparing occupancy and capacity
When defining Room Bundles, you must understand the difference between occupancy and capacity:
- Occupancy is the number of guests that a Room Bundle is intended to
apply to. For example, the "Honeymoon Package" has an occupancy of two.
You set the value of a package's occupancy by using the
- Capacity is the maximum number of people that a room can physically
accommodate. The capacity of a room is always equal to or higher than the occupancy.
For example, the "Honeymoon Suite" in your hotel has a maximum capacity of six people,
but you price a bundle for two guests. You set the value of a package's capacity by
When pricing a Room Bundle, you must give the price for the number of guests
that the bundle is intended to be for (the value specified in the bundle's
<Occupancy> element). If
set to two, then the price in that package must be for two people. You cannot
<Occupancy> to four guests, and set the bundle's price
for two guests.
Updating Room Bundles
This section describes how to remove a Room Bundle that is no longer available and how to update the price of an existing Room Bundle.
Note that every time you update a room/itinerary's
<Result> block in
your Transaction messages, you must include a complete set of
available Room Bundles for each
Removing a Room Bundle
Room Bundles are different from hotel prices in the way that you remove them.
To remove a room/itinerary combination from inventory, you set the
<Baserate> to "-1". To
remove a Room Bundle for a given room/itinerary, remove the
<RoomBundle> element from the
<Result> block in the Transaction
Room Bundles in your data feeds are considered a set, which number anywhere from 0 to tens of them. When you send Room Bundles to Google, you send the current, complete set. You do not change values of an individual Room Bundle to mark a previously-available one as unavailable. Whatever set of bundles is in the most recent Transaction message replaces the current set.
For example, there are bundles A, B, C, and D. You first send a message that defines the set of room bundles A, B, C and D. Later, if bundle B sells out, you re-send the entire set with bundles A, C, and D only. If all Room Bundles have sold out, send an empty set of Room Bundles.
Changing Room Bundle prices
To change the price of a Room Bundle, set the new
<Baserate> in the
Every time you update a room/itinerary's
<Result> block in
your Transaction messages, you must include a complete set of
available Room Bundles for each
<Result>. Google replaces the existing
set of Room Bundles with the new set. If you do not include any Room Bundles in
<Result>, then Google removes all Room Bundles for that room/itinerary.
Updating Room Bundle metadata
You update Room Bundle metadata with a response to a
You respond to a Query message with a Transaction message that defines the room and package metadata for the specified hotels. For more information, see Query Messages.