Skip to content

§ 5.5 — Buyer-supplied block lists (#25) - #71

Draft
Sirajmx wants to merge 2 commits into
mainfrom
spec/25-buyer-block-lists
Draft

Sirajmx wants to merge 2 commits into
mainfrom
spec/25-buyer-block-lists

Conversation

@Sirajmx

@Sirajmx Sirajmx commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

Draft. Do not merge until the working group confirms the disposition of #25.

What this changes

A buyer can now carry its block lists into the proposal. The seller declares which exclusion types it accepts, how many entries, and how it enforces each (exclusions_accepted, seller-set); the buyer supplies its lists within that declaration (exclusions, supplied): domains, apps, content categories, keywords, or a hash-pinned list_ref for large lists. A type the seller doesn't accept is rejected, never silently ignored, and best_effort enforcement is never presented as a guarantee. Exclusions are recompute inputs (§ 3.3) and are never disclosed to anyone but the buyer (§ 5.8).

Related issue

Refs #25

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
  • Appendix A (field index) matches the body — two rows; scripts/check_appendix.py passes
  • Appendix B (fields by marker, and the counts) matches the body — seller-set 29 → 30, supplied 3 → 4; 71 → 73 fields; buyer-touched 23 → 24; resolved without a round trip 20 → 21
  • Any affected example in examples/ is updated and still parses — the display example declares and supplies lists
  • RFC 2119 keywords used deliberately — MUST / SHOULD / MAY are not synonyms
  • The no-inheritance rule (§ 2) still holds
  • Anything selectable declares available[] and included[]; anything settable declares bounds (§ 3.1, § 3.2) — exclusions is supplied, bounded by exclusions_accepted
  • No confidential or commercially sensitive content

Knock-on effects


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

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 #25
#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 #25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant