Data Feeds 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 regular maintenance tasks to ensure that your data is kept up to date.

Introductory video

For an introduction to the data feeds, watch the following video:

One-time Tasks

This section provides an overview of the one-time tasks. Later sections describe these tasks in more detail.

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. Define room and package metadata.
  3. Choose a delivery mode: Decide whether to use Pull or Pull with Hints delivery mode to share your hotel prices with Google.
  4. Discuss configuration and delivery mode with your Technical Account Manager (TAM): After choosing a delivery mode, discuss that and other configuration settings with your TAM, including thread counts, whitelisting endpoints, and query controls.
  5. Provide additional data: The following table summarizes additional data that you must define and share with Google when setting up Hotel Ads:
    Type of Data Description Required Method of Delivery Delivery Format
    Hotel Price Feed Defines room details, packages, Room Bundle, and pricing/availability for hotels in the Hotel List Feed. Required Upload the file via the Hotel Ads Center. XML or CSV file
    Points of Sale Files Defines 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 Use the Point of Sale Editor. XML file
    QueryControl Message Defines default values for the check-in date and length of stay combinations for repricing hotels. You can also use this file to define overrides for specified hotels. Required Send a file to Google as an email attachment (first time only). XML file

    For Hotel Ads partners, you must also provide billing information that specifies how you should be billed when you participate in the ad auctions. You typically provide this information directly to your TAM.

  6. (Optional) Conversion tracking: Set up your conversion tracking snippet to ensure your reports accurately reflect your conversions.

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

On-going Tasks

This section provides an overview of the on-going tasks. Later sections describe these tasks in more detail.

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 Method of Delivery Delivery Format Typical Change Frequency
Hotel Price Feed Updates pricing and availability for your hotels with Transaction messages. 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.

Transaction messages Very frequently.
Hotel List Feed Updates the list of hotels for which you then provide pricing and availability information. You can upload this feed any time that you want using the Feed Upload Tool. XML or CSV Frequently.
Fix Data Issues Fix data issues as they arise. You can use various tools to identify and fix data issues. N/A Occasionally.
Room and Package Metadata Updates changes to your room and Room Bundle descriptions. Room descriptions likely change very infrequently (as often as the hotel itself changes their room configurations). Room Bundles or package descriptions sometimes change weekly. Transaction messages About once/week.
Points of Sale files Update the endpoints that users can use to book a room. Use the Point of Sale Editor. XML file Occasionally.
QueryControl Message Defines default values for the check-in date and length of stay combinations for repricing hotels. You can also use this file to define overrides for specified hotels. Google pulls this message from your server. XML file Once/day.
Bidding (Hotel Ads only) Submit bids to the Hotel Ads auction with the Bids 2.0 API.

You can also use the Hotel Ads Center to set your bids.

API calls Occasionally.
Price Accuracy Score Check that your Price Accuracy Score is not affecting your bidding because of missing or inaccurate pricing. 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.