For the complete documentation index, see llms.txt. This page is also available as Markdown.

Sample Bid Requests

The following examples provide unified bid requests and responses for Android and iOS, based on the OpenRTB spec and DT SDK:

The following example shows a bid request for a 320×50 banner ad on an Android device, including viewability metrics.

JSON
{
  "id": "5421953066022442839",
  "imp": [
    {
      "id": "1",
      "metric": [
        {
          "type": "measurability",
          "value": 1,
          "vendor": "doubleverify.com"
        },
        {
          "type": "measurability",
          "value": 1,
          "vendor": "integralads.com"
        },
        {
          "type": "measurability",
          "value": 1,
          "vendor": "moat.com"
        }
      ],
      "banner": {
        "w": 320,
        "h": 50,
        "btype": [
          4
        ],
        "battr": [
          3,
          6,
          7,
          9,
          10,
          14,
          17
        ],
        "pos": 4,
        "mimes": [
          "text/html",
          "text/javascript",
          "image/png",
          "image/jpeg",
          "image/gif"
        ],
        "topframe": 1,
        "api": [
          5,
          7
        ],
        "id": "1"
      },
      "pmp": {
        "private_auction": 1,
        "deals": [
          {
            "id": "DTX23617",
            "bidfloor": 10,
            "bidfloorcur": "USD",
            "at": 3
          }
        ]
      },
      "displaymanager": "Fyber",
      "displaymanagerver": "8.3.6.0",
      "instl": 0,
      "tagid": "630390",
      "bidfloor": 0.02,
      "bidfloorcur": "USD",
      "clickbrowser": 0,
      "secure": 0,
      "exp": 1800,
      "ext": {
        "dpl": 1,
        "brsrclk": 1
      },
      "rwdd": 0
    }
  ],
  "app": {
    "id": "630390",
    "name": "UnitBanner",
    "bundle": "com.fyber.marketplace.testapp",
    "cat": [
      "IAB24"
    ],
    "ver": "1.8.3.6",
    "privacypolicy": 1,
    "publisher": {
      "id": "553",
      "name": "IA_TestDist",
      "cat": [
        "IAB24"
      ]
    },
    "ext": {
      "fmwname": "native",
      "apilevel": 34
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 14; SM-M346B Build/UP1A.231005.007; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/135.0.7049.111 Mobile Safari/537.36",
    "geo": {
      "lat": 20.2706,
      "lon": 85.8334,
      "type": 2,
      "ipservice": 3,
      "country": "IND",
      "region": "OD",
      "city": "Bhubaneswar",
      "zip": "94401",
      "utcoffset": 330
    },
    "dnt": 0,
    "lmt": 0,
    "ip": "XXX.XXX.XXX.XXX",
    "devicetype": 4,
    "make": "Samsung",
    "model": "SM-M346B",
    "os": "Android",
    "osv": "14.0",
    "hwv": "Galaxy M34",
    "h": 757,
    "w": 384,
    "js": 1,
    "language": "en",
    "carrier": "53",
    "mccmnc": "405-53",
    "connectiontype": 6,
    "ifa": "XXX.XXX.XXX.XXX",
    "ext": {
      "inputLanguage": [
        "en"
      ],
      "headset": 0,
      "charging": 0,
      "batterylevel": 3,
      "batterysaver": 0,
      "darkmode": 0,
      "ringmute": 1,
      "airplane": 0,
      "dnd": 0
    }
  },
  "user": {
    "yob": 1990,
    "gender": "F",
    "ext": {
      "consent": "",
      "sessionduration": 21,
      "clickrate": 60
    }
  },
  "at": 1,
  "tmax": 750,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB25-2",
    "IAB26-3",
    "IAB26-2",
    "IAB25-5",
    "IAB17-18",
    "IAB25-1",
    "IAB9-9",
    "IAB25-4",
    "IAB26",
    "IAB26-1",
    "IAB25-3",
    "IAB7-42",
    "IAB26-4",
    "IAB7-28"
  ],
  "source": {
    "fd": 0,
    "ext": {
      "schain": {
        "ver": "1.0",
        "complete": 1,
        "nodes": [
          {
            "asi": "fyber.com",
            "sid": "553",
            "hp": 1
          }
        ]
      },
      "omidpn": "Fyber",
      "omidpv": "1.3.25"
    }
  },
  "regs": {
    "coppa": 0,
    "ext": {
      "gdpr": 0,
      "us_privacy": ""
    }
  }
}

The following example shows a bid response for a banner ad on an Android device with a creative payload and tracking URLs for an Android device.

Interstitial

Interstitial: Bid Request

The following example shows a bid request for an interstitial ad on an iOS device that supports both banner and video formats.

Interstitial: Bid Response

The following example shows a bid response for an interstitial ad on an iOS device.

Rewarded

Rewarded: Bid Request

The following example shows a bid request for a rewarded video ad on an Android device.

Rewarded: Bid Response

The following example shows a bid response for a rewarded video ad on an Android device with verification URLs.

Native

Native: Bid Request

The following example shows a bid request for a native ad on an Android device, including the types of supported assets.

Native: Bid Response

The following example shows the ad markup in the adm attribute of a bid response specifying a native video ad on an Android device.

Last updated