Having Bing Ads pull Transaction Messages

Bing offers two pull modes. The first option is pull mode. With this option, Bing sends you requests and you send back all of your itinerary data. The second option is pull with hints. With this option, instead of returning all of your itinerary data, you return only the itineraries that you identified as having changed.

For both modes, you work with your TAM to specify:

  • The endpoint that Bing sends requests to
  • The frequency that Bing sends requests
  • Default values for maximum advanced booking and night stays.

Once a day Bing sends a request to an endpoint that you specify asking for updates to your maximum advanced booking and night stays default values. You respond to the request with a QueryControl message. In addition to specifying the default values, you can use the message to override the default values for specific properties or disable specific properties so Bing doesn't collect data for them. For more information, see Creating a QueryControl Message.

Note

Before sending messages to Bing:

  • Validate the message to ensure that it's compliant with the message's XSD. This will save you round trips and time having to fix errors.

  • Ensure that the message contains less than 100 MB of uncompressed data or 10 MB of compressed data (using GZip compression). To reduce network traffic, you should always send compressed data.

Pull mode

With pull mode, Bing sends you a Query message that identifies the itineraries that you should send back in the response using a Transaction message. The request identifies all itineraries. Depending on the values that you specified for maximum advanced booking and nights stay, and the number of properties in your hotel feed, Bing may break the request into multiple requests. For information about processing the query message, see Processing a Query Message.

Pull with hints mode

With pull with hints, Bing first sends you a hint request, which contains a time stamp of the last time you sent Bing updates. You respond to the hint request with a Hint message that identifies the itineraries that have changed since the last successful update. You can identify individual itineraries or a range of itineraries using a range of check-in dates. For more information, see Creating a Hint Message.

Bing uses the hints to generate and send one or more Query messages that specify only the itineraries that you said changed. Your response should be a Transaction message that contains the requested data. For information about processing the query message, see Processing a Query Message.