Skip to end of metadata
Go to start of metadata

Bid Response to SSPs

This describes the AppNexus integration of the OpenRTB 2.4 protocol.

AppNexus will send a Bid Response after it receives a Bid Request from an SSP. The Bid Response will include the bidder's bid (price) and chosen creative (creative_id). This creative will be served if the bid is ultimately accepted by the ad server. Multiple bids within the Bid Response are supported.

On This Page

Implementation

AppNexus currently supports the following fields in the bid response object:

Bid Response Object

Field

Type

Description

id

string

The seller's auction ID. This is the same as the ID of the bid request to which this is a response.

seatbid

array of objects

Used for identifying seatbid objects. See Seat Bid Object below.

bidid

string

A randomly-generated bid response ID to assist tracking.

cur

string

The bid currency using ISO-4217 alphabetic codes. If omitted, USD is assumed.

Seat Bid Object

By default, AppNexus will return a single seatbid object in the bid response. If you would like, AppNexus can return multiple seatbid objects (multiple bids). Please contact your account representative for more details.

AppNexus supports the following fields in the seatbid object:

We will not group bids by their seat ids. For example, if there are three bids from the same seat, we will send three seatbid objects. 

Field

Type

Description

bid

array of objects

seat

string

Either the seat_id passed in the bid request query string (if one was provided) or the AppNexus buyer member_id. 

Bid Object

Field

Type

Description

id

string

The unique ID for the bid object; this is chosen by AppNexus for tracking and debugging purposes.

impid

string

The ID of the impression object to which this bid applies. Will match the id field from the bid request's impression object.   

price

float

The bid price expressed in CPM.

Although this value is a float, OpenRTB strongly suggests using integer math for accounting to avoid rounding errors.

adid

string

The AppNexus creative ID, viewable via the API using the Creative Service. This ID references the actual ad to be served if the bid wins.

admstring

The rendered creative markup to be delivered. Native creatives are returned in this field as a JSON-encoded string. See Native Object below.

SSPs can opt to have markup delivered to the win notification (nurl) instead by specifying "markup_delivery": 1 in the bid request.

adomainarray of stringsA list of URLs associated with the brand of the creative in the bid.
iurlstringA preview URL for the creative in the bid.
cidstringThe AppNexus buyer's member ID.
cridstringThe AppNexus creative ID, viewable via the API using the Creative Service. This ID references the actual ad to be served if the bid wins.
catarray of stringsIAB content categories of the creative. Refer to section 5.1 of the IAB specification for a list of content categories.
attrarray of integersSet of attributes describing the creative. Refer to section 5.3 of the IAB specification for a list of attributes.
dealidstring

The seller's deal ID (AppNexus deal code) from the deal object in the Bid Request, if this bid relates to a deal.

If the deal does not have an AppNexus deal code then we will omit this field.

hintegerThe height of the creative, in pixels.
wintegerThe width of the creative, in pixels.
extobject

Used for identifying AppNexus-specific extensions to the OpenRTB bid response. See Extension Object below.

Native Object

AppNexus supports the following fields to define a native object to be included as a JSON-encoded string in the adm field of the bid object. Refer to Example Native Creative Bid Response for an example of formatting this string.

Field

Type

Description

ver

integer

assets

array of objects

(Required) List of the native ad's assets. See Asset Object below.
 

linkobject(Required) The default destination link for the native ad. Each individual asset can have its own link object, which applies if that asset is clicked. If an individual asset link does not have a link object, the parent link object is used. See Link Object below.
imptrackersarray of stringsArray of impression-tracking URLs expected to return a 1x1 image or HTTP 204 (No Content) response. This is typically passed only when using third-party trackers.
jstracker
string

Optional JavaScript impression tracker. This is a valid HTML, Javascript is already wrapped in <script> tags. It should be executed at impression time where it can be supported.

privacy
stringIf support was indicated in the request, URL of a page informing the user about the buyer’s targeting activity.

Asset Object

AppNexus supports the following fields to define one or more native asset objects to be included as a JSON-encoded string as part of the native object in the adm field of the bid object. Refer to Example Native Creative Bid Response for an example of formatting this string.

Field

Type

Description

id

integer

required

integer

Set to 1 if bidder requires asset to be displayed.
 

titleobjectThe title object, for title assets. See Title Object below.
imgobjectThe image object, for image assets. See Image Object below.
videoobjectThe video object, for video assets. Note that in-stream video ads are not part of native objects. Native ads may be contain a video as the creative itself. See Video Object below.
dataobjectThe data object, for data assets, such as ratings, prices, and so on. See Data Object below.
linkobjectThe link object for individual assets, which applies if that asset is clicked. If there is no link object for an asset, the parent link object is used. See Link Object below.

Title Object

Used to define a title asset in a native object.

Field

Type

Description

text

string

Image Object

Used to define a image asset in a native object. Used for all image elements of the native ad, such as icons, main image, and so on.

Field

Type

Description

url

string

winteger(Recommended) The width of the image, in pixels.
hinteger(Recommended) The height of the image, in pixels.

Data Object

Used to define a data asset in a native object. Used for all miscellaneous elements in a native ad, such as ratings, price, review count, downloads, and so on.

Field

Type

Description

label

string

valuestringThe formatted string of data to be displayed (such as "5 stars" or "$10").

Video Object

Used to define a video asset. Contains the value of a conforming VAST tag.

Field

Type

Description

vasttag

string

Link Object

Used to define the link for a native asset. When clicked, the user is taken to the location of the link. Can be defined for individual assets as well as for the parent native object, which is used as the default for assets when no unique asset link is defined.

Field

Type

Description

url

string

clicktrackersArray of stringsArray of third-party tracking URLs to be fired when the link is clicked.
fallbackstringA fallback URL to be used if the URL is not supported by the device.

Extension Object

AppNexus supports a single object in the ext object to support AppNexus-specific extensions:

Field

Type

Description

appnexus

object

Specifies the AppNexus-specific extensions to the OpenRTB bid response. See AppNexus Object below.

AppNexus Object

AppNexus supports the following fields in the appnexus extension object:

Field

Type

Description

brand_idintegerSpecifies the AppNexus brand ID.
auction_idintegerSpecifies the AppNexus auction ID.
bidder_idintegerSpecifies the AppNexus ID that corresponds to the winning bid's bidder (sometimes referred to as a DSP).
ranking_price
double

Specifies the pCPM bid value for GDLI bids.

This field is only enabled for specific clients. Please reach out to your account representative for this feature.

exclusive
boolean

Indicates whether the bid is exclusive depending on the priority.

  • If 0, then bid is not exclusive
  • If 1, then bid is exclusive

This field is only enabled for specific clients. Please reach out to your account representative for this feature.

bid_ad_type
int

Specifies the ad type of the winning bid. Possible values:

  • 0: banner
  • 1: video
  • 2: audio
  • 3: native

Examples

Banner Creative Bid Response
VAST Creative Bid Response
Native Creative Bid Response

 

 

  • No labels