Send a probe bid request to an ad source
Sends one real OpenRTB BidRequest to the ad source and returns its raw response.
A 4xx/5xx from the ad source is returned as a 200 with status_code set: the vendor
rejecting the request is the probe result, not a failure of this endpoint.
Authorizations
Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.
Body
POST /allocations/bid-request-probes request body.
Ad source to send the test bid request to
Allocation ext under test
Environment to test — web or app
web, app Device platform to test. It picks the User-Agent and device.os sent to the vendor in both environments, and for app it also picks which bundle (ios_bundle or android_bundle) is sent.
ios, android Target ID
Target type — only ad_unit is supported
ad_unit, placement Response
Successful Response
The bid request sent to the ad source and the resulting response.
Ad-source HTTP 4xx and 5xx responses are returned as probe results with HTTP 200; the ad source's status is available in status_code.
BidRequest body that was sent
Round-trip time in milliseconds, including DNS, TCP and TLS setup. Not comparable to the edge server's read timeout, which is applied to the read stage alone over a pooled connection.
Raw response body from the ad source, capped at 16000 bytes while reading — a body longer than that is cut off mid-download
Transport-level failure as ExceptionClass: message — the class name separates a connect timeout from a read timeout, which share the same message
HTTP status returned by the ad source — null if unreachable
