AdCOM 1.0 JSON Schema Unofficial

Decision records

Generating the schemas took 18 recorded decisions: 18 gaps, where the text leaves a point open, and no proposal: we propose no change to what the text settles. Our implementation feedback to the specification's owners will number them; until then they are listed by kind.

Points the text leaves open 18

Where the text leaves a point open, and a decision fills it.

  1. ·D-001Which sentences of AdCOM state a requirement, when the text adopts no RFC 2119 convention and writes its keywords in either case?Gap
  2. ·D-002What name does the vocabulary of each AdCOM list take, when a list has a title and an anchor but no name a schema or an SDK can use?Gap
  3. ·D-003What do AdCOM's objects become while the registry of its lists is generated first?Gap
  4. ·D-004What does List: Start Delay Modes accept, when its row >0 stands for every positive number of seconds rather than one code?Gap
  5. ·D-005What do the statements in AdCOM's list sections become, when they say what a code means or how a list is used?Gap
  6. ·D-006What do the JSON examples in AdCOM's Appendix C become?Gap
  7. ·D-007AdCOM says its lists "may be extended at any time" and that implementers "must accept" such changes within a version. Does a list's schema accept a code the list doesn't name yet?Gap
  8. ·D-008AdCOM says most lists "can also be extended to include vendor-specific codes typically starting at 500". Which lists take vendors' codes, and from which code?Gap
  9. ·D-009List: IP Location Services gives standard codes 511 and 512 to 51Degrees, inside the range other lists reserve for vendors. Are they core terms?Gap
  10. ·D-010List: Event Types numbers the events one apart from OpenRTB Native 1.2, which keeps impression at 1. Which numbering does the vocabulary take?Gap
  11. ·D-011List: Creative Subtypes - Audio/Video ends at VAST 4.3 Wrapper, 16, while VAST 4.4 is published. Is there a code for VAST 4.4?Gap
  12. ·D-012The init and lastmod timestamps are integer milliseconds since the epoch in AdCOM, and ISO 8601 strings in the protocol buffer definitions IAB Tech Lab hosts. Which does the schema follow?Gap
  13. ·D-013AdCOM types 0 or 1 flags as integers, and the protocol buffer definitions as booleans; eight attributes are a single value in one and an array in the other, in both directions, such as playmethod; and Banner.link is an object in AdCOM and a string there. Which does the schema follow?Gap
  14. ·D-014Four lists serve only OpenRTB 2.6, and Dooh.venue refers to List: DOOH Venue Types, whose table AdCOM removed. What does the registry hold for them?Gap
  15. ·D-015AdCOM removed the codes of the legacy List: Placement Subtypes - Video, which OpenRTB 2.6's deprecated placement and VAST's [PLACEMENTTYPE] macro still cite, and whose codes clash with List: Plcmt Subtypes - Video. What does the registry hold?Gap
  16. ·D-016"1.0" covers nearly eight years of changes, the tags are named three ways, and the last tag isn't main. Which revision of AdCOM does the registry rest on?Gap
  17. ·D-017List: 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
  18. ·D-018Some 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