Having Microsoft Advertising pull Transaction Messages

Microsoft offers two pull modes:

  1. Pull
  2. Pull with hints

For both modes, specify:

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

Once a day Microsoft sends a request to the endpoint you specified asking for updates to your maximum advanced booking and night stays default values.

Note

Before sending messages to Microsoft:

  • 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, Microsoft sends you a Query message that identifies the itineraries you send back in the response using a Transaction message. The request identifies all itineraries. Microsoft may send multiple requests depending on the values that you specified for maximum advanced booking and nights stay, and the number of properties in your hotel feed. For information about processing the query message, see Processing a Query Message.

Pull with hints mode

With pull with hints, Microsoft first sends you a hint request, which contains a time stamp of the last time you sent Microsoft 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.

Microsoft 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.