Vacation Rentals

Similar to Hotel Ads, integrating with Vacation Rentals requires completion of one-time tasks to set up vacation rental properties and prices to be displayed to users searching for their next destination. The integration process can be started either directly with Google, by meeting the requirements listed below and completing the Vacation Rentals interest form, or by collaborating with an approved third-party integration partner. Once approved, a Google Technical Account Manager will be in touch with you at every step of the integration pipeline.

In summary, you should implement:

  1. Property listing: Static information about the property including name, address, GeoCode locations, image and website URLs, and amenities.

  2. Price: Itinerary that indicates the availability and price of a stay at a property.

  3. Landing Page: Template that allows users to land on your websites with prefilled itinerary information.

Before you begin

Before integrating with Vacation Rentals, you should be able to provide the following:

  • A designated partner technical contact who can be contacted by a Google Technical Account Manager.

  • A contract signed with Google to protect customer privacy.

  • Localized self-service or email-based user support.

Property listing feed

Creating a Vacation Rentals listing feed

A Vacation Rentals listing feed contains all the properties to be shown on Google. This feed contains the physical attributes of the property including name, address, GeoCode locations, image URLs, website URLs, and amenities. If you are unsure whether your property is a Vacation Rental or Hotel, refer to Categories for hotels and lodging businesses.

For initial ingestion, you need to share a listing feed with the Google Technical Account Manager based on the specifications provided in the Hotel list feed XML reference. However, unlike hotel lists, you should include relevant attributes specific to Vacation Rentals. The ingestion of the listing feed can take approximately 2 to 4 weeks, during which Google will be in touch with you to assist with troubleshooting and optimizing the feed.

Attributes unique to Vacation Rentals

The general XML structure has a similar format as Hotel listing feeds. See Hotel list XML reference.

Failure to include the following items automatically disables the listing.

Hosting the listing feed and file structure

Host your listing feed in a .zip file. Google fetches the latest set of property listings in your inventory daily.

Mind the following requirements for importing the hosted listing file:

  • One or more .zip files to be shared with Google.
  • Feeds should be shared in the .zip format only (no .tar or .gz).
  • Each .zip file can contain multiple listing XML files.
  • Each XML file can contain more than one listing (preferred).
  • Each XML file must be less than 100 MB.
  • Each XML file can only contain one language.

    • Example: <listings><language>en</language>...</listings>

    • For non-primary languages, include only the unique hotel ID and content for the property in that language only.

  • To verify that your XML files are correct before sharing them with Google, use the following command to validate your feed as explained in Hotel Ads schemas:

    xmllint --noout --schema http://www.gstatic.com/localfeed/local_feed.xsd myfile.xml
    

Property listing image requirements

Each property should have a minimum of 8 photos (at least 1 bedroom, 1 bathroom, and 1 common area). Share as many pictures as possible for a competitive advantage. Use best possible quality (upper limit on image dimension is less than 4K pixels for width or 4K pixels for height).

  • Minimum resolution: 1024 x 683 px.
  • Recommended resolution: 1920 x 1080 px.
  • File format: JPG, JPEG, PNG.
  • Orientation: Landscape.

No watermark or branding should be in the images. Properties without images will automatically be disabled from serving.

Common issues

Room-sharing is not currently supported in Google Vacation Rentals. We only support full properties.

Every bookable property should be sent to Google as a separate <listing> that contains its own details and attributes. For example, each apartment unit inside a multi-unit building should be sent as a separate <listing>.

Attributes play an important role in explaining the details of the properties, so send as many attributes as possible to help promote your properties.

Price feed

Once listing feed ingestion and troubleshooting is completed, you need to set up Hotel Price integration so that Google is able to cache the updated itinerary prices for Vacation Rental properties.

There are two methods for setting up pricing:

  • Method 1: Google transaction pricing
  • Method 2: ARI pricing support for vacation rentals

Method 1: Google transaction pricing

If you are using Google transaction prices to pass your prices to Google, price integration is the same as Hotels price integration. Refer to the XML reference: Pricing & room inventory (transactions).

You can begin implementing your Price feed using the PULL delivery method. If the PULL method is successful, you can upgrade to the PULL+HINT (changed pricing) method for better control of updated prices.

A Live Pricing query endpoint (similar to a PULL endpoint) can be used to fetch prices for users when they visit itineraries that are not cached at Google.

Method 2: ARI pricing support for Vacation Rentals

Availability, Rates, and Inventory (ARI) can be used to deliver nightly rates and availability information that Google uses to generate prices to users.

There can, however, be multiple different rate plans (packages) for each property. For example:

  • You can offer guests booking options with different value addons, such as free cancellation.

  • You can use rate plans as virtual rates to implement promotions with extra restrictions (even though the Promotions API is preferable for that use case).

Best practices for ARI messages for Vacation Rentals are:

  • For Transaction (Property Data):

    • Specify a single RoomData element with the room ID you have selected to represent the individual unit on the listing, matching the @InvTypeCode in the ARI messages. You can simply reuse the property ID.

    • Specify one or more PackageData elements for each rate plan you plan to use.

  • For OTA_HoteInvCountNotifRQ:

    • Set an inventory count of 1 if the unit is available on a given date, or 0 if it has been booked.

Landing pages

The basics of configuring Landing pages are the same for Vacation Rentals integration as for Hotels integration. There must be at least one general landing page available to all users without any restrictions.

The following landing page example covers every user country and language. In this example, My Amazing VR Website is the brand name users see in the Vacation Rentals search results:

<?xml version='1.0' encoding='UTF-8'?>
<PointsOfSale partner='partner-name-vr'>
  <PointOfSale id='landing-everywhere'>
    <DisplayNames display_text='My Amazing VR website' display_language='en'/>
    <URL>https://example.com/property/(PARTNER-HOTEL-ID)?checkin=
      (CHECKINDAY)%2F(CHECKINMONTH)%2F(CHECKINYEAR)&amp;checkout=
      (CHECKOUTDAY)%2F(CHECKOUTMONTH)%2F(CHECKOUTYEAR)&amp;guests=(NUM-GUESTS)
    </URL>
  </PointOfSale>
</PointsOfSale>

Refer to the article on how to set up Vacation Rentals in Google Ads.

Price accuracy

Based on the Referral experience policy, Google expects that the prices and availability cached on the Google side will match the prices and availability on your website. We regularly check the prices in the cache with your website prices and assign a Price Accuracy Score based on the freshness of the prices in the Google price cache.

For an account to be eligible to be enabled and shown to the users, it must be above the Price Accuracy Score threshold for a certain number of days to make sure there are no fundamental issues with passing prices to Google. These checks continue even after the account goes live.

You have access to mismatched cases and details in your Hotel Center account throughout integration and afterwards to help in troubleshooting.

Brand associations specific to integration partners

Brand association allows you to group vacation rental properties together. You can associate brand-specific icons (or logos) to the set of properties in a brand. Follow the instructions at Brand associations for Vacation Rentals.