in-app bidding integration

BidRequests Examples

{
        "id": "1",
        "imp": [{
                "id": "1",
                "bidfloor": 0.01,
                "bidfloorcur": "USD",
                "tagid": "951620",
                "banner": {
                        "w": 300,
                        "h": 250
                }
        }],
        "app": {
                "id": "97",
                "name": "Odnoklassniki",
                "bundle": "ru.ok.android",
                "storeurl": "https://play.google.com/store/apps/details?id=ru.ok.android",
                "ver": "16.6.3"
        },
        "device": {
                "geo": {
                        "lat": 55.796919,
                        "lon": 37.537938,
                        "type": 1,
                        "accuracy": 15,
                        "lastfix": 300
                },
                "lmt": 0,
                "ip": "185.6.244.185",
                "devicetype": 4,
                "make": "LGE",
                "model": "bullhead",
                "os": "Android",
                "osv": "6.0.1",
                "language": "ru",
                "carrier": "MegaFon",
                "connectiontype": 2,
                "ifa": "e8be10f0-f17f-485c-96fc-9220b5696ac"
        },
        "user": {
                "id": "e8be10f0-f17f-485c-96fc-9220b5696ac",
                "yob": 1980,
                "gender": "F",
                "ext": {
                        "buyeruid": "eJxVUU1vgzAM/TXNBYGcQCgccui0j8PU03ZH+TAsKiQohHbdr1/oVG272Jb1bL/3jKuTE4qDM8Fbk709vmZqtWPMeh+yz6YmfsYgow+dNYLVQKKd8Ms7FC/H9x17gHJXHgCypzUk5I49H/2i/YXIeT5jELxoC1owACCLOXWp1VkXBQdoASiRJnWiXawbuhikPm0FOqlGNIKS4H1MBWzbulG6QaAj92xmK6oq7bVTN3otSnrDCe2nYroWUYYBo8HJ8xvkr44E3aT45a6bGHSLjVfBij0nH4IxBv/IpSFsFFLoIe/pvs+rhuu8rfsUElbxuq2lLjcCm30beb9sBjRJPpBJurWXOq4h+eb9MOKvr3/9J9YtUTqN28FGVVw3qs7LkmJe8YbnSima77liFaDGveTkIig0ievP/O1JGlTV0r7kLTOGV0nb2WoUAzoMVnfpqd/DG6W6"
                }
        },
        "ext": {
                "pid": 1000
        },
        "cur": [
                "USD"
        ]
}

{
        "id": "1",
        "imp": [{
                "id": "1",
                "bidfloor": 0.01,
                "bidfloorcur": "USD",
                "tagid": "951617",
                "video": {
                        "w": 640,
                        "h": 360,
                        "companionad": [{
                                "id": "1",
                                "w": 240,
                                "h": 400,
                                "btype": [4],
                                "pos": 4
                        }],
                        "companiontype": 1,
                        "minduration": 10,
                        "maxduration": 30,
                        "mimes": ["video/mp4"],
                        "placement": "",
                        "pos": 7,
                        "protocols": [3,4],
                        "skip": 0,
                        "instl": 1,
                        "ext": {
                                "placementtype": "rewarded"
                        }
                }
        }],
        "app": {
                "id": "97",
                "name": "Odnoklassniki",
                "bundle": "ru.ok.android",
                "storeurl": "https://play.google.com/store/apps/details?id=ru.ok.android",
                "ver": "16.6.3"
        },
        "device": {
                "geo": {
                        "lat": 55.796919,
                        "lon": 37.537938,
                        "type": 1,
                        "accuracy": 15,
                        "lastfix": 300
                },
                "lmt": 0,
                "ip": "185.6.244.185",
                "devicetype": 4,
                "make": "LGE",
                "model": "bullhead",
                "os": "Android",
                "osv": "6.0.1",
                "language": "ru",
                "carrier": "MegaFon",
                "connectiontype": 2,
                "ifa": "e8be10f0-f17f-485c-96fc-9220b5696ac"
        },
        "user": {
                "id": "e8be10f0-f17f-485c-96fc-9220b5696ac",
                "yob": 1980,
                "gender": "F",
                "ext": {
                        "buyeruid": "eJxVUU1vgzAM/TXNBYGcQCgccui0j8PU03ZH+TAsKiQohHbdr1/oVG272Jb1bL/3jKuTE4qDM8Fbk709vmZqtWPMeh+yz6YmfsYgow+dNYLVQKKd8Ms7FC/H9x17gHJXHgCypzUk5I49H/2i/YXIeT5jELxoC1owACCLOXWp1VkXBQdoASiRJnWiXawbuhikPm0FOqlGNIKS4H1MBWzbulG6QaAj92xmK6oq7bVTN3otSnrDCe2nYroWUYYBo8HJ8xvkr44E3aT45a6bGHSLjVfBij0nH4IxBv/IpSFsFFLoIe/pvs+rhuu8rfsUElbxuq2lLjcCm30beb9sBjRJPpBJurWXOq4h+eb9MOKvr3/9J9YtUTqN28FGVVw3qs7LkmJe8YbnSima77liFaDGveTkIig0ievP/O1JGlTV0r7kLTOGV0nb2WoUAzoMVnfpqd/DG6W6"
                }
        },
        "cur": [
                "USD"
        ],
        "ext": {
                "pid": 1000
        }

}

{
        "id": "7729573d-a29e-40a3-bcc7-6cde5b08b151",
        "imp": [{
                "id": "6de32339-8bdd-42e6-9d02-0edb8a42ec20",
                "bidfloor": 0.01,
                "bidfloorcur": "USD",
                "tagid": "951614",
                "native": {
                        "request": "{\"plcmttype\":1,\"assets\":[{\"id\":1,\"title\":{\"len\":31}},{\"id\":2,\"img\":{\"wmin\":50,\"type\":1}},{\"id\":3,\"img\":{\"wmin\":150,\"type\":3}},{\"id\":4,\"data\":{\"type\":1}},{\"id\":5,\"data\":{\"type\":2}},{\"id\":6,\"data\":{\"type\":3}},{\"id\":7,\"data\":{\"type\":4}},{\"id\":8,\"data\":{\"type\":11}},{\"id\":9,\"data\":{\"type\":12}}]}",
                        "ver": "1.0"
                }
        }],
        "app": {
                "id": "97",
                "name": "Odnoklassniki",
                "bundle": "ru.ok.android",
                "storeurl": "https://play.google.com/store/apps/details?id=ru.ok.android",
                "ver": "16.6.3"
        },
        "device": {
                "geo": {
                        "lat": 55.796919,
                        "lon": 37.537938,
                        "type": 1,
                        "accuracy": 15,
                        "lastfix": 300
                },
                "lmt": 0,
                "ip": "185.6.244.185",
                "devicetype": 4,
                "make": "LGE",
                "model": "bullhead",
                "os": "Android",
                "osv": "6.0.1",
                "language": "ru",
                "carrier": "MegaFon",
                "connectiontype": 2,
                "ifa": "e8be10f0-f17f-485c-96fc-9220b5696ac"
        },
        "user": {
                "id": "e8be10f0-f17f-485c-96fc-9220b5696ac",
                "yob": 1980,
                "gender": "F",
                "ext": {
                        "buyeruid": "eJxVUU1vgzAM/TXNBYGcQCgccui0j8PU03ZH+TAsKiQohHbdr1/oVG272Jb1bL/3jKuTE4qDM8Fbk709vmZqtWPMeh+yz6YmfsYgow+dNYLVQKKd8Ms7FC/H9x17gHJXHgCypzUk5I49H/2i/YXIeT5jELxoC1owACCLOXWp1VkXBQdoASiRJnWiXawbuhikPm0FOqlGNIKS4H1MBWzbulG6QaAj92xmK6oq7bVTN3otSnrDCe2nYroWUYYBo8HJ8xvkr44E3aT45a6bGHSLjVfBij0nH4IxBv/IpSFsFFLoIe/pvs+rhuu8rfsUElbxuq2lLjcCm30beb9sBjRJPpBJurWXOq4h+eb9MOKvr3/9J9YtUTqN28FGVVw3qs7LkmJe8YbnSima77liFaDGveTkIig0ievP/O1JGlTV0r7kLTOGV0nb2WoUAzoMVnfpqd/DG6W6"
                }
        },
        "ext": {
                "pid": 1000
        },
        "cur": [
                "USD"
        ]
}

{
        "id": "15cd8f22-c30a-45e4-8f82-dda9a5229c85",
        "imp": [{
                "id": "5efb15fd-2750-4eee-b235-d530faf21d3b",
                "bidfloor": 0.01,
                "bidfloorcur": "USD",
                "tagid": "951611",
                "banner": {
                        "pos": 7
                },
                "instl": 1
        }],
        "app": {
                "id": "97",
                "name": "Odnoklassniki",
                "bundle": "ru.ok.android",
                "storeurl": "https://play.google.com/store/apps/details?id=ru.ok.android",
                "ver": "16.6.3"
        },
        "device": {
                "geo": {
                        "lat": 55.796919,
                        "lon": 37.537938,
                        "type": 1,
                        "accuracy": 15,
                        "lastfix": 300
                },
                "lmt": 0,
                "ip": "185.6.244.185",
                "devicetype": 4,
                "make": "LGE",
                "model": "bullhead",
                "os": "Android",
                "osv": "6.0.1",
                "language": "ru",
                "carrier": "MegaFon",
                "connectiontype": 2,
                "ifa": "e8be10f0-f17f-485c-96fc-9220b5696ac"
        },
        "user": {
                "id": "e8be10f0-f17f-485c-96fc-9220b5696ac",
                "yob": 1980,
                "gender": "F",
                "ext": {
                        "buyeruid": "eJxVUU1vgzAM/TXNBYGcQCgccui0j8PU03ZH+TAsKiQohHbdr1/oVG272Jb1bL/3jKuTE4qDM8Fbk709vmZqtWPMeh+yz6YmfsYgow+dNYLVQKKd8Ms7FC/H9x17gHJXHgCypzUk5I49H/2i/YXIeT5jELxoC1owACCLOXWp1VkXBQdoASiRJnWiXawbuhikPm0FOqlGNIKS4H1MBWzbulG6QaAj92xmK6oq7bVTN3otSnrDCe2nYroWUYYBo8HJ8xvkr44E3aT45a6bGHSLjVfBij0nH4IxBv/IpSFsFFLoIe/pvs+rhuu8rfsUElbxuq2lLjcCm30beb9sBjRJPpBJurWXOq4h+eb9MOKvr3/9J9YtUTqN28FGVVw3qs7LkmJe8YbnSima77liFaDGveTkIig0ievP/O1JGlTV0r7kLTOGV0nb2WoUAzoMVnfpqd/DG6W6"
                }
        },
        "cur": [
                "USD"
        ],
        "ext": {
                "pid": 1000
        }
}

BidResponse Examples

{
        "cur": "RUB",
        "bidid": "6718617390701103366",
        "seatbid": [{
                "bid": [{
                        "crid": "63310221",
                        "price": 20.9300,
                        "adomain": ["apple.com"],
                        "id": "5eeb7ed53ad66f5c",
                        "adid": "63310221",
                        "impid": "90ffa5fc6bc94831",
                        "nurl": "https://rs.mail.ru/pixel/AACz8gGmS8bX_36KDP8R5KcRMz_6tq8xK7sDd4F4ALUFbaLf0pqMQFybj-VAUdvHuNXGKHWeitr2EKMbynLgSADOtSYvApp-AcMp-qqUEi3xu-TIqfpdtGGWlavUl8LVLJtkzgCN3uHT-rXhjis9NyUy2awvm2ecxFfb3KljeoB6Xf49lsruF2WoXJMo1n7e1IoQVM5eln440Z0bhzIzMKzT9-IANaWByDjeFrx6jo3YtrpCLsRSc_CZAOV5IBF14SUY2WdTJ4IBBOYGnm8rqLhH-YAm-I1XCt_52nd-v9d9XeJPDoCbY4mTaYYPImHmeqDlHgmyF8XJ0IF78kSE13uPt398lCCypm9oLjHtfygY51xzQa1cNm9mDGy_aWgJML9eG.gif?price=${AUCTION_PRICE}&currency=USD",
                }]
        }],
        "id": "6718617390701103366"
}

{
        "cur": "RUB",
        "bidid": "6718617390701103366",
        "seatbid": [{
                "bid": [{
                        "crid": "63310221",
                        "price": 20.9300,
                        "adomain": ["apple.com"],
                        "id": "5eeb7ed53ad66f5c",
                        "adid": "63310221",
                        "impid": "90ffa5fc6bc94831",
                        "burl": "https://rs.mail.ru/pixel/AACz8gE6m0InSRW2bep18Et9-e2E0ucVQXwBrJygvCe19MNd9SPS3M-dbmizNFk5sBczYlhCG9fO-Z8__4ForYl5ChchaR6Bu_H5ffebZygslLMw_1wOjuzPNRcB4Sgeo0-3I4EngEJ-I0n5MUFbzLjgJ29K29CXK-4duaUSjA5x841LjTIlfwXRAQAA1HlQ6Kb1pk8qPH4KvN2jDrff33sgG_H4zH6BdnhcBGqyYmPOTIVsxVPyM0YRQ2qZAAFRpmMl1N7hHASxnJ_adeWE-t7jlbSSQzUX4Ayr4IDQmVxa8ill2uPBKjlh0W4cGpIu0v5w6XzESAjTDHwUIC_5llvFnuJl1BL1iZrAO4xDmHBnF9QNjAvmbe8Eif55nNzapqF6DufQQqKx1N.gif?price=${AUCTION_PRICE}&currency=USD",
                        "lurl": "https://rs.mail.ru/pixel/AACz8gE6m0InSRW2bep18Et9-e2E0ucVQXwBrJygvCe19MNd9SPS3M-dbmizNFk5sBczYlhCG9fO-Z8__4ForYl5ChchaR6Bu_H5ffebZygslLMw_1wOjuzPNRcB4Sgeo0-3I4EngEJ-I0n5MUFbzXx1kBwhq0aooFkFCjaCi1o6bGVx8KCxol3HCYwRqjkNQISS_ft5PRZ7whf4ha6xDQNlIZdsvtUqVk2HVMlw7AvrNWOitomy0cpnKNYCl7J6IEClBmSh5Bhut8tmNL4NJ3Y1yYh-1trz5ki3y-GrjBH3P5RVhqzCUbCT.gif?price=${AUCTION_PRICE}&currency=USD&auction_loss=${AUCTION_LOSS}&bid_id=61fbb0fe7ad0f23f"
                }]
        }],
        "id": "6718617390701103366"
}

PreviousExample BidRequest and BidResponse NextOpenRTB v 2.3/2.5

Last updated 2 years ago

{ "id": "1", "imp": [{ "id": "1", "bidfloor": 0.01, "bidfloorcur": "USD", "tagid": "951617", "video": { "w": 640, "h": 360, "companionad": [{ "id": "1", "w": 240, "h": 400, "btype": [4], "pos": 4 }], "companiontype": 1, "minduration": 10, "maxduration": 30, "mimes": ["video/mp4"], "placement": "", "pos": 7, "protocols": [3,4], "skip": 0, "instl": 1, "ext": { "placementtype": "rewarded" } } }], "app": { "id": "97", "name": "Odnoklassniki", "bundle": "ru.ok.android", "storeurl": "https://play.google.com/store/apps/details?id=ru.ok.android", "ver": "16.6.3" }, "device": { "geo": { "lat": 55.796919, "lon": 37.537938, "type": 1, "accuracy": 15, "lastfix": 300 }, "lmt": 0, "ip": "185.6.244.185", "devicetype": 4, "make": "LGE", "model": "bullhead", "os": "Android", "osv": "6.0.1", "language": "ru", "carrier": "MegaFon", "connectiontype": 2, "ifa": "e8be10f0-f17f-485c-96fc-9220b5696ac" }, "user": { "id": "e8be10f0-f17f-485c-96fc-9220b5696ac", "yob": 1980, "gender": "F", "ext": { "buyeruid": "eJxVUU1vgzAM/TXNBYGcQCgccui0j8PU03ZH+TAsKiQohHbdr1/oVG272Jb1bL/3jKuTE4qDM8Fbk709vmZqtWPMeh+yz6YmfsYgow+dNYLVQKKd8Ms7FC/H9x17gHJXHgCypzUk5I49H/2i/YXIeT5jELxoC1owACCLOXWp1VkXBQdoASiRJnWiXawbuhikPm0FOqlGNIKS4H1MBWzbulG6QaAj92xmK6oq7bVTN3otSnrDCe2nYroWUYYBo8HJ8xvkr44E3aT45a6bGHSLjVfBij0nH4IxBv/IpSFsFFLoIe/pvs+rhuu8rfsUElbxuq2lLjcCm30beb9sBjRJPpBJurWXOq4h+eb9MOKvr3/9J9YtUTqN28FGVVw3qs7LkmJe8YbnSima77liFaDGveTkIig0ievP/O1JGlTV0r7kLTOGV0nb2WoUAzoMVnfpqd/DG6W6" } }, "cur": [ "USD" ], "ext": { "pid": 1000 } }

{ "id": "7729573d-a29e-40a3-bcc7-6cde5b08b151", "imp": [{ "id": "6de32339-8bdd-42e6-9d02-0edb8a42ec20", "bidfloor": 0.01, "bidfloorcur": "USD", "tagid": "951614", "native": { "request": "{\"plcmttype\":1,\"assets\":[{\"id\":1,\"title\":{\"len\":31}},{\"id\":2,\"img\":{\"wmin\":50,\"type\":1}},{\"id\":3,\"img\":{\"wmin\":150,\"type\":3}},{\"id\":4,\"data\":{\"type\":1}},{\"id\":5,\"data\":{\"type\":2}},{\"id\":6,\"data\":{\"type\":3}},{\"id\":7,\"data\":{\"type\":4}},{\"id\":8,\"data\":{\"type\":11}},{\"id\":9,\"data\":{\"type\":12}}]}", "ver": "1.0" } }], "app": { "id": "97", "name": "Odnoklassniki", "bundle": "ru.ok.android", "storeurl": "https://play.google.com/store/apps/details?id=ru.ok.android", "ver": "16.6.3" }, "device": { "geo": { "lat": 55.796919, "lon": 37.537938, "type": 1, "accuracy": 15, "lastfix": 300 }, "lmt": 0, "ip": "185.6.244.185", "devicetype": 4, "make": "LGE", "model": "bullhead", "os": "Android", "osv": "6.0.1", "language": "ru", "carrier": "MegaFon", "connectiontype": 2, "ifa": "e8be10f0-f17f-485c-96fc-9220b5696ac" }, "user": { "id": "e8be10f0-f17f-485c-96fc-9220b5696ac", "yob": 1980, "gender": "F", "ext": { "buyeruid": "eJxVUU1vgzAM/TXNBYGcQCgccui0j8PU03ZH+TAsKiQohHbdr1/oVG272Jb1bL/3jKuTE4qDM8Fbk709vmZqtWPMeh+yz6YmfsYgow+dNYLVQKKd8Ms7FC/H9x17gHJXHgCypzUk5I49H/2i/YXIeT5jELxoC1owACCLOXWp1VkXBQdoASiRJnWiXawbuhikPm0FOqlGNIKS4H1MBWzbulG6QaAj92xmK6oq7bVTN3otSnrDCe2nYroWUYYBo8HJ8xvkr44E3aT45a6bGHSLjVfBij0nH4IxBv/IpSFsFFLoIe/pvs+rhuu8rfsUElbxuq2lLjcCm30beb9sBjRJPpBJurWXOq4h+eb9MOKvr3/9J9YtUTqN28FGVVw3qs7LkmJe8YbnSima77liFaDGveTkIig0ievP/O1JGlTV0r7kLTOGV0nb2WoUAzoMVnfpqd/DG6W6" } }, "ext": { "pid": 1000 }, "cur": [ "USD" ] }

{ "id": "15cd8f22-c30a-45e4-8f82-dda9a5229c85", "imp": [{ "id": "5efb15fd-2750-4eee-b235-d530faf21d3b", "bidfloor": 0.01, "bidfloorcur": "USD", "tagid": "951611", "banner": { "pos": 7 }, "instl": 1 }], "app": { "id": "97", "name": "Odnoklassniki", "bundle": "ru.ok.android", "storeurl": "https://play.google.com/store/apps/details?id=ru.ok.android", "ver": "16.6.3" }, "device": { "geo": { "lat": 55.796919, "lon": 37.537938, "type": 1, "accuracy": 15, "lastfix": 300 }, "lmt": 0, "ip": "185.6.244.185", "devicetype": 4, "make": "LGE", "model": "bullhead", "os": "Android", "osv": "6.0.1", "language": "ru", "carrier": "MegaFon", "connectiontype": 2, "ifa": "e8be10f0-f17f-485c-96fc-9220b5696ac" }, "user": { "id": "e8be10f0-f17f-485c-96fc-9220b5696ac", "yob": 1980, "gender": "F", "ext": { "buyeruid": "eJxVUU1vgzAM/TXNBYGcQCgccui0j8PU03ZH+TAsKiQohHbdr1/oVG272Jb1bL/3jKuTE4qDM8Fbk709vmZqtWPMeh+yz6YmfsYgow+dNYLVQKKd8Ms7FC/H9x17gHJXHgCypzUk5I49H/2i/YXIeT5jELxoC1owACCLOXWp1VkXBQdoASiRJnWiXawbuhikPm0FOqlGNIKS4H1MBWzbulG6QaAj92xmK6oq7bVTN3otSnrDCe2nYroWUYYBo8HJ8xvkr44E3aT45a6bGHSLjVfBij0nH4IxBv/IpSFsFFLoIe/pvs+rhuu8rfsUElbxuq2lLjcCm30beb9sBjRJPpBJurWXOq4h+eb9MOKvr3/9J9YtUTqN28FGVVw3qs7LkmJe8YbnSima77liFaDGveTkIig0ievP/O1JGlTV0r7kLTOGV0nb2WoUAzoMVnfpqd/DG6W6" } }, "cur": [ "USD" ], "ext": { "pid": 1000 } }

hashtag BidRequests Examples

hashtagBidResponse Examples

BidRequests Examples

BidResponse Examples