Skip to content

§ 5.5 — Selectable geo with per-market price deltas (#14) #72

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
Sirajmx wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

§ 5.5 — Selectable geo with per-market price deltas (#14) #72

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
684c865
Let geo be selectable with per-market price deltas
Sirajmx Oct 22, 2026
208f0c2
Leave combining several market deltas to the working group
Sirajmx Oct 23, 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
6 changes: 6 additions & 0 deletions examples/line-item-audio.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,12 @@ production:
included: ["buyer_supplied"]
pricing: { seller_built: { delta_flat: 12000.00 } }

geo: # priced by market (§ 5.5)
available: ["USA", "CAN", "GBR"]
included: ["USA"]
pricing: { "CAN": { delta_cpm: 1.50 }, "GBR": { delta_cpm: 3.00 } }
max_select: 3

frequency_cap: { max: { min: 1, max: 6 }, period: "day", basis: listener }

pricing:
Expand Down
3 changes: 3 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,9 @@ issue that caused it, so the comment record and the spec history line up.

## [Unreleased]

- § 5.5 — `geo` may be `selectable`, with per-market price deltas
([#14](https://github.com/IABTechLab/OpenProposal/issues/14)).

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

Initial draft published for public comment. Ported from the working-group
Expand Down
33 changes: 25 additions & 8 deletions spec/openproposal-3.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -163,8 +163,9 @@ treated as `seller-set`.

### 3.3 Re-computation

Because audiences, properties and formats are `selectable`, `addressable_scale`
and `availability` MUST be recomputed against the buyer's actual selection. A
Because audiences, properties, formats and, where it is selectable, `geo` are
`selectable`, `addressable_scale` and `availability` MUST be recomputed against
the buyer's actual selection. A
single declared figure is correct only for the default composition.

---
Expand Down Expand Up @@ -251,15 +252,31 @@ channel.
### 5.5 Targeting envelope

Each field declares bounds, not a value. A bare value means the field is
`seller-set`.
`seller-set`. `geo` MAY instead declare the selectable structure of § 3.1, so a
line item can be priced by market.

| Field | Type | Mutability | Description |
| :--- | :--- | :--- | :--- |
| `geo` | Object | settable | `allowed[]` of geo codes the buyer may select within |
| `geo` | Object | selectable | `available[]` of geo codes with `included[]`, `pricing` deltas and `max_select` (§ 3.1), for a line item priced by market. A `geo` that declares only `allowed[]` is `settable`. See below |
| `device` | Object | settable | `allowed[]` of device categories |
| `daypart` | Object | settable | `allowed[]` of time windows |
| `frequency_cap` | Object | settable | `{ max: { min, max }, period, basis: device \| household \| listener }`. Basis matters: CTV typically caps at household, audio at listener |

**Market-priced lines.** A seller whose rate differs by market MAY declare `geo`
with the selectable structure of § 3.1:

```yaml
geo:
available: ["SGP", "THA", "IDN", "MYS"]
included: ["SGP", "THA"]
pricing: { "IDN": { delta_cpm: 18.00 }, "MYS": { delta_cpm: 21.00 } }
max_select: 4
```

- A `geo` that declares `allowed[]` and no `available[]` MUST be treated as
`settable` (§ 3.2). A `geo` MUST NOT declare both.
- `pricing` deltas add to `agreed_rate` as for any selectable field (§ 3.1).

### 5.6 Commercial terms

| Field | Type | Mutability | Description |
Expand Down Expand Up @@ -466,7 +483,7 @@ body is normative.**
| `materials_due` | 5.4 Creative requirements | Timestamp/Offset | requestable |
| `approval` | 5.4 Creative requirements | Object | seller-set |
| `production` | 5.4 Creative requirements | Object | selectable |
| `geo` | 5.5 Targeting envelope | Object | settable |
| `geo` | 5.5 Targeting envelope | Object | selectable |
| `device` | 5.5 Targeting envelope | Object | settable |
| `daypart` | 5.5 Targeting envelope | Object | settable |
| `frequency_cap` | 5.5 Targeting envelope | Object | settable |
Expand Down Expand Up @@ -513,16 +530,16 @@ body is normative.**
| :--- | :--- | :--- | :--- |
| immutable | 6 | Set once at creation. Neither party may change it. | `proposal_id`, `seller_id`, `seller_name`, `type`, `line_item_id`, `channel` |
| seller-set | 29 | Seller sets and may revise while `draft` or `published`. | `valid_from` · `valid_until`, `description`, `specifications`, `best_for[]`, `not_suitable_for[]`, `seasonality_notes`, `content_detail`, `specs`, `third_party_tags`, `creative_delivery`, `approval`, `pricing[].cost_method`, `pricing[].gross_rate`, `pricing[].seller_rate`, `pricing[].price_valid_until`, `pricing[].currency`, `pricing[].floor`, `commitment_bounds`, `min_spend`, `creative_policy`, `visibility`, `required_credentials[]`, `eligible_bidders[]`, `terms_acceptance_required`, `buying_route`, `serving_mode`, `serving_platform`, `billing`, `supported_order_systems[]` |
| selectable | 12 | Buyer chooses from a declared set. Resolves without assent. | `properties`, `environments`, `audiences`, `activation_route`, `formats`, `production`, `cancellation_policy`, `exclusivity`, `measurement_source`, `shortfall_remedy`, `reporting`, `transaction_mechanism` |
| settable | 5 | Buyer sets a value within declared bounds. Resolves without assent. | `geo`, `device`, `daypart`, `frequency_cap`, `commitment` |
| selectable | 13 | Buyer chooses from a declared set. Resolves without assent. | `properties`, `environments`, `audiences`, `activation_route`, `formats`, `production`, `geo`, `cancellation_policy`, `exclusivity`, `measurement_source`, `shortfall_remedy`, `reporting`, `transaction_mechanism` |
| settable | 4 | Buyer sets a value within declared bounds. Resolves without assent. | `device`, `daypart`, `frequency_cap`, `commitment` |
| supplied | 3 | Buyer provides data or an artifact. | `brief_ref`, `buyer_supplied`, `assets[]` |
| requestable | 3 | Buyer may ask outside the declared space. Requires seller assent. | `materials_due`, `hold_status`, `committed_metrics[]` |
| derived | 11 | Computed. Neither party sets it directly. | `version`, `status` (proposal), `assent`, `negotiation_history[]`, `status` (line item), `addressable_scale`, `pricing[].agreed_rate`, `availability`, `deal_id_issuance`, `external_references[]`, `correlation_id` |
| mixed | 2 | Sub-fields carry different markers; see the section. | `pricing[]`, `buyer_requirements` |

### What the distribution says

Of 71 fields, **23 are touched by the buyer** — 12 `selectable`, 5 `settable`, 3
Of 71 fields, **23 are touched by the buyer** — 13 `selectable`, 4 `settable`, 3
`supplied` and 3 `requestable`. The remaining 48 are `seller-set`, `immutable`,
`derived` or `mixed`.

Expand Down
Loading