Integration Overview

Before you can use Hotel Prices, you must first perform a series of one-time tasks to set up your environment. After that, you must then perform periodic maintenance tasks to ensure that your data is kept up to date.

One-time tasks

This section provides an overview of the one-time tasks that you perform during your initial implementation. For additional guidance, see About Hotel Ads integration.

To set up Hotel Prices, perform the following one-time tasks:

  1. Create a Hotel List Feed: Upload an XML or CSV file that lists all hotels for which you will provide pricing information; the Hotel List Feed itself does not contain pricing information.

  2. (Strongly recommended) Define room and package metadata: By defining this data ahead of time, your pricing updates do not need to include repetitive data such as descriptions, photo URLs, amenities, and other information about each and every room or package for each and every itinerary.
  3. Choose a delivery mode: Decide whether to use the Pull or Pull with Hints delivery mode to share your hotel prices with Google. Discuss configuration options with your Technical Account Manager (TAM), including thread counts and whitelisting endpoints.
  4. (Optional) Configure your pricing endpoint: Use the Price Configuration tool to define your hotel itineraries per second, hotels per query, and maximum parallel requests.
  5. (Hotel Ads only) Provide billing information: Tell your Technical Account Manager (TAM) how you should be billed when you participate in the ad auctions.
  6. Provide additional data: The following table summarizes additional data that you define and share with Google when integrating with Hotel Ads:

    Type of Data Description Required? Method of Delivery
    Price Feed Define pricing/availability for hotels and packages in your Hotel List Feed. Required Via the Hotel Ads Center or Pricing & Inventory (Transaction) XML Reference
    Points of Sale Use the Point of Sale Editor to define the endpoints to which end-users are sent after selecting a sponsored hotel in the search results. End-users can book rooms on the sites defined in the Points of Sale file. Required Point of Sale Editor or POS file
    Fenced Rates Specify different rates for your itineraries, based on the end-user's device and country, or whether the end-user is logged in to their Google account.

    Optional Pricing & Inventory (Transaction) XML Reference
  7. (Optional) Conversion tracking: Set up your conversion tracking snippet to ensure that your reports accurately reflect your conversions. You must also set up conversion tracking if you want to use enhanced CPC bidding (formerly known as automatic bid multipliers).

To test your implementation before going live, work with your TAM.

On-going tasks

The following table summarizes the data feeds and files that you regularly provide to Google after you have completed the one-time tasks and started using Hotel Prices:

Type of Data Description Structure Frequency
"Price Feed" Update pricing and availability for your hotels, including base rates, fenced rates, and qualified rates for rooms and Room Bundles. The way in which you update price information depends on your delivery mode:
  • Pull: Google requests pricing updates from your server, to which you respond with the updates.
  • Pull with Hints: Similar to Pull, but with an additional step to reduce the amount of traffic.

For more information, see Delivery Modes.

<HintRequest>, <Hint>, <Query>, <Transaction> Very frequently
Hotel List Feed Update the list of hotels for which you then provide pricing and availability information in your Price Feed. You can upload this feed at any time using the Feed Upload Tool. <listings> Occasionally
Hotel List Feed Fix data issues as they arise. <listings> As needed
Room and Package Metadata Update your room and Room Bundle descriptions. Descriptions likely change very infrequently (as often as the hotel itself changes their room configurations). Room Bundle descriptions typically change more frequently. <Transaction> About once/week
Points of Sale When you update your Price Feed (e.g., with Room Bundles, fenced rates, or new hotels), update the endpoints that users can use to book a room. POS file or Hotel Ads Center Occasionally
Price Feed Configuration Define your hotels per query and hotel itineraries per second. Price Configuration tool> Once/day
Price Accuracy Score Check that your Price Accuracy Score is not affecting your bidding because of missing or inaccurate pricing. You can check your score with the Scorecard API or Price Accuracy Report in the Hotel Ads Center. N/A Occasionally

After configuring your hotel prices, if you encounter errors, try solving the issues with the tips described in Troubleshooting Feeds.

For additional information about configuring and updating your data feeds, contact us.

Send feedback about...

Hotel Prices
Need help? Visit our support page.