OpenRtbEcto.V3.BidResponse.Bid (OpenRtbEcto v0.1.3) View Source

A Seatbid object contains one or more Bid objects, each of which relates to a specific item in the bid request offer via the “item” attribute and constitutes an offer to buy that item for a given price.

Attribute         Type                     Definition
id string; recommended Bidder generated bid ID to assist with logging/tracking.
item string; required ID of the item object in the related bid request; specifically
price float; required Bid price expressed as CPM although the actual transaction is for a unit item only. Note that while the type indicates float, integer math is highly recommended when handling currencies (e.g., BigDecimal in Java).
deal string Reference to a deal from the bid request if this bid pertains to a private marketplace deal; specifically
cid string Campaign ID or other similar grouping of brand-related ads. Typically used to increase the efficiency of audit processes.
tactic string Tactic ID to enable buyers to label bids for reporting to the exchange the tactic through which their bid was submitted. The specific usage and meaning of the tactic ID should be communicated between buyer and exchanges a priori.
purl string Pending notice URL called by the exchange when a bid has been declared the winner within the scope of an OpenRTB compliant supply chain (i.e., there may still be non-compliant decisioning such as header bidding). Substitution macros may be included.
burl string; recommended Billing notice URL called by the exchange when a winning bid becomes billable based on exchange-specific business policy (e.g., markup rendered). Substitution macros may be included.
lurl string Loss notice URL called by the exchange when a bid is known to have been lost. Substitution macros may be included. Exchange-specific policy may preclude support for loss notices or the disclosure of winning clearing prices resulting in ${OPENRTB_PRICE} macros being removed (i.e., replaced with a zero-length string).
exp integer Advisory as to the number of seconds the buyer is willing to wait between auction and fulfilment.
mid string ID to enable media to be specified by reference if previously uploaded to the exchange rather than including it by value in the domain objects.
macro object array Array of Macro objects that enable bid specific values to be substituted into markup; especially useful for previously uploaded media referenced via the mid attribute. Refer to Object: Macro.
media object Layer-4 domain object structure that specifies the media to be presented if the bid is won conforming to the specification and version referenced in openrtb.domainspec and openrtb.domainver. For AdCOM v1.x, the objects allowed here are “Ad” and any objects subordinate thereto as specified by AdCOM.
ext object Optional demand source specific extensions.

Link to this section Summary

Link to this section Functions

Link to this function

changeset(bid, attrs \\ %{})

View Source