AdCOM 1.0 JSON Schema Unofficial

Decision records ·

D-018 Some definitions start with a name, in bold, as "loaded: Delivered as …", or in plain text with a colon. What is the code's label?

Gap Cited on main and at the tag AdCOM1.0-202607.

What the schemas do

The whole row: the name, where a column gives it, and the definition, as written.

Options

  • whole-definition Chosen

    The whole row: the name, where a column gives it, and the definition, as written.

  • name-only

    The leading name alone, such as loaded or Pause.

Why

Most lists have no name column, and a definition's leading name is written two ways: in bold, or in plain text with a colon. Cutting the label at a colon would mangle the definitions that only use one in a sentence. Keeping the whole row is faithful and needs no reading; Feed Types and ID Match Methods, which do have a name column, keep it first.

What we ask the specification to state

Give every list a short name column, as Feed Types and ID Match Methods have, so that each code has a name an implementation can use as a constant, beside its definition.

The specification lines it rests on

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

main

  • List: Event Types, the row of 1 L3629 at 26c59ba
    1 | loaded: Delivered as a part of the creative markup. Creative may be pre-cached or pre-loaded; prior to initial rendering.
  • List: Plcmt Subtypes - Video, the row of 5 L4227 at 26c59ba
    5 | Pause: An ad present in streaming video content that the consumer has requested. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view.
  • List: Feed Types, the row of 1 L3702 at 26c59ba
    1 | AOD | Music streaming service
  • List: ID Match Methods, the row of 1 L3759 at 26c59ba
    1 | No Match | No matching has occurred. The associated ID came directly from a 3rd-party cookie or OS-provided resettable device ID for advertising (IFA).

Tag AdCOM1.0-202607

  • List: Event Types, the row of 1 L3629 at d67a6a8
    1 | loaded: Delivered as a part of the creative markup. Creative may be pre-cached or pre-loaded; prior to initial rendering.
  • List: Plcmt Subtypes - Video, the row of 5 L4227 at d67a6a8
    5 | Pause: An ad present in streaming video content that the consumer has requested. While there may be other content surrounding the player, the video content must be the focus of the user’s visit. It should remain the primary content on the page and the only video player in-view.
  • List: Feed Types, the row of 1 L3702 at d67a6a8
    1 | AOD | Music streaming service
  • List: ID Match Methods, the row of 1 L3759 at d67a6a8
    1 | No Match | No matching has occurred. The associated ID came directly from a 3rd-party cookie or OS-provided resettable device ID for advertising (IFA).

The record's YAML file