bretg
commented
2 years ago Here'a a proposed design. If the ext.prebid.returnallbidstatus flag is true, then as part of the ORTB response generation
Loop through the imps in the original request after the raw auction stage (do we have a snapshot?)
Loop through each bidder in imp (imp[n].ext.prebid.bidder.*
// Find which **requests** were dropped before they even went out
Loop though the requests as sent to bid adapters (do we have a snapshot?)
If the request wasn't sent to the adapter, create an ext.seatnonbid entry with code 'reqrm' and, if possible, details.message with why it was dropped (e.g. "gdpr")
// Find which **responses** were dropped
Else PBS should have some kind of bidresponse object, so while creating the seatbid entries, also create seatnonbid entries for "nobid", "error" and "resprm" scenarios.
If no reason can be found for "error" or "resprm" types, ext.status.details.message should be "unknown"Here's the ext.prebid.seatnonbid entry
ext.prebid.seatnonbid: [{
seat: "bidderB"
nonbid: [{
impid is set to $.imp[].id
ext.status.code is set to "nobid", "error", "reqrm", "resprm"
ext.status.details[].code is set to a code // optional
ext.status.details[].message is set to a string version of the code // optional
}]
}]
SyntaxNode
pm-harshad-mane
ShriprasadM
Client-side analytics adapters don't have access to what actually happened with PBS bids unless they're successful.
The ORTB protocol was designed to carry just actual successful bids, not information about the status of all bid attempts. However, with the Prebid world being part client-side and part server-side, holisitic analytics is made more difficult. It's quite complicated to log auction info/results separately: some client-side, some server-side and then sew them all together at scale on the backend.
e.g. say a request contains calls to bidderA, bidderB, and bidderC. If only bidderA responds, then the resulting seatbid[].bid[] contains only bidderA. The client doesn't know what happened to bidderB or bidderC: no bid? error? GDPR removal? Price floor removal?
So we would like to propose a new optional request flag that instructs PBS to include the status of all bid attempts in the response.
Proposal
1) Support a new request flag ext.prebid.returnallbidstatus: true - this causes PBS to create special entries in the response for every imp+bidder in the request, even nobids and errors.
This is independent from the debug/test option.
2) When the flag is set and a bidder doesn't have a bid for any reason, create a 'non-bid' response just before "Stage 8 - Auction Response"
We considered just collating this data in seatbid.bid, but we can't be sure that that all clients will know what to do with the extra info: e.g. SDK, SSAI servers, etc. Sure, they shouldn't be passing ext.prebid.returnallbidstatus if they can't handle the response, but it seems safer to place the non-bids in a different location.
We also considered whether to put this extension in ext.prebid.seatnonbid but decided that reporting on the non-bids is not prebid-specific.
3) The bids list included should be the list of imps+bidders present just before Stage 3 - Processed Auction Request.
4) Some reasons a bidder might not have a bid response include:
Each of these scenarios should be considered test cases. It's not necessary for PBS-core to be able to immediately be able to distinguish these. If there are scenarios where there's not enough info currently available to detail why a bid request/response was removed, it can supply a reason of "unknown" for now.