IA DSP

The IA-dsp-staging Developer Hub

Welcome to the IA-dsp-staging developer hub. You'll find comprehensive guides and documentation to help you start working with IA-dsp-staging as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Bid Loss Notification

Benefits 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

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 Loss Notification


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.