Skip to content

§ 5.2, § 5.6.4 — DOOH: plays, impressions, and what a commitment commits (#92, #96) - #148

Open
KonstantinMirin wants to merge 105 commits into
IABTechLab:mainfrom
KonstantinMirin:op30-dooh
Open

KonstantinMirin wants to merge 105 commits into
IABTechLab:mainfrom
KonstantinMirin:op30-dooh

Conversation

@KonstantinMirin

@KonstantinMirin KonstantinMirin commented Nov 4, 2026 •

Copy link
Copy Markdown

What this changes

Draft 1 sells DOOH, but doesn't say what a screen, a play, or an impression is, or whose multiplier turns plays into impressions. This PR states each.

  • When channel is dooh, a property is a set of screens of one venue type (§ 5.2). It carries venue_type, allocation, min_screens, screens[], slots_per_loop, and sync_groups[].
  • frequency_cap.per becomes a VocabularyTerm with the core term screen (§ 5.5).
  • New § 5.6.4 defines a play and an impression. delivery_counting, REQUIRED on a dooh line item, holds the play tolerance, proof of performance, partial-play credit, and the multiplier. A line item that counts only plays needs no multiplier.
  • The committed quantity is in the committed entry's unit, so PLAY commits plays and CPM commits impressions.
  • The multiplier's source controls the count of impressions, and counted_by names that source. § 5.7.1 adds the count term impressions.
  • A loop_time share derives from the loop and requires allocation: all. A domination is guaranteed with sole exclusivity (§ 5.9).
  • Summaries carry venue_type and the multiplier's type and source (§ 2.1). New § 6.9 shows a DOOH line item.

Related issue

Closes #92. Closes #96.

Refs #79 and #134.

Builds on

This PR builds on our settlement PR and, through it, on:

Through them it carries #18 and #70 to #72 by @Sirajmx, #73 to #76 by @Kishore-2572, and #117 and #118 by @aleksUIX. Review "Define DOOH properties, plays, and what a commitment commits" and the two DOOH commits after it.

Type

  • Editorial — no normative effect
  • Normative — changes what the spec requires
  • Breaking — would break an implementation already built to this draft
  • Examples / schema / docs only

Checklist

  • The body section is updated — § 2.1, § 2.2, § 2.6, § 3.3, § 5.2, § 5.5, § 5.6, new § 5.6.4, § 5.7.1, § 5.9, and new § 6.9
  • Appendix A (field index) matches the body — one row, delivery_counting seller-set; scripts/check_appendix.py passes
  • Appendix B (fields by marker, and the counts) matches the body — seller-set 45 → 46; 95 → 96 fields
  • Any affected example in examples/ is updated and still parses — new line-item-dooh.yaml (§ 6.9): CPM on looped screens, with a vendor multiplier and no count that repeats commitment. manifest.json doesn't change, because the example isn't public. scripts/check_examples.py reads the new paths, checks counted_by against the multiplier's source, and passes. scripts/check_pricing_fixtures.py passes 60 of 60
  • RFC 2119 keywords used deliberately — MUST / SHOULD / MAY are not synonyms
  • The no-inheritance rule (§ 2) still holds — delivery_counting sits on the line item, and the DOOH keys on each property option
  • Anything selectable declares available[] and included[]; anything settable declares bounds (§ 3.1, § 3.2) — no new selectable or settable fields; frequency_cap keeps its bounds
  • No confidential or commercially sensitive content

Knock-on effects

Open questions

  1. What does a delivered FLAT day count on dooh: plays, or impressions? Does a FLAT entry on seller_allocated need an impression_multiplier?
  2. [Change] § 5.6, § 5.7 — DOOH: define a play, and whose multiplier turns plays into impressions #92 questions 1, 3, 4, and 5, and [Change] § 5.2, § 5.5 — DOOH properties: venue type, screens, operating hours, and loop #96 questions 1 and 3 to 9, stay open.

By opening this pull request I agree my contribution may be published under this
repository's licence, as set out in CONTRIBUTING.md.

Analyzed and generated with the help of Claude, fully reviewed by me.

Sirajmx and others added 30 commits October 6, 2026 16:28
§ 5.6 defines floor as the seller's offer floor at proposal time, not
the downstream auction floor and not a guarantee that bids will clear.
Editorial: the meaning of the field is unchanged.

Refs IABTechLab#16
A proposal can say its line items must be bought together
(linked_execution, § 4.1), and a line item can name the line items or
spend that must be in the same commitment (requires, § 5.6.3). A bonus
line is a line item with requires and its own price. The § 2 "binding
terms" hook now points at a field, and the Summary Representation
carries has_requires and linked_execution.

Adds a CTV bonus line example (§ 6.5) and linked_execution: none to the
proposal example.

Refs IABTechLab#23
The seller declares which exclusion types it accepts and how it
enforces each (exclusions_accepted); the buyer supplies its lists
(exclusions). Blocked apps carry their store, { platform, bundle },
so one store id is never applied across stores. Exclusions are
recompute inputs (§ 3.3) and are never disclosed to other parties
(§ 5.8). The display example declares and supplies lists.

Refs IABTechLab#25
A line item whose rate differs by market can declare geo with the
selectable structure of § 3.1: available[], included[], pricing deltas
and max_select. A geo that declares only allowed[] stays settable, so
existing payloads are unchanged. When several priced markets are
selected, the highest delta applies. The audio example is priced by
market.

Refs IABTechLab#14
A commitment names the proposal and version it was priced against
(§ 5.6.1). The seller rejects a new attempt on a stale version, or past
valid_until or price_valid_until, and returns the current version. An
authenticated replay with the same idempotency_key and terms returns the
stored result without re-running those checks; the same key with
different terms is a conflict. Keys are opaque and scoped to one buyer
and seller pair. § 4.1 states that each revision while published
increments version.

The display, CTV and audio examples carry proposal_id and version.

Refs IABTechLab#24
§ 4.1 adds an optional, immutable proposal_template_id linking an
issued proposal to the seller's template. Each issued proposal has its
own status, version and negotiation_history[], and buyers never need
the template id to transact. § 7 adds a non-normative note separating
seller-side templates from the issued proposals buyers commit against.

Appendix A gains one row; Appendix B counts immutable 6 → 7 and
72 fields. The proposal example carries a proposal_template_id.

Refs IABTechLab#26
§ 5.8 adds terms_ref ({ url, sha256, version }), REQUIRED when
terms_acceptance_required is true, hash-pinned and frozen at agreed, so
assent binds to an exact document. § 5.10 adds agreement_ref, an
informative pointer to the master or annual agreement a line item is
priced under, and documents the io and agreement roles on
external_references[]. IO generation is stated to be a connector
concern, and § 7 adds a non-normative note on relationships.

agreement_ref is seller-set; a buyer-held agreement id travels as an
external_references[] entry with role: agreement, so the field keeps
one marker (§ 3).

Appendix A gains two rows; Appendix B counts seller-set 29 → 31 and
73 fields. The display example carries terms_ref.

Refs IABTechLab#27
A new § 2.3 lets a seller publish its public standard line items at
/.well-known/openproposal.json: seller_id, generated_at, spec_version
and, per proposal, proposal_id, version, the Summary Representation of
each line item and a full_url. ETag / Last-Modified are required, only
line items with visibility public appear, and entries must match the
current version. Buyers discover from the manifest, then fetch the Full
Representation of shortlisted line items.

Adds examples/manifest.json (§ 6.5) and visibility: public to the CTV
and audio examples; the registry_gated display line item is not listed.

Refs IABTechLab#29
The specification does not define authentication yet (WS1; see IABTechLab#62),
so the replay rule now applies to a replay from the same buyer rather
than an authenticated replay.

Refs IABTechLab#24
agreement_ref.parties used buyer_id, which the specification does not
define. parties[] now names the seller by its seller_id and the buyer
by the id it holds in eligible_bidders[] (section 5.8).

Refs IABTechLab#27
The rule that a hold on a linked_execution: all proposal uses
hold_scope: proposal came from a comment on IABTechLab#23, not the change request
as filed. It moves to the PR description as a point for the working
group, so this PR carries only the filed change.

Refs IABTechLab#23
IABTechLab#25 names the content-category list iab_content_category[], a list of
IAB Content Taxonomy ids. The earlier commit renamed it content_category
with a version-pinned taxonomy_ref, which nobody proposed. This restores
the filed name and shape; which taxonomy version to reference is left
to the working group.

Refs IABTechLab#25
IABTechLab#14 doesn't say how deltas combine when a buyer selects more than one
priced market, and neither did any comment on it. The earlier commit
said the highest delta applies; that is a design choice nobody
proposed, so it moves to the PR description as a question.

Refs IABTechLab#14
Read the media condition from the ad served when an impression accepts
several media, name the seller as the party that serves, place linear TV
outside the table, and state environments as (distribution channel,
device type) pairs. Insert environments.available[] into the summary
list without rewrapping it, shorten the changelog entry and drop
audio_streaming from OQ-7 in docs/open-questions.md.

Refs IABTechLab#90
time_zone is the line item's clock for daypart windows and
frequency_cap.period: an IANA time zone name or viewer_local. A window
is { days[], start, end } in civil time with an exclusive end later
than start, up to 24:00; a window that crosses midnight is two windows.
List the `days[]` values once in the `daypart` row, as `monday` | ... |
`sunday`. Write HH:MM, America/New_York, and UTC as plain text, since
they're a format and examples, not field names. The meaning is
unchanged.
"At least one of" an empty list is never satisfied, so the bonus line
would fail a literal check. An absent key sets no condition. Only the
examples change; the any_of[] row and the rules stay as filed in IABTechLab#23.

Refs IABTechLab#23
The floor row now says it "neither constrains nor describes the
downstream auction floor", as IABTechLab#16 asked, and names that floor: the
per-impression floor the exchange applies at auction time (OpenRTB 2.6
Imp.bidfloor).

Refs IABTechLab#16
From the Postindustria review on IABTechLab#73:
- a replay matches on the same body, every value the buyer sent except
  idempotency_key, and returns the stored result whether an acceptance
  or a rejection; a retry against a new version uses a new key;
- version increments on each revision of the proposal, not only while
  published, so a counter under review also moves it;
- "deterministic" now says what the checks depend on: the stored
  proposal and the time the seller receives the attempt;
- the price check names the pricing[] entry the commitment is priced
  against.

Refs IABTechLab#24
# Conflicts:
#	spec/openproposal-3.0.md
# Conflicts:
#	spec/openproposal-3.0.md
The decline rule no longer counts a line item whose preemption names
exclusivity, so the sale that preempts it can go through. Preempted
delivery is a shortfall. The reason holds where and when the line item
delivers, notice becomes notice_duration as on the cancellation option,
and paid_zone names the part of a venue past its paid entry.

Refs IABTechLab#146
A seller MUST keep a rejection whose retry is not same until
offer_window.end, or as long as it keeps a proposal with no end. Any
commit that wrote an entry stays findable by its key, and a replay the
seller no longer remembers runs the checks as a new commit with that key.

Refs IABTechLab#128
…ntract

No IAB Tech Lab document defines the AAMP wire and lifecycle contract
yet. The pre-release iab-agentic-primitives library's OpenAPI file and
JSON Schemas define the messages the reference agents exchange, so an
implementer can use them as the binding until the contract is published.

Refs IABTechLab#59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

4 participants