Edit

Hotel Ads

  • Article

A Microsoft Lodging campaign enables you to advertise hotels and properties from your Microsoft Hotel Center properties feed. Hotel ads from a Microsoft Lodging campaign include details about the rental property, an image optional for Hotel Price ads and required for Property Promotion Ads, and pricing.

Note

As of April 9th, you’ll no longer have full access to Hotel Center. We’re looking forward to introducing you to Property Center, which will provide exciting self-serving capabilities. Thanks for waiting patiently as we update our help content with the new features. In the meantime, you can read about these upcoming changes and how to make your migration process smoother.

Note

Microsoft Lodging Campaigns including Hotel Price Ads and Property Promotion Ads are available in Albania, Algeria, American Samoa, Andorra, Anguilla, Antigua and Barbuda, Argentina, Armenia, Aruba, Australia, Austria, Azerbaijan, Bahamas, Bahrain, Bangladesh, Barbados, Belgium, Belize, Benin, Bermuda, Bolivarian Republic of Venezuela, Bolivia, Bosnia and Herzegovina, Botswana, Brazil, British Virgin, Islands, Brunei Darussalam, Bulgaria, Burkina Faso, Cameroon, Canada, Cayman Islands, Central African Republic, Chile, Christmas Island, Città del Vaticano, Cocos (Keeling) Islands, Colombia, Comoros, Congo, Congo (DRC), Cook Islands, Costa Rica, Côte d’Ivoire, Croatia, Cyprus, Czech Republic, Denmark, Djibouti, Dominica, Dominican Republic, Ecuador, Egypt, El Salvador, Eritrea, Estonia, Ethiopia, Faroe Islands, Fiji, Finland, France, French Guiana, French Polynesia, Gabon, Gambia, Georgia, Germany, Gibraltar, Greece, Greenland, Grenada, Guadeloupe, Guam, Guatemala, Guernsey, Guinea, Guinea-Bissau, Guyana, Haiti, Honduras, Hong Kong S.A.R., Hungary, Iceland, India, Indonesia, Iraq, Ireland, Islamic Republic of Pakistan, Israel, Italy, Jamaica, Japan (currently Property Promotion ads are unsupported), Jersey, Korea (currently Property Promotion ads are unsupported), Kyrgyzstan, Latvia, Lesotho, Libya, Liechtenstein, Lithuania, Luxembourg, Macao S.A.R., Madagascar, Malawi, Malaysia, Maldives, Malta, Marshall, Islands, Martinique, Mauritania, Mauritius, Mayotte, Mexico, Moldova, Mongolia, Montenegro, Montserrat, Namibia, Nauru, Nepal, Netherlands, New Caledonia, New Zealand, Nicaragua, Niger, Nigeria, Niue, Norfolk Island, Northern Mariana Islands, North Macedonia, Norway, Oman, Palau, Panama, Papua New Guinea, Paraguay, Peru, Philippines, Pitcairn Islands, Poland, Portugal, Principality of Monaco, Puerto Rico, Qatar, Réunion, Romania, Rwanda, Saint Kitts and Nevis, Saint Lucia, Saint Pierre and Miquelon, Saint Vincent and the Grenadines, Samoa, San Marino, Saudi Arabia, Senegal, Serbia, Seychelles, Sierra Leone, Singapore, Slovakia, Slovenia, Somalia, South Africa, Spain, Sri Lanka, Suriname, Sweden, Switzerland, Taiwan, Tajikistan, Tanzania, Thailand, Togo, Tokelau, Tonga, Trinidad and Tobago, Tunisia, Türkiye, Turks and, Caicos Islands, Tuvalu, U.A.E., U.S. Virgin Islands, Uganda, United Kingdom, United States, Uruguay, Vanuatu, Vietnam, Wallis and Futuna, Yemen, Zambia, Zimbabwe.

You can manage Bing Lodging settings with either the Bulk Service or Campaign Management Service. You should use the Bulk Service if you need to upload or download a high volume of entity settings. For example you can update all ad groups for your entire account in a single upload. In comparison, with the Campaign Management Service you can only update 100 ad groups per call and those ad groups must be in the same campaign. For details see the following sections.

Set up Microsoft Lodging Campaigns

You can run Microsoft Lodging Campaigns by enrolling into the Hotel Ads and providing all of the required information.

Create a Microsoft Lodging campaign with the Bulk Service

The Bulk Service create, update, and delete operations can be completed using Bulk upload. You can use Bulk download to read back your data. For more information see Bulk File Schema and Bulk Download and Upload.

These are the Bing Lodging entities that can be accessed using the Bulk Service.

To create a Microsoft Lodging campaign, follow these steps.

  1. Create one or more Microsoft Lodging Campaigns.

    • Set the Campaign Type field of the Campaign to Hotel.

    • Set the Bid Strategy Type field of Campaign either ManualCPC, PercentCPC, or Commission.

      • The PercentCPC bid strategy requires populating the Bid Strategy PercentMaxCPC field.
      • The Commission bid strategy requires populating the Bid Strategy CommissionRate field.

  2. Upload an Ad Group and set its Parent Id field to the Id of the campaign added above.

  3. Optionally, you can add Bid Modifier criterions if you wish to change your bid for various properties. These criterions will be a separate row per criterion, per Ad Group for each criterion that you wish to use. Lodging campaigns support the following criterions:

  4. Upload one or more Ad Group Hotel Listing Group records which represent listing group nodes in a tree structure that will be used to further refine the lodging property offers. Duplicate or conflicting lodging property filters attempted within an ad group's hotel listing group will fail during the upload operation.

    Note

    There is a 1 to 1 relationship between ad groups and hotel listing groups. In other words, each ad group has one hotel listing group and vice versa. In the Microsoft Advertising web application, for each ad group you would add one hotel listing group with multiple levels of division or multiple partitions. This is the equivalent of adding ad group level hotel listing groups using the Bing Ads API.

    Please also consider the validation rules described in the Ad Group Hotel Listing Group documentation.

  5. Upload a hotel ad. You must add at least one Hotel Ad to the corresponding ad group. A hotel ad is not used directly for delivered ad copy. Instead, the delivery engine generates hotel ads from the product details that it finds in your Hotel Center feeds. The hotel ad identifier can be used for reporting analytics.

After you complete these steps, the delivery engine can begin serving hotel ads for the properties that it finds in the customer's Hotel Center feeds. If the user's search query has property intent, the delivery engine searches the customer's Hotel Center feed for properties that match the query. If it finds a property, and the property meets the conditions of the property filters specified in the property scope and hotel listing groups, the delivery engine generates a hotel ad using the property details from the store.

Create a Microsoft Lodging campaign with the Campaign Management Service

To create a Microsoft Lodging campaign with the Campaign Management API, follow these steps.

Tip

For code examples that show how to apply product conditions for Microsoft Lodging Campaigns using the Campaign Management service, see Hotel Ads Code Example.

  1. Create one or more Microsoft Lodging Campaigns.

    • Set the CampaignType element of the Campaign to Hotel.

    • Set the BiddingScheme element of the Campaign to either ManualCpcBiddingScheme, PercentCpcBiddingScheme, or CommissionBiddingScheme.

  2. Create an AdGroup and add it to the campaign by calling AddAdGroups.

    • Optionally, you can create a HotelSetting instance and set its HotelAdGroupType (HotelAd, PropertyAd). Add this hotel setting to the Settings list of the Ad group. If you want your Ad group to support both HPA and PPA, do not create a HotelSetting instance and leave the Settings for your Ad group empty.

  3. Create a list of AdGroupCriterionAction objects in a tree structure that will be used to further refine the properties. The AdGroupCriterions must be of the HotelGroup criterion type. Apply the list of actions by calling ApplyHotelGroupActions. Duplicate or conflicting property conditions attempted within an ad group's hotel listing group will fail via the  ApplyHotelGroupActions operation.

    Note

    To retrieve hotel listing groups after they have been applied, call GetAdGroupCriterionsByIds and set the AdGroupCriterionIds element to null to get all hotel listing groups for the ad group. The hotel listing group with ParentCriterionId set to null is the root node.

    Please also consider the validation rules described in the ApplyHotelGroupActions documentation.

  4. Create a hotel ad. You must add at least one HotelAd to the ad group via the AddAds operation. A hotel ad is not used directly for delivered ad copy. Instead, the delivery engine generates hotel ads from the property details that it finds in your Hotel Center property feeds. The hotel ad identifier can be used for reporting analytics.

After you complete these steps, the delivery engine can begin serving hotel ads for the properties that it finds in the customer's Hotel Center property feeds. If the user's search query has property intent, the delivery engine searches the customer's Hotel Center property feed for properties that match the query. If it finds a property, and the property meets the conditions of the property filters specified in the hotel listing groups, the delivery engine generates a property ad using the property details from the feed.

Performance Statistics for Microsoft Lodging Campaigns

The Hotel Ads Reports can be submitted and downloaded with the Reporting Service to get performance data for Microsoft Lodging Campaigns.

If you request a report using account level scope, then the performance reports will include aggregated data for all campaigns, whether or not the campaign type is Bing Lodging. To only get data for Microsoft Lodging Campaigns, use campaign scope or ad group scope. The following is an example SOAP request that specifies campaign level scope.

<Scope>
    <AccountIds i:nil="true" xmlns:a="http://schemas.microsoft.com/2003/10/Serialization/Arrays" />
    <AdGroups i:nil="true" />
    <Campaigns>
    <CampaignReportScope>
        <AccountId>AccountIdGoesHere</AccountId>
        <CampaignId>CampaignIdGoesHere</CampaignId>
    </CampaignReportScope>
    </Campaigns>
</Scope>

For more information about using the Reporting Service, see Reporting API Guides and Request and Download a Report.

Note

Performance statistics and the product partition tree structure returned by the Reporting service lags behind the performance statistics that you see in the Microsoft Advertising web application by up to an hour.