The following table lists the options for Vistar to inform a bidder as to why they did not win an impression. In addition to the Open RTB specification version 2.5 loss reasons, Vistar's loss reasons list also includes those commonly seen in the Vistar exchange ecosystem.
Loss reason codes, descriptions, and their definitions are provided below:
| Code | Description | Notes |
|
0 |
Bid Won | Bid won the auction. |
|
1 |
Internal Error | An error on Vistar's end prevented the ad from serving. |
|
3 |
Invalid Bid Response | Bid response doesn't match bid request buy type. |
|
4 |
Invalid Deal ID | The deal ID in the bid isn't in the request. |
|
6 |
Invalid (i.e. malformed) Advertiser Domain | No adomain passed. |
|
7 |
Missing Markup | No creative found. |
|
8 |
Missing Creative ID | No crid passed. |
|
9 |
Missing Bid Price | No bid price passed. |
|
100 |
Bid Below Auction Floor | The bid was below the open exchange auction price floor. |
|
101 |
Bid Below Deal Floor | The bid was below the price floor for the PMP. |
|
102 |
Lost to Higher Bid | The bid lost to a higher-priced bid CPM. |
|
103 |
Lost to a Bid for a PMP Deal | Lost to a buyer bidding on a deal. |
|
104 |
Buyer Seat Blocked | The buyer seat isn't eligible for the bid request. |
|
202 |
Creative Filtered - Disapproved by Exchange | Creative is either denied or not yet approved. |
|
204 |
Creative Filtered - Incorrect Creative Format | The requesting venue doesn't allow the creative format contained in the bid. |
|
205 |
Creative Filtered - Advertiser Exclusions | The requesting venue doesn't allow the advertiser contained in the bid. |
|
209 |
Creative Filtered - Category Exclusions | The requesting venue doesn't allow the category contained in the bid. |
|
210 |
Creative Filtered - Creative Attribute Exclusions | The requesting venue has a block against the creative contained in the bid. |
| Code | Description | Notes |
|
1000 |
Invalid Bid Type |
The bid is for open exchange when open exchange isn't supported. |
|
1001 |
Missing Campaign ID |
The bid response is missing the campaign ID. |
|
1002 |
Missing Burl |
The bid response is missing the billing URL. |
|
1003 |
Lost to a Direct Bid |
The bid lost to a direct campaign at a higher priority level. |
|
1004 |
Lost to an Exchange Bid |
The bid lost to an exchange campaign at a higher priority level. |
|
1005 |
Lost due to Weighted Auction |
The highest bid doesn't always win for open exchange auctions. |
|
1006 |
Invalid Auction - Multiple Bids Won |
Vistar doesn't support multiple bids with the group set to true. |
|
1009 |
Lost to a Guaranteed Bid |
The bid lost to a programmatic guaranteed campaign. |
|
1010 |
No Expected Guaranteed Bids Returned |
The targeted bidder didn't return a programmatic guaranteed bid. |
|
1011 |
Unknown Bidder for a Guaranteed Bid |
Can't identify the bidder making the programmatic guaranteed bid. |
|
1100 |
Creative Filtered - New Creative Asset |
Vistar system sees a new creative and is processing the information. When this process is complete, the media owner will be able to see the creative for approval. |
|
1101 |
Creative Filtered - Audio Not Allowed |
The bid required audio to play and the requesting screen doesn't support audio. |
|
1102 |
Creative Filtered - Assets don't Match Targeting |
The creative size, duration, or mime type in the bid doesn't match the request. |
|
1103 |
Creative Filtered - ID Excluded |
The creative ID is blocked. |
|
1104 |
Not IAB Category |
The creative category isn't a valid IAB category. |
|
1200 |
VAST Error - Error Unmarshaling VAST XML Bytes |
The VAST doc is incorrectly formatted. |
|
1201 |
VAST Error - VAST XML has No Ad |
The VAST doc doesn't contain an ad. |
|
1202 |
VAST Error - VAST XML Has Multiple Ads |
The VAST doc has multiple ads when only one is supported. |
|
1203 |
VAST Error - No InLine Ad Found |
The full VAST doc passed via adm doesn't contain a video file. |
|
1204 |
VAST Error - Duration and Media Files Missing |
Missing duration and media file. |
|
1205 |
VAST Error - More than 1 Redirect |
Vistar supports at most 1 redirect. |