You are here: Demand Partners > Real-time bidding > Bid notifications > Loss notifications via LURL

Loss notifications via LURL

Last updated on July 14, 2017

OpenX supports sending real-time loss notifications to demand partners via the lurl implementation introduced in OpenRTB 2.5. To enable this feature or receive more information, please contact your Platform Development Manager.

lurl field in Bid object

The lurl is the loss notice URL that is called by OpenX when a bid is known to have lost the auction. This value can be submitted by the demand partnerA company which purchases ad inventory on OpenX Ad Exchange. as a field in the bid object of a bid responseAfter evaluating a bid request, a real-time bidder’s communication to OpenX Ad Exchange, indicating if they’re interested in the impression, and if so, how much they’re willing to pay for it..

The OpenRTB substitution macroFor OpenX, a command enclosed in curly braces {} that dynamically inserts attributes into your HTML or third-party ad creatives and click-through URLs when OpenX serves an ad. Other macros, like from your video player, may have alternate formatting. ${AUCTION_LOSS} may be included. For example, if the lurl was:

http://example.com/?id=${AUCTION_ID}&bid=920314&loss=${AUCTION_LOSS}

then the expansion might be:

http://example.com/?id=81a05ff8-a85e-44f2-b601-2fd537d0c39e&bid=920314&loss=102

where the code 102 means "Lost to Higher Bid" per the Loss Reason Codes table.

Note: The lurl submitted by a demand partner must be 500 characters or less. Submitted lurl values that exceed this limit with automatically be discarded.

Loss reason codes

The following table lists the codes and corresponding reasons for OpenX to inform a demand partner why they did not win an impressionA single display of an ad on a web page, mobile app, or other delivery medium. For deals, impression is a metric to relay the total number of ads that have served. See also billable impression, forecasted impressions. for a submitted bid.

Note: The following is subject to regular updates. We strongly recommend regularly checking this table for new OpenX-specific loss codes/reasons (≥ 1000).

 

Code Reason
1 Internal Error
2 Impression Opportunity Expired

3

Invalid Bid Response

4

Invalid Deal ID

5

Invalid Auction ID

6

Invalid (i.e., malformed) AdvertiserIn OpenX, an account type that represents a business that runs advertising campaigns to display ads on websites. Domain

7

Missing Markup

8

Missing CreativeThe media asset associated with an ad, such as an image or video file. ID

9

Missing Bid Price

10

Missing Minimum Creative Approval Data

100

Bid was Below Auction FloorThe minimum price a publisher is willing to accept for a given impression.

101

Bid was Below Deal Floor

102

Lost to Higher Bid

103

Lost to a Bid for a PMPPrivate marketplace, the packaging, offering, and selling of high quality inventory to a limited set of buyers. Deal

104

BuyerA company that pays a demand partner to purchase ad inventory on OpenX Ad Exchange. Seat Blocked

200

Creative Filtered - General; reason unknown

201

Creative Filtered - Pending processing by Exchange

202

Creative Filtered - Disapproved by Exchange

203

Creative Filtered - Size Not Allowed

204

Creative Filtered - Incorrect Creative Format

205

Creative Filtered - Advertiser Exclusions

206

Creative Filtered – App Bundle Exclusions

207

Creative Filtered – Not Secure

208

Creative Filtered - Language Exclusions

209

Creative Filtered - Category Exclusions

210

Creative Filtered - Creative Attribute Exclusions

211

Creative Filtered - Ad Type Exclusions

212

Creative Filtered - Animation Too Long

213

Creative Filtered - Not Allowed in PMP Deal

1001

Multi-Bid - Bid Not Selected

1010

Creative Filtered - Malware

 

Feedback form