Skip to content

§ 2.1, § 5.1, § 5.2 — Define channel and environments in AdCOM terms (#90) #119

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
KonstantinMirin wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

§ 2.1, § 5.1, § 5.2 — Define channel and environments in AdCOM terms (#90) #119

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
49ad2e2
Define channel and environments in AdCOM terms
KonstantinMirin Oct 25, 2026
0125d55
Clarify channel and environment matching rules
KonstantinMirin Oct 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/open-questions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -96,8 +96,8 @@ property).

**Issue:** [#8](https://github.com/IABTechLab/OpenProposal/issues/8) · **Spec:** § 5.2

The enum — `web_desktop`, `web_mobile`, `app_mobile`, `ctv`, `dooh`,
`audio_streaming` — is proposed, not derived from implementation experience.
The enum — `web_desktop`, `web_mobile`, `app_mobile`, `ctv`, `dooh`, each
defined in § 5.2.1 — is proposed, not derived from implementation experience.

**What would settle it:** sellers mapping their real inventory onto the enum and
reporting what does not fit.
Expand Down
3 changes: 2 additions & 1 deletion examples/line-item-audio.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@
line_item_id: "streaming-audio"
status: published
channel: audio
environments: { available: ["audio_streaming"], included: ["audio_streaming"] }
environments: { available: ["web_mobile", "app_mobile"],
included: ["web_mobile", "app_mobile"] }
formats: { available: ["audio/host-read-30s", "audio/produced-30s"],
included: ["audio/produced-30s"],
pricing: { "audio/host-read-30s": { delta_cpm: 9.00 } } }
Expand Down
6 changes: 6 additions & 0 deletions spec/CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ issue that caused it, so the comment record and the spec history line up.

## [Unreleased]

- § 2.1, § 5.1, § 5.2 — `channel` and `environments` defined in AdCOM 1.0
terms, with a first-match channel table, a skip rule for unknown channels
and a channel and environment consistency rule. `audio_streaming` removed;
the summary carries `environments.available[]`
([#90](https://github.com/IABTechLab/OpenProposal/issues/90)).

## [3.0-draft-1] — 2026-09-22

Initial draft published for public comment. Ported from the working-group
Expand Down
60 changes: 57 additions & 3 deletions spec/openproposal-3.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,8 @@ Every line item has two representations.
sellers' shelves. A catalog response MAY return it. It MUST contain, per line
item:

`line_item_id` · `channel` · `content_detail` · property names ·
`line_item_id` · `channel` · `environments.available[]` ·
`content_detail` · property names ·
`formats.included[]` · `pricing.cost_method` · `pricing.gross_rate` ·
`min_spend` · `addressable_scale` · `committed_metrics[]` ·
`transaction_mechanism`
Expand Down Expand Up @@ -216,15 +217,68 @@ channel.
| :--- | :--- | :--- | :--- |
| `line_item_id` | String | immutable | Identity within the proposal |
| `status` | Enum | derived | `draft` \| `published` \| `under_review` \| `agreed` \| `withdrawn` \| `sold_out` \| `expired`. Independent of the proposal's status, so one line item may sell out while the rest of the shelf stays live |
| `channel` | Enum | immutable | `display` \| `video` \| `audio` \| `ctv` \| `dooh` \| `native`. The discriminator for how the rest of the line item is read |
| `channel` | Enum | immutable | `display` \| `video` \| `audio` \| `ctv` \| `dooh` \| `native`, each defined in 5.1.1. The discriminator for how the rest of the line item is read |

#### 5.1.1 channel

An impression's channel is the first row of this table that the impression
matches. Conditions are stated in
[AdCOM 1.0](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/26c59ba1b235cd8d938c9877409e506f1b8d3f0c/AdCOM%20v1.0%20FINAL.md)
terms: the
[distribution channel](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/26c59ba1b235cd8d938c9877409e506f1b8d3f0c/AdCOM%20v1.0%20FINAL.md#abstract_distributionchannel),
the ad's media
([`Placement`](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/26c59ba1b235cd8d938c9877409e506f1b8d3f0c/AdCOM%20v1.0%20FINAL.md#object_placement)
subtypes) and the
[device type](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/26c59ba1b235cd8d938c9877409e506f1b8d3f0c/AdCOM%20v1.0%20FINAL.md#list_devicetypes).
Where an impression accepts more than one medium, its media is that of the ad
served.

| `channel` | Condition |
| :--- | :--- |
| `dooh` | Distribution channel `Dooh` |
| `audio` | Audio ad (`AudioPlacement`) |
| `ctv` | Device type Connected TV (3), Connected Device (6) or Set Top Box (7) |
| `native` | Native ad (`DisplayPlacement.nativefmt`), including native ads with video assets |
| `video` | Video ad (`VideoPlacement`) |
| `display` | Any other display ad (`DisplayPlacement`) |

Device types are values of AdCOM 1.0 List: Device Types, each written as its
name followed by its code.

- The seller MUST serve a line item only on impressions of its `channel`.
Placement type, such as interstitial or rewarded
([OpenRTB 2.6](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/1debba8001f40eb14597102dec3205afddf811d4/2.6.md#objectimp)
`video.plcmt`, `imp.instl` and `imp.rwdd`), does not change the channel.
- A consumer MUST skip a line item whose `channel` it does not recognise, and
MUST NOT reject the proposal because of it.
- Impressions in linear TV, including addressable linear, are outside this
table: they have no `channel` value in 3.0.

### 5.2 Inventory composition

| Field | Type | Mutability | Description |
| :--- | :--- | :--- | :--- |
| `properties` | Object | selectable | `available[]` of `{ id, name, domains, supported_formats }`, `included[]`, `pricing`, `max_select` |
| `content_detail` | Object | seller-set | Shows, series, sections, network verticals |
| `environments` | Object | selectable | `available[]` from `web_desktop` \| `web_mobile` \| `app_mobile` \| `ctv` \| `dooh` \| `audio_streaming` |
| `environments` | Object | selectable | `available[]` from `web_desktop` \| `web_mobile` \| `app_mobile` \| `ctv` \| `dooh`, each defined in 5.2.1 |

#### 5.2.1 environments

Each environment value is the set of (distribution channel, device type) pairs
formed from its row, in AdCOM 1.0 terms. An impression matches the value when
both its distribution channel and its device type are in the row. Device types
are as in 5.1.1.

| Value | Distribution channel | Device types |
| :--- | :--- | :--- |
| `web_desktop` | `Site` | Personal Computer (2) |
| `web_mobile` | `Site` | Mobile/Tablet - General (1), Phone (4), Tablet (5) |
| `app_mobile` | `App` | Mobile/Tablet - General (1), Phone (4), Tablet (5) |
| `ctv` | `Site` or `App` | Connected TV (3), Connected Device (6), Set Top Box (7) |
| `dooh` | `Dooh` | Any |

Each `environments.available[]` value MUST match at least one impression to
which 5.1.1 gives the line item's `channel`.

### 5.3 Audience reach

Expand Down