Deals API 1.0 JSON Schema Unofficial

Decision records ·

D-008 Does pricetype default to 2, Second Price Plus, though 0, Dynamic, defers to the bid request's auction type?

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

What the schemas do

Yes: pricetype absent is 2, Second Price Plus, as the Type cell writes it.

Options

  • default-2 Chosen

    Yes: pricetype absent is 2, Second Price Plus, as the Type cell writes it.

  • default-0

    No: absent is 0, Dynamic, which leaves the auction type to the bid request's at.

Why

The Type cell states default 2, and nothing in the text contradicts it, so the schema keeps it. A deal that leaves pricetype out is a second-price deal, even where the bid request says first price; the feedback asks whether that is meant, since 0 would defer to the request. How each code meets a bid request's at is a bridge between the deal and the bid request, which the deal's own schema doesn't state: no sentence of the text is a rule a deal payload alone can be checked against, so the schema states none, and the bridge belongs to the map from deal to bid request.

What we ask the specification to state

Say whether the default 2, Second Price Plus, is meant. A deal that leaves pricetype out then overrides the bid request's auction type, which 0, Dynamic, would follow.

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 pricetype row L114 at 3028ddc
    pricetype | int, default 2 | Deal Price Type where: 0 = Dynamic (ie. auction type will be provided by request.at attribute in OpenRTB Bid Request) 1 = First Price 2 = Second Price Plus 3 = Fixed Price Exchange-specific auction types can be defined using values 500 and greater.

Tag 1.0-202602

  • Object: Terms, the pricetype row L114 at 938a5d1
    pricetype | int, default 2 | Deal Price Type where: 0 = Dynamic (ie. auction type will be provided by request.at attribute in OpenRTB Bid Request) 1 = First Price 2 = Second Price Plus 3 = Fixed Price Exchange-specific auction types can be defined using values 500 and greater.

What it shapes

main: Terms.pricetype

Tag 1.0-202602: Terms.pricetype

The record's YAML file