3 - Bid request parameters

Smart AdServer's Real Time Bidding solution follows the Open RTB 2.3 protocol. Based on this industry standard, Smart RTB+ sends bid requests (encoded in a JSON message) to connected DSPs in order to exchange RTB information.

Below you'll find important notes, bid request details and examples regarding Web, In App and Video inventory.

Web / Web Mobile Bid Request

Bid request highlights

In App Bid Request

For In-App inventory, these are the important details to focus on:

1. API framework this parameter notify the Trading Desk if your App supports MRAID creatives.

Smart RTB+ pass this information in our bid requests

 "api": [
            5

2. Bundle ID/ Name / ID important for DSP targeting

Smart RTB+ pass this information in our bid requests:

Bundle ID for Android apps must look like: "com.domain.com"

Bundle ID for iOS apps must look like: "387771637"

"app": {
      "id": "44765",
      "name": "App-Name",
      "bundle": "http://com.domain.com",
      "domain": "http://domain.com",

3. Latitude/ Longitude information

Smart RTB+ pass this information if the user accepts geolocalization:

 "geo": {
        "country": "MAR",
        "zip": "10000",
        "type": 1,
        "lat": 31.62521,
        "lon": -7.993426

4. IFA parameters

This refer to Idfa information

 "ifa": "3862fd77-757e-4683-890e-ddaaf58e2c67",
      "ext": {
        "is_app": 1
      }

 Complete In-App bid request example:

"PartnerBidRequest": {
    "id": "323511186578926643",
    "imp": [
      {
        "id": "e4f96a2a-2788-458f-97f2-75d6cad12cb8",
        "banner": {
          "w": 320,
          "h": 50,
          "api": [
            5
          ]
        },
        "bidfloor": 0.11322464,
        "bidfloorcur": "USD",
        "pmp": {
          "private_auction": 1,
          "deals": [
            {
              "id": "534952458605",
              "bidfloor": 1.69836962,
              "bidfloorcur": "USD",
              "wseat": [
                "263"
              ],
              "at": 3
            },
            {
              "id": "233314567086",
              "bidfloor": 1.69836962,
              "bidfloorcur": "USD",
              "wseat": [
                "263"
              ],
              "at": 3
            },
            {
              "id": "250292997179",
              "bidfloor": 1.69836962,
              "bidfloorcur": "USD",
              "wseat": [
                "263"
              ],
              "at": 3
            }
          ]
        }
      }
    ],
    "app": {
      "id": "44765",
      "name": "App-Name",
      "bundle": "http://com.domain.com",
      "cat": [
        "IAB1"
      ],
      "domain": "http://domain.com",
      "publisher": {
        "id": "666",
        "name": "Publisher Name"
      }
    },
    "device": {
      "ua": "Mozilla/5.0 (Linux; Android 5.0.2; SM-A500FU  Build/LRX22G; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0  Chrome/52.0.2743.98 Mobile Safari/537.36",
      "ip": "41.141.253.227",
      "geo": {
        "country": "MAR",
        "zip": "10000",
        "type": 1,
        "lat": 31.62521,
        "lon": -7.993426
      },
      "dpidsha1": "fe80cd336f738e35c506de83bce261e7f5ed9bda",
      "dpidmd5": "7bcae5196bb3672c8932cad624590d64",
      "make": "Samsung",
      "model": "SM-A500FU",
      "os": "Android",
      "osv": "5.0.2",
      "connectiontype": 2,
      "devicetype": 4,
      "language": "",
      "ifa": "3862fd77-757e-4683-890e-ddaaf58e2c67",
      "ext": {
        "is_app": 1
      }
    },
    "user": {
      "id": "-1685912401"
    },
    "at": 2,
    "cur": [
      "USD"
    ],
    "bcat": [
      "IAB17-18",
      "IAB23-1",
      "IAB24",
      "IAB25-3",
      "IAB25-4",
      "IAB25-5",
      "IAB25-7",
      "IAB26",
      "IAB7-39"
    ]
  },

Video Bid Request

For Video inventory, there are 2 relevant points to focus on:

1. API framework this parameter notify the Trading Desk if your player supports VPAID creatives

Smart RTB+ pass this information in our bid requests (must be 1 or 2 for VPAID)

 "api": [
            2

2. Outstream Bid Request (Web, Mobile Web, Mobile App)

In order to target video outstream exclusively, we add a flag called “smart_context” in the video bid request. When “smart_context=1”, the impression is video outstream. In any other case, the impression is video instream.


"video": {
       "ext": {
          "smart_context": 1
      }

 Complete Video bid request example:

"PartnerBidRequest": {
    "id": "438071501962817695",
    "imp": [
      {
        "id": "b2b95010-9caa-4359-9cbb-ff65f1b34609",
        "video": {
          "mimes": [
            "video/mp4",
            "application/javascript"
          ],
          "linearity": 1,
          "minduration": 1,
          "maxduration": 60,
          "protocols": [
            2,
            3,
            5,
            6
          ],
          "w": 1,
          "h": 1,
          "startdelay": 0,
          "api": [
            1,
            2
          ],
          "boxingallowed": 1
        },
        "bidfloor": 7.92572451,
        "bidfloorcur": "USD",
        "pmp": {
          "private_auction": 1,
          "deals": [
            {
              "id": "211851251964",
              "bidfloor": 13.586957,
              "bidfloorcur": "USD",
              "wseat": [
                "377"
              ],
              "at": 3
            }
          ]
        }
      }
    ],
    "site": {
      "publisher": {
        "id": "1936",
        "name": "Publisher-Name"
      },
      "id": "114697",
      "name": "Publisherdomain.com",
      "domain": "http://Publisherdomain.com ",
      "page": "http://Publisherdomain.com"
    },
    "device": {
      "ua": "Mozilla/5.0 (BB10; Touch) AppleWebKit/537.35+ (KHTML, like Gecko) Version/10.3.2.2876 Mobile Safari/537.35+",
      "ip": "80.12.33.126",
      "geo": {
        "country": "FRA",
        "zip": "84100",
        "type": 2
      },
      "make": "BlackBerry",
      "model": "Z10",
      "os": "Rim",
      "osv": "BB10",
      "devicetype": 4,
      "carrier": "208-1",
      "language": "fr",
      "ext": {
        "is_app": 0
      }
    },
    "user": {
      "id": "6208636019451380755",
      "buyeruid": "CAESEFk2D1CDXX_XXXXX"
    },
    "at": 2,
    "cur": [
      "USD"
    ],
    "bcat": [
      "IAB17-18",
      "IAB23-1",
      "IAB24",
      "IAB25-3",
      "IAB25-4",
      "IAB25-5",
      "IAB25-7",
      "IAB26",
      "IAB7-39"
    ]
  },
Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk