ListNonBillableWinningBidsResponse
Stay organized with collections
Save and categorize content based on your preferences.
Response message for listing all reasons for which a buyer was not billed for a winning bid.
NonBillableWinningBidStatusRow
The number of winning bids with the specified dimension values for which the buyer was not billed, as described by the specified status.
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. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eThe ListNonBillableWinningBids API response details why a buyer wasn't billed for winning bids, providing counts aggregated by reason.\u003c/p\u003e\n"],["\u003cp\u003eEach NonBillableWinningBidStatusRow item includes the bid count, reason (status), and associated dimensions.\u003c/p\u003e\n"],["\u003cp\u003eReasons for not billing can include: ad not rendered, invalid impression, VAST error, or loss in mediation.\u003c/p\u003e\n"],["\u003cp\u003eStatuses such as 'AD_NOT_RENDERED' or 'INVALID_IMPRESSION' clarify the specific cause for non-billing.\u003c/p\u003e\n"],["\u003cp\u003eThe response may be paginated, requiring the use of 'nextPageToken' for retrieving subsequent result pages.\u003c/p\u003e\n"]]],[],null,["# ListNonBillableWinningBidsResponse\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [NonBillableWinningBidStatusRow](#NonBillableWinningBidStatusRow)\n - [JSON representation](#NonBillableWinningBidStatusRow.SCHEMA_REPRESENTATION)\n- [Status](#Status)\n\nResponse message for listing all reasons for which a buyer was not billed for a winning bid.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"nonBillableWinningBidStatusRows\": [ { object (/authorized-buyers/apis/reference/rest/v2beta1/ListNonBillableWinningBidsResponse#NonBillableWinningBidStatusRow) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `nonBillableWinningBidStatusRows[]` | `object (`[NonBillableWinningBidStatusRow](/authorized-buyers/apis/reference/rest/v2beta1/ListNonBillableWinningBidsResponse#NonBillableWinningBidStatusRow)`)` List of rows, with counts of bids not billed aggregated by reason. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [ListNonBillableWinningBidsRequest.pageToken](/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets.nonBillableWinningBids/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to the [nonBillableWinningBids.list](/authorized-buyers/apis/reference/rest/v2beta1/bidders.accounts.filterSets.nonBillableWinningBids/list#google.ads.adexchange.buyer.v2beta1.RtbTroubleshooting.ListNonBillableWinningBids) method to retrieve the next page of results. |\n\nNonBillableWinningBidStatusRow\n------------------------------\n\nThe number of winning bids with the specified dimension values for which the buyer was not billed, as described by the specified status.\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"bidCount\": { object (/authorized-buyers/apis/reference/rest/v2beta1/MetricValue) }, \"status\": enum (/authorized-buyers/apis/reference/rest/v2beta1/ListNonBillableWinningBidsResponse#Status), \"rowDimensions\": { object (/authorized-buyers/apis/reference/rest/v2beta1/RowDimensions) } } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `bidCount` | `object (`[MetricValue](/authorized-buyers/apis/reference/rest/v2beta1/MetricValue)`)` The number of bids with the specified status. |\n| `status` | `enum (`[Status](/authorized-buyers/apis/reference/rest/v2beta1/ListNonBillableWinningBidsResponse#Status)`)` The status specifying why the winning bids were not billed. |\n| `rowDimensions` | `object (`[RowDimensions](/authorized-buyers/apis/reference/rest/v2beta1/RowDimensions)`)` The values of all dimensions associated with metric values in this row. |\n\nStatus\n------\n\nSpecifies the status of a winning bid for which the buyer was not billed.\n\n| Enums ||\n|----------------------------|----------------------------------------------------------------------------------------------------------|\n| `STATUS_UNSPECIFIED` | A placeholder for an undefined status. This value will never be returned in responses. |\n| `AD_NOT_RENDERED` | The buyer was not billed because the ad was not rendered by the publisher. |\n| `INVALID_IMPRESSION` | The buyer was not billed because the impression won by the bid was determined to be invalid. |\n| `FATAL_VAST_ERROR` | A video impression was served but a fatal error was reported from the client during playback. |\n| `LOST_IN_MEDIATION` | The buyer was not billed because the ad was outplaced in the mediation waterfall. |\n| `OVERDELIVERED_IMPRESSION` | The buyer was not billed because the impression won by the bid exceeded a guaranteed deal delivery goal. |"]]