OpenRTB BidResponse
Fields
Field | Type | Description |
---|---|---|
cf_latitude | Float; optional | Latitude of the incoming request, e.g. 30.27130 |
cf_longitude | Float; optional | Longitude of the incoming request, e.g. -97.74260 |
cf_colo | String; optional | The three-letter airport code (e.g. ATX, LUX) representing the colocation which processed the request |
cf_asn | Integer; optional | The Autonomous System Number (ASN) of the request, e.g. 395747 |
cf_country | String; optional | The two-letter country code of origin for the request. This is the same value as that provided in the CF-IPCountry header, e.g. "US" |
cf_city | String; optional | City of the incoming request, e.g. “Austin”. |
cf_continent | String; optional | Continent of the incoming request, e.g. “NA” |
cf_postal_code | String; optional | Postal code of the incoming request, e.g. “78701” |
cf_region | String; optional | If known, the ISO 3166-2 name for the first level region associated with the IP address of the incoming request, e.g. “Texas”. |
cf_region_code | String; optional | If known, the ISO 3166-2 code for the first level region associated with the IP address of the incoming request, e.g. “TX”. |
worker_cf_ray | String; required | The Cf-Ray of the worker that handled the request |
client_ip | String; required | The ip of the request |
timestamp | Integer; required | The timestamp of the request |
date | String; required | The date of the request in the format YYYY-MM-DD |
id | String; required | A unique identifier for this request, as indicated in the id field of the Bid Request Object. Note: This must be equal to the value received in the bid request. |
cur | String; optional | TBD |
bidid | String; required | The currency of the bid response. For more information, see List of currencies. |
seatbid_seat | String; required | Unique identifier for the agency (when multiple agencies or independent direct clients use a DSP). |
seatbid_group | Integer; optional | TBD |
seatbid_bid_adid | String; optional | TBD |
seatbid_bid_adomain | Array of Strings; required | The domain/landing page/brand to identify the advertiser; limited to 128 characters. |
seatbid_bid_adm | String; required | The actual ad markup: XHTML if responding to a Banner Object; VAST URL if responding to a Video Object. |
seatbid_bid_bundle | String; optional | The app name or bundle being advertised (e.g. com.foo.mygame ) if applicable; |
seatbid_bid_burl | String; required | The billing notice URL called by an exchange when a winning bid becomes billable based on publisher criteria (begin-to-render for web). Note: - It should contain the ${AUCTION_PRICE} notification macro and should be a part of a valid URL. - It may contain the ${AUCTION_PRICE} notification macro in both the burl and adm fields. However, only impressions tracked from burl are considered billable. |
seatbid_bid_cat | Array of Strings; optional | The IAB Category of the Advertiser. |
seatbid_bid_cid | String; optional | TBD |
seatbid_bid_crid | String; optional | TBD |
seatbid_bid_dealid | String; optional | A unique identifier to represent a deal. |
seatbid_bid_dsp_id | String; optional | Added by AIDEM after receiving the response. If sent it will be overwritten. |
seatbid_bid_h | Integer; required | Height of the creative in device-independent pixels. |
seatbid_bid_id | String; required | A unique identifier to represent this bid. |
seatbid_bid_impid | String; required | A unique identifier for this impression (indicated in the id field of the Impression Object); must be equal to the value received in the bid request. |
seatbid_bid_price | Float; required | The bid price represented as cost per thousand impressions (CPM). By default, bidding is in dollars represented as floating point numbers (for example, 2.71828 ). |
seatbid_bid_w | Integer; required | Width of the creative in device-independent pixels. |