Deals API 1.0 JSON Schema Unofficial

Decision records ·

D-005 What currency is cur in, when the text calls it the "Bid currency"?

Gap Cited on main and at the tag 1.0-202602.

What the schemas do

The currency of the deal's money, dealfloor and totalcost, which every buyer's bid on the deal is in.

Options

  • deal-money Chosen

    The currency of the deal's money, dealfloor and totalcost, which every buyer's bid on the deal is in.

  • bid-only

    The currency a bidder bids in, which says nothing of what dealfloor and totalcost are in.

Why

dealfloor and totalcost are sums of money and name no currency of their own, and cur is the one currency the terms carry, so it is theirs, as OpenRTB writes bidfloor with bidfloorcur. Read as the bid's alone, the deal's money would have no currency at all.

What we ask the specification to state

Say that cur is the currency of dealfloor and totalcost, not only of a bid, as OpenRTB's bidfloorcur is of bidfloor.

The specification lines it rests on

Each line is quoted as the record pins it. Expand an item to read the quote.

main

  • Object: Terms, the cur row L112 at 3028ddc
    cur | string; default "USD" | Bid currency using ISO-4217 alpha codes.
  • Object: Terms, the dealfloor row L111 at 3028ddc
    dealfloor | float | Minimum bid for impressions for this deal expressed in CPM. Unless pricetype is Fixed, this should be used as guidance to buyers. See Implementation Guidance for additional detail
  • Object: Terms, the totalcost row L116 at 3028ddc
    totalcost | float | The total cost over the specified start and end date of the deal. If the deal is guaranteed, this value should be provided. If the deal is not guaranteed this may be omitted. See Implementation Guidance for additional detail

Tag 1.0-202602

  • Object: Terms, the cur row L112 at 938a5d1
    cur | string; default "USD" | Bid currency using ISO-4217 alpha codes.
  • Object: Terms, the dealfloor row L111 at 938a5d1
    dealfloor | float | Minimum bid for impressions for this deal expressed in CPM. Unless pricetype is Fixed, this should be used as guidance to buyers. See Implementation Guidance for additional detail
  • Object: Terms, the totalcost row L116 at 938a5d1
    totalcost | float | The total cost over the specified start and end date of the deal. If the deal is guaranteed, this value should be provided. If the deal is not guaranteed this may be omitted. See Implementation Guidance for additional detail

What it shapes

main: Amount, CurrencyCode, Terms.cur, Terms.dealfloor, Terms.totalcost

Tag 1.0-202602: Amount, CurrencyCode, Terms.cur, Terms.dealfloor, Terms.totalcost

The record's YAML file