Integration Overview

Before you can use Hotel Ads, 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 Ads, 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 Ads:

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. You can use various tools to identify and fix data issues, including the Matching Report and Manual Match Fix tool. <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. You can also use the Point of Sale Editor. 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
Bidding (Hotel Ads only) Submit bids to the auction via the Bids API or in the Hotel Ads Center. For more information, see Bidding User Guide. Bid update message format or Hotel Ads Center Occasionally
Spending caps (Hotel Ads only) Adjust your spending caps to increase the chances of winning auctions. You can do this with the Budgets API or in the Hotel Ads Center. For more information, see Budgeting & Billing Guide. Budget update message format or Hotel Ads Center Occasionally
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 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...

Need help? Visit our support page.