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'll 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 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 Pull, Changed Pricing (formerly Pull with Hints), or ARI as a delivery mode to share your hotel prices with Google. Discuss configuration options with your Technical Account Manager (TAM), including thread counts and allowlisting endpoints. For partners interested in onboarding on the ARI pricing feed, work directly with your Sales Account Manager (SAM) to determine eligibility and requirements.
  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 Hotel Center or Pricing & Inventory (Transaction) XML Reference
    Landing Pages (formerly Points of Sale) Use a landing pages file to define the URLs 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 landing pages file. Required Create a landing pages file and upload it via Hotel Center
    Conditional Rates (formerly 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.

Ongoing 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, conditional rates, and private 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.
  • Changed Pricing: Similar to Pull, but with an additional step to reduce the amount of traffic.
  • ARI: You push messages when new or changed data for your pricing model is available.

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
Landing Pages When you update your Price Feed (e.g., with Room Bundles, conditional rates, or new hotels), update the endpoints that users can use to book a room. You can also use the Landing Page Editor. Landing Pages File or Hotel 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 Google Ads API or using Google Ads manual entry (as described in Choose a bid for Hotel ads). N/A Occasionally
Spending caps (Hotel Ads only) Use the Google Ads API to control your spend with bidding at the campaign level or with your budget at the account level. N/A 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 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.