ListNonBillableWinningBidsResponse

  • The ListNonBillableWinningBids API response details why a buyer wasn't billed for winning bids, providing counts aggregated by reason.

  • Each NonBillableWinningBidStatusRow item includes the bid count, reason (status), and associated dimensions.

  • Reasons for not billing can include: ad not rendered, invalid impression, VAST error, or loss in mediation.

  • Statuses such as 'AD_NOT_RENDERED' or 'INVALID_IMPRESSION' clarify the specific cause for non-billing.

  • The response may be paginated, requiring the use of 'nextPageToken' for retrieving subsequent result pages.

Response message for listing all reasons for which a buyer was not billed for a winning bid.

JSON representation 
{
  "nonBillableWinningBidStatusRows": [
    {
      object (NonBillableWinningBidStatusRow)
    }
  ],
  "nextPageToken": string
}
Fields
nonBillableWinningBidStatusRows[]

object (NonBillableWinningBidStatusRow)

List of rows, with counts of bids not billed aggregated by reason.
nextPageToken

string

A token to retrieve the next page of results. Pass this value in the ListNonBillableWinningBidsRequest.pageToken field in the subsequent call to the nonBillableWinningBids.list method to retrieve the next page of results.

NonBillableWinningBidStatusRow

The number of winning bids with the specified dimension values for which the buyer was not billed, as described by the specified status.

JSON representation 
{
  "bidCount": {
    object (MetricValue)
  },
  "status": enum (Status),
  "rowDimensions": {
    object (RowDimensions)
  }
}
Fields
bidCount

object (MetricValue)

The number of bids with the specified status.
status

enum (Status)

The status specifying why the winning bids were not billed.
rowDimensions

object (RowDimensions)

The values of all dimensions associated with metric values in this row.

Status

Specifies the status of a winning bid for which the buyer was not billed.

Enums
STATUS_UNSPECIFIED A placeholder for an undefined status. This value will never be returned in responses.
AD_NOT_RENDERED The buyer was not billed because the ad was not rendered by the publisher.
INVALID_IMPRESSION The buyer was not billed because the impression won by the bid was determined to be invalid.
FATAL_VAST_ERROR A video impression was served but a fatal error was reported from the client during playback.
LOST_IN_MEDIATION The buyer was not billed because the ad was outplaced in the mediation waterfall.
OVERDELIVERED_IMPRESSION The buyer was not billed because the impression won by the bid exceeded a guaranteed deal delivery goal.