AdCOM 1.0 JSON Schema Unofficial

Decision records ·

D-017 List: Category Taxonomies says taxonomies 1 and 2 are "Deprecated, and recommend NOT be used". Are they codes of the vocabulary, and does the schema warn on them?

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

What the schemas do

Core terms, each labeled with its deprecation; a payload that uses one is still valid, and a warning on the attributes that carry a taxonomy waits until AdCOM's objects are mapped.

Options

  • core-terms Chosen

    Core terms, each labeled with its deprecation; a payload that uses one is still valid, and a warning on the attributes that carry a taxonomy waits until AdCOM's objects are mapped.

  • warning-rule

    Core terms, plus a warning rule on any payload that uses 1 or 2.

  • drop

    Leave them out of the vocabulary.

Why

A deprecated code is still a code: old payloads carry it, and Content.cattax even defaults to 1. Leaving the codes out would reject those payloads. "Recommend NOT be used" reads as NOT RECOMMENDED, and a code alone can show it, so a warning is a fair reading; but the code is used through an attribute, cattax, whose default makes taxonomy 1 the value of an absent Content.cattax, so the warning belongs on those attributes, beside their defaults, which aren't mapped yet. Until then, each code's label carries the deprecation for every reader of the vocabulary.

What we ask the specification to state

Make Content.cattax default to the same taxonomy as Ad.cattax and Restrictions.cattax, which default to 2, or to a current one: today an absent cattax on Content means taxonomy 1, which this list recommends against.

The specification lines it rests on

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

main

  • List: Category Taxonomies, the row of 1 L2968 at 26c59ba
    1 | IAB Tech Lab Content Category Taxonomy 1.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
  • List: Category Taxonomies, the row of 2 L2972 at 26c59ba
    2 | IAB Tech Lab Content Category Taxonomy 2.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
  • Object: Content, the Content.cattax key row L2051 at 26c59ba
    cattax | The taxonomy in use. Refer to list List: Category Taxonomies in AdCOM 1.0 for values.
  • Object: Content, the Content.cat key row L2050 at 26c59ba
    cat | Array of IAB Tech Lab content categories that describe the content. The taxonomy to be used is defined by the cattax field. If no cattax field is supplied Content Category Taxonomy 1.0 is assumed.
  • Object: Ad, the Ad.cattax key row L258 at 26c59ba
    cattax | The taxonomy in use for the cat attribute. Refer to List: Category Taxonomies.
  • Object: Restrictions, the Restrictions.cattax key row L2779 at 26c59ba
    cattax | The taxonomy in use for the bcat attribute. Refer to List: Category Taxonomies.

Tag AdCOM1.0-202607

  • List: Category Taxonomies, the row of 1 L2968 at d67a6a8
    1 | IAB Tech Lab Content Category Taxonomy 1.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
  • List: Category Taxonomies, the row of 2 L2972 at d67a6a8
    2 | IAB Tech Lab Content Category Taxonomy 2.0: Deprecated, and recommend NOT be used since it does not have SCD flags.
  • Object: Content, the Content.cattax key row L2051 at d67a6a8
    cattax | The taxonomy in use. Refer to list List: Category Taxonomies in AdCOM 1.0 for values.
  • Object: Content, the Content.cat key row L2052 at d67a6a8
    cat | Array of IAB Tech Lab content categories that describe the content. The taxonomy to be used is defined by the cattax field. If no cattax field is supplied Content Category Taxonomy 1.0 is assumed.
  • Object: Ad, the Ad.cattax key row L258 at d67a6a8
    cattax | The taxonomy in use for the cat attribute. Refer to List: Category Taxonomies.
  • Object: Restrictions, the Restrictions.cattax key row L2779 at d67a6a8
    cattax | The taxonomy in use for the bcat attribute. Refer to List: Category Taxonomies.

The record's YAML file