Sample Bid Requests

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

Banner

Banner: Bid Request

The following sample is a banner ad bid request for an Ad size 320x50, with viewability metrics.

Android iOS
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": ""
    }
  }
}

Banner: Bid Response

The following sample shows a banner bid response with a creative payload and tracking URLs.

Android iOS
JSON
{
  "id": "3",
  "bidid": "25a85c3eb4a74b6fbe8c0f35081bce71",
  "cur": "USD",
  "seatbid": [{
    "seat": "1",
    "bid": [{
      "id": "4b2a6f15ae0c46aab52f40dc73ea647d",
      "adid": "2879474376",
      "price": 2.9976508885484914,
      "nurl": "http://forest.fyber.com/internal/callbacks/nurl?bidid=25a85c3eb4a74b6fbe8c0f35081bce71",
      "lurl": "http://forest.fyber.com/internal/callbacks/lurl?bidid=25a85c3eb4a74b6fbe8c0f35081bce71",
      "crid": "2879474376",
      "adm": "<script src=\"https://cdn.doubleverify.com/dvtp_src.js?ctx=17890514&cmp=DV986992&sid=adcolony&plc=pmp-display&advid=818053&adsrv=0&autt=1&DVP_DV_CT=1&ppid=223&btadsrv=&auadv=Programmatic-DISPLAY&aucmp=3cqyalw&audeal=DTX23511&aulitem=NotManaged&aucrtv=7hmzbsl7&aubndl=com.zynga.words3&ausite=209382&pltfrm=FyberSDK\" type=\"text/javascript\">...</script>",
      "adomain": ["fyber.com"],
      "attr": [1],
      "impid": "1",
      "iurl": "http://forest.fyber.com/internal/callbacks/iurl?bidid=25a85c3eb4a74b6fbe8c0f35081bce71",
      "cid": "2879474376"
    }]
  }]
}

Interstitial

Interstitial: Bid Request

The following sample is for an interstitial ad request that supports banner and video formats.

Android iOS
JSON
{
  "id": "4953651281984934655",
  "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": 480,
      "btype": [4],
      "battr": [3, 8, 9, 10, 14, 17],
      "pos": 7,
      "mimes": ["text/html", "text/javascript", "image/png", "image/jpeg", "image/gif"],
      "topframe": 1,
      "api": [5, 7],
      "id": "1",
      "ext": {
        "rewarded": 0
      }
    },
    "video": {
      "mimes": ["video/mp4", "video/webm"],
      "minduration": 1,
      "maxduration": 60,
      "protocols": [2, 3, 5, 6, 7, 8],
      "w": 320,
      "h": 480,
      "startdelay": 0,
      "placement": 5,
      "plcmt": 3,
      "linearity": 1,
      "skip": 1,
      "skipmin": 15,
      "skipafter": 5,
      "battr": [3, 8, 9, 10, 13, 14, 17],
      "maxbitrate": 5000,
      "playbackmethod": [5],
      "playbackend": 1,
      "pos": 7,
      "companionad": [{
        "w": 320,
        "h": 480,
        "mimes": ["text/html", 
         "text/javascript",
         "image/png",
         "image/jpeg",
         "image/gif"],
        "vcm": 1
      }],
      "api": [5, 7],
      "companiontype": [1, 2, 3],
      "ext": {
        "rewarded": 0,
        "mraidendcard": 1,
        "dualendcard": 1
      }
    },
    "pmp": {
      "private_auction": 0,
      "deals": [{
        "id": "DTX23473",
        "bidfloor": 0.05,
        "bidfloorcur": "USD",
        "at": 3
      }, {
        "id": "DTX23944",
        "bidfloor": 0.05,
        "bidfloorcur": "USD",
        "at": 3
      }]
    },
    "displaymanager": "Fyber",
    "displaymanagerver": "8.3.6.0",
    "instl": 1,
    "tagid": "630394",
    "bidfloor": 0.02,
    "bidfloorcur": "USD",
    "clickbrowser": 0,
    "secure": 0,
    "exp": 3600,
    "ext": {
      "dpl": 1,
      "brsrclk": 1
    },
    "rwdd": 0
  }],
  "app": {
    "id": "630394",
    "name": "UnitInterstitial",
    "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": 8,
      "clickrate": 20,
      "completionrate": 20
    }
  },
  "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": ""
    }
  }
} 

Interstitial: Bid Response

The following sample shows an interstitial bid response with a VAST markup.

Android iOS
JSON
{
  "id": "1",
  "bidid": "31345a6be4104a7fb69f60b23f247df8",
  "cur": "USD",
  "seatbid": [{
    "seat": "1",
    "bid": [{
      "id": "86cce85d74e54f5f962c9c2468543d65",
      "adid": "1766589897",
      "price": 2.096142446536477,
      "nurl": "http://forest.fyber.com/internal/callbacks/nurl?bidid=31345a6be4104a7fb69f60b23f247df8",
      "lurl": "http://forest.fyber.com/internal/callbacks/lurl?bidid=31345a6be4104a7fb69f60b23f247df8",
      "crid": "1766589897",
      "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?><VAST>...</VAST>",
      "adomain": ["fyber.com"],
      "attr": [1],
      "impid": "1",
      "iurl": "http://forest.fyber.com/internal/callbacks/iurl?bidid=31345a6be4104a7fb69f60b23f247df8",
      "cid": "1766589897"
    }]
  }]
}

Rewarded

Rewarded: Bid Request

The following sample shows a request for a rewarded video ad.

Android iOS
JSON
{
  "id": "6760241165890363414",
  "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": 480,
        "btype": [
          4
        ],
        "battr": [
          3,
          8,
          9,
          10,
          14,
          17
        ],
        "pos": 7,
        "mimes": [
          "text/html",
          "text/javascript",
          "image/png",
          "image/jpeg",
          "image/gif"
        ],
        "topframe": 1,
        "api": [
          5,
          7
        ],
        "id": "1",
        "ext": {
          "rewarded": 1
        }
      },
      "video": {
        "mimes": [
          "video/mp4",
          "video/webm"
        ],
        "minduration": 1,
        "maxduration": 30,
        "protocols": [
          2,
          3,
          5,
          6,
          7,
          8
        ],
        "w": 320,
        "h": 480,
        "startdelay": 0,
        "placement": 5,
        "plcmt": 3,
        "linearity": 1,
        "skip": 0,
        "battr": [
          3,
          8,
          9,
          10,
          13,
          14,
          17
        ],
        "maxbitrate": 5000,
        "playbackmethod": [
          5
        ],
        "playbackend": 1,
        "pos": 7,
        "companionad": [
          {
            "w": 320,
            "h": 480,
            "mimes": [
              "text/html",
              "text/javascript",
              "image/png",
              "image/jpeg",
              "image/gif"
            ],
            "vcm": 1
          }
        ],
        "api": [
          5,
          7
        ],
        "companiontype": [
          1,
          2,
          3
        ],
        "ext": {
          "rewarded": 1,
          "mraidendcard": 1,
          "dualendcard": 1
        }
      },
      "pmp": {
        "private_auction": 0,
        "deals": [
          {
            "id": "DTX23473",
            "bidfloor": 0.05,
            "bidfloorcur": "USD",
            "at": 3
          },
          {
            "id": "DTX23944",
            "bidfloor": 0.05,
            "bidfloorcur": "USD",
            "at": 3
          }
        ]
      },
      "displaymanager": "Fyber",
      "displaymanagerver": "8.3.6.0",
      "instl": 1,
      "tagid": "630397",
      "bidfloor": 0.02,
      "bidfloorcur": "USD",
      "clickbrowser": 0,
      "secure": 0,
      "exp": 3600,
      "ext": {
        "dpl": 1,
        "brsrclk": 1
      },
      "rwdd": 1
    }
  ],
  "app": {
    "id": "630397",
    "name": "UnitRewarded",
    "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.XX",
    "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.XX",
    "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": 17
    }
  },
  "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": ""
    }
  }
}

Rewarded: Bid Response

The following sample shows a rewarded video bid response with verification URLs.

Android iOS
JSON
{
  "id": "1",
  "bidid": "a4738e7d696f4913b9d80d1954c41600",
  "cur": "USD",
  "seatbid": [{
    "seat": "1",
    "bid": [{
      "id": "49379b671e4b499eb38e988f989120da",
      "adid": "1766589897",
      "price": 1.860125365237718,
      "nurl": "http://forest.fyber.com/internal/callbacks/nurl?bidid=a4738e7d696f4913b9d80d1954c41600",
      "lurl": "http://forest.fyber.com/internal/callbacks/lurl?bidid=a4738e7d696f4913b9d80d1954c41600",
      "crid": "1766589897",
      "adm": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?><VAST>...</VAST>",
      "adomain": ["fyber.com"],
      "attr": [1],
      "impid": "1",
      "iurl": "http://forest.fyber.com/internal/callbacks/iurl?bidid=a4738e7d696f4913b9d80d1954c41600",
      "cid": "1766589897"
    }]
  }]
}

 

Back to Top ⇧