Process the bid request

When you simulate traffic to a TinyTag for which your bidder is eligible to bid, a Bid Request will be sent to your bidder. This request includes a significant amount of information about the impression. Sample bid requests for OpenRTB and Xandr's bidding protocol are shown below. For a more detailed description of the various fields, seeĀ Bid Request.

The Bid Request is sent with header information, such as the IP address and debug information. The JSON for the request itself includes details about the members for which the auction should be evaluated by the bidder; the tag(s) for the auction, including details about each tag; and information about the auction, including the user ID, the region from which the impression originated, and other information.

Once your bidder has received this first bid request, you can trust that the initial sandbox setup is working properly.

Sample bid requests


  "id": "1234534625254",
  "at": 2,
  "tmax": 120,
  "imp": [
      "id": "1",
      "banner": {
        "w": 320,
        "h": 50,
        "pos": 1,
        "battr": [
  "badv": [
  "app": {
    "id": "234563",
    "bundle": "com.rovio.angrybirds",
    "cat": [
    "publisher": {
      "id": "pub12345"
  "device": {
    "ip": "",
    "ua": "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv: Gecko/20110319 Firefox/3.6.16",
    "os": "OS X"
  "user": {
    "id": "45asdf987656789adfad4678rew656789"

Bidding protocol

Connection: keep-alive
X-Inventory-Class: 4
X-Venue: 352
X-DMA: 501
X-Exclusive: 0
X-Debug: 1
         "user_agent":"Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US;rv: Gecko/2008092414 Firefox/3.0.3",
         "city": "New York",
         "postal_code": 10014,

Next step

Submitting your Bid Response