Loss Notifications
If a lurl is provided in the bid response, Chartboost will send win/loss/error notifications via server-side HTTP GET requests. Standard OpenRTB 2.5 macro replacement is supported here. A list of the supported macros as well as our reason code mapping table can be found below.
Note: This url is used for losses as well as wins & errors, even if nurl is also provided.
Supported lurl macros:
${AUCTION_ID}${AUCTION_BID_ID}${AUCTION_IMP_ID}${AUCTION_SEAT_ID}${AUCTION_AD_ID}${AUCTION_PRICE}${AUCTION_CURRENCY}${AUCTION_LOSS}${MIN_BID_TO_WIN}
Note:
${MIN_BID_TO_WIN} will be populated with the winning bid price only if your valid bid does not win the auction (i.e. only when ${AUCTION_LOSS}=102). ${AUCTION_PRICE} will be populated with the winning bid price only when your bid wins the auction (i.e. only when ${AUCTION_LOSS}=0). If you plan to use the ${MIN_BID_TO_WIN} macro, please reach out to us so we can enable it for you.
| Code | ${AUCTION_LOSS} code definition |
|---|---|
| 0 | Bid Won |
| 3 | Invalid Bid Response |
| 4 | Invalid Deal ID |
| 5 | Bid response’s impid doesn’t match auction id |
| 6 | Invalid Advertiser Domain |
| 100 | Bid was Below Auction Floor |
| 102 | Lost to Higher Bid |
| 103 | Lost to a Bid for a PMP Deal |
| 202 | Creative Filtered - Disapproved by Exchange |
| 204 | Creative Filtered - Incorrect Creative Format |
| 205 | Creative Filtered - Advertiser Exclusions |
| 206 | Creative Filtered – App Bundle Exclusions |
| 209 | Creative Filtered - Category Exclusions |
| 211 | Blocked due to a bid response missing bid.ext.crtype:"MRAID playable” for a Rewarded placement and non-VAST response |
| 214 | Invalid SKAdNetwork |
| 502 | Bid won the auction but the ad failed to load |
| 1000 | Blocked due to creative id (crid) being blocked globally on Chartboost side |
| 1001 | Timeout. Bid request was not received in time for the auction. *Partial as we can only wait a brief time for a response after the auction timeout |
| 1002 | burl or ext.imptrackers contains non-URL-encoded ' character |
| 1003 | burl or ext.imptrackers URL that exceeds 12K characters |