Bid Loss Notification

Benefit to DSPs

Bid Loss Notifications provide granular, immediate feedback on a per impression basis, helping DSPs:

  • Receive auction transparency on pricing and blocks (bid below the floor, lost to a higher bidder, advertiser blocked, etc.)
  • Uncover technical issues that prevent successful bids (timeout, invalid adomain, etc.)
  • Understand the winning clear price of the auction in order to improve pricing strategies 

Requirements

  • Partner must be setup as an RTB enabled bidder on the Inneractive Exchange

Getting Started

Contact your dedicated Programmatic Demand Manager to enable this feature:

  1. DSP to pass the lurl in the bid response, which allows Fyber to fire a loss notification when applicable
  2. For notifications on timeouts, please provide a static URL endpoint to your Demand Manager
  3. To receive transparency on the winning clear price, add the ${AUCTION_PRICE} macro to your tracking pixel and Fyber will return the winning clear price in $USD

What's Not Supported?

We do not support error code 0 (win) for the lurl. For win notifications, please use the nurl parameter.

Loss Notifications Errors Table

Set out below are the codes and possible reasons for loss notification errors.

Code Reason
1 Internal Error
2 Impression Opportunity Expired
3 Invalid Bid Response
6 Invalid (i.e., malformed) Advertiser Domain
7 Missing Markup
9 Missing Bid Price
100 Bid was Below Auction Floor
101 Bid was Below Deal Floor
102 Lost to Higher Bid
103 Lost to a Bid for a PMP Deal
202 Creative Filtered - Disapproved by Exchange
205 Creative Filtered - Advertiser Exclusions
206 Creative Filtered - App Bundle Exclusions
207 Creative Filtered - Not Secure
209 Creative Filtered - Category Exclusions
210 Creative Filtered - Creative Attribute Exclusions
1010 Invalid or malformed Bundle. A valid bundle is considered to be either:
  • A valid Android package name
  • A valid App Store ID
 
Example
... 

      "id": "5194605187929577452",
      "impid": "1",
      "price": 2.522437,
      "adomain": ["example.com"],
      "attr": [6],"lurl":"http://dsp_sample/inneractiveid=5194605187929577452\u0026code=${AUCTION_LOSS}",
      "w": 320,
      "h": 480
    }]
  }]
}

Bid Statuses

Fyber's ad exchange uses RTB (real-time bidding) protocols to conduct an auction. Fyber Marketplace or our publishers, can filter out or reject certain bids for a variety of reasons.

Each bid response filtering mechanism is detailed below in the Bid Statuses section.

Note

Rejected bid responses appear as bid requests in Fyber's Buyer's Report.

Screen_Shot_2021-05-04_at_9.14.40.png

Set out in the table below are the descriptions for each bid status.

Bid Status Definition Corresponding Loss Notificatoin Status (LURL)
Adapter Failure This metric is relevant for FairBid only. Fyber's SDK failed to activate the adapter of the mediation network Not Applicable
Below the Floor Price An invalid bid response where the demand source bid below the floor price sent on the bid request 100
Blocked Advertiser App The bid response was rejected because the campaign's bundle corresponded to a blocked category by the publisher's app. 206
Blocked Advertiser Domain The bid response was rejected because the campaign's advertiser domain corresponded to a blocked category by the publisher's app. 205
Blocked Category The bid response was rejected because the campaign's IAB category corresponded to a blocked category by the publisher's app. 209
Blocked on Creative The bid response was manually blocked due to blacklisting of the creative ID due to creative issues or policy violations. Not Applicable
Capped This metric is only relevant to Traditional Mediated Networks buying FairBid mediated supply. The bid request was dropped when the frequency cap was reached. Not Applicable
Demand QPS Throttling A bid request that was never sent because it was blocked according to the DSP's set QPS (Queries Per Second) cap Not Applicable
Empty Advertiser Domain The bid response was rejected due to an empty advertiser domain 6
Failed Creative ID Blocked The bid response was automatically blocked by an algorithm that blocks creatives with consistently low survival rate. Not Applicable
Filtered Out for Optimization A bid request that was never sent because it was blocked automatically due to Fyber's internal supply optimization algorithm that blocks unmonetized traffic Not Applicable
HTTP Error The bid response failed due to a web server error. 3
Incompatible SKAD Versions The bid response was rejected because the SKAdNetwork version returned on BidResponse.seatbid.bid.ext.skadn.version was higher than the SKAdNetwork supported by the app and on the bid request 214
Invalid Advertiser Domain An invalid bid response where the demand source bid with an invalid advertiser domain. What's valid: All top-level domains in the form of either "google.com" or "google.co.uk" (country code appended) will be considered valid. What's invalid: Bundles in numeric iOS or standard Android format are considered invalid Any other string now in the top-level domain format We do not accept www.domain.com or https://domain.com ad an adomain We do not accept subdomains like subdomain.domain.com 6
Invalid or Malformed Bundle An invalid bid response where the demand source bid with an invalid bundle format 1010
Invalid Response The bid response failed because it was invalid. Common examples include, the JSON was invalid and the response was missing mandatory parameters. See our Demand Docs for a list of mandatory parameters. 3
Invalid SKAD Parameters An invalid bid response where the demand source returned one or more invalid parameters on the BidResponse.seatbid.bid.ext.skadn Please refer to the IAB specifications to further details here 214
Lost on Price A valid bid response where the demand source lost the auction because the price returned was lower than another bid in the auction. 102
No Bid The bid response returned an HTTP 204 "No Content" response signalling the bidder had no bid for the auction. Not Applicable
Timeout The bid response failed because it exceeded the timeout window (350ms for RTB Bidders). A best practice is for Demand Partners to pass a no bid instead of timing out. 2