Bid Request JSON Examples

In App Example

{
    "regs": {
        "coppa": 0
    },
    "id": "4ecfe2ab-c275-48fb-8c0b-c7103579eaa0",
    "source": {
        "fd": 1,
        "ext": {
            "schain": {
                "complete": 0,
                "ver": "1.0",
                "nodes": [
                    {
                        "asi": "reseller.com",
                        "sid": "aaaaa",
                        "rid": "BidRequest4",
                        "hp": 1
                    }
                ]
            }
        }
    },
    "app": {
        "id": "adaptv_",
        "publisher": {
            "name": "",
            "id": "adaptv_11690"
        },
        "storeurl": "https://play.google.com/store/apps/details?id=com.zynga.looney",
        "bundle": "com.zynga.looney",
        "cat": [
            "IAB1"
        ],
        "name": "looney tunes dash!"
    },
    "wseat": [
        "68"
    ],
    "user": {
        "id": "dfc68ac9-9530-44b0-bdea-44cf153d7cea",
        "ext": {
            "ug": 1
        }
    },
    "device": {
        "dpidsha1": "0d7e6f65e1db717f0ed298bd268cc6415fa72124",
        "language": "en",
        "mccmnc": "310-005",
        "geo": {
            "country": "US",
            "lon": -78.83,
            "city": "Hamburg",
            "lat": 42.71,
            "zip": "14075",
            "region": "NY",
            "type": 2
        },
        "ifa": "dfc68ac9-9530-44b0-bdea-44cf153d7cea",
        "lmt": 0,
        "os": "android",
        "devicetype": 4,
        "ip": "72.88.84.159",
        "ua": "Mozilla/5.0 (Linux; Android 6.0.1; SM-G920P Build/MMB29K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/51.0.2704.81 Mobile Safari/537.36",
        "dpidmd5": "c65cf7c5bffe94c62cf20c5e465d92f7"
    },
    "tmax": 120,
    "cur": [
        "USD"
    ],
    "imp": [
        {
            "bidfloor": 0.02268,
            "metric": [
                {
                    "type": "viewability",
                    "value": 0.85
                }
            ],
            "id": "1",
            "instl": 0,
            "exp": 300,
            "bidfloorcur": "USD",
            "ext": {},
            "secure": 0,
            "video": {
                "protocols": [
                    2,
                    5
                ],
                "placement": 2,
                "playbackend": 1,
                "minduration": 5,
                "playbackmethod": [
                    1
                ],
                "maxduration": 30,
                "startdelay": 0,
                "linearity": 1,
                "mimes": [
                    "video/mp4"
                ]
            }
        }
    ],
    "bcat": [
        "IAB25-3",
        "BSW1",
        "BSW2",
        "BSW10",
        "BSW4",
        "IAB26"
    ],
    "ext": {
        "is_secure": 0,
        "wt": 1,
        "clktrkrq": 0,
        "ssp": "adaptv"
    },
    "at": 2
}

In App iOS 14

Note

See the highlighted lines that denote the iOS 14 fields, see the Protocol Release Notes for more details.

{
    "regs": {
        "ext": {
            "gdpr": 0,
            "us_privacy": "1YN-"
        }
    },
    "id": "4ecfe2ab-c275-48fb-8c0b-c7103579eaa0",
    "source": {
        "fd": 1,
        "ext": {
            "schain": {
                "complete": 0,
                "ver": "1.0",
                "nodes": [
                    {
                        "asi": "reseller.com",
                        "sid": "aaaaa",
                        "rid": "BidRequest4",
                        "hp": 1
                    }
                ]
            }
        }
    },
    "app": {
        "id": "adaptv_",
        "publisher": {
            "name": "Fyber",
            "id": "pubnative_1007055"
        },
        "storeurl": "https://apps.apple.com/us/app/wordscapes/id1207472156",
        "bundle": "1207472156",
        "cat": [
            "IAB1"
        ],
        "name": "Wordscapes"
    },
    "wseat": [
        "68"
    ],
    "user": {
        "ext": {
            "impdepth": 2,
            "sessionduration": 45
        }
    },
    "device": {
        "dpidsha1": "0d7e6f65e1db717f0ed298bd268cc6415fa72124",
        "language": "en",
        "mccmnc": "310-005",
        "geo": {
            "country": "US",
            "lon": -78.83,
            "city": "Hamburg",
            "lat": 42.71,
            "zip": "14075",
            "region": "NY",
            "type": 2
        },
        "ifa": "00000000-0000-0000-0000-000000000000",
        "ext": {
            "idfv": "1F277D46-12BF-482A-9085-B4F811DD6E4D"
        },
        "lmt": 1,
        "os": "ios",
        "devicetype": 4,
        "ip": "72.88.84.159",
        "ua": "Mozilla/5.0 (Linux; Android 6.0.1; SM-G920P Build/MMB29K; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/51.0.2704.81 Mobile Safari/537.36",
    },
    "tmax": 120,
    "cur": [
        "USD"
    ],
    "imp": [
        {
            "bidfloor": 0.02268,
            "metric": [
                {
                    "type": "viewability",
                    "value": 0.85
                }
            ],
            "id": "1",
            "instl": 0,
            "exp": 300,
            "bidfloorcur": "USD",
            "ext": {
                "skadn": {
                    "version": "2.0",
                    "sourceapp": "90987654321",
                    "skadnetids": [
                        "abc123.skadnetwork",
                        "def234.skadnetwork"
                    ]
                }
            }
        }
    ],
    "secure": 0,
    "video": {
        "protocols": [
            2,
            5
        ],
        "placement": 2,
        "playbackend": 1,
        "minduration": 5,
        "playbackmethod": [
            1
        ],
        "maxduration": 30,
        "startdelay": 0,
        "linearity": 1,
        "mimes": [
            "video/mp4"
        ]
    },
    "bcat": [
        "IAB25-3",
        "BSW1",
        "BSW2",
        "BSW10",
        "BSW4",
        "IAB26"
    ],
    "ext": {
        "wt": 1,
        "clktrkrq": 0,
        "is_secure": 0,
        "ssp": "gumgum",
        "tgroup": [
            123,
            456,
            321,
            765
        ],
        "ads_txt": {
            "status": 2,
            "auth_id": "1kjgh7653",
            "pub_id": "537120563",
            "supplier_domain": "example.com"
        }
    },
    "at": 2
}

Native Ad

{
    "id": "129ca6dd-5403-4476-a4a6-555d6a538bc4",
    "app": {
        "id": "pubnative_1009429",
        "publisher": {
            "name": "",
            "id": "pubnative_1005292"
        },
        "storeurl": "https://play.google.com/store/apps/details?id=com.leo.appmaster",
        "bundle": "com.leo.appmaster",
        "cat": [
            "IAB3"
        ],
        "name": "PG_lock_pic"
    },
    "wseat": [
        "167"
    ],
    "source": {
        "fd": 0
    },
    "user": {
        "id": "45asdf987656789adfad4678rew656789",
        "buyeruid": "1234567890",
        "keywords": "sports, entertainment",
        "yob": 1976,
        "gender": "F",
        "ext": {
            "ug": 1,
            "cookie_age": 15,
            "consent": "Y29uc2VudCBkYXRh",
            "consented_providers_settings": {
                "consented_providers": [
                    1791
                ]
            },
            "xuid": [
                {
                    "provider": "digitrust",
                    "id": "F6vrzeiV625KD2WaTcGs68ajfRYokPFm6jNUSsawIKAdo"
                },
                {
                    "provider": "TDID",
                    "id": "abc12345"
                },
                {
                    "provider": "id5",
                    "id": "ID5-abc12345"
                }
            ]
        }
    },
    "device": {
        "connectiontype": 3,
        "model": "Micromax A096",
        "mccmnc": "310-005",
        "language": "en",
        "geo": {
            "country": "IN",
            "lon": 85.1167,
            "city": "Patna",
            "lat": 25.6,
            "zip": "800002",
            "region": "34",
            "type": 2
        },
        "ifa": "793ff4b0-d077-4002-aeb6-b8ea64dd4b2b",
        "osv": "5.0.2",
        "os": "Android",
        "carrier": "Airtel",
        "devicetype": 1,
        "ip": "223.176.12.242",
        "ua": "Dalvik/2.1.0 (Linux; U; Android 5.0.2; Micromax A096 Build/LRX21M)",
        "dnt": 2
    },
    "tmax": 80,
    "cur": [
        "USD"
    ],
    "imp": [
        {
            "bidfloor": 0.324,
            "id": "1",
            "native": {
                "request": {
                    "plcmtcnt": 1,
                    "plcmttype": 2,
                    "privacy": 1,
                    "context": 1,
                    "contextsubtype": 12,
                    "assets": [
                        {
                            "id": 1,
                            "data": {
                                "type": 12
                            },
                            "required": 1
                        },
                        {
                            "title": {
                                "len": 50
                            },
                            "id": 2,
                            "required": 1
                        },
                        {
                            "id": 3,
                            "img": {
                                "w": 80,
                                "h": 80,
                                "type": 1
                            },
                            "required": 1
                        },
                        {
                            "id": 4,
                            "img": {
                                "w": 1200,
                                "h": 627,
                                "type": 3
                            },
                            "required": 1
                        },
                        {
                            "data": {
                                "type": 3
                            },
                            "id": 5,
                            "required": 0
                        },
                        {
                            "id": 6,
                            "data": {
                                "len": 100,
                                "type": 2
                            },
                            "required": 1
                        }
                    ],
                    "ver": "1.2"
                }
            },
            "exp": 1800,
            "bidfloorcur": "USD",
            "ext": {},
            "instl": 0
        }
    ],
    "bcat": [
        "IAB25-3",
        "BSW1",
        "BSW2",
        "BSW10",
        "BSW4",
        "IAB26"
    ],
    "ext": {
        "wt": 112,
        "clktrkrq": 0,
        "is_secure": 0,
        "ssp": "pubnative",
        "tgroup": [
            123,
            456,
            321,
            765
        ],
        "ads_txt": {
            "status": 2,
            "auth_id": "1kjgh7653",
            "pub_id": "537120563",
            "supplier_domain": "example.com"
        }
    },
    "at": 2
}

Private Deal Example

{
    "id": "500da108-85f8-44af-ac98-d7adcf9e0daf",
    "site": {
        "id": "spotx_SpotX_www.businessinsider.com",
        "publisher": {
            "name": "",
            "id": "spotx_84548"
        },
        "domain": "businessinsider.com",
        "page": "https://www.businessinsider.com/japanese-potato-changed-olivia-munns-appearance-2016-2"
    },
    "wseat": [
        "145"
    ],
    "user": {
        "ext": {
            "ug": 0
        }
    },
    "device": {
        "model": "Chrome - Windows",
        "mccmnc": "310-005",
        "language": "en",
        "geo": {
            "country": "US",
            "city": "Jackson Heights",
            "region": "NY",
            "zip": "11372"
        },
        "make": "Google",
        "osv": "NT 6.1",
        "os": "Windows 7",
        "devicetype": 2,
        "ip": "98.14.26.33",
        "ua": "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2342.0 Safari/537.36",
        "dnt": 0
    },
    "tmax": 415,
    "cur": [
        "USD"
    ],
    "imp": [
        {
            "bidfloor": 0.011232,
            "metric": [
                {
                    "type": "viewability",
                    "value": 0.85
                }
            ],
            "id": "1",
            "pmp": {
                "private_auction": 1,
                "deals": [
                    {
                        "bidfloor": 10.8,
                        "id": "14a44.a7993.d401",
                        "bidfloorcur": "USD",
                        "at": 2
                    }
                ]
            },
            "instl": 0,
            "exp": 300,
            "tagid": "spotx_http://search.spotxchange.com/vast/2.00/149110?VPAID=1&content_type=game&vmaxd=30&player_width=640&player_height=480&content_page_url=http%3A%2F%2Fwww.businessinsider.com%2Fjapanese-potato-changed-olivia-munns-appearance-2016-2&cb=1468903661330&adtid=T6GDD32DDC8UD5OOS5I6QROV40&viewability=0",
            "bidfloorcur": "USD",
            "secure": 0,
            "video": {
                "protocols": [
                    2,
                    5
                ],
                "companiontype": [
                    1,
                    2,
                    3
                ],
                "placement": 2,
                "playbackend": 1,
                "minduration": 1,
                "maxduration": 60,
                "startdelay": 0,
                "api": [
                    1
                ],
                "linearity": 1,
                "h": 480,
                "delivery": [
                    2
                ],
                "ext": {
                    "player_type": 3
                },
                "mimes": [
                    "video/x-flv",
                    "video/mp4",
                    "application/x-shockwave-flash"
                ],
                "w": 640,
                "companionad": [
                    {
                        "h": 250,
                        "id": "1",
                        "w": 300
                    }
                ]
            }
        }
    ],
    "bcat": [
        "IAB25-3",
        "BSW1",
        "BSW2",
        "BSW10",
        "BSW4",
        "IAB26"
    ],
    "ext": {
        "is_secure": 0,
        "wt": 1,
        "clktrkrq": 0,
        "ssp": "spotx"
    },
    "at": 2
}

Video Example

{
    "regs": {
        "coppa": 0,
        "ext": {
            "gdpr": 1
        }
    },
    "id": "75c0238c-3b52-4b87-957a-817f83e853f1",
    "site": {
        "id": "adaptv_",
        "publisher": {
            "name": "",
            "id": "adaptv_4182"
        },
        "cat": [
            "IAB1"
        ],
        "page": "http://kissasian.com"
    },
    "wseat": [
        "126"
    ],
    "source": {
        "fd": 1,
        "ext": {
            "schain": {
                "complete": 0,
                "ver": "1.0",
                "nodes": [
                    {
                        "asi": "reseller.com",
                        "sid": "aaaaa",
                        "rid": "BidRequest4",
                        "hp": 1
                    }
                ]
            }
        }
    },
    "user": {
        "id": "45asdf987656789adfad4678rew656789",
        "buyeruid": "1234567890",
        "keywords": "sports, entertainment",
        "yob": 1976,
        "gender": "F",
        "ext": {
            "ug": 1,
            "cookie_age": 15,
            "consent": "Y29uc2VudCBkYXRh",
            "consented_providers_settings": {
                "consented_providers": [
                    1791
                ]
            },
            "xuid": [
                {
                    "provider": "digitrust",
                    "id": "F6vrzeiV625KD2WaTcGs68ajfRYokPFm6jNUSsawIKAdo"
                },
                {
                    "provider": "TDID",
                    "id": "abc12345"
                },
                {
                    "provider": "id5",
                    "id": "ID5-abc12345"
                }
            ]
        }
    },
    "device": {
        "language": "en",
        "mccmnc": "310-005",
        "geo": {
            "country": "US",
            "lon": -75.15,
            "city": "Philadelphia",
            "lat": 39.94,
            "zip": "19147",
            "region": "PA",
            "type": 2
        },
        "lmt": 0,
        "os": "Other",
        "devicetype": 6,
        "ip": "73.141.79.240",
        "ua": "Mozilla/5.0 (PlayStation 4 3.55) AppleWebKit/537.78 (KHTML, like Gecko)"
    },
    "tmax": 120,
    "cur": [
        "USD"
    ],
    "imp": [
        {
            "bidfloor": 0.02268,
            "id": "1",
            "instl": 0,
            "exp": 300,
            "bidfloorcur": "USD",
            "ext": {},
            "secure": 0,
            "video": {
                "protocols": [
                    2,
                    5
                ],
                "placement": 2,
                "skip": 1,
                "playbackend": 1,
                "minduration": 5,
                "playbackmethod": [
                    3
                ],
                "maxduration": 60,
                "startdelay": 0,
                "linearity": 1,
                "mimes": [
                    "video/mp4"
                ]
            }
        }
    ],
    "bcat": [
        "IAB25-3",
        "BSW1",
        "BSW2",
        "BSW10",
        "BSW4",
        "IAB26"
    ],
    "ext": {
        "wt": 1,
        "clktrkrq": 0,
        "is_secure": 0,
        "ssp": "adaptv",
        "s2s_nurl": 1
    },
    "at": 2
}

Audio Ad Example

{
    "id": "1234534625253",
    "wseat": [
        "58"
    ],
    "source": {
        "fd": 1,
        "ext": {
            "schain": {
                "complete": 0,
                "ver": "1.0",
                "nodes": [
                    {
                        "asi": "reseller.com",
                        "sid": "aaaaa",
                        "rid": "BidRequest4",
                        "hp": 1
                    }
                ]
            }
        }
    },
    "imp": [
        {
            "id": "1",
            "secure": 1,
            "audio": {
                "startdelay": 0,
                "minduration": 5,
                "maxduration": 30,
                "maxextended": 30,
                "minbitrate": 300,
                "maxbitrate": 1500,
                "api": [
                    1,
                    2
                ],
                "protocols": [
                    9,
                    10
                ],
                "mimes": [
                    "audio/aac",
                    "audio/mp4",
                    "audio/mpeg"
                ],
                "delivery": [
                    2
                ],
                "battr": [
                    13,
                    14
                ],
                "companionad": [
                    {
                        "id": "1234567893-1",
                        "w": 300,
                        "h": 250,
                        "pos": 1,
                        "battr": [
                            13,
                            14
                        ],
                        "expdir": [
                            2,
                            4
                        ]
                    },
                    {
                        "id": "1234567893-2",
                        "w": 728,
                        "h": 90,
                        "pos": 1,
                        "battr": [
                            13,
                            14
                        ]
                    }
                ],
                "companiontype": [
                    1,
                    2
                ]
            }
        }
    ],
    "site": {
        "id": "google_234563",
        "domain": "siteabcd.com",
        "page": "https://siteabcd.com/page.htm",
        "ref": "http://google.com/?q=siteabcd",
        "publisher": {
            "id": "google_25"
        }
    },
    "device": {
        "ip": "64.124.253.1",
        "mccmnc": "310-005",
        "geo": {
            "country": "US",
            "region": "NY",
            "city": "White Plains",
            "zip": "10601"
        },
        "ua": "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.16) Gecko/20110319 Firefox/3.6.16",
        "language": "en"
    },
    "ext": {
        "wt": 1,
        "clktrkrq": 0,
        "is_secure": 0,
        "ssp": "gumgum",
        "tgroup": [
            123,
            456,
            321,
            765
        ],
        "ads_txt": {
            "status": 2,
            "auth_id": "1kjgh7653",
            "pub_id": "537120563",
            "supplier_domain": "example.com"
        }
    },
    "user": {
        "id": "45asdf987656789adfad4678rew656789",
        "buyeruid": "1234567890",
        "keywords": "sports, entertainment",
        "yob": 1976,
        "gender": "F",
        "ext": {
            "ug": 1,
            "cookie_age": 15,
            "consent": "Y29uc2VudCBkYXRh",
            "consented_providers_settings": {
                "consented_providers": [
                    1791
                ]
            },
            "xuid": [
                {
                    "provider": "digitrust",
                    "id": "F6vrzeiV625KD2WaTcGs68ajfRYokPFm6jNUSsawIKAdo"
                },
                {
                    "provider": "TDID",
                    "id": "abc12345"
                },
                {
                    "provider": "id5",
                    "id": "ID5-abc12345"
                }
            ]
        }
    },
    "regs": {
        "ext": {
            "gdpr": 0,
            "us_privacy": "1YN-"
        }
    },
    "cur": [
        "USD"
    ]
}

TV Ad Example

{
    "id": "1234534625253",
    "wseat": [
        "58"
    ],
    "imp": [
        {
            "id": "1",
            "bidfloor": 15,
            "exp": 360,
            "video": {
                "mimes": [
                    "video/x-flv",
                    "video/mp4",
                    "application/x-shockwave-flash",
                    "application/javascript"
                ],
                "placement": 2,
                "skip": 0,
                "playbackend": 1,
                "minduration": 30,
                "maxduration": 30,
                "protocols": [
                    3,
                    6
                ]
            }
        }
    ],
    "source": {
        "fd": 0,
    },
    "device": {
        "geo": {
            "country": "US",
            "region": "TX"
        },
        "devicetype": 6
    },
    "user": {
        "id": "45asdf987656789adfad4678rew656789",
        "keywords": "A_18_24,COLLEGE,HHI_75_100,M_18_24,HH_SINGLE",
        "data": [
            {
                "name": "program_types",
                "segment": [
                    {
                        "name": "HOCKEY_DEC",
                        "value": "8"
                    },
                    {
                        "name": "BASEBALL_DEC",
                        "value": "9"
                    },
                    {
                        "name": "FOOTBALL_DEC",
                        "value": "8.1"
                    }
                ]
            }
        ]
    },
    "tmax": 150,
    "cur": "USD",
    "ext": {
        "ssp": "dish",
        "tv": {
            "publisher": {
                "id": "dish_"
            }
        }
    }
}

DOOH Ad Example

{
    "id": "1234534625253",
    "wseat": [
        "58"
    ],
    "imp": [
        {
            "id": "06d690d1-bac0-43fa-9257-f6d62d984231",
            "bidfloor": 15,
            "exp": 360,
            "video": {
                "mimes": [
                    "video/x-flv",
                    "video/mp4"
                ],
                "placement": 2,
                "playbackend": 1,
                "skip": 0,
                "minduration": 30,
                "maxduration": 30,
                "protocols": [
                    3,
                    6,
                    7
                ],
                "w": 640,
                "h": 480
            },
            "pmp": {
                "private_auction": 1,
                "deals": [
                    {
                        "id": "deal-1",
                        "wseat": [
                            "58"
                        ],
                        "bidfloor": 2.5,
                        "bidfloorcur": "USD",
                        "at": 3
                    }
                ]
            }
        }
    ],
    "device": {
        "ifa": "035911ea467d03b65cf44f5633b",
        "mccmnc": "310-005",
        "ip": "64.124.253.1",
        "geo": {
            "lat": 35.012344,
            "lon": -115.12345,
            "country": "US",
            "region": "NY",
            "city": "White Plains",
            "zip": "10601"
        },
        "devicetype": 6
    },
    "user": {
        "id": "45asdf987656789adfad4678rew656789",
        "data": [
            {
                "id": "6",
                "name": "Data Provider 1",
                "segment": [
                    {
                        "name": "M",
                        "value": "15"
                    },
                    {
                        "name": "F",
                        "value": "9"
                    },
                    {
                        "name": "M65+",
                        "value": "8.1"
                    },
                    {
                        "name": "TOTAL",
                        "value": "19.5"
                    }
                ]
            },
            {
                "name": "demographic",
                "segment": [
                    {
                        "id": "12341318394918",
                        "name": "auto intenders"
                    }
                ]
            }
        ]
    },
    "tmax": 150,
    "exp": 300,
    "cur": "USD",
    "source": {
        "fd": 0,
    },
    "ext": {
        "wt": 1,
        "clktrkrq": 0,
        "dooh": {
            "publisher": {
                "id": "rubicon_234563",
                "cat": [
                    "IAB1"
                ]
            },
            "audience": 19.5,
            "impmultiply": 1
        },
        "is_secure": 0,
        "ssp": "rubicon",
        "tgroup": [
            123,
            456,
            321,
            765
        ],
        "ads_txt": {
            "status": 2,
            "auth_id": "1kjgh7653",
            "pub_id": "537120563",
            "supplier_domain": "example.com"
        }
    }
}