@adcp/sdk 17.0.0-beta.12 → 17.0.0-beta.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1655) hide show
  1. package/compliance/cache/{3.2.7 → 3.2.8}/index.json +3 -3
  2. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_lifecycle_webhooks.yaml +2 -0
  3. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/creative_fate_after_cancellation.yaml +2 -4
  4. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/dependency_impairment.yaml +2 -4
  5. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/dependency_impairment_cardinality.yaml +2 -4
  6. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/invalid_transitions.yaml +2 -4
  7. package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_terms_rejected.yaml +6 -7
  8. package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-broadcast-tv/index.yaml +7 -1
  9. package/compliance/cache/{3.2.7 → 3.2.8}/universal/stale-response-advisory.yaml +77 -69
  10. package/compliance/cache/{3.2.7 → 3.2.8}/universal/storyboard-schema.yaml +7 -0
  11. package/dist/lib/adapters/version/schema-projection.js +37 -2
  12. package/dist/lib/adapters/version/schema-projection.mjs +37 -2
  13. package/dist/lib/core/SingleAgentClient.js +3 -3
  14. package/dist/lib/core/SingleAgentClient.mjs +4 -3
  15. package/dist/lib/negotiation/commercial-terms-semantics.js +11 -0
  16. package/dist/lib/negotiation/commercial-terms-semantics.mjs +11 -0
  17. package/dist/lib/schemas-data/3.2/a2ui/bound-value.json +1 -1
  18. package/dist/lib/schemas-data/3.2/a2ui/component.json +1 -1
  19. package/dist/lib/schemas-data/3.2/a2ui/si-catalog.json +25 -25
  20. package/dist/lib/schemas-data/3.2/a2ui/surface.json +2 -2
  21. package/dist/lib/schemas-data/3.2/a2ui/user-action.json +1 -1
  22. package/dist/lib/schemas-data/3.2/aao/agent-publishers.json +1 -1
  23. package/dist/lib/schemas-data/3.2/account/get-account-financials-request.json +6 -6
  24. package/dist/lib/schemas-data/3.2/account/get-account-financials-response.json +12 -12
  25. package/dist/lib/schemas-data/3.2/account/list-account-changes-request.json +7 -7
  26. package/dist/lib/schemas-data/3.2/account/list-account-changes-response.json +7 -7
  27. package/dist/lib/schemas-data/3.2/account/list-accounts-request.json +6 -6
  28. package/dist/lib/schemas-data/3.2/account/list-accounts-response.json +8 -8
  29. package/dist/lib/schemas-data/3.2/account/report-usage-request.json +6 -6
  30. package/dist/lib/schemas-data/3.2/account/report-usage-response.json +6 -6
  31. package/dist/lib/schemas-data/3.2/account/sync-accounts-request.json +16 -16
  32. package/dist/lib/schemas-data/3.2/account/sync-accounts-response.json +21 -21
  33. package/dist/lib/schemas-data/3.2/account/sync-governance-request.json +5 -5
  34. package/dist/lib/schemas-data/3.2/account/sync-governance-response.json +10 -10
  35. package/dist/lib/schemas-data/3.2/adagents.json +30 -30
  36. package/dist/lib/schemas-data/3.2/brand/acquire-rights-request.json +12 -12
  37. package/dist/lib/schemas-data/3.2/brand/acquire-rights-response.json +16 -16
  38. package/dist/lib/schemas-data/3.2/brand/creative-approval-request.json +5 -5
  39. package/dist/lib/schemas-data/3.2/brand/creative-approval-response.json +12 -12
  40. package/dist/lib/schemas-data/3.2/brand/get-brand-identity-request.json +4 -4
  41. package/dist/lib/schemas-data/3.2/brand/get-brand-identity-response.json +10 -10
  42. package/dist/lib/schemas-data/3.2/brand/get-rights-request.json +8 -8
  43. package/dist/lib/schemas-data/3.2/brand/get-rights-response.json +11 -11
  44. package/dist/lib/schemas-data/3.2/brand/revocation-notification.json +4 -4
  45. package/dist/lib/schemas-data/3.2/brand/rights-pricing-option.json +5 -5
  46. package/dist/lib/schemas-data/3.2/brand/rights-terms.json +3 -3
  47. package/dist/lib/schemas-data/3.2/brand/search-brands-request.json +6 -6
  48. package/dist/lib/schemas-data/3.2/brand/search-brands-response.json +11 -11
  49. package/dist/lib/schemas-data/3.2/brand/update-rights-request.json +6 -6
  50. package/dist/lib/schemas-data/3.2/brand/update-rights-response.json +11 -11
  51. package/dist/lib/schemas-data/3.2/brand/verification-status.json +1 -1
  52. package/dist/lib/schemas-data/3.2/brand/verify-brand-claim-request.json +3 -3
  53. package/dist/lib/schemas-data/3.2/brand/verify-brand-claim-response.json +13 -13
  54. package/dist/lib/schemas-data/3.2/brand/verify-brand-claims-request.json +3 -3
  55. package/dist/lib/schemas-data/3.2/brand/verify-brand-claims-response.json +13 -13
  56. package/dist/lib/schemas-data/3.2/brand.json +23 -23
  57. package/dist/lib/schemas-data/3.2/bundled.schemas.br +0 -0
  58. package/dist/lib/schemas-data/3.2/collection/base-collection-source.json +3 -3
  59. package/dist/lib/schemas-data/3.2/collection/collection-list-changed-webhook.json +2 -2
  60. package/dist/lib/schemas-data/3.2/collection/collection-list-filters.json +7 -7
  61. package/dist/lib/schemas-data/3.2/collection/collection-list.json +5 -5
  62. package/dist/lib/schemas-data/3.2/collection/create-collection-list-request.json +8 -8
  63. package/dist/lib/schemas-data/3.2/collection/create-collection-list-response.json +6 -6
  64. package/dist/lib/schemas-data/3.2/collection/delete-collection-list-request.json +5 -5
  65. package/dist/lib/schemas-data/3.2/collection/delete-collection-list-response.json +5 -5
  66. package/dist/lib/schemas-data/3.2/collection/get-collection-list-request.json +5 -5
  67. package/dist/lib/schemas-data/3.2/collection/get-collection-list-response.json +12 -12
  68. package/dist/lib/schemas-data/3.2/collection/list-collection-lists-request.json +6 -6
  69. package/dist/lib/schemas-data/3.2/collection/list-collection-lists-response.json +7 -7
  70. package/dist/lib/schemas-data/3.2/collection/update-collection-list-request.json +8 -8
  71. package/dist/lib/schemas-data/3.2/collection/update-collection-list-response.json +6 -6
  72. package/dist/lib/schemas-data/3.2/content-standards/artifact-webhook-payload.json +3 -3
  73. package/dist/lib/schemas-data/3.2/content-standards/artifact.json +8 -8
  74. package/dist/lib/schemas-data/3.2/content-standards/calibrate-content-request.json +5 -5
  75. package/dist/lib/schemas-data/3.2/content-standards/calibrate-content-response.json +10 -10
  76. package/dist/lib/schemas-data/3.2/content-standards/content-standards.json +7 -7
  77. package/dist/lib/schemas-data/3.2/content-standards/create-content-standards-request.json +8 -8
  78. package/dist/lib/schemas-data/3.2/content-standards/create-content-standards-response.json +8 -8
  79. package/dist/lib/schemas-data/3.2/content-standards/get-content-standards-request.json +4 -4
  80. package/dist/lib/schemas-data/3.2/content-standards/get-content-standards-response.json +9 -9
  81. package/dist/lib/schemas-data/3.2/content-standards/get-media-buy-artifacts-request.json +5 -5
  82. package/dist/lib/schemas-data/3.2/content-standards/get-media-buy-artifacts-response.json +10 -10
  83. package/dist/lib/schemas-data/3.2/content-standards/list-content-standards-request.json +6 -6
  84. package/dist/lib/schemas-data/3.2/content-standards/list-content-standards-response.json +10 -10
  85. package/dist/lib/schemas-data/3.2/content-standards/update-content-standards-request.json +8 -8
  86. package/dist/lib/schemas-data/3.2/content-standards/update-content-standards-response.json +8 -8
  87. package/dist/lib/schemas-data/3.2/content-standards/validate-content-delivery-request.json +5 -5
  88. package/dist/lib/schemas-data/3.2/content-standards/validate-content-delivery-response.json +10 -10
  89. package/dist/lib/schemas-data/3.2/core/acceptance-policy-profile-ids.json +1 -1
  90. package/dist/lib/schemas-data/3.2/core/account-authorization.json +1 -1
  91. package/dist/lib/schemas-data/3.2/core/account-change-recorded-webhook.json +2 -2
  92. package/dist/lib/schemas-data/3.2/core/account-change.json +2 -2
  93. package/dist/lib/schemas-data/3.2/core/account-identity-change-preview.json +4 -4
  94. package/dist/lib/schemas-data/3.2/core/account-identity-change.json +3 -3
  95. package/dist/lib/schemas-data/3.2/core/account-ref.json +3 -3
  96. package/dist/lib/schemas-data/3.2/core/account-status-changed-webhook.json +4 -4
  97. package/dist/lib/schemas-data/3.2/core/account-timezone-capability.json +1 -1
  98. package/dist/lib/schemas-data/3.2/core/account-with-authorization.json +3 -3
  99. package/dist/lib/schemas-data/3.2/core/account.json +14 -14
  100. package/dist/lib/schemas-data/3.2/core/activation-key.json +1 -1
  101. package/dist/lib/schemas-data/3.2/core/ad-inventory-config.json +1 -1
  102. package/dist/lib/schemas-data/3.2/core/agent-encryption-key.json +1 -1
  103. package/dist/lib/schemas-data/3.2/core/agent-notification-config-state.json +4 -4
  104. package/dist/lib/schemas-data/3.2/core/agent-notification-config.json +4 -4
  105. package/dist/lib/schemas-data/3.2/core/agent-reporting-destination-state.json +4 -4
  106. package/dist/lib/schemas-data/3.2/core/agent-reporting-destination.json +8 -8
  107. package/dist/lib/schemas-data/3.2/core/agent-signing-key.json +1 -1
  108. package/dist/lib/schemas-data/3.2/core/agent-webhook-challenge.json +1 -1
  109. package/dist/lib/schemas-data/3.2/core/app-item.json +4 -4
  110. package/dist/lib/schemas-data/3.2/core/applicable-package-id.json +1 -1
  111. package/dist/lib/schemas-data/3.2/core/asset-group-vocabulary.json +1 -1
  112. package/dist/lib/schemas-data/3.2/core/assets/asset-union.json +22 -22
  113. package/dist/lib/schemas-data/3.2/core/assets/audio-asset.json +3 -3
  114. package/dist/lib/schemas-data/3.2/core/assets/brief-asset.json +2 -2
  115. package/dist/lib/schemas-data/3.2/core/assets/card-asset.json +6 -6
  116. package/dist/lib/schemas-data/3.2/core/assets/catalog-asset.json +2 -2
  117. package/dist/lib/schemas-data/3.2/core/assets/css-asset.json +2 -2
  118. package/dist/lib/schemas-data/3.2/core/assets/daast-asset.json +6 -6
  119. package/dist/lib/schemas-data/3.2/core/assets/daast-tracker-asset.json +5 -5
  120. package/dist/lib/schemas-data/3.2/core/assets/display-tag-asset.json +12 -12
  121. package/dist/lib/schemas-data/3.2/core/assets/html-asset.json +2 -2
  122. package/dist/lib/schemas-data/3.2/core/assets/image-asset.json +2 -2
  123. package/dist/lib/schemas-data/3.2/core/assets/javascript-asset.json +3 -3
  124. package/dist/lib/schemas-data/3.2/core/assets/markdown-asset.json +2 -2
  125. package/dist/lib/schemas-data/3.2/core/assets/pixel-tracker-asset.json +5 -5
  126. package/dist/lib/schemas-data/3.2/core/assets/published-post-asset.json +2 -2
  127. package/dist/lib/schemas-data/3.2/core/assets/text-asset.json +2 -2
  128. package/dist/lib/schemas-data/3.2/core/assets/url-asset.json +5 -5
  129. package/dist/lib/schemas-data/3.2/core/assets/vast-asset.json +6 -6
  130. package/dist/lib/schemas-data/3.2/core/assets/vast-tracker-asset.json +5 -5
  131. package/dist/lib/schemas-data/3.2/core/assets/video-asset.json +7 -7
  132. package/dist/lib/schemas-data/3.2/core/assets/webhook-asset.json +7 -7
  133. package/dist/lib/schemas-data/3.2/core/assets/zip-asset.json +2 -2
  134. package/dist/lib/schemas-data/3.2/core/async-response-data.json +43 -43
  135. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/get-creative-features-async-response-submitted.json +3 -3
  136. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-input-required.json +3 -3
  137. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-submitted.json +4 -4
  138. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-working.json +3 -3
  139. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-input-required.json +2 -2
  140. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-submitted.json +2 -2
  141. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-working.json +2 -2
  142. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-input-required.json +4 -4
  143. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-submitted.json +4 -4
  144. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-working.json +3 -3
  145. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-input-required.json +2 -2
  146. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-submitted.json +2 -2
  147. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-working.json +2 -2
  148. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-input-required.json +2 -2
  149. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-submitted.json +2 -2
  150. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-working.json +2 -2
  151. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-input-required.json +4 -4
  152. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-submitted.json +4 -4
  153. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-working.json +3 -3
  154. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-input-required.json +2 -2
  155. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-submitted.json +2 -2
  156. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-working.json +2 -2
  157. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-input-required.json +4 -4
  158. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-submitted.json +4 -4
  159. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-working.json +3 -3
  160. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-input-required.json +2 -2
  161. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-submitted.json +2 -2
  162. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-working.json +2 -2
  163. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-input-required.json +2 -2
  164. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-submitted.json +2 -2
  165. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-working.json +2 -2
  166. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-input-required.json +3 -3
  167. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-submitted.json +4 -4
  168. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-working.json +3 -3
  169. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-input-required.json +3 -3
  170. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-submitted.json +4 -4
  171. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-working.json +3 -3
  172. package/dist/lib/schemas-data/3.2/core/async-response-refs/signals/get-signals-async-response-submitted.json +4 -4
  173. package/dist/lib/schemas-data/3.2/core/async-response-refs/signals/get-signals-async-response-working.json +3 -3
  174. package/dist/lib/schemas-data/3.2/core/attestation-capabilities.json +5 -5
  175. package/dist/lib/schemas-data/3.2/core/attestation-evaluation.json +2 -2
  176. package/dist/lib/schemas-data/3.2/core/attestation-issuer.json +5 -5
  177. package/dist/lib/schemas-data/3.2/core/attestation-reference.json +7 -7
  178. package/dist/lib/schemas-data/3.2/core/attestation-subject.json +5 -5
  179. package/dist/lib/schemas-data/3.2/core/attribution-window.json +4 -4
  180. package/dist/lib/schemas-data/3.2/core/audience-activation-method.json +6 -6
  181. package/dist/lib/schemas-data/3.2/core/audience-characteristic.json +1 -1
  182. package/dist/lib/schemas-data/3.2/core/audience-evidence-pin.json +2 -2
  183. package/dist/lib/schemas-data/3.2/core/audience-evidence-requirements.json +10 -10
  184. package/dist/lib/schemas-data/3.2/core/audience-evidence-selection.json +5 -5
  185. package/dist/lib/schemas-data/3.2/core/audience-evidence.json +10 -10
  186. package/dist/lib/schemas-data/3.2/core/audience-member.json +3 -3
  187. package/dist/lib/schemas-data/3.2/core/audience-selector.json +7 -7
  188. package/dist/lib/schemas-data/3.2/core/audience-source.json +3 -3
  189. package/dist/lib/schemas-data/3.2/core/authorized-agent-base.json +3 -3
  190. package/dist/lib/schemas-data/3.2/core/bidding-policy-capability.json +1 -1
  191. package/dist/lib/schemas-data/3.2/core/bidding-policy.json +1 -1
  192. package/dist/lib/schemas-data/3.2/core/brand-id.json +1 -1
  193. package/dist/lib/schemas-data/3.2/core/brand-key.json +2 -2
  194. package/dist/lib/schemas-data/3.2/core/brand-ref.json +3 -3
  195. package/dist/lib/schemas-data/3.2/core/brand-response-authorization-result.json +1 -1
  196. package/dist/lib/schemas-data/3.2/core/budget-allocation.json +2 -2
  197. package/dist/lib/schemas-data/3.2/core/budget-range.json +1 -1
  198. package/dist/lib/schemas-data/3.2/core/business-entity.json +2 -2
  199. package/dist/lib/schemas-data/3.2/core/cancellation-policy.json +2 -2
  200. package/dist/lib/schemas-data/3.2/core/canonical-account-ref.json +3 -3
  201. package/dist/lib/schemas-data/3.2/core/canonical-audience-evidence-selection.json +3 -3
  202. package/dist/lib/schemas-data/3.2/core/canonical-audience-evidence.json +8 -8
  203. package/dist/lib/schemas-data/3.2/core/canonical-budget-allocation.json +2 -2
  204. package/dist/lib/schemas-data/3.2/core/canonical-delivery-forecast.json +7 -7
  205. package/dist/lib/schemas-data/3.2/core/canonical-forecast-point.json +12 -12
  206. package/dist/lib/schemas-data/3.2/core/canonical-forecast-vendor-metric-value.json +5 -5
  207. package/dist/lib/schemas-data/3.2/core/canonical-format-kind.json +1 -1
  208. package/dist/lib/schemas-data/3.2/core/canonical-format-option.json +6 -6
  209. package/dist/lib/schemas-data/3.2/core/canonical-measurement-terms.json +3 -3
  210. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-action-fields.json +6 -6
  211. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-action.json +4 -4
  212. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-features.json +2 -2
  213. package/dist/lib/schemas-data/3.2/core/canonical-metric-qualifier.json +6 -6
  214. package/dist/lib/schemas-data/3.2/core/canonical-optimization-goal.json +9 -9
  215. package/dist/lib/schemas-data/3.2/core/canonical-performance-standard.json +4 -4
  216. package/dist/lib/schemas-data/3.2/core/canonical-placement.json +9 -9
  217. package/dist/lib/schemas-data/3.2/core/canonical-pricing-option.json +5 -5
  218. package/dist/lib/schemas-data/3.2/core/canonical-product-action.json +6 -6
  219. package/dist/lib/schemas-data/3.2/core/canonical-product.json +141 -32
  220. package/dist/lib/schemas-data/3.2/core/canonical-projection-ref.json +3 -3
  221. package/dist/lib/schemas-data/3.2/core/canonical-projection-slot-override.json +1 -1
  222. package/dist/lib/schemas-data/3.2/core/canonical-proposal.json +6 -6
  223. package/dist/lib/schemas-data/3.2/core/canonical-reporting-capabilities.json +11 -11
  224. package/dist/lib/schemas-data/3.2/core/canonical-reporting-commitment.json +6 -6
  225. package/dist/lib/schemas-data/3.2/core/canvas-constraint.json +1 -1
  226. package/dist/lib/schemas-data/3.2/core/capabilities-changed-webhook.json +2 -2
  227. package/dist/lib/schemas-data/3.2/core/catalog-field-mapping.json +2 -2
  228. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-error.json +3 -3
  229. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-ref.json +1 -1
  230. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-state.json +4 -4
  231. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-update-result.json +4 -4
  232. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-update.json +2 -2
  233. package/dist/lib/schemas-data/3.2/core/catalog-item-delivery-metrics.json +3 -3
  234. package/dist/lib/schemas-data/3.2/core/catalog-item-reference-not-found-error.json +1 -1
  235. package/dist/lib/schemas-data/3.2/core/catalog-selection.json +7 -7
  236. package/dist/lib/schemas-data/3.2/core/catalog.json +7 -7
  237. package/dist/lib/schemas-data/3.2/core/catchment.json +5 -5
  238. package/dist/lib/schemas-data/3.2/core/collection-delivery-metrics.json +3 -3
  239. package/dist/lib/schemas-data/3.2/core/collection-distribution.json +3 -3
  240. package/dist/lib/schemas-data/3.2/core/collection-list-ref.json +1 -1
  241. package/dist/lib/schemas-data/3.2/core/collection-property-delivery-metrics.json +5 -5
  242. package/dist/lib/schemas-data/3.2/core/collection-ref.json +1 -1
  243. package/dist/lib/schemas-data/3.2/core/collection-selection.json +4 -4
  244. package/dist/lib/schemas-data/3.2/core/collection-selector.json +1 -1
  245. package/dist/lib/schemas-data/3.2/core/collection.json +13 -13
  246. package/dist/lib/schemas-data/3.2/core/committed-metric.json +14 -14
  247. package/dist/lib/schemas-data/3.2/core/compact-task-input-required.json +4 -4
  248. package/dist/lib/schemas-data/3.2/core/compact-task-submitted.json +6 -6
  249. package/dist/lib/schemas-data/3.2/core/compact-task-working.json +3 -3
  250. package/dist/lib/schemas-data/3.2/core/content-rating.json +2 -2
  251. package/dist/lib/schemas-data/3.2/core/context.json +1 -1
  252. package/dist/lib/schemas-data/3.2/core/creative-approval-scope.json +3 -3
  253. package/dist/lib/schemas-data/3.2/core/creative-asset.json +13 -13
  254. package/dist/lib/schemas-data/3.2/core/creative-assets.json +3 -3
  255. package/dist/lib/schemas-data/3.2/core/creative-assignment.json +2 -2
  256. package/dist/lib/schemas-data/3.2/core/creative-brief.json +4 -4
  257. package/dist/lib/schemas-data/3.2/core/creative-consumption.json +1 -1
  258. package/dist/lib/schemas-data/3.2/core/creative-delivery-metrics.json +2 -2
  259. package/dist/lib/schemas-data/3.2/core/creative-filters.json +8 -8
  260. package/dist/lib/schemas-data/3.2/core/creative-item.json +1 -1
  261. package/dist/lib/schemas-data/3.2/core/creative-locale-policy.json +2 -2
  262. package/dist/lib/schemas-data/3.2/core/creative-localization-readback.json +6 -6
  263. package/dist/lib/schemas-data/3.2/core/creative-localization.json +6 -6
  264. package/dist/lib/schemas-data/3.2/core/creative-manifest.json +13 -13
  265. package/dist/lib/schemas-data/3.2/core/creative-operation-format-declaration.json +7 -7
  266. package/dist/lib/schemas-data/3.2/core/creative-policy.json +3 -3
  267. package/dist/lib/schemas-data/3.2/core/creative-representation-set.json +4 -4
  268. package/dist/lib/schemas-data/3.2/core/creative-representation.json +2 -2
  269. package/dist/lib/schemas-data/3.2/core/creative-revision-id.json +1 -1
  270. package/dist/lib/schemas-data/3.2/core/creative-variable.json +1 -1
  271. package/dist/lib/schemas-data/3.2/core/creative-variant.json +6 -6
  272. package/dist/lib/schemas-data/3.2/core/daast-tracker-constraints.json +2 -2
  273. package/dist/lib/schemas-data/3.2/core/data-provider-signal-selector.json +1 -1
  274. package/dist/lib/schemas-data/3.2/core/date-range.json +1 -1
  275. package/dist/lib/schemas-data/3.2/core/datetime-range.json +1 -1
  276. package/dist/lib/schemas-data/3.2/core/daypart-target.json +3 -3
  277. package/dist/lib/schemas-data/3.2/core/deadline-policy.json +1 -1
  278. package/dist/lib/schemas-data/3.2/core/delivery-breakdown-controls.json +3 -3
  279. package/dist/lib/schemas-data/3.2/core/delivery-forecast.json +7 -7
  280. package/dist/lib/schemas-data/3.2/core/delivery-metric-aggregate.json +14 -14
  281. package/dist/lib/schemas-data/3.2/core/delivery-metrics.json +11 -11
  282. package/dist/lib/schemas-data/3.2/core/delivery-provider.json +1 -1
  283. package/dist/lib/schemas-data/3.2/core/delivery-recipient.json +2 -2
  284. package/dist/lib/schemas-data/3.2/core/demographic-age-range.json +1 -1
  285. package/dist/lib/schemas-data/3.2/core/demographic-predicate.json +2 -2
  286. package/dist/lib/schemas-data/3.2/core/demographic-reporting-capability.json +4 -4
  287. package/dist/lib/schemas-data/3.2/core/demographic-targeting-capability.json +4 -4
  288. package/dist/lib/schemas-data/3.2/core/demographic-targeting-intent.json +4 -4
  289. package/dist/lib/schemas-data/3.2/core/demographic-targeting-resolution.json +10 -10
  290. package/dist/lib/schemas-data/3.2/core/deployment.json +3 -3
  291. package/dist/lib/schemas-data/3.2/core/destination-item.json +4 -4
  292. package/dist/lib/schemas-data/3.2/core/destination.json +1 -1
  293. package/dist/lib/schemas-data/3.2/core/diagnostic-issue.json +1 -1
  294. package/dist/lib/schemas-data/3.2/core/downstream-connection-requirement.json +1 -1
  295. package/dist/lib/schemas-data/3.2/core/duration.json +1 -1
  296. package/dist/lib/schemas-data/3.2/core/education-item.json +4 -4
  297. package/dist/lib/schemas-data/3.2/core/error.json +1 -1
  298. package/dist/lib/schemas-data/3.2/core/evaluator-spec.json +5 -5
  299. package/dist/lib/schemas-data/3.2/core/event-custom-data.json +2 -2
  300. package/dist/lib/schemas-data/3.2/core/event-source-health.json +3 -3
  301. package/dist/lib/schemas-data/3.2/core/event-surface.json +2 -2
  302. package/dist/lib/schemas-data/3.2/core/event.json +8 -8
  303. package/dist/lib/schemas-data/3.2/core/experimental-feature-id.json +1 -1
  304. package/dist/lib/schemas-data/3.2/core/ext.json +1 -1
  305. package/dist/lib/schemas-data/3.2/core/feature-requirement.json +1 -1
  306. package/dist/lib/schemas-data/3.2/core/flight-item.json +4 -4
  307. package/dist/lib/schemas-data/3.2/core/forecast-dimension-audience.json +2 -2
  308. package/dist/lib/schemas-data/3.2/core/forecast-dimension-device-platform.json +2 -2
  309. package/dist/lib/schemas-data/3.2/core/forecast-dimension-device-type.json +2 -2
  310. package/dist/lib/schemas-data/3.2/core/forecast-dimension-geo.json +5 -5
  311. package/dist/lib/schemas-data/3.2/core/forecast-dimension-placement.json +2 -2
  312. package/dist/lib/schemas-data/3.2/core/forecast-dimension-signal.json +2 -2
  313. package/dist/lib/schemas-data/3.2/core/forecast-dimension-time.json +1 -1
  314. package/dist/lib/schemas-data/3.2/core/forecast-point-dimensions.json +8 -8
  315. package/dist/lib/schemas-data/3.2/core/forecast-point.json +28 -28
  316. package/dist/lib/schemas-data/3.2/core/forecast-range.json +1 -1
  317. package/dist/lib/schemas-data/3.2/core/forecast-rate-range.json +2 -2
  318. package/dist/lib/schemas-data/3.2/core/forecast-vendor-metric-value.json +7 -7
  319. package/dist/lib/schemas-data/3.2/core/format-id.json +1 -1
  320. package/dist/lib/schemas-data/3.2/core/format-option-ref.json +1 -1
  321. package/dist/lib/schemas-data/3.2/core/format-shape-vocabulary.json +1 -1
  322. package/dist/lib/schemas-data/3.2/core/format.json +45 -45
  323. package/dist/lib/schemas-data/3.2/core/frequency-cap-constraints.json +8 -8
  324. package/dist/lib/schemas-data/3.2/core/frequency-cap-duration-unit.json +1 -1
  325. package/dist/lib/schemas-data/3.2/core/frequency-cap-impression-constraints.json +2 -2
  326. package/dist/lib/schemas-data/3.2/core/frequency-cap-interval-constraints.json +3 -3
  327. package/dist/lib/schemas-data/3.2/core/frequency-cap-requirements.json +6 -6
  328. package/dist/lib/schemas-data/3.2/core/frequency-cap.json +4 -4
  329. package/dist/lib/schemas-data/3.2/core/generation-credential.json +3 -3
  330. package/dist/lib/schemas-data/3.2/core/geo-breakdown-support.json +3 -3
  331. package/dist/lib/schemas-data/3.2/core/geo-delivery-metrics.json +6 -6
  332. package/dist/lib/schemas-data/3.2/core/geo-metro.json +2 -2
  333. package/dist/lib/schemas-data/3.2/core/geo-place-area.json +4 -4
  334. package/dist/lib/schemas-data/3.2/core/geo-place-catalog-capability.json +2 -2
  335. package/dist/lib/schemas-data/3.2/core/geo-place-catalog-entry.json +3 -3
  336. package/dist/lib/schemas-data/3.2/core/geo-place-requirement.json +3 -3
  337. package/dist/lib/schemas-data/3.2/core/geo-place-resolver.json +1 -1
  338. package/dist/lib/schemas-data/3.2/core/geo-place-support.json +3 -3
  339. package/dist/lib/schemas-data/3.2/core/geo-place-system.json +1 -1
  340. package/dist/lib/schemas-data/3.2/core/geo-place-type.json +1 -1
  341. package/dist/lib/schemas-data/3.2/core/geo-region-requirement.json +1 -1
  342. package/dist/lib/schemas-data/3.2/core/geo-region-support.json +2 -2
  343. package/dist/lib/schemas-data/3.2/core/get-geo-place-resolution-request.json +3 -3
  344. package/dist/lib/schemas-data/3.2/core/get-geo-place-resolution-response.json +4 -4
  345. package/dist/lib/schemas-data/3.2/core/hotel-item.json +4 -4
  346. package/dist/lib/schemas-data/3.2/core/iana-timezone.json +1 -1
  347. package/dist/lib/schemas-data/3.2/core/identifier.json +2 -2
  348. package/dist/lib/schemas-data/3.2/core/impairment.json +3 -3
  349. package/dist/lib/schemas-data/3.2/core/indicator-bearing.json +4 -4
  350. package/dist/lib/schemas-data/3.2/core/indicator-scope.json +1 -1
  351. package/dist/lib/schemas-data/3.2/core/indicator.json +4 -4
  352. package/dist/lib/schemas-data/3.2/core/indicators-changed-webhook.json +3 -3
  353. package/dist/lib/schemas-data/3.2/core/industry-identifier.json +2 -2
  354. package/dist/lib/schemas-data/3.2/core/insertion-order.json +1 -1
  355. package/dist/lib/schemas-data/3.2/core/installment-deadlines.json +2 -2
  356. package/dist/lib/schemas-data/3.2/core/installment-delivery-metrics.json +3 -3
  357. package/dist/lib/schemas-data/3.2/core/installment-property-delivery-metrics.json +5 -5
  358. package/dist/lib/schemas-data/3.2/core/installment-ref.json +2 -2
  359. package/dist/lib/schemas-data/3.2/core/installment.json +10 -10
  360. package/dist/lib/schemas-data/3.2/core/inventory-list-application.json +1 -1
  361. package/dist/lib/schemas-data/3.2/core/job-item.json +3 -3
  362. package/dist/lib/schemas-data/3.2/core/keyword-delivery-metrics.json +3 -3
  363. package/dist/lib/schemas-data/3.2/core/keyword-target.json +2 -2
  364. package/dist/lib/schemas-data/3.2/core/limited-series.json +1 -1
  365. package/dist/lib/schemas-data/3.2/core/locale-tag.json +1 -1
  366. package/dist/lib/schemas-data/3.2/core/localized-creative-asset.json +3 -3
  367. package/dist/lib/schemas-data/3.2/core/macro-bearing-url.json +1 -1
  368. package/dist/lib/schemas-data/3.2/core/macro-declaration.json +10 -10
  369. package/dist/lib/schemas-data/3.2/core/macro-encoding.json +1 -1
  370. package/dist/lib/schemas-data/3.2/core/macro-resolution-capability.json +8 -8
  371. package/dist/lib/schemas-data/3.2/core/macro-resolution-result.json +10 -10
  372. package/dist/lib/schemas-data/3.2/core/macro-translation-target.json +7 -7
  373. package/dist/lib/schemas-data/3.2/core/material-deadline.json +1 -1
  374. package/dist/lib/schemas-data/3.2/core/mcp-webhook-payload.json +6 -6
  375. package/dist/lib/schemas-data/3.2/core/measurement-readiness.json +5 -5
  376. package/dist/lib/schemas-data/3.2/core/measurement-terms.json +3 -3
  377. package/dist/lib/schemas-data/3.2/core/measurement-window.json +1 -1
  378. package/dist/lib/schemas-data/3.2/core/media-buy-available-action-id.json +2 -2
  379. package/dist/lib/schemas-data/3.2/core/media-buy-available-action.json +7 -7
  380. package/dist/lib/schemas-data/3.2/core/media-buy-change-term-id.json +1 -1
  381. package/dist/lib/schemas-data/3.2/core/media-buy-features.json +2 -2
  382. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-capability.json +3 -3
  383. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-requirement.json +3 -3
  384. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-support.json +3 -3
  385. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap.json +2 -2
  386. package/dist/lib/schemas-data/3.2/core/media-buy-legacy-terms-ref.json +1 -1
  387. package/dist/lib/schemas-data/3.2/core/media-buy-support-requirements.json +2 -2
  388. package/dist/lib/schemas-data/3.2/core/media-buy-support.json +3 -3
  389. package/dist/lib/schemas-data/3.2/core/media-buy.json +14 -14
  390. package/dist/lib/schemas-data/3.2/core/missing-metric.json +14 -14
  391. package/dist/lib/schemas-data/3.2/core/negative-keyword.json +2 -2
  392. package/dist/lib/schemas-data/3.2/core/notification-config.json +3 -3
  393. package/dist/lib/schemas-data/3.2/core/offering-asset-group.json +16 -16
  394. package/dist/lib/schemas-data/3.2/core/offering.json +5 -5
  395. package/dist/lib/schemas-data/3.2/core/operator-identity.json +2 -2
  396. package/dist/lib/schemas-data/3.2/core/operator-unit.json +1 -1
  397. package/dist/lib/schemas-data/3.2/core/opportunity-context.json +3 -3
  398. package/dist/lib/schemas-data/3.2/core/optimization-goal.json +9 -9
  399. package/dist/lib/schemas-data/3.2/core/outcome-measurement.json +2 -2
  400. package/dist/lib/schemas-data/3.2/core/outcome-target-cost-per.json +2 -2
  401. package/dist/lib/schemas-data/3.2/core/overlay.json +1 -1
  402. package/dist/lib/schemas-data/3.2/core/package-delivery-metric-value.json +2 -2
  403. package/dist/lib/schemas-data/3.2/core/package-format-snapshot.json +5 -5
  404. package/dist/lib/schemas-data/3.2/core/package-signal-targeting-group.json +2 -2
  405. package/dist/lib/schemas-data/3.2/core/package-signal-targeting-groups.json +2 -2
  406. package/dist/lib/schemas-data/3.2/core/package-signal-targeting.json +3 -3
  407. package/dist/lib/schemas-data/3.2/core/package-targeting-resolution.json +3 -3
  408. package/dist/lib/schemas-data/3.2/core/package.json +23 -23
  409. package/dist/lib/schemas-data/3.2/core/pagination-request.json +1 -1
  410. package/dist/lib/schemas-data/3.2/core/pagination-response.json +1 -1
  411. package/dist/lib/schemas-data/3.2/core/performance-feedback-assertion.json +8 -8
  412. package/dist/lib/schemas-data/3.2/core/performance-feedback-metric.json +14 -14
  413. package/dist/lib/schemas-data/3.2/core/performance-feedback.json +17 -17
  414. package/dist/lib/schemas-data/3.2/core/performance-standard.json +4 -4
  415. package/dist/lib/schemas-data/3.2/core/placement-definition.json +15 -15
  416. package/dist/lib/schemas-data/3.2/core/placement-delivery-metrics.json +3 -3
  417. package/dist/lib/schemas-data/3.2/core/placement-evidence.json +1 -1
  418. package/dist/lib/schemas-data/3.2/core/placement-identity.json +2 -2
  419. package/dist/lib/schemas-data/3.2/core/placement-presentation.json +1 -1
  420. package/dist/lib/schemas-data/3.2/core/placement-property-delivery-metrics.json +5 -5
  421. package/dist/lib/schemas-data/3.2/core/placement-ref.json +1 -1
  422. package/dist/lib/schemas-data/3.2/core/placement-selection.json +5 -5
  423. package/dist/lib/schemas-data/3.2/core/placement.json +10 -10
  424. package/dist/lib/schemas-data/3.2/core/planned-delivery.json +8 -8
  425. package/dist/lib/schemas-data/3.2/core/platform-extension-ref.json +1 -1
  426. package/dist/lib/schemas-data/3.2/core/positive-postal-area-support.json +2 -2
  427. package/dist/lib/schemas-data/3.2/core/postal-area-support.json +2 -2
  428. package/dist/lib/schemas-data/3.2/core/postal-area.json +4 -4
  429. package/dist/lib/schemas-data/3.2/core/postal-country-system.json +2 -2
  430. package/dist/lib/schemas-data/3.2/core/presentation-ref.json +1 -1
  431. package/dist/lib/schemas-data/3.2/core/preview-provider.json +1 -1
  432. package/dist/lib/schemas-data/3.2/core/preview-renderer-metadata.json +1 -1
  433. package/dist/lib/schemas-data/3.2/core/price.json +1 -1
  434. package/dist/lib/schemas-data/3.2/core/pricing-option.json +11 -11
  435. package/dist/lib/schemas-data/3.2/core/principal-changed-webhook.json +2 -2
  436. package/dist/lib/schemas-data/3.2/core/principal-declarations-state.json +3 -3
  437. package/dist/lib/schemas-data/3.2/core/principal-declarations.json +2 -2
  438. package/dist/lib/schemas-data/3.2/core/principal-state.json +4 -4
  439. package/dist/lib/schemas-data/3.2/core/product-allocation.json +5 -5
  440. package/dist/lib/schemas-data/3.2/core/product-allowed-action.json +6 -6
  441. package/dist/lib/schemas-data/3.2/core/product-audience-evidence-requirements.json +13 -13
  442. package/dist/lib/schemas-data/3.2/core/product-card-reference-asset.json +5 -5
  443. package/dist/lib/schemas-data/3.2/core/product-change-map.json +1 -1
  444. package/dist/lib/schemas-data/3.2/core/product-execution-requirement.json +7 -7
  445. package/dist/lib/schemas-data/3.2/core/product-filters.json +36 -36
  446. package/dist/lib/schemas-data/3.2/core/product-format-declaration.json +22 -22
  447. package/dist/lib/schemas-data/3.2/core/product-identity.json +1 -1
  448. package/dist/lib/schemas-data/3.2/core/product-offer-filters.json +26 -26
  449. package/dist/lib/schemas-data/3.2/core/product-signal-targeting-option.json +3 -3
  450. package/dist/lib/schemas-data/3.2/core/product-targeting-resolution.json +3 -3
  451. package/dist/lib/schemas-data/3.2/core/product.json +54 -54
  452. package/dist/lib/schemas-data/3.2/core/property-delivery-metrics.json +4 -4
  453. package/dist/lib/schemas-data/3.2/core/property-id.json +1 -1
  454. package/dist/lib/schemas-data/3.2/core/property-list-ref.json +1 -1
  455. package/dist/lib/schemas-data/3.2/core/property-ref.json +2 -2
  456. package/dist/lib/schemas-data/3.2/core/property-tag.json +1 -1
  457. package/dist/lib/schemas-data/3.2/core/property.json +6 -6
  458. package/dist/lib/schemas-data/3.2/core/proposal.json +9 -9
  459. package/dist/lib/schemas-data/3.2/core/protocol-envelope.json +5 -5
  460. package/dist/lib/schemas-data/3.2/core/provenance.json +9 -9
  461. package/dist/lib/schemas-data/3.2/core/publisher-property-selector.json +3 -3
  462. package/dist/lib/schemas-data/3.2/core/push-notification-config.json +2 -2
  463. package/dist/lib/schemas-data/3.2/core/real-estate-item.json +4 -4
  464. package/dist/lib/schemas-data/3.2/core/reference-asset.json +1 -1
  465. package/dist/lib/schemas-data/3.2/core/reference-renderer.json +1 -1
  466. package/dist/lib/schemas-data/3.2/core/registry-event.json +15 -15
  467. package/dist/lib/schemas-data/3.2/core/registry-feed-response.json +2 -2
  468. package/dist/lib/schemas-data/3.2/core/reporting-adjustment-receipt.json +1 -1
  469. package/dist/lib/schemas-data/3.2/core/reporting-adjustment.json +2 -2
  470. package/dist/lib/schemas-data/3.2/core/reporting-canonical-content-digest.json +1 -1
  471. package/dist/lib/schemas-data/3.2/core/reporting-canonicalization-contract.json +1 -1
  472. package/dist/lib/schemas-data/3.2/core/reporting-capabilities.json +12 -12
  473. package/dist/lib/schemas-data/3.2/core/reporting-consumer-status.json +1 -1
  474. package/dist/lib/schemas-data/3.2/core/reporting-control-total.json +1 -1
  475. package/dist/lib/schemas-data/3.2/core/reporting-coverage.json +1 -1
  476. package/dist/lib/schemas-data/3.2/core/reporting-dataset-share-destination.json +1 -1
  477. package/dist/lib/schemas-data/3.2/core/reporting-delivery-capabilities.json +3 -3
  478. package/dist/lib/schemas-data/3.2/core/reporting-delivery-config-state.json +4 -4
  479. package/dist/lib/schemas-data/3.2/core/reporting-delivery-config.json +7 -7
  480. package/dist/lib/schemas-data/3.2/core/reporting-delivery-method.json +4 -4
  481. package/dist/lib/schemas-data/3.2/core/reporting-delivery-offering-id.json +1 -1
  482. package/dist/lib/schemas-data/3.2/core/reporting-delivery-offering.json +8 -8
  483. package/dist/lib/schemas-data/3.2/core/reporting-delivery-ready-webhook.json +3 -3
  484. package/dist/lib/schemas-data/3.2/core/reporting-file-compression.json +1 -1
  485. package/dist/lib/schemas-data/3.2/core/reporting-file-entry.json +3 -3
  486. package/dist/lib/schemas-data/3.2/core/reporting-file-manifest.json +4 -4
  487. package/dist/lib/schemas-data/3.2/core/reporting-file-object-ref.json +1 -1
  488. package/dist/lib/schemas-data/3.2/core/reporting-ledger-changed-webhook.json +3 -3
  489. package/dist/lib/schemas-data/3.2/core/reporting-materialization.json +4 -4
  490. package/dist/lib/schemas-data/3.2/core/reporting-native-version-ref.json +1 -1
  491. package/dist/lib/schemas-data/3.2/core/reporting-obligation.json +9 -9
  492. package/dist/lib/schemas-data/3.2/core/reporting-receipt.json +5 -5
  493. package/dist/lib/schemas-data/3.2/core/reporting-reconciliation-mode.json +1 -1
  494. package/dist/lib/schemas-data/3.2/core/reporting-reliability-statistics.json +1 -1
  495. package/dist/lib/schemas-data/3.2/core/reporting-report-definition.json +1 -1
  496. package/dist/lib/schemas-data/3.2/core/reporting-resource.json +2 -2
  497. package/dist/lib/schemas-data/3.2/core/reporting-revision.json +6 -6
  498. package/dist/lib/schemas-data/3.2/core/reporting-schedule-offering.json +2 -2
  499. package/dist/lib/schemas-data/3.2/core/reporting-schedule.json +1 -1
  500. package/dist/lib/schemas-data/3.2/core/reporting-status-changed-webhook.json +5 -5
  501. package/dist/lib/schemas-data/3.2/core/reporting-status-issue.json +4 -4
  502. package/dist/lib/schemas-data/3.2/core/reporting-verification-profile-set.json +1 -1
  503. package/dist/lib/schemas-data/3.2/core/reporting-verification-profile.json +1 -1
  504. package/dist/lib/schemas-data/3.2/core/reporting-verification.json +7 -7
  505. package/dist/lib/schemas-data/3.2/core/reporting-webhook.json +3 -3
  506. package/dist/lib/schemas-data/3.2/core/reporting-write-destination.json +1 -1
  507. package/dist/lib/schemas-data/3.2/core/representation-destination.json +5 -5
  508. package/dist/lib/schemas-data/3.2/core/representation-rejection.json +1 -1
  509. package/dist/lib/schemas-data/3.2/core/representation-selection.json +5 -5
  510. package/dist/lib/schemas-data/3.2/core/requirements/asset-requirements.json +13 -13
  511. package/dist/lib/schemas-data/3.2/core/requirements/audio-asset-requirements.json +1 -1
  512. package/dist/lib/schemas-data/3.2/core/requirements/catalog-field-binding.json +4 -4
  513. package/dist/lib/schemas-data/3.2/core/requirements/catalog-requirements.json +5 -5
  514. package/dist/lib/schemas-data/3.2/core/requirements/css-asset-requirements.json +1 -1
  515. package/dist/lib/schemas-data/3.2/core/requirements/daast-asset-requirements.json +3 -3
  516. package/dist/lib/schemas-data/3.2/core/requirements/html-asset-requirements.json +1 -1
  517. package/dist/lib/schemas-data/3.2/core/requirements/image-asset-requirements.json +2 -2
  518. package/dist/lib/schemas-data/3.2/core/requirements/javascript-asset-requirements.json +1 -1
  519. package/dist/lib/schemas-data/3.2/core/requirements/markdown-asset-requirements.json +1 -1
  520. package/dist/lib/schemas-data/3.2/core/requirements/offering-asset-constraint.json +4 -4
  521. package/dist/lib/schemas-data/3.2/core/requirements/text-asset-requirements.json +1 -1
  522. package/dist/lib/schemas-data/3.2/core/requirements/url-asset-requirements.json +1 -1
  523. package/dist/lib/schemas-data/3.2/core/requirements/vast-asset-requirements.json +4 -4
  524. package/dist/lib/schemas-data/3.2/core/requirements/video-asset-requirements.json +6 -6
  525. package/dist/lib/schemas-data/3.2/core/requirements/webhook-asset-requirements.json +1 -1
  526. package/dist/lib/schemas-data/3.2/core/response-payload-jws-envelope.json +1 -1
  527. package/dist/lib/schemas-data/3.2/core/response.json +1 -1
  528. package/dist/lib/schemas-data/3.2/core/rights-attestation-evaluation.json +5 -5
  529. package/dist/lib/schemas-data/3.2/core/rights-constraint.json +7 -7
  530. package/dist/lib/schemas-data/3.2/core/seller-agent-ref.json +1 -1
  531. package/dist/lib/schemas-data/3.2/core/signal-coverage-forecast.json +5 -5
  532. package/dist/lib/schemas-data/3.2/core/signal-definition-enrichment.json +5 -5
  533. package/dist/lib/schemas-data/3.2/core/signal-definition.json +8 -8
  534. package/dist/lib/schemas-data/3.2/core/signal-filters.json +3 -3
  535. package/dist/lib/schemas-data/3.2/core/signal-id.json +1 -1
  536. package/dist/lib/schemas-data/3.2/core/signal-listing.json +6 -6
  537. package/dist/lib/schemas-data/3.2/core/signal-modeling-disclosure.json +1 -1
  538. package/dist/lib/schemas-data/3.2/core/signal-pricing-option.json +2 -2
  539. package/dist/lib/schemas-data/3.2/core/signal-pricing.json +6 -6
  540. package/dist/lib/schemas-data/3.2/core/signal-ref.json +1 -1
  541. package/dist/lib/schemas-data/3.2/core/signal-selection-group-rule.json +1 -1
  542. package/dist/lib/schemas-data/3.2/core/signal-targeting-expression.json +4 -4
  543. package/dist/lib/schemas-data/3.2/core/signal-targeting-rules.json +2 -2
  544. package/dist/lib/schemas-data/3.2/core/signal-targeting.json +7 -7
  545. package/dist/lib/schemas-data/3.2/core/sla-window.json +1 -1
  546. package/dist/lib/schemas-data/3.2/core/special.json +2 -2
  547. package/dist/lib/schemas-data/3.2/core/spot-reporting-capability.json +2 -2
  548. package/dist/lib/schemas-data/3.2/core/start-timing.json +1 -1
  549. package/dist/lib/schemas-data/3.2/core/store-item.json +3 -3
  550. package/dist/lib/schemas-data/3.2/core/talent.json +2 -2
  551. package/dist/lib/schemas-data/3.2/core/targeting-input.json +40 -40
  552. package/dist/lib/schemas-data/3.2/core/targeting-modification.json +3 -3
  553. package/dist/lib/schemas-data/3.2/core/targeting-overlay-requirements.json +15 -15
  554. package/dist/lib/schemas-data/3.2/core/targeting-overlay-support.json +25 -25
  555. package/dist/lib/schemas-data/3.2/core/targeting-unknown-age-eligibility-constraint.json +1 -1
  556. package/dist/lib/schemas-data/3.2/core/targeting-verified-age-basis-constraint.json +1 -1
  557. package/dist/lib/schemas-data/3.2/core/targeting.json +34 -34
  558. package/dist/lib/schemas-data/3.2/core/tasks-get-request.json +5 -5
  559. package/dist/lib/schemas-data/3.2/core/tasks-get-response.json +10 -10
  560. package/dist/lib/schemas-data/3.2/core/tasks-list-request.json +13 -13
  561. package/dist/lib/schemas-data/3.2/core/tasks-list-response.json +8 -8
  562. package/dist/lib/schemas-data/3.2/core/tracker-execution-contract.json +2 -2
  563. package/dist/lib/schemas-data/3.2/core/tracker-execution-selector.json +18 -18
  564. package/dist/lib/schemas-data/3.2/core/transformer-param.json +1 -1
  565. package/dist/lib/schemas-data/3.2/core/transformer.json +6 -6
  566. package/dist/lib/schemas-data/3.2/core/truncation-sentinel.json +1 -1
  567. package/dist/lib/schemas-data/3.2/core/user-match.json +3 -3
  568. package/dist/lib/schemas-data/3.2/core/vast-media-file-requirements.json +2 -2
  569. package/dist/lib/schemas-data/3.2/core/vast-tracker-constraints.json +2 -2
  570. package/dist/lib/schemas-data/3.2/core/vehicle-item.json +4 -4
  571. package/dist/lib/schemas-data/3.2/core/vendor-metric-id.json +1 -1
  572. package/dist/lib/schemas-data/3.2/core/vendor-metric-optimization-supported-metric.json +3 -3
  573. package/dist/lib/schemas-data/3.2/core/vendor-metric-optimization.json +2 -2
  574. package/dist/lib/schemas-data/3.2/core/vendor-metric-value.json +9 -9
  575. package/dist/lib/schemas-data/3.2/core/vendor-pricing-option.json +3 -3
  576. package/dist/lib/schemas-data/3.2/core/verification-token-claims.json +1 -1
  577. package/dist/lib/schemas-data/3.2/core/version-envelope.json +1 -1
  578. package/dist/lib/schemas-data/3.2/core/warning-resource.json +1 -1
  579. package/dist/lib/schemas-data/3.2/core/warning.json +4 -4
  580. package/dist/lib/schemas-data/3.2/core/webhook-activity-record.json +3 -3
  581. package/dist/lib/schemas-data/3.2/core/webhook-challenge-response.json +1 -1
  582. package/dist/lib/schemas-data/3.2/core/webhook-challenge.json +2 -2
  583. package/dist/lib/schemas-data/3.2/core/wholesale-feed-event.json +20 -20
  584. package/dist/lib/schemas-data/3.2/core/wholesale-feed-webhook.json +3 -3
  585. package/dist/lib/schemas-data/3.2/core/x-entity-types.json +1 -1
  586. package/dist/lib/schemas-data/3.2/creative/asset-types/index.json +6 -6
  587. package/dist/lib/schemas-data/3.2/creative/audit-observation.json +2 -2
  588. package/dist/lib/schemas-data/3.2/creative/creative-assignment-changed-webhook.json +2 -2
  589. package/dist/lib/schemas-data/3.2/creative/creative-feature-result.json +2 -2
  590. package/dist/lib/schemas-data/3.2/creative/creative-purged-webhook.json +3 -3
  591. package/dist/lib/schemas-data/3.2/creative/creative-status-changed-webhook.json +5 -5
  592. package/dist/lib/schemas-data/3.2/creative/get-creative-delivery-request.json +6 -6
  593. package/dist/lib/schemas-data/3.2/creative/get-creative-delivery-response.json +11 -11
  594. package/dist/lib/schemas-data/3.2/creative/get-creative-features-async-response-submitted.json +3 -3
  595. package/dist/lib/schemas-data/3.2/creative/get-creative-features-request.json +7 -7
  596. package/dist/lib/schemas-data/3.2/creative/get-creative-features-response.json +9 -9
  597. package/dist/lib/schemas-data/3.2/creative/get-creative-features-terminal-success.json +6 -6
  598. package/dist/lib/schemas-data/3.2/creative/list-creative-formats-request.json +13 -13
  599. package/dist/lib/schemas-data/3.2/creative/list-creative-formats-response.json +9 -9
  600. package/dist/lib/schemas-data/3.2/creative/list-creatives-request.json +9 -9
  601. package/dist/lib/schemas-data/3.2/creative/list-creatives-response.json +34 -34
  602. package/dist/lib/schemas-data/3.2/creative/list-transformers-request.json +9 -9
  603. package/dist/lib/schemas-data/3.2/creative/list-transformers-response.json +8 -8
  604. package/dist/lib/schemas-data/3.2/creative/preview-creative-request.json +13 -13
  605. package/dist/lib/schemas-data/3.2/creative/preview-creative-response.json +18 -18
  606. package/dist/lib/schemas-data/3.2/creative/preview-render.json +4 -4
  607. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-input-required.json +3 -3
  608. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-submitted.json +4 -4
  609. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-working.json +3 -3
  610. package/dist/lib/schemas-data/3.2/creative/sync-creatives-request.json +10 -10
  611. package/dist/lib/schemas-data/3.2/creative/sync-creatives-response.json +18 -18
  612. package/dist/lib/schemas-data/3.2/creative/validate-input-request.json +4 -4
  613. package/dist/lib/schemas-data/3.2/creative/validate-input-response.json +4 -4
  614. package/dist/lib/schemas-data/3.2/creative/validate-input-result.json +2 -2
  615. package/dist/lib/schemas-data/3.2/creative/video-brief.json +1 -1
  616. package/dist/lib/schemas-data/3.2/enums/account-currency-mode.json +1 -1
  617. package/dist/lib/schemas-data/3.2/enums/account-scope.json +1 -1
  618. package/dist/lib/schemas-data/3.2/enums/account-status.json +1 -1
  619. package/dist/lib/schemas-data/3.2/enums/action-not-allowed-reason.json +1 -1
  620. package/dist/lib/schemas-data/3.2/enums/action-source.json +1 -1
  621. package/dist/lib/schemas-data/3.2/enums/activation-method.json +1 -1
  622. package/dist/lib/schemas-data/3.2/enums/adcp-protocol.json +1 -1
  623. package/dist/lib/schemas-data/3.2/enums/adjustment-kind.json +1 -1
  624. package/dist/lib/schemas-data/3.2/enums/advertiser-industry.json +1 -1
  625. package/dist/lib/schemas-data/3.2/enums/age-determination-basis.json +1 -1
  626. package/dist/lib/schemas-data/3.2/enums/age-verification-method.json +1 -1
  627. package/dist/lib/schemas-data/3.2/enums/assessment-status.json +1 -1
  628. package/dist/lib/schemas-data/3.2/enums/asset-content-type.json +1 -1
  629. package/dist/lib/schemas-data/3.2/enums/attestation-claim.json +1 -1
  630. package/dist/lib/schemas-data/3.2/enums/attribution-methodology.json +1 -1
  631. package/dist/lib/schemas-data/3.2/enums/attribution-model.json +1 -1
  632. package/dist/lib/schemas-data/3.2/enums/audience-evidence-methodology.json +1 -1
  633. package/dist/lib/schemas-data/3.2/enums/audience-resolution-method.json +1 -1
  634. package/dist/lib/schemas-data/3.2/enums/audience-source.json +1 -1
  635. package/dist/lib/schemas-data/3.2/enums/audience-status.json +1 -1
  636. package/dist/lib/schemas-data/3.2/enums/audience-subject-type.json +1 -1
  637. package/dist/lib/schemas-data/3.2/enums/audio-channel-layout.json +1 -1
  638. package/dist/lib/schemas-data/3.2/enums/audio-distribution-type.json +1 -1
  639. package/dist/lib/schemas-data/3.2/enums/auth-scheme.json +1 -1
  640. package/dist/lib/schemas-data/3.2/enums/availability-status.json +1 -1
  641. package/dist/lib/schemas-data/3.2/enums/available-metric.json +1 -1
  642. package/dist/lib/schemas-data/3.2/enums/billing-party.json +1 -1
  643. package/dist/lib/schemas-data/3.2/enums/binary-verdict.json +1 -1
  644. package/dist/lib/schemas-data/3.2/enums/brand-agent-type.json +1 -1
  645. package/dist/lib/schemas-data/3.2/enums/browser-family.json +1 -1
  646. package/dist/lib/schemas-data/3.2/enums/c2pa-watermark-action.json +1 -1
  647. package/dist/lib/schemas-data/3.2/enums/canceled-by.json +1 -1
  648. package/dist/lib/schemas-data/3.2/enums/canonical-media-buy-action-mode.json +1 -1
  649. package/dist/lib/schemas-data/3.2/enums/canonical-media-buy-action.json +1 -1
  650. package/dist/lib/schemas-data/3.2/enums/catalog-action.json +1 -1
  651. package/dist/lib/schemas-data/3.2/enums/catalog-item-status.json +1 -1
  652. package/dist/lib/schemas-data/3.2/enums/catalog-type.json +1 -1
  653. package/dist/lib/schemas-data/3.2/enums/channels.json +1 -1
  654. package/dist/lib/schemas-data/3.2/enums/cloud-storage-protocol.json +1 -1
  655. package/dist/lib/schemas-data/3.2/enums/co-branding-requirement.json +1 -1
  656. package/dist/lib/schemas-data/3.2/enums/collection-cadence.json +1 -1
  657. package/dist/lib/schemas-data/3.2/enums/collection-kind.json +1 -1
  658. package/dist/lib/schemas-data/3.2/enums/collection-relationship.json +1 -1
  659. package/dist/lib/schemas-data/3.2/enums/collection-status.json +1 -1
  660. package/dist/lib/schemas-data/3.2/enums/completion-source.json +1 -1
  661. package/dist/lib/schemas-data/3.2/enums/consent-basis.json +1 -1
  662. package/dist/lib/schemas-data/3.2/enums/content-id-type.json +1 -1
  663. package/dist/lib/schemas-data/3.2/enums/content-rating-system.json +1 -1
  664. package/dist/lib/schemas-data/3.2/enums/creative-action.json +1 -1
  665. package/dist/lib/schemas-data/3.2/enums/creative-agent-capability.json +1 -1
  666. package/dist/lib/schemas-data/3.2/enums/creative-approval-status.json +1 -1
  667. package/dist/lib/schemas-data/3.2/enums/creative-event-reason-code.json +1 -1
  668. package/dist/lib/schemas-data/3.2/enums/creative-identifier-type.json +1 -1
  669. package/dist/lib/schemas-data/3.2/enums/creative-quality.json +1 -1
  670. package/dist/lib/schemas-data/3.2/enums/creative-selection-strategy.json +1 -1
  671. package/dist/lib/schemas-data/3.2/enums/creative-sort-field.json +1 -1
  672. package/dist/lib/schemas-data/3.2/enums/creative-status.json +1 -1
  673. package/dist/lib/schemas-data/3.2/enums/ctv-ad-experience.json +1 -1
  674. package/dist/lib/schemas-data/3.2/enums/daast-tracking-event.json +1 -1
  675. package/dist/lib/schemas-data/3.2/enums/daast-version.json +1 -1
  676. package/dist/lib/schemas-data/3.2/enums/day-of-week.json +1 -1
  677. package/dist/lib/schemas-data/3.2/enums/daypart-timezone-mode.json +1 -1
  678. package/dist/lib/schemas-data/3.2/enums/delegation-authority.json +1 -1
  679. package/dist/lib/schemas-data/3.2/enums/delivery-recipient-cloud.json +1 -1
  680. package/dist/lib/schemas-data/3.2/enums/delivery-status.json +1 -1
  681. package/dist/lib/schemas-data/3.2/enums/delivery-type.json +1 -1
  682. package/dist/lib/schemas-data/3.2/enums/demographic-system.json +1 -1
  683. package/dist/lib/schemas-data/3.2/enums/derivative-type.json +1 -1
  684. package/dist/lib/schemas-data/3.2/enums/device-platform.json +1 -1
  685. package/dist/lib/schemas-data/3.2/enums/device-type.json +1 -1
  686. package/dist/lib/schemas-data/3.2/enums/digital-source-type.json +1 -1
  687. package/dist/lib/schemas-data/3.2/enums/dimension-unit.json +1 -1
  688. package/dist/lib/schemas-data/3.2/enums/disclosure-persistence.json +1 -1
  689. package/dist/lib/schemas-data/3.2/enums/disclosure-position.json +1 -1
  690. package/dist/lib/schemas-data/3.2/enums/distance-unit.json +1 -1
  691. package/dist/lib/schemas-data/3.2/enums/distribution-identifier-type.json +1 -1
  692. package/dist/lib/schemas-data/3.2/enums/dooh-motion-type.json +1 -1
  693. package/dist/lib/schemas-data/3.2/enums/embedded-provenance-method.json +1 -1
  694. package/dist/lib/schemas-data/3.2/enums/error-code.json +1 -1
  695. package/dist/lib/schemas-data/3.2/enums/error-scope.json +1 -1
  696. package/dist/lib/schemas-data/3.2/enums/escalation-severity.json +1 -1
  697. package/dist/lib/schemas-data/3.2/enums/event-type.json +1 -1
  698. package/dist/lib/schemas-data/3.2/enums/exclusivity.json +1 -1
  699. package/dist/lib/schemas-data/3.2/enums/feature-check-status.json +1 -1
  700. package/dist/lib/schemas-data/3.2/enums/feed-format.json +1 -1
  701. package/dist/lib/schemas-data/3.2/enums/feedback-source.json +1 -1
  702. package/dist/lib/schemas-data/3.2/enums/forecast-method.json +1 -1
  703. package/dist/lib/schemas-data/3.2/enums/forecast-range-unit.json +1 -1
  704. package/dist/lib/schemas-data/3.2/enums/forecastable-metric.json +1 -1
  705. package/dist/lib/schemas-data/3.2/enums/format-id-parameter.json +1 -1
  706. package/dist/lib/schemas-data/3.2/enums/frame-rate-type.json +1 -1
  707. package/dist/lib/schemas-data/3.2/enums/frequency-cap-control-mode.json +1 -1
  708. package/dist/lib/schemas-data/3.2/enums/frequency-cap-mutable-field.json +1 -1
  709. package/dist/lib/schemas-data/3.2/enums/frequency-cap-scope.json +1 -1
  710. package/dist/lib/schemas-data/3.2/enums/genre-taxonomy.json +1 -1
  711. package/dist/lib/schemas-data/3.2/enums/geo-level.json +1 -1
  712. package/dist/lib/schemas-data/3.2/enums/gop-type.json +1 -1
  713. package/dist/lib/schemas-data/3.2/enums/governance-decision.json +1 -1
  714. package/dist/lib/schemas-data/3.2/enums/governance-domain.json +1 -1
  715. package/dist/lib/schemas-data/3.2/enums/governance-mode.json +1 -1
  716. package/dist/lib/schemas-data/3.2/enums/governance-phase.json +1 -1
  717. package/dist/lib/schemas-data/3.2/enums/history-entry-type.json +1 -1
  718. package/dist/lib/schemas-data/3.2/enums/http-method.json +1 -1
  719. package/dist/lib/schemas-data/3.2/enums/identifier-types.json +1 -1
  720. package/dist/lib/schemas-data/3.2/enums/impairment-offline-state.json +1 -1
  721. package/dist/lib/schemas-data/3.2/enums/impairment-reason-code.json +1 -1
  722. package/dist/lib/schemas-data/3.2/enums/indicator-type.json +1 -1
  723. package/dist/lib/schemas-data/3.2/enums/installment-status.json +1 -1
  724. package/dist/lib/schemas-data/3.2/enums/javascript-module-type.json +1 -1
  725. package/dist/lib/schemas-data/3.2/enums/landing-page-requirement.json +1 -1
  726. package/dist/lib/schemas-data/3.2/enums/legacy-postal-system.json +1 -1
  727. package/dist/lib/schemas-data/3.2/enums/lift-dimension.json +1 -1
  728. package/dist/lib/schemas-data/3.2/enums/logo-slot.json +1 -1
  729. package/dist/lib/schemas-data/3.2/enums/macro-dialect.json +1 -1
  730. package/dist/lib/schemas-data/3.2/enums/macro-mapping-status.json +1 -1
  731. package/dist/lib/schemas-data/3.2/enums/macro-processing-operation.json +1 -1
  732. package/dist/lib/schemas-data/3.2/enums/macro-resolution-reason.json +1 -1
  733. package/dist/lib/schemas-data/3.2/enums/macro-resolver.json +1 -1
  734. package/dist/lib/schemas-data/3.2/enums/macro-value-context.json +1 -1
  735. package/dist/lib/schemas-data/3.2/enums/makegood-remedy.json +1 -1
  736. package/dist/lib/schemas-data/3.2/enums/markdown-flavor.json +1 -1
  737. package/dist/lib/schemas-data/3.2/enums/match-id-type.json +1 -1
  738. package/dist/lib/schemas-data/3.2/enums/match-type.json +1 -1
  739. package/dist/lib/schemas-data/3.2/enums/media-buy-action-mode.json +1 -1
  740. package/dist/lib/schemas-data/3.2/enums/media-buy-frequency-cap-control-mode.json +1 -1
  741. package/dist/lib/schemas-data/3.2/enums/media-buy-health.json +1 -1
  742. package/dist/lib/schemas-data/3.2/enums/media-buy-status.json +1 -1
  743. package/dist/lib/schemas-data/3.2/enums/media-buy-valid-action.json +1 -1
  744. package/dist/lib/schemas-data/3.2/enums/metric-scope.json +1 -1
  745. package/dist/lib/schemas-data/3.2/enums/metric-type.json +1 -1
  746. package/dist/lib/schemas-data/3.2/enums/metro-system.json +1 -1
  747. package/dist/lib/schemas-data/3.2/enums/moov-atom-position.json +1 -1
  748. package/dist/lib/schemas-data/3.2/enums/motion-level.json +1 -1
  749. package/dist/lib/schemas-data/3.2/enums/notification-type.json +1 -1
  750. package/dist/lib/schemas-data/3.2/enums/offering-availability-status.json +1 -1
  751. package/dist/lib/schemas-data/3.2/enums/outcome-target-cost-strength.json +1 -1
  752. package/dist/lib/schemas-data/3.2/enums/outcome-type.json +1 -1
  753. package/dist/lib/schemas-data/3.2/enums/pacing.json +1 -1
  754. package/dist/lib/schemas-data/3.2/enums/payment-terms.json +1 -1
  755. package/dist/lib/schemas-data/3.2/enums/performance-baseline.json +1 -1
  756. package/dist/lib/schemas-data/3.2/enums/performance-standard-metric.json +1 -1
  757. package/dist/lib/schemas-data/3.2/enums/pixel-tracking-event.json +1 -1
  758. package/dist/lib/schemas-data/3.2/enums/policy-category.json +1 -1
  759. package/dist/lib/schemas-data/3.2/enums/policy-enforcement.json +1 -1
  760. package/dist/lib/schemas-data/3.2/enums/postal-system.json +1 -1
  761. package/dist/lib/schemas-data/3.2/enums/preview-output-format.json +1 -1
  762. package/dist/lib/schemas-data/3.2/enums/pricing-model.json +1 -1
  763. package/dist/lib/schemas-data/3.2/enums/pricing-structure.json +1 -1
  764. package/dist/lib/schemas-data/3.2/enums/principal-kind.json +1 -1
  765. package/dist/lib/schemas-data/3.2/enums/production-quality.json +1 -1
  766. package/dist/lib/schemas-data/3.2/enums/property-type.json +1 -1
  767. package/dist/lib/schemas-data/3.2/enums/proposal-decline-reason.json +1 -1
  768. package/dist/lib/schemas-data/3.2/enums/proposal-refinement-reason.json +1 -1
  769. package/dist/lib/schemas-data/3.2/enums/proposal-status.json +1 -1
  770. package/dist/lib/schemas-data/3.2/enums/publisher-identifier-types.json +1 -1
  771. package/dist/lib/schemas-data/3.2/enums/purchase-type.json +1 -1
  772. package/dist/lib/schemas-data/3.2/enums/reach-aggregation.json +1 -1
  773. package/dist/lib/schemas-data/3.2/enums/reach-unit.json +1 -1
  774. package/dist/lib/schemas-data/3.2/enums/reporting-destination-setup-state.json +1 -1
  775. package/dist/lib/schemas-data/3.2/enums/reporting-finality.json +1 -1
  776. package/dist/lib/schemas-data/3.2/enums/reporting-frequency.json +1 -1
  777. package/dist/lib/schemas-data/3.2/enums/reporting-health.json +1 -1
  778. package/dist/lib/schemas-data/3.2/enums/representation-selection-strategy.json +1 -1
  779. package/dist/lib/schemas-data/3.2/enums/request-signing-error-code.json +1 -1
  780. package/dist/lib/schemas-data/3.2/enums/response-type.json +1 -1
  781. package/dist/lib/schemas-data/3.2/enums/restricted-attribute.json +1 -1
  782. package/dist/lib/schemas-data/3.2/enums/right-type.json +1 -1
  783. package/dist/lib/schemas-data/3.2/enums/right-use.json +1 -1
  784. package/dist/lib/schemas-data/3.2/enums/rights-billing-period.json +1 -1
  785. package/dist/lib/schemas-data/3.2/enums/scan-type.json +1 -1
  786. package/dist/lib/schemas-data/3.2/enums/seller-policy-decline-reason.json +1 -1
  787. package/dist/lib/schemas-data/3.2/enums/si-session-status.json +1 -1
  788. package/dist/lib/schemas-data/3.2/enums/signal-catalog-type.json +1 -1
  789. package/dist/lib/schemas-data/3.2/enums/signal-source.json +1 -1
  790. package/dist/lib/schemas-data/3.2/enums/signal-value-type.json +1 -1
  791. package/dist/lib/schemas-data/3.2/enums/snapshot-unavailable-reason.json +1 -1
  792. package/dist/lib/schemas-data/3.2/enums/social-placement-surface.json +1 -1
  793. package/dist/lib/schemas-data/3.2/enums/sort-direction.json +1 -1
  794. package/dist/lib/schemas-data/3.2/enums/sort-metric.json +1 -1
  795. package/dist/lib/schemas-data/3.2/enums/special-category.json +1 -1
  796. package/dist/lib/schemas-data/3.2/enums/specialism.json +1 -1
  797. package/dist/lib/schemas-data/3.2/enums/sponsored-placement-type.json +1 -1
  798. package/dist/lib/schemas-data/3.2/enums/talent-role.json +1 -1
  799. package/dist/lib/schemas-data/3.2/enums/task-status.json +1 -1
  800. package/dist/lib/schemas-data/3.2/enums/task-type.json +1 -1
  801. package/dist/lib/schemas-data/3.2/enums/tracker-execution-actor.json +1 -1
  802. package/dist/lib/schemas-data/3.2/enums/tracker-firing-path.json +1 -1
  803. package/dist/lib/schemas-data/3.2/enums/transport-mode.json +1 -1
  804. package/dist/lib/schemas-data/3.2/enums/travel-time-unit.json +1 -1
  805. package/dist/lib/schemas-data/3.2/enums/uid-type.json +1 -1
  806. package/dist/lib/schemas-data/3.2/enums/universal-macro.json +1 -1
  807. package/dist/lib/schemas-data/3.2/enums/update-frequency.json +1 -1
  808. package/dist/lib/schemas-data/3.2/enums/url-asset-type.json +1 -1
  809. package/dist/lib/schemas-data/3.2/enums/validation-mode.json +1 -1
  810. package/dist/lib/schemas-data/3.2/enums/vast-media-delivery-method.json +1 -1
  811. package/dist/lib/schemas-data/3.2/enums/vast-tracking-event.json +1 -1
  812. package/dist/lib/schemas-data/3.2/enums/vast-version.json +1 -1
  813. package/dist/lib/schemas-data/3.2/enums/vendor-relationship.json +1 -1
  814. package/dist/lib/schemas-data/3.2/enums/video-placement-type.json +1 -1
  815. package/dist/lib/schemas-data/3.2/enums/view-threshold-basis.json +1 -1
  816. package/dist/lib/schemas-data/3.2/enums/viewability-standard.json +1 -1
  817. package/dist/lib/schemas-data/3.2/enums/warning-code.json +1 -1
  818. package/dist/lib/schemas-data/3.2/enums/watermark-media-type.json +1 -1
  819. package/dist/lib/schemas-data/3.2/enums/wcag-level.json +1 -1
  820. package/dist/lib/schemas-data/3.2/enums/webhook-response-type.json +1 -1
  821. package/dist/lib/schemas-data/3.2/enums/webhook-security-method.json +1 -1
  822. package/dist/lib/schemas-data/3.2/error-details/accessibility-violation.json +1 -1
  823. package/dist/lib/schemas-data/3.2/error-details/account-moved.json +2 -2
  824. package/dist/lib/schemas-data/3.2/error-details/account-setup-required.json +1 -1
  825. package/dist/lib/schemas-data/3.2/error-details/action-not-allowed.json +5 -5
  826. package/dist/lib/schemas-data/3.2/error-details/agent-permission-denied.json +1 -1
  827. package/dist/lib/schemas-data/3.2/error-details/audience-too-small.json +1 -1
  828. package/dist/lib/schemas-data/3.2/error-details/authorization-required.json +3 -3
  829. package/dist/lib/schemas-data/3.2/error-details/billing-not-permitted-for-agent.json +3 -3
  830. package/dist/lib/schemas-data/3.2/error-details/billing-not-supported.json +2 -2
  831. package/dist/lib/schemas-data/3.2/error-details/budget-too-low.json +1 -1
  832. package/dist/lib/schemas-data/3.2/error-details/conflict.json +1 -1
  833. package/dist/lib/schemas-data/3.2/error-details/creative-rejected.json +1 -1
  834. package/dist/lib/schemas-data/3.2/error-details/creative-representation-unresolved.json +2 -2
  835. package/dist/lib/schemas-data/3.2/error-details/creative-revision-content-mismatch.json +2 -2
  836. package/dist/lib/schemas-data/3.2/error-details/execution-requirement-unmet.json +2 -2
  837. package/dist/lib/schemas-data/3.2/error-details/governance-agent-not-accepted.json +2 -2
  838. package/dist/lib/schemas-data/3.2/error-details/macro-resolution-failed.json +2 -2
  839. package/dist/lib/schemas-data/3.2/error-details/policy-violation.json +1 -1
  840. package/dist/lib/schemas-data/3.2/error-details/rate-limited.json +1 -1
  841. package/dist/lib/schemas-data/3.2/error-details/requote-required.json +3 -3
  842. package/dist/lib/schemas-data/3.2/error-details/stale-response.json +1 -1
  843. package/dist/lib/schemas-data/3.2/error-details/unsupported-refinement-dimension.json +1 -1
  844. package/dist/lib/schemas-data/3.2/error-details/vast-version-mismatch.json +6 -6
  845. package/dist/lib/schemas-data/3.2/error-details/vendor-error-codes.json +1 -1
  846. package/dist/lib/schemas-data/3.2/error-details/version-unsupported.json +2 -2
  847. package/dist/lib/schemas-data/3.2/extensions/extension-meta.json +1 -1
  848. package/dist/lib/schemas-data/3.2/extensions/index.json +2 -2
  849. package/dist/lib/schemas-data/3.2/formats/canonical/_base.json +5 -5
  850. package/dist/lib/schemas-data/3.2/formats/canonical/agent_placement.json +2 -2
  851. package/dist/lib/schemas-data/3.2/formats/canonical/audio_daast.json +4 -4
  852. package/dist/lib/schemas-data/3.2/formats/canonical/audio_hosted.json +2 -2
  853. package/dist/lib/schemas-data/3.2/formats/canonical/audio_vast.json +5 -5
  854. package/dist/lib/schemas-data/3.2/formats/canonical/coordinated_placements.json +18 -18
  855. package/dist/lib/schemas-data/3.2/formats/canonical/display_tag.json +2 -2
  856. package/dist/lib/schemas-data/3.2/formats/canonical/html5.json +2 -2
  857. package/dist/lib/schemas-data/3.2/formats/canonical/image.json +5 -5
  858. package/dist/lib/schemas-data/3.2/formats/canonical/image_carousel.json +2 -2
  859. package/dist/lib/schemas-data/3.2/formats/canonical/native_in_feed.json +5 -5
  860. package/dist/lib/schemas-data/3.2/formats/canonical/responsive_creative.json +2 -2
  861. package/dist/lib/schemas-data/3.2/formats/canonical/seller_rendered_stateful_display.json +3 -3
  862. package/dist/lib/schemas-data/3.2/formats/canonical/sponsored_placement.json +4 -4
  863. package/dist/lib/schemas-data/3.2/formats/canonical/video_hosted.json +3 -3
  864. package/dist/lib/schemas-data/3.2/formats/canonical/video_vast.json +8 -8
  865. package/dist/lib/schemas-data/3.2/governance/accepted-governance-agents.json +1 -1
  866. package/dist/lib/schemas-data/3.2/governance/attribute-definition.json +1 -1
  867. package/dist/lib/schemas-data/3.2/governance/audience-constraints.json +3 -3
  868. package/dist/lib/schemas-data/3.2/governance/check-governance-request.json +10 -10
  869. package/dist/lib/schemas-data/3.2/governance/check-governance-response.json +8 -8
  870. package/dist/lib/schemas-data/3.2/governance/get-plan-audit-logs-request.json +5 -5
  871. package/dist/lib/schemas-data/3.2/governance/get-plan-audit-logs-response.json +14 -14
  872. package/dist/lib/schemas-data/3.2/governance/policy-category-definition.json +2 -2
  873. package/dist/lib/schemas-data/3.2/governance/policy-entry.json +7 -7
  874. package/dist/lib/schemas-data/3.2/governance/policy-ref.json +1 -1
  875. package/dist/lib/schemas-data/3.2/governance/report-plan-adjustment-request.json +4 -4
  876. package/dist/lib/schemas-data/3.2/governance/report-plan-adjustment-response.json +4 -4
  877. package/dist/lib/schemas-data/3.2/governance/report-plan-outcome-request.json +8 -8
  878. package/dist/lib/schemas-data/3.2/governance/report-plan-outcome-response.json +5 -5
  879. package/dist/lib/schemas-data/3.2/governance/reported-outcome-error.json +1 -1
  880. package/dist/lib/schemas-data/3.2/governance/sync-plans-request.json +14 -14
  881. package/dist/lib/schemas-data/3.2/governance/sync-plans-response.json +6 -6
  882. package/dist/lib/schemas-data/3.2/index.json +639 -639
  883. package/dist/lib/schemas-data/3.2/manifest.json +3 -3
  884. package/dist/lib/schemas-data/3.2/manifest.schema.json +1 -1
  885. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/get-account-financials-request.json +1 -1
  886. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/list-account-changes-request.json +1 -1
  887. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/list-accounts-request.json +1 -1
  888. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/report-usage-request.json +1 -1
  889. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/sync-accounts-request.json +1 -1
  890. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/sync-governance-request.json +1 -1
  891. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/acquire-rights-request.json +1 -1
  892. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/get-brand-identity-request.json +1 -1
  893. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/get-rights-request.json +1 -1
  894. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/search-brands-request.json +1 -1
  895. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/update-rights-request.json +1 -1
  896. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/verify-brand-claim-request.json +1 -1
  897. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/verify-brand-claims-request.json +1 -1
  898. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/create-collection-list-request.json +1 -1
  899. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/delete-collection-list-request.json +1 -1
  900. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/get-collection-list-request.json +1 -1
  901. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/list-collection-lists-request.json +1 -1
  902. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/update-collection-list-request.json +1 -1
  903. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/compliance/comply-test-controller-request.json +1 -1
  904. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/calibrate-content-request.json +1 -1
  905. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/create-content-standards-request.json +1 -1
  906. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/get-content-standards-request.json +1 -1
  907. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/get-media-buy-artifacts-request.json +1 -1
  908. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/list-content-standards-request.json +1 -1
  909. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/update-content-standards-request.json +1 -1
  910. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/validate-content-delivery-request.json +1 -1
  911. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/get-creative-delivery-request.json +1 -1
  912. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/get-creative-features-request.json +1 -1
  913. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/list-creatives-request.json +1 -1
  914. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/list-transformers-request.json +1 -1
  915. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/preview-creative-request.json +1 -1
  916. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/sync-creatives-request.json +1 -1
  917. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/validate-input-request.json +1 -1
  918. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/check-governance-request.json +1 -1
  919. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/get-plan-audit-logs-request.json +1 -1
  920. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/report-plan-adjustment-request.json +1 -1
  921. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/report-plan-outcome-request.json +1 -1
  922. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/sync-plans-request.json +1 -1
  923. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/accept-proposal-request.json +1 -1
  924. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/build-creative-request.json +1 -1
  925. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/buy-products-request.json +1 -1
  926. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/control-media-buy-request.json +1 -1
  927. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/create-media-buy-request.json +1 -1
  928. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/decline-proposals-request.json +1 -1
  929. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-media-buy-delivery-request.json +1 -1
  930. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-media-buys-request.json +1 -1
  931. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-products-request.json +1 -1
  932. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-reporting-status-request.json +1 -1
  933. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/list-creative-formats-request.json +1 -1
  934. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/list-products-request.json +1 -1
  935. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/log-event-request.json +1 -1
  936. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/provide-performance-feedback-request.json +1 -1
  937. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/refine-proposals-request.json +1 -1
  938. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/request-proposals-request.json +1 -1
  939. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-audiences-request.json +1 -1
  940. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-catalogs-request.json +1 -1
  941. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-event-sources-request.json +1 -1
  942. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-reporting-receipts-request.json +1 -1
  943. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-reporting-status-request.json +1 -1
  944. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/update-media-buy-request.json +1 -1
  945. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/get-account-financials-request.json +1 -1
  946. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/list-accounts-request.json +1 -1
  947. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/report-usage-request.json +1 -1
  948. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/sync-accounts-request.json +1 -1
  949. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/sync-governance-request.json +1 -1
  950. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/creative/list-creatives-request.json +1 -1
  951. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/creative/sync-creatives-request.json +1 -1
  952. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/manifest.json +1 -1
  953. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/accept-proposal-request.json +1 -1
  954. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/buy-products-request.json +1 -1
  955. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/control-media-buy-request.json +1 -1
  956. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/decline-proposals-request.json +1 -1
  957. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-media-buy-delivery-request.json +1 -1
  958. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-media-buys-request.json +1 -1
  959. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-reporting-status-request.json +1 -1
  960. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/list-products-request.json +1 -1
  961. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/log-event-request.json +1 -1
  962. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/provide-performance-feedback-request.json +1 -1
  963. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/refine-proposals-request.json +1 -1
  964. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/request-proposals-request.json +1 -1
  965. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-audiences-request.json +1 -1
  966. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-catalogs-request.json +1 -1
  967. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-event-sources-request.json +1 -1
  968. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-reporting-receipts-request.json +1 -1
  969. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-reporting-status-request.json +1 -1
  970. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-adcp-capabilities-request.json +1 -1
  971. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-principal-request.json +1 -1
  972. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-task-status-request.json +1 -1
  973. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/list-tasks-request.json +1 -1
  974. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/sync-principal-request.json +1 -1
  975. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/create-property-list-request.json +1 -1
  976. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/delete-property-list-request.json +1 -1
  977. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/get-property-list-request.json +1 -1
  978. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/list-property-lists-request.json +1 -1
  979. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/update-property-list-request.json +1 -1
  980. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/validate-property-delivery-request.json +1 -1
  981. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-adcp-capabilities-request.json +1 -1
  982. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-principal-request.json +1 -1
  983. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-task-status-request.json +1 -1
  984. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/list-tasks-request.json +1 -1
  985. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/sync-agent-notification-configs-request.json +1 -1
  986. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/sync-principal-request.json +1 -1
  987. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/signals/activate-signal-request.json +1 -1
  988. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/signals/get-signals-request.json +1 -1
  989. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-get-offering-request.json +1 -1
  990. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-initiate-session-request.json +1 -1
  991. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-send-message-request.json +1 -1
  992. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-terminate-session-request.json +1 -1
  993. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-input-required.json +2 -2
  994. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-submitted.json +2 -2
  995. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-working.json +2 -2
  996. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-request.json +11 -11
  997. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-response.json +2 -2
  998. package/dist/lib/schemas-data/3.2/media-buy/acceptance-context.json +3 -3
  999. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-catalog.json +4 -4
  1000. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-profile-ref.json +1 -1
  1001. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-profile.json +3 -3
  1002. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-requirement.json +3 -3
  1003. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-rule.json +3 -3
  1004. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-input-required.json +4 -4
  1005. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-submitted.json +4 -4
  1006. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-working.json +3 -3
  1007. package/dist/lib/schemas-data/3.2/media-buy/build-creative-request.json +19 -19
  1008. package/dist/lib/schemas-data/3.2/media-buy/build-creative-response.json +35 -35
  1009. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-input-required.json +2 -2
  1010. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-submitted.json +2 -2
  1011. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-working.json +2 -2
  1012. package/dist/lib/schemas-data/3.2/media-buy/buy-products-request.json +20 -20
  1013. package/dist/lib/schemas-data/3.2/media-buy/buy-products-response.json +2 -2
  1014. package/dist/lib/schemas-data/3.2/media-buy/change-term-constraints.json +4 -4
  1015. package/dist/lib/schemas-data/3.2/media-buy/change-term.json +6 -6
  1016. package/dist/lib/schemas-data/3.2/media-buy/commercial-terms.json +12 -12
  1017. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-input-required.json +2 -2
  1018. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-submitted.json +2 -2
  1019. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-working.json +2 -2
  1020. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-request.json +15 -15
  1021. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-response.json +37 -19
  1022. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-input-required.json +4 -4
  1023. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-submitted.json +4 -4
  1024. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-working.json +3 -3
  1025. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-request.json +19 -19
  1026. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-response.json +23 -23
  1027. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-input-required.json +2 -2
  1028. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-submitted.json +2 -2
  1029. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-working.json +2 -2
  1030. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-request.json +9 -9
  1031. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-response.json +6 -6
  1032. package/dist/lib/schemas-data/3.2/media-buy/get-media-buy-delivery-request.json +47 -47
  1033. package/dist/lib/schemas-data/3.2/media-buy/get-media-buy-delivery-response.json +81 -81
  1034. package/dist/lib/schemas-data/3.2/media-buy/get-media-buys-request.json +9 -9
  1035. package/dist/lib/schemas-data/3.2/media-buy/get-media-buys-response.json +52 -52
  1036. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-input-required.json +4 -4
  1037. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-submitted.json +4 -4
  1038. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-working.json +3 -3
  1039. package/dist/lib/schemas-data/3.2/media-buy/get-products-rejected.json +5 -5
  1040. package/dist/lib/schemas-data/3.2/media-buy/get-products-request.json +19 -19
  1041. package/dist/lib/schemas-data/3.2/media-buy/get-products-response.json +13 -13
  1042. package/dist/lib/schemas-data/3.2/media-buy/get-products-targeting-resolution.json +3 -3
  1043. package/dist/lib/schemas-data/3.2/media-buy/get-reporting-status-request.json +10 -10
  1044. package/dist/lib/schemas-data/3.2/media-buy/get-reporting-status-response.json +27 -27
  1045. package/dist/lib/schemas-data/3.2/media-buy/legacy-purchase-continuation-input.json +2 -2
  1046. package/dist/lib/schemas-data/3.2/media-buy/list-creative-formats-request.json +14 -14
  1047. package/dist/lib/schemas-data/3.2/media-buy/list-creative-formats-response.json +9 -9
  1048. package/dist/lib/schemas-data/3.2/media-buy/list-products-request.json +11 -11
  1049. package/dist/lib/schemas-data/3.2/media-buy/list-products-response.json +6 -6
  1050. package/dist/lib/schemas-data/3.2/media-buy/log-event-request.json +5 -5
  1051. package/dist/lib/schemas-data/3.2/media-buy/log-event-response.json +8 -8
  1052. package/dist/lib/schemas-data/3.2/media-buy/media-buy-commitment-response.json +38 -20
  1053. package/dist/lib/schemas-data/3.2/media-buy/media-buy-delivery-webhook-result.json +11 -11
  1054. package/dist/lib/schemas-data/3.2/media-buy/outcome-target.json +4 -4
  1055. package/dist/lib/schemas-data/3.2/media-buy/package-control.json +10 -10
  1056. package/dist/lib/schemas-data/3.2/media-buy/package-request.json +31 -31
  1057. package/dist/lib/schemas-data/3.2/media-buy/package-update.json +14 -14
  1058. package/dist/lib/schemas-data/3.2/media-buy/product-discovery-criteria.json +10 -10
  1059. package/dist/lib/schemas-data/3.2/media-buy/product-fields.json +1 -1
  1060. package/dist/lib/schemas-data/3.2/media-buy/product-purchase-input.json +22 -22
  1061. package/dist/lib/schemas-data/3.2/media-buy/product-purchase.json +13 -13
  1062. package/dist/lib/schemas-data/3.2/media-buy/product-refinement.json +1 -1
  1063. package/dist/lib/schemas-data/3.2/media-buy/proposal-budget-constraint.json +1 -1
  1064. package/dist/lib/schemas-data/3.2/media-buy/proposal-decline.json +2 -2
  1065. package/dist/lib/schemas-data/3.2/media-buy/proposal-refinement.json +5 -5
  1066. package/dist/lib/schemas-data/3.2/media-buy/provide-performance-feedback-request.json +5 -5
  1067. package/dist/lib/schemas-data/3.2/media-buy/provide-performance-feedback-response.json +8 -8
  1068. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-input-required.json +2 -2
  1069. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-submitted.json +2 -2
  1070. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-working.json +2 -2
  1071. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-request.json +8 -8
  1072. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-response.json +14 -14
  1073. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-input-required.json +2 -2
  1074. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-submitted.json +2 -2
  1075. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-working.json +2 -2
  1076. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-request.json +11 -11
  1077. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-response.json +21 -11
  1078. package/dist/lib/schemas-data/3.2/media-buy/sync-audiences-request.json +9 -9
  1079. package/dist/lib/schemas-data/3.2/media-buy/sync-audiences-response.json +15 -15
  1080. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-input-required.json +3 -3
  1081. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-submitted.json +4 -4
  1082. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-working.json +3 -3
  1083. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-request.json +10 -10
  1084. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-response.json +20 -20
  1085. package/dist/lib/schemas-data/3.2/media-buy/sync-event-sources-request.json +8 -8
  1086. package/dist/lib/schemas-data/3.2/media-buy/sync-event-sources-response.json +14 -14
  1087. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-receipts-request.json +9 -9
  1088. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-receipts-response.json +10 -10
  1089. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-status-request.json +8 -8
  1090. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-status-response.json +8 -8
  1091. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-input-required.json +3 -3
  1092. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-submitted.json +4 -4
  1093. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-working.json +3 -3
  1094. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-request.json +15 -15
  1095. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-response.json +21 -21
  1096. package/dist/lib/schemas-data/3.2/pricing-options/cpa-option.json +4 -4
  1097. package/dist/lib/schemas-data/3.2/pricing-options/cpc-option.json +4 -4
  1098. package/dist/lib/schemas-data/3.2/pricing-options/cpcv-option.json +4 -4
  1099. package/dist/lib/schemas-data/3.2/pricing-options/cpm-option.json +4 -4
  1100. package/dist/lib/schemas-data/3.2/pricing-options/cpp-option.json +5 -5
  1101. package/dist/lib/schemas-data/3.2/pricing-options/cpv-option.json +4 -4
  1102. package/dist/lib/schemas-data/3.2/pricing-options/flat-rate-option.json +4 -4
  1103. package/dist/lib/schemas-data/3.2/pricing-options/price-breakdown.json +2 -2
  1104. package/dist/lib/schemas-data/3.2/pricing-options/price-guidance.json +1 -1
  1105. package/dist/lib/schemas-data/3.2/pricing-options/revenue-share-option.json +2 -2
  1106. package/dist/lib/schemas-data/3.2/pricing-options/time-option.json +4 -4
  1107. package/dist/lib/schemas-data/3.2/pricing-options/vcpm-option.json +4 -4
  1108. package/dist/lib/schemas-data/3.2/property/authorization-result.json +1 -1
  1109. package/dist/lib/schemas-data/3.2/property/base-property-source.json +4 -4
  1110. package/dist/lib/schemas-data/3.2/property/create-property-list-request.json +8 -8
  1111. package/dist/lib/schemas-data/3.2/property/create-property-list-response.json +6 -6
  1112. package/dist/lib/schemas-data/3.2/property/delete-property-list-request.json +5 -5
  1113. package/dist/lib/schemas-data/3.2/property/delete-property-list-response.json +5 -5
  1114. package/dist/lib/schemas-data/3.2/property/delivery-record.json +3 -3
  1115. package/dist/lib/schemas-data/3.2/property/get-property-list-request.json +5 -5
  1116. package/dist/lib/schemas-data/3.2/property/get-property-list-response.json +9 -9
  1117. package/dist/lib/schemas-data/3.2/property/list-property-lists-request.json +6 -6
  1118. package/dist/lib/schemas-data/3.2/property/list-property-lists-response.json +7 -7
  1119. package/dist/lib/schemas-data/3.2/property/property-error.json +2 -2
  1120. package/dist/lib/schemas-data/3.2/property/property-feature-definition.json +2 -2
  1121. package/dist/lib/schemas-data/3.2/property/property-feature-result.json +4 -4
  1122. package/dist/lib/schemas-data/3.2/property/property-feature-value.json +2 -2
  1123. package/dist/lib/schemas-data/3.2/property/property-feature.json +1 -1
  1124. package/dist/lib/schemas-data/3.2/property/property-list-changed-webhook.json +2 -2
  1125. package/dist/lib/schemas-data/3.2/property/property-list-filters.json +5 -5
  1126. package/dist/lib/schemas-data/3.2/property/property-list.json +6 -6
  1127. package/dist/lib/schemas-data/3.2/property/update-property-list-request.json +8 -8
  1128. package/dist/lib/schemas-data/3.2/property/update-property-list-response.json +6 -6
  1129. package/dist/lib/schemas-data/3.2/property/validate-property-delivery-request.json +6 -6
  1130. package/dist/lib/schemas-data/3.2/property/validate-property-delivery-response.json +6 -6
  1131. package/dist/lib/schemas-data/3.2/property/validation-result.json +5 -5
  1132. package/dist/lib/schemas-data/3.2/protocol/get-adcp-capabilities-request.json +4 -4
  1133. package/dist/lib/schemas-data/3.2/protocol/get-adcp-capabilities-response.json +53 -53
  1134. package/dist/lib/schemas-data/3.2/protocol/get-principal-request.json +4 -4
  1135. package/dist/lib/schemas-data/3.2/protocol/get-principal-response.json +9 -9
  1136. package/dist/lib/schemas-data/3.2/protocol/get-task-status-request.json +5 -5
  1137. package/dist/lib/schemas-data/3.2/protocol/get-task-status-response.json +10 -10
  1138. package/dist/lib/schemas-data/3.2/protocol/list-tasks-request.json +13 -13
  1139. package/dist/lib/schemas-data/3.2/protocol/list-tasks-response.json +8 -8
  1140. package/dist/lib/schemas-data/3.2/protocol/sync-agent-notification-configs-request.json +5 -5
  1141. package/dist/lib/schemas-data/3.2/protocol/sync-agent-notification-configs-response.json +7 -7
  1142. package/dist/lib/schemas-data/3.2/protocol/sync-principal-request.json +8 -8
  1143. package/dist/lib/schemas-data/3.2/protocol/sync-principal-response.json +10 -10
  1144. package/dist/lib/schemas-data/3.2/registries/v1-canonical-mapping.json +2 -2
  1145. package/dist/lib/schemas-data/3.2/signals/activate-signal-request.json +6 -6
  1146. package/dist/lib/schemas-data/3.2/signals/activate-signal-response.json +9 -9
  1147. package/dist/lib/schemas-data/3.2/signals/get-signals-async-response-submitted.json +4 -4
  1148. package/dist/lib/schemas-data/3.2/signals/get-signals-async-response-working.json +3 -3
  1149. package/dist/lib/schemas-data/3.2/signals/get-signals-request.json +11 -11
  1150. package/dist/lib/schemas-data/3.2/signals/get-signals-response.json +17 -17
  1151. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-capabilities.json +1 -1
  1152. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-context-use.json +1 -1
  1153. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-get-offering-request.json +4 -4
  1154. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-get-offering-response.json +9 -9
  1155. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-identity.json +1 -1
  1156. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-initiate-session-request.json +7 -7
  1157. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-initiate-session-response.json +10 -10
  1158. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-send-message-request.json +5 -5
  1159. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-send-message-response.json +10 -10
  1160. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-sponsored-context-receipt.json +4 -4
  1161. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-sponsored-context.json +4 -4
  1162. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-terminate-session-request.json +4 -4
  1163. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-terminate-session-response.json +7 -7
  1164. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-ui-element.json +1 -1
  1165. package/dist/lib/schemas-data/3.2/trusted-match/available-package.json +5 -5
  1166. package/dist/lib/schemas-data/3.2/trusted-match/context-match-request.json +5 -5
  1167. package/dist/lib/schemas-data/3.2/trusted-match/context-match-response.json +4 -4
  1168. package/dist/lib/schemas-data/3.2/trusted-match/error.json +1 -1
  1169. package/dist/lib/schemas-data/3.2/trusted-match/identity-match-request.json +4 -4
  1170. package/dist/lib/schemas-data/3.2/trusted-match/identity-match-response.json +4 -4
  1171. package/dist/lib/schemas-data/3.2/trusted-match/offer-price.json +1 -1
  1172. package/dist/lib/schemas-data/3.2/trusted-match/offer.json +5 -5
  1173. package/dist/lib/schemas-data/3.2/trusted-match/provider-context-match-response.json +4 -4
  1174. package/dist/lib/schemas-data/3.2/trusted-match/provider-identity-match-response.json +4 -4
  1175. package/dist/lib/schemas-data/3.2/trusted-match/provider-registration.json +2 -2
  1176. package/dist/lib/schemas-data/3.2/trusted-match/publisher-targeting-kv-config.json +1 -1
  1177. package/dist/lib/schemas-data/3.2/trusted-match/publisher-tmpx-config.json +1 -1
  1178. package/dist/lib/schemas-data/3.2/trusted-match/tmpx-chunk.json +1 -1
  1179. package/dist/lib/server/create-adcp-server.js +1 -1
  1180. package/dist/lib/server/create-adcp-server.mjs +2 -1
  1181. package/dist/lib/server/responses.js +50 -3
  1182. package/dist/lib/server/responses.mjs +49 -3
  1183. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  1184. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  1185. package/dist/lib/v2/projection/creative-delivery.js +31 -32
  1186. package/dist/lib/v2/projection/creative-delivery.mjs +29 -31
  1187. package/dist/lib/version.d.mts +5 -5
  1188. package/dist/lib/version.d.ts +5 -5
  1189. package/dist/lib/version.js +4 -3
  1190. package/dist/lib/version.mjs +4 -3
  1191. package/docs/CLI.md +1 -1
  1192. package/docs/TYPE-SUMMARY.md +2 -2
  1193. package/docs/guides/CREATIVE-DELIVERY.md +15 -2
  1194. package/docs/guides/CREATIVE-PACKAGE-FIT.md +1 -1
  1195. package/docs/guides/REPORTING-LEDGER.md +6 -0
  1196. package/docs/guides/REPORTING-OPERATIONS.md +62 -5
  1197. package/docs/llms.txt +2 -2
  1198. package/docs/migration-14.x-rc-worksheet.md +5 -5
  1199. package/docs/migration-16-to-17.md +3 -3
  1200. package/docs/migration-account-change-feed.md +1 -1
  1201. package/docs/migration-reporting-storage-package.md +21 -1
  1202. package/package.json +3 -3
  1203. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/index.yaml +0 -0
  1204. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/distributed_brand_resolution.yaml +0 -0
  1205. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/signed_response_envelope_vectors.yaml +0 -0
  1206. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/single_side_trust_extension.yaml +0 -0
  1207. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/index.yaml +0 -0
  1208. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/asset_type_filtering.yaml +0 -0
  1209. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/billing_out_of_band.yaml +0 -0
  1210. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/canonical_supported_formats.yaml +0 -0
  1211. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_features_idempotency.yaml +0 -0
  1212. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_revision_identity.yaml +0 -0
  1213. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/evaluator_auth.yaml +0 -0
  1214. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/list_creatives_filter_behavior.yaml +0 -0
  1215. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/native_in_feed.yaml +0 -0
  1216. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/native_localization.yaml +0 -0
  1217. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/policy_backed_rejections.yaml +0 -0
  1218. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/index.yaml +0 -0
  1219. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/scenarios/failed_outcome_audit_persistence.yaml +0 -0
  1220. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/scenarios/property_list_change_webhook_signing.yaml +0 -0
  1221. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/index.yaml +0 -0
  1222. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/acceptance_policy_discovery.yaml +0 -0
  1223. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_change_feed.yaml +0 -0
  1224. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_buyer_selected.yaml +0 -0
  1225. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_seller_assigned.yaml +0 -0
  1226. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_seller_fixed.yaml +0 -0
  1227. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/advanced_delivery_reporting.yaml +0 -0
  1228. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/audience_activation_discovery.yaml +0 -0
  1229. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/audience_buy_flow.yaml +0 -0
  1230. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/availability_windows.yaml +0 -0
  1231. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/available_actions.yaml +0 -0
  1232. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/bidding_cost_binding.yaml +0 -0
  1233. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/bidding_policy_placement.yaml +0 -0
  1234. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/billing_finality_delivery.yaml +0 -0
  1235. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_account.yaml +0 -0
  1236. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_fixed.yaml +0 -0
  1237. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_override.yaml +0 -0
  1238. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_override_rejected.yaml +0 -0
  1239. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/canonical_formats.yaml +0 -0
  1240. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/catalog_item_availability_updates.yaml +0 -0
  1241. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/change_rights_state_projection.yaml +0 -0
  1242. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/clicks_buy_flow.yaml +0 -0
  1243. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/collection_selection.yaml +0 -0
  1244. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/compact_direct_buy_lifecycle.yaml +0 -0
  1245. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/compact_product_lifecycle.yaml +0 -0
  1246. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/completed_views_buy_flow.yaml +0 -0
  1247. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/create_media_buy_async.yaml +0 -0
  1248. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/create_media_buy_async_lifecycle.yaml +0 -0
  1249. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/creative_reception.yaml +0 -0
  1250. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/cross_path_targeting_provenance.yaml +0 -0
  1251. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/declined_proposal_execution.yaml +0 -0
  1252. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/declined_proposal_refinement.yaml +0 -0
  1253. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/delivery_reporting.yaml +0 -0
  1254. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/demographic_targeting.yaml +0 -0
  1255. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/dependency_impairment_audience.yaml +0 -0
  1256. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/event_dedup_flow.yaml +0 -0
  1257. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/expired_proposal_execution.yaml +0 -0
  1258. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/external_audience_source_binding.yaml +0 -0
  1259. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/frequency_cap_capability_updates.yaml +0 -0
  1260. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -0
  1261. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_place_targeting.yaml +0 -0
  1262. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_all_values_support.yaml +0 -0
  1263. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_exclusion_support.yaml +0 -0
  1264. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_targeting.yaml +0 -0
  1265. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/get_products_async.yaml +0 -0
  1266. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/get_products_rejected.yaml +0 -0
  1267. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_agent_binding_acceptance.yaml +0 -0
  1268. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_approved.yaml +0 -0
  1269. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_conditions.yaml +0 -0
  1270. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_denied.yaml +0 -0
  1271. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_denied_recovery.yaml +0 -0
  1272. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inline_creatives_without_sync.yaml +0 -0
  1273. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inventory_list_no_match.yaml +0 -0
  1274. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inventory_list_targeting.yaml +0 -0
  1275. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_accountability.yaml +0 -0
  1276. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_terms_accepted.yaml +0 -0
  1277. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/media_buy_frequency_cap_readback.yaml +0 -0
  1278. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/media_buy_frequency_cap_updates.yaml +0 -0
  1279. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/metric_container_subsumption.yaml +0 -0
  1280. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/outcome_target.yaml +0 -0
  1281. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/outcome_target_list_products_inert.yaml +0 -0
  1282. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/owner_sold_channel_carriage.yaml +0 -0
  1283. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/package_automatic_bidding.yaml +0 -0
  1284. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/package_correlation_legacy_fallback.yaml +0 -0
  1285. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/pending_creatives_to_start.yaml +0 -0
  1286. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -0
  1287. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/performance_buy_flow.yaml +0 -0
  1288. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -0
  1289. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/portfolio_routing_scope.yaml +0 -0
  1290. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/pricing_currency_filter.yaml +0 -0
  1291. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_coverage_filters.yaml +0 -0
  1292. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_filter_behavior.yaml +0 -0
  1293. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_signal_targeting.yaml +0 -0
  1294. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_finalize.yaml +0 -0
  1295. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -0
  1296. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_not_found_errors.yaml +0 -0
  1297. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_audit_observation.yaml +0 -0
  1298. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_enforcement.yaml +0 -0
  1299. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -0
  1300. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/reach_buy_flow.yaml +0 -0
  1301. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/read_filter_behavior.yaml +0 -0
  1302. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -0
  1303. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_frequency_cap_negotiation.yaml +0 -0
  1304. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_products.yaml +0 -0
  1305. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/revenue_share_pricing.yaml +0 -0
  1306. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_budget.yaml +0 -0
  1307. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_min_spend_target_exceeds_package_cap.yaml +0 -0
  1308. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_proposal_package_pacing.yaml +0 -0
  1309. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/targeting_aware_discovery.yaml +0 -0
  1310. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/total_budget_redistribution.yaml +0 -0
  1311. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/typed_proposal_negotiation.yaml +0 -0
  1312. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_accountability.yaml +0 -0
  1313. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -0
  1314. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -0
  1315. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/state-machine.yaml +0 -0
  1316. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/signals/index.yaml +0 -0
  1317. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/signals/scenarios/get_signals_async.yaml +0 -0
  1318. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/sponsored-intelligence/index.yaml +0 -0
  1319. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/sponsored-intelligence/sponsored-context-accountability.yaml +0 -0
  1320. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/audience-sync/index.yaml +0 -0
  1321. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/index.yaml +0 -0
  1322. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/governance_approved.yaml +0 -0
  1323. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/governance_denied.yaml +0 -0
  1324. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/update_rights_lifecycle.yaml +0 -0
  1325. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-activation/index.yaml +0 -0
  1326. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-discovery/index.yaml +0 -0
  1327. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-monitoring/index.yaml +0 -0
  1328. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-negotiation/index.yaml +0 -0
  1329. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-recovery/index.yaml +0 -0
  1330. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/collection-lists/index.yaml +0 -0
  1331. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/content-standards/index.yaml +0 -0
  1332. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-ad-server/index.yaml +0 -0
  1333. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-generative/generative-seller.yaml +0 -0
  1334. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-generative/index.yaml +0 -0
  1335. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-template/index.yaml +0 -0
  1336. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/index.yaml +0 -0
  1337. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/scenarios/governance_approved.yaml +0 -0
  1338. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/scenarios/governance_denied.yaml +0 -0
  1339. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-aware-seller/index.yaml +0 -0
  1340. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-aware-seller/scenarios/governance_multi_agent_rejected.yaml +0 -0
  1341. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-delivery-monitor/index.yaml +0 -0
  1342. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-spend-authority/denied.yaml +0 -0
  1343. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-spend-authority/index.yaml +0 -0
  1344. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/orchestrator-multi-agent/index.yaml +0 -0
  1345. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/property-lists/index.yaml +0 -0
  1346. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-catalog-driven/index.yaml +0 -0
  1347. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-dooh/index.yaml +0 -0
  1348. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-exchange/index.yaml +0 -0
  1349. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-guaranteed/index.yaml +0 -0
  1350. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-non-guaranteed/index.yaml +0 -0
  1351. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-proposal-mode/index.yaml +0 -0
  1352. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-retail-media/index.yaml +0 -0
  1353. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-social/index.yaml +0 -0
  1354. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-streaming-tv/index.yaml +0 -0
  1355. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/index.yaml +0 -0
  1356. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/scenarios/governance_approved.yaml +0 -0
  1357. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/scenarios/governance_denied.yaml +0 -0
  1358. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-owned/index.yaml +0 -0
  1359. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sponsored-intelligence/index.yaml +0 -0
  1360. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/acme-outdoor-live.yaml +0 -0
  1361. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/acme-outdoor.yaml +0 -0
  1362. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/billing-gate-runner.yaml +0 -0
  1363. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/bistro-oranje.yaml +0 -0
  1364. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/creative-build-probe-runner.yaml +0 -0
  1365. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/distributed-brand-runner.yaml +0 -0
  1366. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/hosted-grader.yaml +0 -0
  1367. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/nova-motors.yaml +0 -0
  1368. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/oauth-setup-runner.yaml +0 -0
  1369. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/osei-natural.yaml +0 -0
  1370. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/parallel-dispatch-runner.yaml +0 -0
  1371. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/rate-limit-trip-runner.yaml +0 -0
  1372. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/signed-requests-runner.yaml +0 -0
  1373. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/signed-responses-runner.yaml +0 -0
  1374. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/single-side-trust-runner.yaml +0 -0
  1375. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/substitution-observer-runner.yaml +0 -0
  1376. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/summit-foods.yaml +0 -0
  1377. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/trusted-match-router-runner.yaml +0 -0
  1378. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/webhook-receiver-runner.yaml +0 -0
  1379. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/attestations/README.md +0 -0
  1380. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/attestations/vectors.json +0 -0
  1381. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/audience-evidence/README.md +0 -0
  1382. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/audience-evidence/vectors.json +0 -0
  1383. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/brand-response-signing/brand-authorization-cross-check.json +0 -0
  1384. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/catalog-macro-substitution.json +0 -0
  1385. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/creative-representation-resolution.json +0 -0
  1386. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/creative-representation-resolution.schema.json +0 -0
  1387. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/error-recovery/README.md +0 -0
  1388. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/error-recovery/vectors.json +0 -0
  1389. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-authorization.json +0 -0
  1390. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-runtime-attestations/README.md +0 -0
  1391. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-runtime-attestations/vectors.json +0 -0
  1392. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/macro-processing.json +0 -0
  1393. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/macro-processing.schema.json +0 -0
  1394. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/oauth-setup/vectors.json +0 -0
  1395. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/001-minimal-plan.json +0 -0
  1396. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/002-full-plan.json +0 -0
  1397. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/003-bookkeeping-stripped.json +0 -0
  1398. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/004a-human-review-omitted.json +0 -0
  1399. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/004b-human-review-explicit-null.json +0 -0
  1400. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/005a-policy-categories-order-1.json +0 -0
  1401. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/005b-policy-categories-order-2.json +0 -0
  1402. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/006a-ext-trace-v1.json +0 -0
  1403. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/006b-ext-trace-v2.json +0 -0
  1404. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/007-unicode-objectives.json +0 -0
  1405. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/008-numeric-canonicalization.json +0 -0
  1406. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/products-only-brief-compatibility/README.md +0 -0
  1407. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/products-only-brief-compatibility/vectors.json +0 -0
  1408. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/relationship-scoped-indicators.json +0 -0
  1409. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/README.md +0 -0
  1410. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/adjustment.json +0 -0
  1411. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/canonicalization.json +0 -0
  1412. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/coverage-aggregation.json +0 -0
  1413. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/manifest.json +0 -0
  1414. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/materialization.json +0 -0
  1415. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/obligation.json +0 -0
  1416. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-recorded-response.json +0 -0
  1417. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-request.json +0 -0
  1418. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-unchanged-response.json +0 -0
  1419. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/adjustment-accepted-recorded-response.json +0 -0
  1420. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/adjustment-accepted-request.json +0 -0
  1421. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/rejected-recorded-response.json +0 -0
  1422. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/rejected-request.json +0 -0
  1423. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/report-definition.json +0 -0
  1424. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/revision.json +0 -0
  1425. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/row-schema.json +0 -0
  1426. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/rows.jsonl +0 -0
  1427. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/scenario-index.json +0 -0
  1428. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/scenario-index.schema.json +0 -0
  1429. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-summary/complete-summary.json +0 -0
  1430. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/README.md +0 -0
  1431. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/001-unsigned-sendmessage-required.json +0 -0
  1432. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/002-unsigned-message-send-v0-3-required.json +0 -0
  1433. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/003-unsigned-sendstreamingmessage-required.json +0 -0
  1434. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/004-duplicate-invocation-datapart.json +0 -0
  1435. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/005-signed-duplicate-invocation-datapart.json +0 -0
  1436. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/006-missing-skill.json +0 -0
  1437. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/007-protocol-method-required-covers-sendmessage.json +0 -0
  1438. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/008-no-extension-header.json +0 -0
  1439. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/009-extra-non-invocation-datapart.json +0 -0
  1440. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/010-filepart-present.json +0 -0
  1441. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/011-part-with-text-and-data.json +0 -0
  1442. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/012-non-object-data.json +0 -0
  1443. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/013-v0-3-kind-mismatch.json +0 -0
  1444. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/014-duplicate-skill-key.json +0 -0
  1445. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/015-non-string-skill.json +0 -0
  1446. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/016-text-only-message.json +0 -0
  1447. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/017-unsigned-message-stream-v0-3-required.json +0 -0
  1448. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/018-unresolvable-with-lone-signature-header.json +0 -0
  1449. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/019-raw-part-present.json +0 -0
  1450. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/020-case-variant-member-name.json +0 -0
  1451. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/021-escaped-duplicate-skill-key.json +0 -0
  1452. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/022-unsigned-http-json-message-send-required.json +0 -0
  1453. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/023-batch-body.json +0 -0
  1454. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/024-duplicate-method-key.json +0 -0
  1455. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/025-missing-method.json +0 -0
  1456. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/026-empty-skill.json +0 -0
  1457. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/001-signed-sendmessage-create-media-buy.json +0 -0
  1458. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/002-signed-message-send-v0-3-create-media-buy.json +0 -0
  1459. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/003-unsigned-sendmessage-get-products-not-required.json +0 -0
  1460. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/004-unsigned-decoy-text-and-metadata.json +0 -0
  1461. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/005-unsigned-alias-skill-not-in-lists.json +0 -0
  1462. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/006-unsigned-message-send-v0-3-legacy-parameters.json +0 -0
  1463. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/007-unsigned-method-case-variant.json +0 -0
  1464. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/body-integrity-policy.json +0 -0
  1465. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/canonicalization.json +0 -0
  1466. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/keys.json +0 -0
  1467. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/001-no-signature-header.json +0 -0
  1468. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/002-wrong-tag.json +0 -0
  1469. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/003-expired-signature.json +0 -0
  1470. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/004-window-too-long.json +0 -0
  1471. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/005-alg-not-allowed.json +0 -0
  1472. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/006-missing-covered-component.json +0 -0
  1473. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/007-missing-content-digest.json +0 -0
  1474. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/008-unknown-keyid.json +0 -0
  1475. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/009-key-ops-missing-verify.json +0 -0
  1476. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/010-content-digest-mismatch.json +0 -0
  1477. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/011-malformed-header.json +0 -0
  1478. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/012-missing-expires-param.json +0 -0
  1479. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/013-expires-le-created.json +0 -0
  1480. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/014-missing-nonce-param.json +0 -0
  1481. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/015-signature-invalid.json +0 -0
  1482. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/016-replayed-nonce.json +0 -0
  1483. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/017-key-revoked.json +0 -0
  1484. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/018-digest-covered-when-forbidden.json +0 -0
  1485. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/019-signature-without-signature-input.json +0 -0
  1486. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/020-rate-abuse.json +0 -0
  1487. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/021-duplicate-signature-input-label.json +0 -0
  1488. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/022-multi-valued-content-type.json +0 -0
  1489. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/023-multi-valued-content-digest.json +0 -0
  1490. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/024-unquoted-string-param.json +0 -0
  1491. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/025-jwk-alg-crv-mismatch.json +0 -0
  1492. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/026-non-ascii-host.json +0 -0
  1493. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/027-webhook-registration-authentication-unsigned.json +0 -0
  1494. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/028-unsigned-protocol-method-required.json +0 -0
  1495. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/029-duplicate-signature-label.json +0 -0
  1496. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/030-content-digest-key-case.json +0 -0
  1497. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/031-malformed-host-authority.json +0 -0
  1498. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/001-basic-post.json +0 -0
  1499. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/002-post-with-content-digest.json +0 -0
  1500. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/003-es256-post.json +0 -0
  1501. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/004-multiple-signature-labels.json +0 -0
  1502. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/005-default-port-stripped.json +0 -0
  1503. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/006-dot-segment-path.json +0 -0
  1504. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/007-query-byte-preserved.json +0 -0
  1505. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/008-percent-encoded-path.json +0 -0
  1506. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/009-percent-encoded-unreserved-decoded.json +0 -0
  1507. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/010-percent-encoded-slash-preserved.json +0 -0
  1508. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/011-ipv6-authority.json +0 -0
  1509. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/012-ipv6-authority-default-port-stripped.json +0 -0
  1510. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/013-two-signature-labels-distinct.json +0 -0
  1511. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/014-content-digest-two-algorithms.json +0 -0
  1512. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/015-bracketed-ipv6-host-with-port.json +0 -0
  1513. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/001-base64url-sf-binary.json +0 -0
  1514. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/001-no-signature-header.json +0 -0
  1515. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/002-multiple-trailing-dots.json +0 -0
  1516. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/002-wrong-tag.json +0 -0
  1517. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/003-expired-signature.json +0 -0
  1518. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/004-window-too-long.json +0 -0
  1519. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/005-alg-not-allowed.json +0 -0
  1520. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/006-missing-covered-component.json +0 -0
  1521. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/007-missing-content-digest.json +0 -0
  1522. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/008-unknown-keyid.json +0 -0
  1523. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/009-key-ops-missing-verify.json +0 -0
  1524. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/010-content-digest-mismatch.json +0 -0
  1525. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/011-malformed-header.json +0 -0
  1526. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/012-missing-expires-param.json +0 -0
  1527. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/013-expires-le-created.json +0 -0
  1528. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/014-missing-nonce-param.json +0 -0
  1529. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/015-signature-invalid.json +0 -0
  1530. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/016-replayed-nonce.json +0 -0
  1531. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/017-key-revoked.json +0 -0
  1532. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/019-signature-without-signature-input.json +0 -0
  1533. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/020-rate-abuse.json +0 -0
  1534. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/021-duplicate-signature-input-label.json +0 -0
  1535. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/022-multi-valued-content-type.json +0 -0
  1536. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/023-multi-valued-content-digest.json +0 -0
  1537. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/024-unquoted-string-param.json +0 -0
  1538. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/025-jwk-alg-crv-mismatch.json +0 -0
  1539. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/026-non-ascii-host.json +0 -0
  1540. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/027-webhook-registration-authentication-unsigned.json +0 -0
  1541. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/028-unsigned-protocol-method-required.json +0 -0
  1542. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/029-duplicate-signature-label.json +0 -0
  1543. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/030-content-digest-key-case.json +0 -0
  1544. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/031-malformed-host-authority.json +0 -0
  1545. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/001-post-with-content-digest.json +0 -0
  1546. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/003-es256-post.json +0 -0
  1547. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/004-multiple-signature-labels.json +0 -0
  1548. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/005-default-port-stripped.json +0 -0
  1549. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/006-dot-segment-path.json +0 -0
  1550. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/007-query-byte-preserved.json +0 -0
  1551. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/008-percent-encoded-path.json +0 -0
  1552. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/009-percent-encoded-unreserved-decoded.json +0 -0
  1553. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/010-percent-encoded-slash-preserved.json +0 -0
  1554. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/011-ipv6-authority.json +0 -0
  1555. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/012-ipv6-authority-default-port-stripped.json +0 -0
  1556. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/013-two-signature-labels-distinct.json +0 -0
  1557. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/014-content-digest-two-algorithms.json +0 -0
  1558. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/015-bracketed-ipv6-host-with-port.json +0 -0
  1559. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/protocol-method-names.json +0 -0
  1560. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/rights-attestations/README.md +0 -0
  1561. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/rights-attestations/vectors.json +0 -0
  1562. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/supply-path/README.md +0 -0
  1563. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/supply-path/vectors.json +0 -0
  1564. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/tracker-execution-contracts.json +0 -0
  1565. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/tracker-execution-contracts.schema.json +0 -0
  1566. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/trusted-match-context-merge/README.md +0 -0
  1567. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/trusted-match-context-merge/vectors.json +0 -0
  1568. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/universal-macro-translation.json +0 -0
  1569. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/universal-macro-translation.schema.json +0 -0
  1570. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-receiver-envelope.json +0 -0
  1571. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/README.md +0 -0
  1572. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/keys.json +0 -0
  1573. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/001-wrong-tag.json +0 -0
  1574. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/002-expired-signature.json +0 -0
  1575. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/003-window-too-long.json +0 -0
  1576. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/004-alg-not-allowed.json +0 -0
  1577. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/005-missing-authority-component.json +0 -0
  1578. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/006-missing-content-digest.json +0 -0
  1579. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/007-unknown-keyid.json +0 -0
  1580. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/008-wrong-adcp-use.json +0 -0
  1581. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/009-content-digest-mismatch.json +0 -0
  1582. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/010-malformed-signature-input.json +0 -0
  1583. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/011-signature-without-input.json +0 -0
  1584. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/012-missing-expires-param.json +0 -0
  1585. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/013-expires-le-created.json +0 -0
  1586. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/014-missing-nonce-param.json +0 -0
  1587. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/015-signature-invalid.json +0 -0
  1588. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/016-replayed-nonce.json +0 -0
  1589. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/017-key-revoked.json +0 -0
  1590. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/018-rate-abuse.json +0 -0
  1591. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/019-revocation-stale.json +0 -0
  1592. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/020-key-ops-missing-verify.json +0 -0
  1593. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/021-base64-alphabet-mixing.json +0 -0
  1594. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/001-basic-post.json +0 -0
  1595. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/002-es256-post.json +0 -0
  1596. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/003-multiple-signature-labels.json +0 -0
  1597. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/004-default-port-stripped.json +0 -0
  1598. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/005-percent-encoded-path.json +0 -0
  1599. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/006-query-byte-preserved.json +0 -0
  1600. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/007-body-without-idempotency-key.json +0 -0
  1601. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/008-request-signing-key-reuse.json +0 -0
  1602. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/account-identity-reconciliation.yaml +0 -0
  1603. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/agent-notification-configs.yaml +0 -0
  1604. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/billing-gate-dispatch.yaml +0 -0
  1605. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/buyer-fixture-publisher.yaml +0 -0
  1606. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/buyer-orchestrator-track.yaml +0 -0
  1607. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/canonical-format-validate-input.yaml +0 -0
  1608. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/capability-discovery.yaml +0 -0
  1609. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/collection-lists-pagination-integrity.yaml +0 -0
  1610. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/comply-controller-mode-gate.yaml +0 -0
  1611. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/content-standards-pagination-integrity.yaml +0 -0
  1612. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/ctv-experience-validate-input.yaml +0 -0
  1613. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/deterministic-testing.yaml +0 -0
  1614. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/error-compliance-signals.yaml +0 -0
  1615. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/error-compliance.yaml +0 -0
  1616. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/fictional-entities.yaml +0 -0
  1617. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-media-buys-pagination-integrity.yaml +0 -0
  1618. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-products-pagination-integrity.yaml +0 -0
  1619. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-signals-pagination-integrity.yaml +0 -0
  1620. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/governance.yaml +0 -0
  1621. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/idempotency.yaml +0 -0
  1622. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-event-scope.yaml +0 -0
  1623. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-lifecycle.yaml +0 -0
  1624. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-rejections.yaml +0 -0
  1625. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/oauth-setup.yaml +0 -0
  1626. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity-creative-formats.yaml +0 -0
  1627. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity-list-accounts.yaml +0 -0
  1628. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity.yaml +0 -0
  1629. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/premium-display-canonical-validation.yaml +0 -0
  1630. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/principal.yaml +0 -0
  1631. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/property-lists-pagination-integrity.yaml +0 -0
  1632. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/read-tool-idempotency.yaml +0 -0
  1633. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reliable-reporting-managed-delivery.yaml +0 -0
  1634. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reliable-reporting-reconciled-billing.yaml +0 -0
  1635. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-consumer-status.yaml +0 -0
  1636. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-core-declaration.yaml +0 -0
  1637. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-core.yaml +0 -0
  1638. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/runner-output-contract.yaml +0 -0
  1639. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/schema-validation-signals.yaml +0 -0
  1640. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/schema-validation.yaml +0 -0
  1641. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/security.yaml +0 -0
  1642. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/signed-requests.yaml +0 -0
  1643. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/trusted-match-publisher-authentication.yaml +0 -0
  1644. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/v3-envelope-integrity.yaml +0 -0
  1645. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/v4-compatibility.yaml +0 -0
  1646. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/version-negotiation.yaml +0 -0
  1647. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/webhook-emission.yaml +0 -0
  1648. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/webhook-receiver-envelope.yaml +0 -0
  1649. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-bulk-webhooks.yaml +0 -0
  1650. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-product-webhooks.yaml +0 -0
  1651. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-products-scope-isolation.yaml +0 -0
  1652. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-products.yaml +0 -0
  1653. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signal-webhooks.yaml +0 -0
  1654. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signals-scope-isolation.yaml +0 -0
  1655. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signals.yaml +0 -0
@@ -1 +1 @@
1
- {"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json","title":"Create Media Buy Request","description":"Deprecated AdCP 3.x compatibility request for creating a MediaBuy. New 3.2 callers use buy_products for direct published-offer purchases or accept_proposal for proposal execution. Existing package and proposal payloads remain valid throughout 3.x.","type":"object","deprecated":true,"x-deprecated-in":"3.2.0","x-superseded-by":["buy_products","accept_proposal"],"x-mutates-state":true,"x-governed-commitment":{"scope":"always"},"properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99},"governance_context":{"type":"string","description":"Opaque intent authorization for this media-buy commitment. Required when governance applies to the resolved account.","minLength":1,"maxLength":4096,"pattern":"^[\\x20-\\x7E]+$"},"idempotency_key":{"type":"string","description":"Client-generated unique key for this request. If a request with the same idempotency_key and account has already been processed, the seller returns the existing media buy rather than creating a duplicate. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.","minLength":16,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{16,255}$"},"plan_id":{"type":"string","description":"DEPRECATED on seller-facing requests. New buyers send the approved governance_context on the protocol envelope; the seller forwards that opaque context and does not need the plan identifier. If both are present, the governance agent MUST reject a mismatch. Removed in 4.0.","deprecated":true,"x-removed-in":"4.0.0","x-entity":"governance_plan"},"account":{"$ref":"#/$defs/external:core~1account-ref.json","description":"Account to bill for this media buy. Pass a natural key (brand, operator, optional sandbox) or a seller-assigned account_id from list_accounts."},"proposal_id":{"type":"string","x-entity":"proposal","description":"ID of the exact committed proposal snapshot to execute. With total_budget, the publisher creates packages using the proposal's fixed percentages or seller-optimized constraints. Mutually exclusive: provide packages or proposal_id, not both. AdCP 3.2 request_proposals and ordinary refine_proposals revisions issue drafts; refine_proposals action finalize creates the executable committed hold. Sellers reject draft, declined, or previously executed snapshots, while exact retries with the original idempotency key replay historical success. Changed commercial terms are issued under a new proposal_id, so no separate proposal version is required."},"opportunity":{"allOf":[{"$ref":"#/$defs/external:core~1opportunity-context.json"},{"properties":{"status":{"const":"closed"}},"if":{"properties":{"status":{"const":"closed"}},"required":["status"]},"then":{"properties":{"close_reason":{"const":"accepted_with_seller"}}}}],"description":"Optional planning-cycle closure. Sellers infer successful proposal execution as closed with close_reason accepted_with_seller when status is omitted; when status is present it MUST be closed with that reason. If the proposal was issued under an opportunity_id, a supplied ID MUST match it."},"total_budget":{"type":"object","description":"Hard aggregate lifetime budget for the media buy. Required when executing a proposal and for seller-optimized explicit packages. Optional in fixed explicit-package mode; when present there, amount MUST equal the sum of package budgets. For a fixed proposal, the publisher applies allocation percentages to this amount. For a seller-optimized proposal or explicit buy, packages draw dynamically from this shared total.","properties":{"amount":{"type":"number","description":"Total budget amount","minimum":0},"currency":{"type":"string","description":"ISO 4217 currency code","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},"daily_budget_cap":{"type":"number","minimum":0,"description":"Optional hard aggregate daily spend ceiling in the media-buy currency. It limits total spend without allocating package amounts. Package caps are subordinate and need not sum to it. Requires advertised media_buy budget-capping scope; otherwise rejected with UNSUPPORTED_FEATURE."},"frequency_cap":{"$ref":"#/$defs/external:core~1media-buy-frequency-cap.json","description":"Optional max-impression cap using one counter across explicit packages. Requires advertised aggregate_frequency_capping and compatible media_buy_support on every product; otherwise sellers MUST reject with UNSUPPORTED_FEATURE before any mutation and MUST NOT silently drop, soften, or clamp the cap. Omit when executing proposal_id because accepted terms are authoritative."},"budget_cap_timezone":{"type":"string","minLength":1,"description":"Optional shared IANA day boundary override for all caps. Requires buyer_timezone_override; otherwise rejected with UNSUPPORTED_FEATURE. When omitted, budget_capping.timezone_basis selects Account.timezone or the advertised fixed_timezone."},"budget_allocation":{"allOf":[{"$ref":"#/$defs/external:core~1budget-allocation.json"}],"description":"How budget is allocated across explicit packages. Omission means fixed allocation (legacy-compatible). Buyer agents SHOULD send budget_allocation explicitly ({mode: \"fixed\"} or seller_optimized) rather than rely on omission, and when the principal's instruction does not determine whether the budget is one shared pool across packages or split per package, SHOULD ask the principal rather than guess. seller_optimized requires advertised media_buy.features.seller_optimized_budget; inside it, package budget caps, min_spend_target, and package pacing each require their own advertised sub-capability (seller_optimized_package_budgets, seller_optimized_min_spend_targets, seller_optimized_package_pacing), otherwise the request is rejected with UNSUPPORTED_FEATURE before any over-subscription validation. In proposal mode the committed proposal supplies this configuration and callers MUST omit it here."},"packages":{"type":"array","description":"Array of package configurations. Required when not using proposal_id. Mutually exclusive: provide packages or proposal_id, not both. Fixed allocation requires budget on every package. Seller-optimized allocation permits package budget to be omitted or to act as a hard cap. When executing a proposal, omit packages; the seller derives them from the committed proposal.","items":{"$ref":"#/$defs/external:media-buy~1package-request.json"},"minItems":1},"brand":{"$ref":"#/$defs/external:core~1brand-ref.json","description":"Brand reference for this media buy. Resolved to full brand identity at execution time from brand.json or the registry."},"advertiser_industry":{"$ref":"#/$defs/external:enums~1advertiser-industry.json","description":"Industry classification for this specific campaign. A brand may operate across multiple industries (brand.json industries field), but each media buy targets one. For example, a consumer health company running a wellness campaign sends 'healthcare.wellness', not 'cpg'. Sellers map this to platform-native codes (e.g., Spotify ADV categories, LinkedIn industry IDs). When omitted, sellers may infer from the brand manifest's industries field."},"invoice_recipient":{"$ref":"#/$defs/external:core~1business-entity.json","description":"Override the account's default billing entity for this specific buy. When provided, the seller invoices this entity instead. The seller MUST validate the invoice recipient is authorized for this account. When governance_agents are configured, the seller MUST include invoice_recipient in the check_governance request."},"io_acceptance":{"type":"object","description":"Acceptance of an insertion order from a committed proposal. Required when the proposal's insertion_order has requires_signature: true. References the io_id from the proposal's insertion_order.","properties":{"io_id":{"type":"string","description":"The io_id from the proposal's insertion_order being accepted"},"accepted_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the IO was accepted"},"signatory":{"type":"string","description":"Who accepted the IO — agent identifier or human name","minLength":1,"maxLength":250},"signature_id":{"type":"string","description":"Reference to the electronic signature from the signing service, when signing_url was used"}},"required":["io_id","accepted_at","signatory"],"additionalProperties":true},"po_number":{"type":"string","description":"Purchase order number for tracking"},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"\\S","description":"Human-readable name for this media buy, shared by buyer and seller for trafficking UI display and operational communication. When supplied, the seller MUST persist it and echo it unchanged on the create success response and subsequent get_media_buys reads. This display label is not an identifier or financial reference."},"agency_estimate_number":{"type":"string","maxLength":100,"description":"Agency estimate or authorization number. Primary financial reference for broadcast buys — links the order to the agency's media plan and billing system. Travels with the order and creative traffic identifiers through the transaction lifecycle."},"start_time":{"$ref":"#/$defs/external:core~1start-timing.json"},"end_time":{"type":"string","format":"date-time","description":"Campaign end date/time in ISO 8601 format"},"pacing":{"$ref":"#/$defs/external:enums~1pacing.json","description":"Aggregate pacing strategy for the media-buy budget across the media-buy flight. This controls how much the buy spends over time. Package pacing is subordinate and influences which package receives the aggregate spend; package pacing MUST NOT cause aggregate delivery to exceed this strategy. Defaults to even when total_budget is present. When executing a proposal that carries pacing, omit this field or send the identical value; the seller MUST reject a conflicting override with TERMS_REJECTED. In a seller-optimized buy, a seller declaring media_buy.features.seller_optimized_budget MUST accept omission and `even`; it MAY reject `asap` or `front_loaded` with UNSUPPORTED_FEATURE (error.field `pacing`) before any provider mutation and MUST NOT silently coerce them to `even`. Pacing carried by the seller's own committed proposal is not subject to that rejection. Fixed-allocation semantics are unchanged."},"bidding":{"allOf":[{"$ref":"#/$defs/external:core~1bidding-policy.json"}],"description":"Complete media-buy bidding default inherited by packages that omit package.bidding. `{automatic:true}` records an explicit automatic policy. In seller-optimized mode, cost_per/roas bind to the primary budget_allocation.optimization_goals goal. In fixed mode, inherited cost_per is valid only when inheriting package primary-goal result units are compatible; inherited roas requires value-bearing primary goals. Every monetary field uses total_budget.currency or the single currency derived for the media buy, and every affected pricing option MUST declare that currency. Sellers MUST reject incompatible units, combinations, currency, or overrides before mutation with BIDDING_PLACEMENT_CONFLICT. Media-buy bidding combined with any inheriting package's legacy bid_price or legacy monetary optimization-goal target is ambiguous and MUST be rejected with AMBIGUOUS_BIDDING_POLICY."},"paused":{"type":"boolean","description":"Create the media buy in a paused delivery state. When true, and the buy would otherwise be active because creatives are assigned and the flight has started, the seller returns media_buy_status 'paused'. Setup blockers still take precedence: a buy with no creatives remains 'pending_creatives', and a future-dated buy remains 'pending_start' until its flight can start. Defaults to false.","default":false},"push_notification_config":{"$ref":"#/$defs/external:core~1push-notification-config.json","description":"Optional webhook configuration for async task status notifications. Publisher will send webhooks when status changes (working, input-required, completed, failed, canceled). Buyers SHOULD supply `push_notification_config.operation_id` as the canonical correlation value; publishers echo that field back verbatim in webhook payloads and MUST NOT parse the URL to derive it."},"reporting_webhook":{"$ref":"#/$defs/external:core~1reporting-webhook.json","description":"Optional webhook configuration for automated reporting delivery"},"artifact_webhook":{"$comment":"Webhook configuration for content artifact delivery - enables governance validation. Same authentication structure as reporting_webhook.","type":"object","description":"Optional webhook configuration for content artifact delivery. Used by governance agents to validate content adjacency. Seller pushes artifacts to this endpoint; orchestrator forwards to governance agent for validation.","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for artifact delivery"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.","minLength":16},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration for webhook delivery (A2A-compatible). Opts the receiver into Bearer or HMAC-SHA256 signing. Both schemes are deprecated; the preferred signing profile for new integrations is RFC 9421, where the seller signs with a key published at its brand.json agents[] entry and the buyer verifies against the seller's JWKS — no shared secret crosses the wire (see docs/building/by-layer/L1/security.mdx#webhook-callbacks). This field is required in AdCP 3.x; the requirement is removed in AdCP 4.0 when the default RFC 9421 path becomes the only path.","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD use the RFC 9421 webhook signing profile instead.","items":{"$ref":"#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false},"delivery_mode":{"type":"string","enum":["realtime","batched"],"description":"How artifacts are delivered. 'realtime' pushes artifacts as impressions occur. 'batched' aggregates artifacts and pushes periodically (see batch_frequency)."},"batch_frequency":{"type":"string","enum":["hourly","daily"],"description":"For batched delivery, how often to push artifacts. Required when delivery_mode is 'batched'."},"sampling_rate":{"type":"number","minimum":0,"maximum":1,"description":"Fraction of impressions to include (0-1). 1.0 = all impressions, 0.1 = 10% sample. Default: 1.0"}},"required":["url","authentication","delivery_mode"],"additionalProperties":true},"context":{"$ref":"#/$defs/external:core~1context.json"},"ext":{"$ref":"#/$defs/external:core~1ext.json"}},"required":["idempotency_key","account","brand","start_time","end_time"],"additionalProperties":true,"$defs":{"external:core/version-envelope.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/version-envelope.json","title":"AdCP Version Envelope","description":"Release-precision AdCP protocol version negotiation fields. Composed via `allOf` into AdCP request schemas and shared response components so the version semantics live in one place. Strict (`additionalProperties: false`) request schemas also redeclare these two fields in their own `properties` via `$ref`, because draft-07 does not evaluate properties across `allOf`. The Trusted Match match requests are the exception: they inline both fields for their strict privacy boundary. Distinct from `core/protocol-envelope.json`, which wraps responses at the transport layer (context_id / task_id / status / payload). This envelope is part of the payload itself.","type":"object","properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99}}},"external:core/account-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/account-ref.json","title":"Account Reference","description":"Reference to an advertiser account by seller-assigned ID or natural key. account_id is the seller/storefront handle returned by list_accounts. The natural key is brand + operator + optional operator_unit.id + optional fixed currency + optional buyer-selected account timezone + sandbox; it describes the advertiser object the seller resolves or provisions. After a capability-gated identity rekey, the former natural key is tombstoned and returns ACCOUNT_MOVED to authorized callers rather than resolving or provisioning another account. brand.countries qualifies the advertiser's geographic identity. operator_unit identifies the operator-owned buying seat or business unit and is distinct from the seller account. operator_unit.name is display metadata and does not participate in identity. Use account_id when the seller or upstream platform owns the canonical account namespace; use the natural key for buyer-declared accounts (require_operator_auth: false).","type":"object","oneOf":[{"properties":{"account_id":{"type":"string","description":"Seller-assigned account identifier. For upstream-managed account namespaces, this value comes from list_accounts; for seller-defined namespaces without a list_accounts surface, it is supplied out-of-band. Buyer-declared account sellers MAY echo account_id from sync_accounts as an internal handle, but they MUST continue accepting the account's current natural-key AccountRef on subsequent calls. Buyers of buyer-declared accounts send the natural key; a seller MAY also accept its echoed account_id, and buyers MUST NOT assume it does. A former key tombstoned by identity reconciliation returns ACCOUNT_MOVED to authorized callers.","x-entity":"account"}},"required":["account_id"],"additionalProperties":false},{"properties":{"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Brand reference identifying the advertiser"},"operator":{"type":"string","description":"Domain of the entity operating on the brand's behalf. When the brand operates directly, this is the brand's domain.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","x-entity":"operator"},"operator_unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1operator-unit.json","description":"Optional operator-owned business unit, agency seat, or platform account. Only id participates in the natural account key; name is mutable display metadata."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Immutable ISO 4217 transaction currency when the seller's advertiser object is currency-bound. When present, this is part of the natural account key and media buys on the account MUST use it. Omit when currency is selected independently per media buy."},"timezone":{"type":"string","minLength":1,"description":"Immutable account timezone. Include it in the natural key when get_adcp_capabilities.account.timezone declares account_fixed with buyer_selected; omit it for seller_fixed or seller_assigned accounts."},"sandbox":{"type":"boolean","description":"When true, references the sandbox account for this brand/operator pair. Defaults to false (production account).","default":false}},"required":["brand","operator"],"additionalProperties":false}],"examples":[{"account_id":"acc_acme_001"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com"},{"brand":{"domain":"nova-brands.com","brand_id":"spark"},"operator":"pinnacle-media.com"},{"brand":{"domain":"nova-athletics.example","countries":["NL"]},"operator":"nova-athletics.example","operator_unit":{"id":"234284238","name":"Nova EMEA"},"currency":"EUR","timezone":"Europe/Amsterdam"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com","sandbox":true}]},"external:core/brand-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/brand-ref.json","title":"Brand Reference","description":"Reference to a brand by domain and optional brand_id. The domain hosts /.well-known/brand.json or is registered in the brand registry. For single-brand domains, brand_id can be omitted. For house-of-brands domains, brand_id identifies the specific brand. For creative production, brand.json is the canonical source of master brand identity (logo, palette, fonts, voice, and visual guidelines), subject only to the supported per-call fields in brand_kit_override. Catalogs supply product or item payload; catalog item asset groups, including property- or franchise-level logos, are item identity and do not override these master brand fields.","type":"object","properties":{"domain":{"type":"string","description":"Domain where /.well-known/brand.json is hosted, or the brand's operating domain","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"brand_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-id.json","description":"Brand identifier within the house portfolio. Optional for single-brand domains."},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting."},"industries":{"type":"array","items":{"type":"string"},"description":"Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."},"data_subject_contestation":{"type":"object","description":"Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.","properties":{"url":{"type":"string","format":"uri","pattern":"^https://"},"email":{"type":"string","format":"email"},"languages":{"type":"array","items":{"type":"string"}}},"anyOf":[{"required":["url"]},{"required":["email"]}],"additionalProperties":false},"brand_kit_override":{"type":"object","description":"Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call — e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` — the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently — when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently — a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.","properties":{"logo":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1image-asset.json","description":"Override logo asset."},"colors":{"type":"object","description":"Override brand colors (hex strings).","properties":{"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"secondary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"additionalProperties":true},"voice":{"type":"string","description":"Override brand-voice description for surface-composed text/audio output."},"tagline":{"type":"string","description":"Override tagline."}},"additionalProperties":true}},"required":["domain"],"additionalProperties":false,"examples":[{"domain":"nova-brands.com","brand_id":"spark"},{"domain":"nova-brands.com","brand_id":"glow"},{"domain":"acme-corp.com"},{"domain":"nova-athletics.example","countries":["NL"]}]},"external:core/brand-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/brand-id.json","title":"Brand ID","description":"Identifier for a brand within a house portfolio. Must be lowercase alphanumeric with underscores only. The house chooses this identifier.","type":"string","pattern":"^[a-z0-9_]+$","x-entity":"advertiser_brand","examples":["tide","cheerios","air_jordan","nike","pampers"]},"external:core/assets/image-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/image-asset.json","title":"Image Asset","description":"Image asset with URL and dimensions","type":"object","properties":{"asset_type":{"type":"string","const":"image","description":"Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the image asset"},"width":{"type":"integer","minimum":1,"description":"Width in pixels"},"height":{"type":"integer","minimum":1,"description":"Height in pixels"},"file_size_bytes":{"type":"integer","minimum":1,"description":"Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Intrinsic pixels per logical render pixel (for example `2` for a 600×500 image intended to render at 300×250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields."},"state_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots."},"breakpoint_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots."},"focal_point":{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":2,"maxItems":2,"description":"Normalized `[x, y]` coordinates (0–1 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults."},"format":{"type":"string","description":"Image file format (jpg, png, gif, webp, etc.)"},"alt_text":{"type":"string","description":"Alternative text for accessibility","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","width","height"],"additionalProperties":true},"external:core/provenance.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/provenance.json","title":"Provenance","description":"Declares how content was produced, whether AI was involved, and what disclosure obligations apply. Attaches to creative manifests, individual assets, or content-standards artifacts. When present at multiple levels, the most specific provenance object replaces the inherited one entirely (no field-level merging). Provenance is a claim by the declaring party — receiving parties should verify claims independently via their own detection tools.","type":"object","properties":{"digital_source_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1digital-source-type.json","description":"IPTC-aligned classification of AI involvement in producing this content"},"synthetic_depiction":{"type":"boolean","description":"Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`."},"ai_tool":{"type":"object","description":"AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.","properties":{"name":{"type":"string","description":"Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"},"version":{"type":"string","description":"Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."},"provider":{"type":"string","description":"Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"}},"required":["name"]},"human_oversight":{"type":"string","description":"Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` — the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.","enum":["none","prompt_only","selected","edited","directed"],"enumDescriptions":{"none":"Fully automated with no human involvement in generation","prompt_only":"Human provided the prompt or instructions but did not review outputs","selected":"Human selected from multiple AI-generated candidates","edited":"Human edited or refined AI-generated output","directed":"Human directed the creative process with AI as an assistive tool"}},"declared_by":{"type":"object","description":"Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent or service that declared this provenance"},"role":{"type":"string","enum":["creator","advertiser","agency","platform","tool"],"description":"Role of the declaring party in the supply chain","enumDescriptions":{"creator":"The party that created or generated the content","advertiser":"The brand or advertiser that owns the content","agency":"Agency acting on behalf of the advertiser","platform":"Ad platform or publisher that processed the content","tool":"Automated tool or service that attached provenance metadata"}}},"required":["role"]},"declared_at":{"type":"string","format":"date-time","description":"When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."},"created_time":{"type":"string","format":"date-time","description":"When this content was created or generated (ISO 8601)"},"c2pa":{"type":"object","description":"C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.","properties":{"manifest_url":{"type":"string","format":"uri","description":"URL to the C2PA manifest store for this content"}},"required":["manifest_url"]},"embedded_provenance":{"type":"array","description":"Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1embedded-provenance-method.json","description":"How provenance data is carried within the content"},"standard":{"type":"string","description":"Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)"},"provider":{"type":"string","description":"Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"embedded_at":{"type":"string","format":"date-time","description":"When the provenance data was embedded (ISO 8601)"}},"required":["method","provider"]}},"watermarks":{"type":"array","description":"Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"media_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1watermark-media-type.json","description":"Media category of the watermarked content"},"provider":{"type":"string","description":"Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"c2pa_action":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1c2pa-watermark-action.json","description":"C2PA action classification for this watermark"},"embedded_at":{"type":"string","format":"date-time","description":"When the watermark was applied (ISO 8601)"}},"required":["media_type","provider"]}},"disclosure":{"type":"object","description":"Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.","properties":{"required":{"type":"boolean","description":"The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain — useful as a routing and audit input — not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."},"jurisdictions":{"type":"array","description":"Jurisdictions where disclosure obligations apply","items":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"},"region":{"type":"string","description":"Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"},"regulation":{"type":"string","description":"Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"},"label_text":{"type":"string","description":"Required disclosure label text for this jurisdiction, in the local language"},"render_guidance":{"type":"object","description":"How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.","minProperties":1,"properties":{"persistence":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-persistence.json","description":"How long the disclosure must persist during content playback or display"},"min_duration_ms":{"type":"integer","minimum":1,"description":"Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."},"positions":{"type":"array","description":"Preferred disclosure positions in priority order. The first position a format supports should be used.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-position.json"},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}}}},"required":["country","regulation"]},"minItems":1}},"required":["required"]},"verification":{"type":"array","description":"Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.","minItems":1,"items":{"type":"object","properties":{"verified_by":{"type":"string","description":"Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"},"verified_time":{"type":"string","format":"date-time","description":"When the verification was performed (ISO 8601)"},"result":{"type":"string","enum":["authentic","ai_generated","ai_modified","inconclusive"],"description":"Verification outcome"},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Confidence score of the verification result (0.0 to 1.0)"},"details_url":{"type":"string","format":"uri","description":"URL to the full verification report"}},"required":["verified_by","result"]}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}}},"external:enums/digital-source-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/digital-source-type.json","title":"Digital Source Type","description":"Classification of AI involvement in content creation, aligned with IPTC digitalsourcetype vocabulary. Used in provenance metadata to declare how a creative asset, artifact, or individual asset was produced.","type":"string","enum":["digital_capture","digital_creation","trained_algorithmic_media","composite_with_trained_algorithmic_media","algorithmic_media","composite_capture","composite_synthetic","human_edits","data_driven_media"],"enumDescriptions":{"digital_capture":"Captured by a digital device (camera, scanner, screen recording) with no AI involvement","digital_creation":"Created by a human using digital tools (Photoshop, Illustrator, After Effects) without AI generation","trained_algorithmic_media":"Generated entirely by a trained AI model (DALL-E, Midjourney, Stable Diffusion, Sora)","composite_with_trained_algorithmic_media":"Human-created content combined with AI-generated elements (e.g., photo with AI background)","algorithmic_media":"Produced by deterministic algorithms without machine learning (procedural generation, rule-based systems)","composite_capture":"Multiple digital captures composited together without AI","composite_synthetic":"Composite of multiple elements where at least one is AI-generated (e.g., stock photo composited with AI-generated background)","human_edits":"Content augmented, corrected, or enhanced by humans using non-generative tools","data_driven_media":"Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"}},"external:enums/embedded-provenance-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/embedded-provenance-method.json","title":"Embedded Provenance Method","description":"How provenance data is carried within the content stream. Distinguishes between format-level manifest embedding (where the manifest travels inside the file container) and provenance markers (where invisible markers in the content itself encode or reference a provenance record). Both survive operations that strip sidecar metadata, but provenance markers additionally survive content-level transformations such as copy-paste, reformatting, and CMS re-encoding.","type":"string","enum":["manifest_wrapper","provenance_markers"],"enumDescriptions":{"manifest_wrapper":"A provenance manifest embedded in the file container per format-specific rules (e.g., JUMBF box in JPEG, C2PATextManifestWrapper in plaintext per C2PA Section A.7). The manifest travels with the file but is tied to the file's byte structure.","provenance_markers":"Invisible markers embedded within the content stream that encode or reference a provenance record. Designed to survive reformatting, copy-paste, CMS ingestion, and ad-server transcoding that breaks file-level bindings."}},"external:enums/watermark-media-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/watermark-media-type.json","title":"Watermark Media Type","description":"Media category of a content watermark. Identifies what kind of content the watermark is applied to, which determines the detection and verification methods required.","type":"string","enum":["audio","image","video","text"],"enumDescriptions":{"audio":"Watermark applied to audio content (e.g., spread-spectrum, echo hiding)","image":"Watermark applied to image content (e.g., spatial domain, frequency domain)","video":"Watermark applied to video content (e.g., per-frame image watermarking, temporal watermarking)","text":"Watermark applied to text content (e.g., synonym substitution, structural modification)"}},"external:enums/c2pa-watermark-action.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/c2pa-watermark-action.json","title":"C2PA Watermark Action","description":"C2PA action classification for a content watermark. Distinguishes watermarks that are cryptographically linked to a C2PA manifest (bound) from watermarks that exist independently (unbound). Aligns with the c2pa.watermarked.* action family in the C2PA action taxonomy.","type":"string","enum":["c2pa.watermarked.bound","c2pa.watermarked.unbound"],"enumDescriptions":{"c2pa.watermarked.bound":"Watermark linked to a C2PA manifest for this asset. The watermark and manifest are mutually reinforcing: the manifest references the watermark, and the watermark can be used to locate the manifest.","c2pa.watermarked.unbound":"Watermark independent of any C2PA manifest. Applied before any provenance signing event (e.g., by the AI generator at creation time) or in pipelines where no manifest is present."}},"external:enums/disclosure-persistence.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/disclosure-persistence.json","title":"Disclosure Persistence","description":"How long a disclosure must persist during content playback or display. Different jurisdictions and regulations require different persistence behaviors for AI-generated content labels. When multiple sources specify persistence for the same jurisdiction (e.g., brief and provenance), the most restrictive mode applies: continuous > initial > flexible.","type":"string","enum":["continuous","initial","flexible"],"enumDescriptions":{"continuous":"Disclosure must remain visible or audible throughout the entire content display duration. For video and audio, this means the full playback duration. For static formats (display, DOOH), this means the full display slot. For DOOH specifically, 'content duration' means the ad's display slot within the rotation, not the screen's full rotation cycle.","initial":"Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.","flexible":"Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"}},"external:enums/disclosure-position.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/disclosure-position.json","title":"Disclosure Position","description":"Where a required disclosure should appear within a creative. Used by creative briefs to specify disclosure placement and by formats to declare which positions they can render.","type":"string","enum":["prominent","footer","audio","subtitle","overlay","end_card","pre_roll","companion"]},"external:core/ext.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/ext.json","title":"Extension Object","description":"Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.","type":"object","additionalProperties":true},"external:core/operator-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/operator-unit.json","title":"Operator Unit","description":"Operator-owned buying context used to distinguish business units, agency seats, or platform accounts beneath one operator domain. The id is stable identity in the operator's namespace; name is mutable display metadata and never participates in account identity.","x-entity":"operator_unit","type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*$","description":"Stable identifier assigned by the operator. Numeric platform IDs and durable slugs are both valid. Scoped by the enclosing operator domain."},"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable seat or business-unit name, such as Nova EMEA. This label may change and is not part of the natural account key."}},"required":["id"],"additionalProperties":false,"examples":[{"id":"234284238","name":"Nova EMEA"},{"id":"benelux-seat","name":"Nova Benelux"}]},"external:core/opportunity-context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/opportunity-context.json","title":"Opportunity Context","description":"Buyer-supplied context for one planning cycle across proposal request, decline, and media-buy creation. The opaque opportunity_id is stable within the seller and account scope; sellers associate it with proposals without treating it as proposal identity.","type":"object","properties":{"opportunity_id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{1,255}$","x-entity":"opportunity","description":"Opaque buyer-assigned identifier for this planning cycle, scoped to the seller and account."},"phase":{"type":"string","enum":["exploratory","planning","active_sourcing"],"description":"Current stage of buyer planning."},"intent":{"type":"string","enum":["test","speculative","planning","live_rfp"],"description":"How seriously the buyer is evaluating supply in this cycle."},"planning_horizon":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1date-range.json","description":"Inclusive calendar range in which the buyer expects the campaign to run."},"response_deadline":{"type":"string","format":"date-time","description":"Deadline by which the buyer needs a seller response."},"status":{"type":"string","enum":["open","closed"],"description":"Whether the planning cycle remains open. On calls after initial creation, omission means no status update and MUST NOT reopen or close the opportunity implicitly, except that successful create_media_buy proposal execution explicitly infers accepted closure."},"close_reason":{"type":"string","enum":["accepted_with_seller","purchased_elsewhere","selected_alternative","not_pursued","budget_changed","timing_changed","other"],"description":"Why the opportunity closed. Required when status is closed."},"close_detail":{"type":"string","minLength":1,"maxLength":500,"description":"Optional non-sensitive context about closure. MUST NOT identify a competitor or disclose confidential clearing terms."}},"required":["opportunity_id"],"allOf":[{"if":{"properties":{"status":{"const":"closed"}},"required":["status"]},"then":{"required":["close_reason"]},"else":{"not":{"anyOf":[{"required":["close_reason"]},{"required":["close_detail"]}]}}},{"if":{"properties":{"close_reason":{"const":"other"}},"required":["close_reason"]},"then":{"required":["close_detail"]}}],"additionalProperties":false},"external:core/date-range.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/date-range.json","title":"Date Range","description":"A date range with inclusive start and end dates (ISO 8601 calendar dates). Used for billing periods, flight dates, and other calendar-day boundaries.","type":"object","properties":{"start":{"type":"string","format":"date","description":"Start date (inclusive), ISO 8601"},"end":{"type":"string","format":"date","description":"End date (inclusive), ISO 8601"}},"required":["start","end"],"additionalProperties":true},"external:core/media-buy-frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/media-buy-frequency-cap.json","title":"Media Buy Frequency Cap","description":"A MediaBuy-level maximum-impression cap. The counter is shared across participating packages for the declared per unit. Duration windows are rolling elapsed windows; campaign spans the MediaBuy flight. Aggregate suppression is not defined in 3.2 because suppress-only FrequencyCap values do not identify a counter entity.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1frequency-cap.json"},{"required":["max_impressions"],"not":{"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]}]}}]},"external:core/frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/frequency-cap.json","title":"Frequency Cap","description":"Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.","type":"object","properties":{"suppress":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {\"interval\": 60, \"unit\": \"minutes\"} for a 1-hour cooldown). Preferred over suppress_minutes."},"suppress_minutes":{"type":"number","deprecated":true,"description":"Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).","minimum":0},"max_impressions":{"type":"integer","description":"Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window. campaign applies across the owning field's full flight: the package flight for a targeting overlay, or the MediaBuy flight for a root cap.","minimum":1},"per":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1reach-unit.json"}],"description":"Entity granularity for impression counting. Required when max_impressions is set."},"window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Time window for the max_impressions cap (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Required when max_impressions is set."}},"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]},{"required":["max_impressions"]}],"additionalProperties":true,"dependentRequired":{"max_impressions":["per","window"],"per":["max_impressions"],"window":["max_impressions"]}},"external:core/duration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/duration.json","title":"Duration","description":"A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.","type":"object","properties":{"interval":{"type":"integer","minimum":1,"description":"Number of time units. Must be 1 when unit is 'campaign'."},"unit":{"type":"string","enum":["seconds","minutes","hours","days","campaign"],"description":"Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."}},"required":["interval","unit"],"additionalProperties":false},"external:enums/reach-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/reach-unit.json","title":"Reach Unit","description":"Unit of measurement for reach and audience size metrics. Different channels and measurement providers count reach in fundamentally different units, making cross-channel comparison impossible without declaring the unit.","type":"string","enum":["individuals","households","devices","accounts","cookies","custom"],"enumDescriptions":{"individuals":"Unique people. Panel-based or identity-resolved measurement.","households":"Unique households or TV homes.","devices":"Unique device identifiers (IDFA, GAID, CTV device ID).","accounts":"Unique logged-in accounts (platform-specific identity).","cookies":"Unique browser cookies.","custom":"Seller-defined reach unit. Describe in ext. For a Product.identity declaration with persistent_identifier false, describe the unit in Product.identity.reach_methodology."}},"external:core/budget-allocation.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/budget-allocation.json","title":"Budget Allocation","description":"How a media buy's total budget is allocated across its packages. Omission on a request means fixed allocation (legacy-compatible); buyer agents SHOULD send this block explicitly ({mode: \"fixed\"} or seller_optimized) rather than rely on omission, and SHOULD ask the principal rather than guess when the instruction does not determine whether the budget is one shared pool or split per package. Fixed allocation preserves independent package budgets. Seller-optimized allocation delegates continuous cross-package allocation to the seller within the media-buy total, package caps, minimum-spend targets, flight windows, and pacing controls. The core seller-optimized contract is gated by media_buy.features.seller_optimized_budget; package caps, minimum-spend targets, and package pacing are separately gated by seller_optimized_package_budgets, seller_optimized_min_spend_targets, and seller_optimized_package_pacing; an undeclared package control is rejected with UNSUPPORTED_FEATURE before any over-subscription validation. Core seller-optimized pacing guarantees only omitted or `even` media-buy pacing; sellers MAY reject `asap` or `front_loaded` with UNSUPPORTED_FEATURE and MUST NOT coerce them to `even`. When a seller-optimized media-buy BiddingPolicy carries cost_per or roas, that control binds to this allocation block's primary optimization goal rather than independently to each package goal.","x-adcp-hoist":true,"discriminator":{"propertyName":"mode"},"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"fixed","description":"Packages have independent budgets. The seller does not automatically move budget between packages."}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"seller_optimized","description":"Packages draw from a shared media-buy budget. The seller continuously allocates spend across packages to optimize the declared goals."},"optimization_goals":{"type":"array","description":"Goals the seller uses to allocate the shared budget across packages. These are distinct from packages[].optimization_goals, which optimize delivery within an individual package. The primary goal is the earliest array entry among goals with the lowest explicit numeric priority; goals without priority follow all explicitly prioritized goals; when all priorities are omitted, the first entry is primary. It supplies the result unit/value source for media-buy bidding.cost_per or bidding.roas. Legacy monetary target kinds are prohibited at allocation scope because canonical controls belong in media-buy bidding. Every participating product MUST support the primary cross-package goal; otherwise the seller MUST reject the request with TERMS_REJECTED or UNSUPPORTED_FEATURE and identify the incompatible package.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1optimization-goal.json"},{"not":{"properties":{"target":{"properties":{"kind":{"enum":["cost_per","per_ad_spend"]}},"required":["kind"]}},"required":["target"]}}]},"minItems":1}},"required":["mode","optimization_goals"],"additionalProperties":false}]},"external:core/optimization-goal.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/optimization-goal.json","title":"Optimization Goal","description":"A single objective function: what to maximize or optimize, in what units, and in what priority order. Used on packages to optimize delivery within one package and on seller-optimized budget allocations to allocate spend across packages. Currency-bearing execution policy belongs in BiddingPolicy in 3.2. Legacy target.cost_per and target.per_ad_spend remain accepted only on package goals for migration and are deprecated. The primary goal is the earliest array entry among goals with the lowest explicit numeric priority; goals without priority follow all explicitly prioritized goals; when all priorities are omitted, the first entry is primary. This array-order tie-break makes duplicate priorities deterministic.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","description":"Optimize for a seller-tracked delivery metric. No event source required — the seller tracks these natively.","properties":{"kind":{"type":"string","const":"metric"},"metric":{"type":"string","enum":["clicks","views","completed_views","viewed_seconds","viewable_rate","attention_seconds","attention_score","engagements","follows","saves","profile_visits","reach"],"description":"Seller-native metric to optimize for. Delivery metrics: clicks (link clicks, swipe-throughs, CTA taps that navigate away), views (content views at the billable view threshold, as defined by delivery-metrics `views`; for viewability use viewable_rate), completed_views (video/audio completions — see view_duration_seconds), reach (unique audience reach — see reach_unit and target_frequency). Duration/score metrics: viewed_seconds (time in view per impression — reported back via `delivery-metrics.viewability.viewed_seconds`, governed by the viewability `standard`). Quality-rate metrics: viewable_rate (viewable / measurable impressions under the goal's `standard`; requires `standard`). Audience action metrics: engagements (any direct interaction with the ad unit beyond viewing — social reactions/comments/shares, story/unit opens, interactive overlay taps, companion banner interactions on audio and CTV), follows (new followers, page likes, artist/podcast/channel follows, or free channel/feed subscribes; paid subscriptions use event_type: subscribe), saves (saves, bookmarks, playlist adds, pins — signals of intent to return), profile_visits (visits to the brand's in-platform page — profile, artist page, channel, or storefront. Does not include external website clicks, which are covered by 'clicks'). **DEPRECATED values** (slated for removal at next major): `attention_seconds` and `attention_score` — these have no industry-graduated definition (DoubleVerify, IAS, Adelaide, TVision, Lumen each define them differently) and cannot be meaningfully optimized for without a vendor binding. Use `kind: 'vendor_metric'` with an explicit `vendor` and `metric_id` instead — that path binds the goal to a specific measurement vendor and reconciles to the same `(vendor, metric_id)` key in delivery's `vendor_metric_values[]`. Sellers MAY reject the deprecated values with `TERMS_REJECTED` and a suggestion to use the `vendor_metric` kind."},"standard":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json"}],"description":"Viewability standard the goal is judged against. Required when metric is 'viewable_rate'; optional for 'viewed_seconds' (seller default standard when omitted); not allowed for other metrics. Must be in metric_optimization.supported_viewability_standards when declared. A goal below a same-standard viewability performance_standard never relaxes that standard."},"vendor":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"}],"description":"Measurement vendor judging a viewable_rate or viewed_seconds goal; not allowed for other metrics. When omitted, the seller's default viewability measurement applies. Sellers MUST reject a vendor they cannot optimize against rather than substitute another."},"reach_unit":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1reach-unit.json"}],"description":"Unit for reach measurement. Required when metric is 'reach'. Must be a value declared in the product's metric_optimization.supported_reach_units."},"target_frequency":{"type":"object","description":"Target frequency band for reach optimization. Only applicable when metric is 'reach'. Frames frequency as an optimization signal: the seller should treat impressions toward entities already within the [min, max] band as lower-value, and impressions toward unreached entities as higher-value. This shifts budget toward fresh reach rather than re-reaching known users. When omitted, the seller maximizes unique reach without a frequency constraint. A hard cap can still be layered via targeting_overlay.frequency_cap if a ceiling is needed.","properties":{"min":{"type":"integer","minimum":1,"description":"Minimum frequency for an entity to be considered meaningfully reached within the window. Impressions that would bring an entity below this threshold are treated as high-value (growing reach). When omitted, the seller uses their platform default (typically 1)."},"max":{"type":"integer","minimum":1,"description":"Frequency at which an entity is considered saturated within the window. Impressions toward entities at or above this threshold are treated as lower-value. When both min and max are present, max must be greater than or equal to min. When omitted, the seller determines the saturation point."},"window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Time window over which frequency is measured (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Weekly windows are typical for brand campaigns; daily windows suit high-cadence direct response."}},"required":["window"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"view_duration_seconds":{"type":"number","exclusiveMinimum":0,"description":"Minimum video view duration in seconds that qualifies as a completed_view for this goal. Only applicable when metric is 'completed_views'. When omitted, the seller uses their platform default (typically 2–15 seconds). Common values: 2 (Snap/LinkedIn default), 6 (TikTok), 15 (Snap 15-second views, Meta ThruPlay). Sellers declare which durations they support in metric_optimization.supported_view_durations. Sellers must reject goals with unsupported values — silent rounding would create measurement discrepancies."},"target":{"description":"Target for this metric. When omitted, the seller optimizes for maximum metric volume within budget.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","deprecated":true,"description":"DEPRECATED legacy target cost per unit of the metric. Normalize to package.bidding.cost_per with strength target while retaining this goal as the objective.","properties":{"kind":{"type":"string","const":"cost_per"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target cost per metric unit in the buy currency"}},"required":["kind","value"],"additionalProperties":true},{"type":"object","description":"Minimum per-impression rate for this metric. The metric defines the units: proportions for count metrics (e.g., 0.001 for 0.1% CTR, 0.70 for 70% viewable_rate), seconds for duration metrics (e.g., 3.0 for 3s in view), or score for score metrics.","properties":{"kind":{"type":"string","const":"threshold_rate"},"value":{"type":"number","exclusiveMinimum":0,"description":"Minimum per-impression value. Units depend on the metric: proportion (clicks, views, completed_views, viewable_rate), seconds (viewed_seconds, attention_seconds), or score (attention_score)."}},"required":["kind","value"],"additionalProperties":true}]},"priority":{"type":"integer","minimum":1,"description":"Relative priority among sibling goals. Lower numbers rank first. Goals without priority follow explicitly prioritized goals. Ties use array order, so the earliest goal at the lowest explicit priority is primary; when all priorities are omitted, the first goal is primary."}},"required":["kind","metric"],"allOf":[{"if":{"properties":{"metric":{"const":"viewable_rate"}},"required":["metric"]},"then":{"required":["standard"],"properties":{"target":{"properties":{"kind":{"const":"threshold_rate"},"value":{"maximum":1}}}}}},{"if":{"properties":{"metric":{"enum":["viewable_rate","viewed_seconds"]}},"required":["metric"]},"else":{"not":{"anyOf":[{"required":["standard"]},{"required":["vendor"]}]}}}],"additionalProperties":true},{"type":"object","description":"Optimize for advertiser-tracked conversion events. Requires event sources registered via sync_event_sources.","properties":{"kind":{"type":"string","const":"event"},"event_sources":{"type":"array","description":"Event source and type pairs that feed this goal. Each entry identifies a source and event type to include. When the seller supports multi_source_event_dedup (declared in get_adcp_capabilities), they deduplicate by event_id across all entries — the same business event from multiple sources counts once, using value_field and value_factor from the first matching entry. When multi_source_event_dedup is false or absent, buyers should use a single entry per goal; the seller will use only the first entry. All event sources must be configured via sync_event_sources.","items":{"type":"object","properties":{"event_source_id":{"type":"string","minLength":1,"description":"Event source to include (must be configured on this account via sync_event_sources)"},"event_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1event-type.json","description":"Event type to include from this source (e.g., purchase, lead, app_install, refund)"},"custom_event_name":{"type":"string","description":"Required when event_type is 'custom'. Platform-specific name for the custom event."},"value_field":{"type":"string","description":"Which field in the event's custom_data carries the monetary value. The seller must use this field for value extraction and aggregation when computing ROAS and conversion value metrics. Required on at least one entry when target.kind is 'per_ad_spend' or 'maximize_value' — sellers must reject these target kinds when no event source entry includes value_field. When canonical bidding.roas binds to this goal, every referenced value-bearing source MUST declare value_currencies containing the media-buy currency; the seller validates this at buy creation. Once that source contract is declared, log_event rejects monetary records whose currency is missing or absent from the list. For each buy, only records exactly matching its media-buy currency contribute to ROAS; records in other declared currencies remain available to matching buys, and sellers MUST NOT convert between them. When present without a value-oriented target, the seller may use it for delivery reporting but must not change the objective. Common values: 'value', 'order_total', 'profit_margin'. This is not passed as a parameter to underlying platform APIs — the seller maps it to their platform's value ingestion mechanism."},"value_factor":{"type":"number","default":1,"description":"Unit-scaling multiplier the seller must apply to value_field before aggregation. Use -1 for refund events (negate the value), 0.01 for values in cents, -0.01 for refunds in cents. It MUST NOT be used for currency conversion. A value of 0 zeroes out this source's value contribution (the source still counts for event dedup). Defaults to 1. This is not passed as a parameter to underlying platform APIs — the seller applies it when computing aggregated value metrics."}},"required":["event_source_id","event_type"],"additionalProperties":true},"minItems":1},"target":{"description":"Target cost or return for this event goal. When omitted, the seller optimizes for maximum conversion count within budget — regardless of whether value_field is present on event sources. The presence of value_field alone does not change the optimization objective; it only makes value available for reporting. An explicit target of maximize_value or per_ad_spend is required to steer toward value.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","deprecated":true,"description":"DEPRECATED legacy target cost per conversion event. Normalize to package.bidding.cost_per with strength target while retaining this event goal as the objective.","properties":{"kind":{"type":"string","const":"cost_per"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target cost per event in the buy currency"}},"required":["kind","value"],"additionalProperties":true},{"type":"object","deprecated":true,"description":"DEPRECATED legacy target return per unit of ad spend. Normalize to package.bidding.roas with strength target while retaining this event goal and its value-bearing event source. Requires value_field on at least one event_sources entry.","properties":{"kind":{"type":"string","const":"per_ad_spend"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target return ratio (e.g., 4.0 means $4 of value per $1 spent)"}},"required":["kind","value"],"additionalProperties":true},{"type":"object","description":"Maximize total conversion value within budget, without a specific return ratio target. Steers spend toward higher-value conversions rather than maximizing conversion count. Requires value_field on at least one event_sources entry.","properties":{"kind":{"type":"string","const":"maximize_value"}},"required":["kind"],"additionalProperties":true}]},"attribution_window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attribution-window.json"}],"description":"Attribution window for this optimization goal — references the canonical `attribution-window` shape (post_click, post_view, model). Values must match an option declared in the seller's `conversion_tracking.attribution_windows` capability. Sellers MUST reject windows not in their declared capabilities. When the entire field is omitted, the seller uses their default window."},"priority":{"type":"integer","minimum":1,"description":"Relative priority among sibling goals. Lower numbers rank first. Goals without priority follow explicitly prioritized goals. Ties use array order, so the earliest goal at the lowest explicit priority is primary; when all priorities are omitted, the first goal is primary."}},"required":["kind","event_sources"],"additionalProperties":true},{"type":"object","description":"Optimize for a vendor-attested measurement metric. Use when the metric has no graduated industry-standard definition and must be reconciled to a specific vendor — e.g., attention (DoubleVerify, IAS, Adelaide, TVision, Lumen), panel-based brand lift (Kantar, Upwave, Cint), emissions (Scope3, Good-Loop), retail-media partner metrics. The vendor + metric_id pair binds buyer→seller→vendor end-to-end: the seller's bidding stack steers toward this specific vendor's measurement, and delivery reports the value via `vendor_metric_values[]` with the same `(vendor, metric_id)` key. Three preconditions for goal acceptance: (1) Discovery — the `metric_id` SHOULD appear in the vendor's published `measurement.metrics[]` catalog (queried from the vendor's `brand.json` `agents[type='measurement']`). Sellers SHOULD verify against a cached snapshot of the vendor's capability response; staleness handling is implementation-defined. SHOULD this minor while measurement-vendor adoption of AdCP-conformant capability publication catches up; tightens to MUST at the next minor. (2) Capability — the `(vendor, metric_id)` pair MUST appear in the product's `vendor_metric_optimization.supported_metrics[]`, and the goal's `target.kind` MUST appear in that entry's `supported_targets`. (3) Reporting coherence — the package's `committed_metrics[]` MUST include a matching `{ scope: 'vendor', vendor, metric_id }` entry. Sellers MUST reject goals failing the capability or reporting-coherence preconditions. Optimization without committed reporting is unverifiable and is therefore disallowed at the wire level. Precondition checks are seller-runtime; the schema's `required` only validates structural presence of `kind`, `vendor`, and `metric_id`.","properties":{"kind":{"type":"string","const":"vendor_metric"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor that defines and computes this metric. Same shape as `vendor_metric_values.vendor`, `reporting_capabilities.vendor_metrics[].vendor`, and `vendor_metric_optimization.supported_metrics[].vendor` — symmetric across discovery, capability, commitment, optimization, and reporting surfaces."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1vendor-metric-id.json","description":"Identifier for the metric within the vendor's vocabulary (e.g., `attention_score`, `attention_seconds`, `gco2e_per_impression`, `awareness_lift`). MUST be present in the vendor's published `measurement.metrics[]` catalog and in the product's `vendor_metric_optimization.supported_metrics[]`."},"target":{"description":"Target for this vendor metric. When omitted, the seller optimizes for maximum metric volume / score within budget. `cost_per` and `threshold_rate` semantics mirror the same target kinds on the `metric` kind — units are vendor-defined and depend on the vendor's `measurement.metrics[]` declaration for this `metric_id`.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","deprecated":true,"description":"DEPRECATED legacy target cost per vendor-metric unit. Normalize to package.bidding.cost_per with strength target while retaining this vendor-metric goal as the objective.","properties":{"kind":{"type":"string","const":"cost_per"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target cost per metric unit in the buy currency. Units of the metric are vendor-defined."}},"required":["kind","value"],"additionalProperties":true},{"type":"object","description":"Minimum per-impression value for this vendor metric (e.g., attention_score ≥ 70).","properties":{"kind":{"type":"string","const":"threshold_rate"},"value":{"type":"number","exclusiveMinimum":0,"description":"Minimum per-impression value. Units of the metric are vendor-defined."}},"required":["kind","value"],"additionalProperties":true}]},"priority":{"type":"integer","minimum":1,"description":"Relative priority among sibling goals. Lower numbers rank first. Goals without priority follow explicitly prioritized goals. Ties use array order, so the earliest goal at the lowest explicit priority is primary; when all priorities are omitted, the first goal is primary."}},"required":["kind","vendor","metric_id"],"additionalProperties":true}]},"external:enums/viewability-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/viewability-standard.json","title":"Viewability Standard","description":"Viewability measurement standard applied to determine whether an impression qualifies as viewable. These are materially different thresholds and should not be compared across standards.","type":"string","enum":["mrc","groupm"],"enumDescriptions":{"mrc":"MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).","groupm":"GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."}},"external:enums/event-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/event-type.json","title":"Event Type","description":"Standard marketing event types for event logging, aligned with IAB ECAPI","type":"string","enum":["page_view","view_content","select_content","select_item","search","share","add_to_cart","remove_from_cart","viewed_cart","add_to_wishlist","initiate_checkout","add_payment_info","purchase","refund","lead","qualify_lead","close_convert_lead","disqualify_lead","complete_registration","subscribe","follow","content_view","watch_milestone","start_trial","app_install","app_launch","contact","schedule","donate","submit_application","custom"],"enumDescriptions":{"page_view":"User viewed a page","view_content":"User viewed specific content (product, article, etc.)","select_content":"User selected or clicked on content (article, video, etc.)","select_item":"User selected a specific product or item from a list","search":"User performed a search","share":"User shared content via social or messaging","add_to_cart":"User added an item to cart","remove_from_cart":"User removed an item from cart","viewed_cart":"User viewed their shopping cart","add_to_wishlist":"User added an item to a wishlist","initiate_checkout":"User started checkout process","add_payment_info":"User added payment information","purchase":"User completed a purchase","refund":"A purchase was fully or partially refunded (adjusts ROAS)","lead":"User expressed interest (form submission, signup, etc.)","qualify_lead":"Lead qualified by sales or scoring criteria","close_convert_lead":"Lead converted to a customer or closed deal","disqualify_lead":"Lead disqualified or marked as not viable","complete_registration":"User completed account registration","subscribe":"User started a paid subscription or paid membership","follow":"User made a free, durable opt-in to an account, channel, feed, list, podcast, or similar owned property","content_view":"User meaningfully consumed a content unit, such as a watch, listen, stream, episode play, or read","watch_milestone":"User reached a content progress threshold, such as 25%, 50%, 75%, 100%, or a seconds-viewed milestone","start_trial":"User started a free trial","app_install":"User installed an application","app_launch":"User launched an application","contact":"User initiated contact (call, message, etc.)","schedule":"User scheduled an appointment or event","donate":"User made a donation","submit_application":"User submitted an application (loan, job, etc.)","custom":"Custom event type (specify in custom_event_name)"}},"external:core/attribution-window.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/attribution-window.json","title":"Attribution Window","description":"Describes the attribution methodology and lookback windows used for conversion measurement. Enables cross-platform comparison by making attribution methodology transparent. Used as a `$ref` from `optimization-goal.json` (buyer's optimization-time attribution choice), `get-media-buy-delivery-response.json` (seller-declared attribution methodology in delivery reports), and similar surfaces. All fields are optional individually but at least one of `post_click`, `post_view`, or `model` SHOULD be populated; absence of `model` means the seller's default attribution model applies (typically `last_touch` per industry convention) — sellers SHOULD populate `model` explicitly when committing to a specific methodology.","type":"object","properties":{"post_click":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Post-click attribution window. Conversions occurring within this duration after a click are attributed to the ad."},"post_view":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Post-view attribution window. Conversions occurring within this duration after an ad impression (without click) are attributed to the ad."},"model":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1attribution-model.json","description":"Attribution model used to assign credit when multiple touchpoints exist. SHOULD be populated when committing to a specific model; when absent, the seller's default applies."}},"additionalProperties":true},"external:enums/attribution-model.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/attribution-model.json","title":"Attribution Model","description":"Attribution model used for conversion measurement","type":"string","enum":["last_touch","first_touch","linear","time_decay","data_driven"]},"external:core/vendor-metric-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/vendor-metric-id.json","title":"Vendor Metric ID","description":"Identifier for a vendor-defined metric within the vendor's vocabulary. Stable lookup key; the vendor publishes the canonical list (with category, methodology, and standard alignment) in `brand.json` `agents[type='measurement']`. Lowercase with underscores so a future enum promotion into `available-metric.json` is a literal string lift. Identifier is namespaced by the vendor — the same `metric_id` may mean different things in different vendors' vocabularies.","type":"string","x-entity":"vendor_metric","minLength":1,"maxLength":64,"pattern":"^[a-z][a-z0-9_]*$","examples":["attention_units","gco2e_per_impression","demographic_reach","co_view_index","incremental_lift_percent"]},"external:media-buy/package-request.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/media-buy/package-request.json","title":"Package Request","description":"Package configuration for media buy creation.\n\n**Format selector contract (normative).** New 3.2 buyers author at most one canonical selector route: `format_option_refs`, or `format_kind` with optional `params`; omitting both selects all formats supported by the product. New buyers MUST NOT emit deprecated `format_ids`. During the 3.x compatibility window, receivers MUST continue to accept legacy-only `format_ids` and older requests that carry more than one selector route.\n\nReceivers process selectors in this order: (1) independently resolve each present route to canonical declarations, without applying route precedence; an unresolved `format_option_ref` or a legacy `format_id` that cannot be normalized through the canonical mapping path MUST be rejected with `UNSUPPORTED_FEATURE`; (2) when every route resolves, derive the product `format_options[]` entries selected by each route using directional product satisfaction, and require the selected option sets to match; legacy-to-canonical parameter compatibility uses the asymmetric [v2 narrows v1](/docs/creative/canonical-formats#narrows-formal-definition-normative) relation, not raw object equality; (3) reject different format shapes, selected option sets, or incompatible dimensions with `CONFLICTING_SELECTORS`; and only then (4) apply precedence: `format_option_refs`, then `format_kind` plus `params`, then `format_ids`. Equivalent legacy dual emission remains valid. A single resolved route that does not satisfy the product is rejected with `UNSUPPORTED_FEATURE`. `params` requires `format_kind`; for fixed-size image selectors, `width` and `height` MUST either both be present or both be absent.","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1version-envelope.json"},{"if":{"required":["bidding"]},"then":{"properties":{"optimization_goals":{"not":{"contains":{"properties":{"target":{"properties":{"kind":{"enum":["cost_per","per_ad_spend"]}},"required":["kind"]}},"required":["target"]}}}}}},{"if":{"properties":{"format_kind":{"const":"image"}},"required":["format_kind","params"]},"then":{"properties":{"params":{"dependentRequired":{"width":["height"],"height":["width"]}}}}}],"not":{"anyOf":[{"required":["capability_ids"]},{"required":["bidding","bid_price"]},{"required":["budget_cap_timezone"]}]},"properties":{"product_id":{"type":"string","description":"Opaque configured product ID returned by get_products. Selecting it accepts the product's disclosed targeting_resolution, pricing, forecast assumptions, and terms. Sellers MUST echo this value on every response package object that represents this requested package.","x-entity":"product"},"format_ids":{"type":"array","deprecated":true,"x-removed-in":"4.0.0","description":"Deprecated in AdCP 3.2; removed in AdCP 4.0. Legacy named-format selector retained for older 3.x peers. New buyers MUST NOT emit this field. Sellers MUST normalize every entry through the canonical mapping path before product satisfaction checks; an entry that cannot be normalized is rejected with `UNSUPPORTED_FEATURE` before any equivalence check. When this field coexists with `format_option_refs` or `format_kind` plus `params`, sellers MUST compare the product option sets selected by each resolved route. Legacy parameter compatibility follows the asymmetric v2-narrows-v1 relation defined by canonical formats, not raw object equality. Different format shapes, selected option sets, or incompatible dimensions are rejected with `CONFLICTING_SELECTORS`; sellers MUST NOT silently ignore the legacy projection. Equivalent dual emission remains valid during the 3.x compatibility window. If omitted and no canonical selector is present, all formats supported by the product are active.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-id.json"},"minItems":1},"format_option_refs":{"type":"array","description":"Canonical 3.2 format-option selector. Each reference matches one target product `format_options[]` entry. Publisher-backed options match `{ scope: \"publisher\", publisher_domain, format_option_id }`; product-local options match `{ scope: \"product\", format_option_id }`. Sellers reject unresolved options with `UNSUPPORTED_FEATURE` and a field path to the failing entry before comparing co-present routes. New buyers MUST use this route by itself and MUST NOT dual-emit either a direct canonical selector or deprecated `format_ids`. Receivers handling older 3.x multi-route requests MUST resolve every present route, require each route to select the same product option set, and reject disagreement with `CONFLICTING_SELECTORS` before treating `format_option_refs` as authoritative.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-option-ref.json"},"minItems":1},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Canonical 3.2 direct selector. Names the canonical format shape this package targets when the buyer is not selecting a published `format_option_ref`. Pair with `params` for dimensions, duration, codecs, or other constraints. New buyers MUST NOT combine this route with `format_option_refs` or deprecated `format_ids`. Receivers handling older 3.x multi-route requests MUST equivalence-check every present route before applying precedence and reject disagreement with `CONFLICTING_SELECTORS`. Product satisfaction is directional: broad `{ format_kind: \"image\" }` does not satisfy a fixed-size product declaration."},"params":{"type":"object","description":"Parameters for the direct canonical selector in `format_kind`. Shape follows the selected canonical's parameter vocabulary: dimensions (`width`, `height`, `sizes`), duration (`duration_ms_exact`, `duration_ms_range`), codecs, asset-source and slot narrowing, or other canonical-specific constraints. Requires `format_kind`. For fixed-size image selectors, `width` and `height` MUST co-occur; a selector containing only one dimension is schema-invalid. New buyers omit `params` when selecting by `format_option_refs` or `format_ids`; older multi-route requests are accepted only when every route selects the same product option set.","additionalProperties":true},"budget":{"type":"number","description":"Hard lifetime spend cap for this package in the media buy's currency. Required in fixed allocation mode. Optional in seller-optimized mode; when omitted, the package is bounded by the shared total_budget and any other package constraints. In seller-optimized mode this is a ceiling, not a reserved or current allocation, and requires advertised media_buy.features.seller_optimized_package_budgets; otherwise rejected with UNSUPPORTED_FEATURE before any over-subscription validation.","minimum":0},"min_spend_target":{"type":"number","description":"Soft lifetime spend target for this package in the media buy's currency. Only valid with seller-optimized budget allocation. Requires advertised media_buy.features.seller_optimized_min_spend_targets; otherwise rejected with UNSUPPORTED_FEATURE before any over-subscription validation. The seller SHOULD attempt to deliver at least this amount before allocating incremental spend elsewhere, but inventory, policy, optimization targets, or other delivery constraints may prevent it. This is not a billing guarantee. Must not exceed the package budget when both are present; a seller advertising both seller_optimized_min_spend_targets and seller_optimized_package_budgets MUST reject a violation with `INVALID_REQUEST`, while a seller missing either capability rejects the undeclared control with UNSUPPORTED_FEATURE before any over-subscription validation.","minimum":0},"pacing":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1pacing.json","description":"Package pacing, subordinate to media-buy pacing. In seller-optimized mode, pacing that differs from the media-buy pacing requires advertised media_buy.features.seller_optimized_package_pacing; otherwise rejected with UNSUPPORTED_FEATURE."},"pricing_option_id":{"type":"string","description":"ID of the selected pricing option from the product's pricing_options array","x-entity":"product_pricing_option"},"bid_price":{"type":"number","deprecated":true,"description":"DEPRECATED in 3.2 and removed in the next major. Use bidding.bid_amount or bidding.max_bid. Legacy normalization: selected pricing_option.max_bid=true maps to bidding.max_bid; otherwise maps to bidding.bid_amount. A package MUST NOT supply both representations.","minimum":0},"bidding":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1bidding-policy.json"}],"description":"Package-authored bidding policy. This complete block replaces, rather than field-merges with, any media-buy bidding policy for this package. `{automatic:true}` explicitly overrides a media-buy policy with provider automatic bidding; omission inherits the complete media-buy block. Monetary fields use the media-buy currency, while the selected pricing option supplies only the auction unit and MUST declare that same currency. Sellers MUST reject a new bidding block combined with legacy bid_price or legacy monetary optimization-goal targets on the same effective package with AMBIGUOUS_BIDDING_POLICY."},"impressions":{"type":"number","description":"Impression goal for this package","minimum":0},"daily_budget_cap":{"type":"number","minimum":0,"description":"Optional hard package daily spend ceiling in the media-buy currency. It is subordinate, not a reserved allocation; package caps need not sum to the aggregate cap. Uses the media buy's cap timezone. Requires advertised package budget-capping scope; otherwise rejected with UNSUPPORTED_FEATURE."},"start_time":{"type":"string","format":"date-time","not":{"const":"asap"},"description":"Flight start date/time for this package in ISO 8601 format. When omitted, the package inherits the media buy's start_time. Must fall within the media buy's date range."},"end_time":{"type":"string","format":"date-time","description":"Flight end date/time for this package in ISO 8601 format. When omitted, the package inherits the media buy's end_time. Must fall within the media buy's date range."},"paused":{"type":"boolean","description":"Whether this package should be created in a paused state. Paused packages do not deliver impressions. Defaults to false.","default":false},"catalogs":{"type":"array","description":"Catalogs this package promotes. Each catalog MUST have a distinct type (e.g., one product catalog, one store catalog). This constraint is enforced at the application level — sellers MUST reject requests containing multiple catalogs of the same type with a validation_error. Makes the package catalog-driven: one budget envelope, platform optimizes across items.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1catalog.json"}},"optimization_goals":{"type":"array","description":"Optimization targets for this package. The seller optimizes delivery toward these goals in priority order. Common pattern: event goals (purchase, install) as primary targets at priority 1; metric goals (clicks, views) as secondary proxy signals at priority 2+.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1optimization-goal.json"},"minItems":1},"targeting_overlay":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-input.json","description":"Optional package-specific targeting input with three states per dimension. Omission inherits targeting already bound to the configured product, a non-null value replaces that dimension, and null explicitly suppresses the configured/product default for that dimension. Null cannot remove inherent product scope: sellers reject a clear the product cannot execute rather than silently retaining the default. Non-null fields MUST be declared in the product's overlay_support unless they were already accepted during discovery. The one fixed-inventory restatement exception is placement_selection equal to the product's complete, explicitly enumerated mode: included placement set: that set is an inherent exact match across discovery, create, and update and does not require overlay_support.placement_selection; partial selection still requires a selectable product. Opaque property_list and collection_list references have no equivalent exception because their membership can change independently and cannot be proven equal from the product wire representation. Package readback echoes the complete effective targeting without null dimensions. A supported value with no current inventory returns PRODUCT_UNAVAILABLE rather than a silent substitute or reprice."},"audience_evidence_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1audience-evidence-requirements.json","description":"Buyer policy that the selected product and constructed package MUST satisfy using product audience evidence. This remains planning and suitability evidence, not a targeting instruction. Sellers MUST reject an unsatisfied required policy rather than silently drop it, and a confirmed package MUST include every evidence snapshot used to satisfy this policy in audience_evidence_selections with decision_use package_construction."},"audience_evidence_pins":{"type":"array","description":"Exact immutable evidence snapshots selected by the buyer during discovery. The seller MUST match evidence_id, snapshot_id, version, and content_digest against one published snapshot and MUST reject catalog mutation, snapshot reuse, missing snapshots, or substitutions. Every accepted pin MUST be echoed in the confirmed package's audience_evidence_selections with decision_use package_construction.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1audience-evidence-pin.json"},"minItems":1},"measurement_terms":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1measurement-terms.json","description":"Buyer's proposed billing measurement and makegood terms. Overrides product defaults. Seller accepts (echoed on confirmed package), rejects with TERMS_REJECTED, or adjusts. When absent, product's measurement_terms apply."},"performance_standards":{"type":"array","description":"Buyer's proposed performance standards for this package. Overrides product defaults. Seller accepts, rejects with TERMS_REJECTED, or adjusts. When absent, product's performance_standards apply.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1performance-standard.json"},"minItems":1},"committed_metrics":{"type":"array","description":"Buyer's proposed reporting contract for this package — the metrics the buyer wants the seller to commit to populating in delivery reports. Same negotiation pattern as `measurement_terms` and `performance_standards`: seller accepts (echoes on confirmed package with `committed_at` stamped), rejects with `TERMS_REJECTED` (with explanation of which entries were unworkable), or normalizes (echoes a different but compatible list — buyer can accept by retrying with the normalized terms). When absent, the seller decides what to commit based on the product's `available_metrics` and the buyer's `required_metrics` filter on `get_products`. Each entry uses an explicit `scope` discriminator (`standard` or `vendor`) and identifies the metric — request-side entries do NOT carry `committed_at`; that timestamp is stamped by the seller on accept. Constraints on what the buyer MAY propose: each `scope: standard` entry's `metric_id` MUST be in the product's `available_metrics`, and each `scope: vendor` entry's `(vendor, metric_id)` MUST appear in the product's `vendor_metrics` — sellers SHOULD reject with `TERMS_REJECTED` and reference the offending entry when the proposal exceeds product capability.","items":{"type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"properties":{"scope":{"type":"string","const":"standard","description":"Standard metric from the closed `available-metric.json` enum."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1available-metric.json","description":"Identifier for the standard metric. MUST be present in the product's `reporting_capabilities.available_metrics`."},"qualifier":{"type":"object","description":"Disambiguator — same shape as on the response-side `committed_metrics`. Required when the buyer wants to pin a specific measurement path: `viewability_standard` for MRC vs GroupM viewability; `completion_source` for seller- vs vendor-attested `completion_rate`; `attribution_methodology` for how attribution was computed (deterministic_purchase, probabilistic, panel_based, modeled); `attribution_window` for the time window over which outcomes are attributed. See response-side description for full semantics.","properties":{"viewability_standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json"},"completion_source":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1completion-source.json"},"attribution_methodology":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1attribution-methodology.json"},"attribution_window":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"},"lift_dimension":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1lift-dimension.json"}},"additionalProperties":false}},"required":["scope","metric_id"],"additionalProperties":false},{"properties":{"scope":{"type":"string","const":"vendor","description":"Vendor-defined metric, identified by the tuple `(vendor, metric_id)`."},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor that defines and computes this metric. The vendor's `brand.json` `agents[type='measurement']` is the canonical anchor."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1vendor-metric-id.json","description":"Identifier for the metric within the vendor's vocabulary. MUST be present in the product's `reporting_capabilities.vendor_metrics` for the same vendor."},"methodology_version":{"type":"string","description":"Optional buyer-proposed pin of the vendor's `measurement.metrics[].methodology_version`. The seller accepts by echoing it on the confirmed package's `committed_metrics` entry, normalizes to the version it can actually deliver, or rejects with `TERMS_REJECTED`. Opaque string — equality comparison only."},"qualifier":{"type":"object","description":"Optional disambiguator for vendor metrics committed under more than one methodology or window — same closed key set as standard-scope entries.","properties":{"viewability_standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json"},"completion_source":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1completion-source.json"},"attribution_methodology":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1attribution-methodology.json"},"attribution_window":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"},"lift_dimension":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1lift-dimension.json"}},"additionalProperties":false}},"required":["scope","vendor","metric_id"],"additionalProperties":false}]},"minItems":1},"creative_assignments":{"type":"array","description":"Assign existing library creatives to this package with optional rotation, grouping, weights, and placement targeting. rotation_mode is package-scoped: omission resolves to weighted, and every assignment MUST resolve to the same effective mode. In sequential mode, sequence_position MUST be unique within each package-local group. Sellers reject conflicts with VALIDATION_ERROR before creating the package.","x-adcp-validation":{"verifier_constraints":{"package_rotation_policy":{"effective_mode":"assignment.rotation_mode_or_weighted_default","mode_consistency":"all_assignments_equal","sequence_positions":"required_and_unique_per_effective_group_when_sequential","effective_group":"assignment.group_id_or_package_default","group_namespace":"package_id","on_violation":"reject_before_mutation_with_VALIDATION_ERROR"}},"spec":"docs/reference/migration/creatives.mdx#rotation-modes-and-groups"},"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-assignment.json"},"minItems":1},"creatives":{"type":"array","description":"Upload creative assets inline and assign to this package. Native localization is not accepted on this path; use sync_creatives before assigning the library creative. When the seller also advertises creative.has_creative_library: true, these creatives enter the seller's creative library and can be reused by creative_id while retained; inline-only sellers may store them as package-scoped assets. Use creative_assignments instead for existing library creatives.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-asset.json"},{"not":{"required":["localization"]}}]},"minItems":1,"maxItems":100},"agency_estimate_number":{"type":"string","maxLength":100,"description":"Agency estimate or authorization number for this package. Overrides the media buy-level estimate number when different packages correspond to different agency estimates (e.g., different stations or flights within the same buy)."},"context":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1context.json","description":"Opaque package-level correlation data echoed unchanged in the package response, webhooks, and read surfaces. Buyers targeting mixed seller populations SHOULD include a per-package correlation value here, commonly context.buyer_ref, so responses from legacy sellers that do not echo product_id can still be mapped back to the requested product or line item. Do not use deprecated top-level buyer_ref for v3 correlation."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["product_id","pricing_option_id"],"additionalProperties":true,"dependentRequired":{"params":["format_kind"]}},"external:core/format-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/format-id.json","title":"Format Reference (Structured Object)","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format reference retained for 3.x compatibility. This JSON object — never a plain string — identifies a format by its declaring agent and local slug, and may carry legacy logical dimensions, pixel ratio, or duration parameters. New products and manifests use canonical `format_options`, `format_kind`, and `format_option_ref`; creative-agent build routing uses `creative.supported_formats[].capability_id`.","x-entity":"creative_format","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent that defines this format (e.g., 'https://creative.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats). Callers comparing two `format-id` values MUST canonicalize `agent_url` per the AdCP URL canonicalization rules before treating two formats as the same. See docs/reference/url-canonicalization."},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant."},"width":{"type":"integer","minimum":1,"description":"Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"height":{"type":"integer","minimum":1,"description":"Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"duration_ms":{"type":"number","minimum":1,"description":"Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Required intrinsic-pixel density for a parameterized visual format, expressed as intrinsic pixels per logical pixel. Requires `width` and `height`. Example: `{id: \"display_image\", width: 300, height: 250, pixel_ratio: 2}` identifies a 300×250 logical render supplied by a 600×500 image. Omit for the backward-compatible 1x variant."}},"required":["agent_url","id"],"additionalProperties":true,"dependentRequired":{"width":["height"],"height":["width"],"pixel_ratio":["width","height"]}},"external:core/format-option-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/format-option-ref.json","title":"Format Option Reference","description":"Discriminated reference to a product format option. The global canonical shape is still named by `format_kind`; this reference selects one concrete product `format_options[]` entry. `scope: \"publisher\"` identifies a publisher-declared catalog option by `{ publisher_domain, format_option_id }`. `scope: \"product\"` identifies a product-local option by `format_option_id`; the enclosing package/product context supplies the namespace.","type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"title":"Publisher Catalog Format Option Reference","description":"Selects a publisher-catalog-backed product format option by publisher domain and format option ID.","type":"object","properties":{"scope":{"type":"string","const":"publisher","description":"Reference resolves against the named publisher's adagents.json top-level `formats[]` catalog."},"publisher_domain":{"type":"string","description":"Publisher domain where the adagents.json declaring this format option is hosted.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"format_option_id":{"type":"string","description":"Stable format option ID from the publisher's adagents.json top-level `formats[]`, matching a publisher-catalog-backed entry in the target product's `format_options[]`."}},"required":["scope","publisher_domain","format_option_id"],"additionalProperties":true},{"title":"Product-Local Format Option Reference","description":"Selects a product-local format option by ID within the enclosing package/product context. This branch deliberately forbids `publisher_domain` (`publisher_domain: false` in the schema) because product-local references are namespaced by the enclosing product only; include `scope: \"publisher\"` when the selector must cross into a publisher catalog.","type":"object","properties":{"scope":{"type":"string","const":"product","description":"Reference resolves only against the target product's inline `format_options[]`."},"format_option_id":{"type":"string","description":"Stable format option ID from the target product's inline `format_options[]`."},"publisher_domain":false},"required":["scope","format_option_id"],"additionalProperties":true}],"additionalProperties":true},"external:core/canonical-format-kind.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/canonical-format-kind.json","title":"Canonical Format Kind","description":"Discriminator naming one of the 15 AdCP 3.2 canonical creative formats, plus `custom` for adopter-defined shapes. AdCP 3.2 adds `audio_vast` for VAST-tag-delivered audio (the standards-conformant profile starts at VAST 4.1, with older versions available only as seller-declared legacy interoperability) and promotes the legacy `multi_state_display` and `multi_placement_takeover` custom shapes to `seller_rendered_stateful_display` and `coordinated_placements`. When `format_kind` is `custom`, the declaration also carries `format_shape` and `format_schema`. The enum mirrors the branches in `product-format-declaration.json` and is closed for producer validation: sellers do not mint ad-hoc values. SDKs may retain unknown future values in tolerant in-memory parsers, but that does not change versioned JSON Schema validation. A seller responding to a 3.1-or-earlier request MUST project away 3.2-only kinds and emit a compatible legacy declaration; a strict older schema correctly rejects an unprojected newer kind. See adcp#3666 and the promotion migration contract in canonical-formats.mdx.","type":"string","enum":["image","html5","display_tag","image_carousel","video_hosted","video_vast","audio_hosted","audio_vast","audio_daast","sponsored_placement","native_in_feed","responsive_creative","agent_placement","seller_rendered_stateful_display","coordinated_placements","custom"]},"external:enums/pacing.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/pacing.json","title":"Pacing","description":"Budget pacing strategy","type":"string","enum":["even","asap","front_loaded"],"enumDescriptions":{"even":"Allocate remaining budget evenly over remaining campaign duration (default)","asap":"Spend remaining budget as quickly as possible","front_loaded":"Allocate more remaining budget earlier in the remaining campaign period"}},"external:core/bidding-policy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/bidding-policy.json","title":"Bidding Policy","description":"Buyer-authored execution policy for automatic delivery, auction bidding, average outcome cost, or return on ad spend. The containing object determines authored scope: media-buy `bidding` is a complete inherited default and package `bidding` is a complete package override. Sellers MUST preserve authored scope on readback and MUST NOT copy an inherited media-buy policy into package `bidding`. Every monetary field in this block is denominated in the media-buy currency; the selected pricing option supplies the auction unit, never another denomination. Auction-unit identity is the pricing_model plus every canonical billing-event qualifier after defaults are applied: for example CPV view threshold, CPP demographic system/demographic, CPA event tuple, time time_unit, and flat-rate/DOOH parameters. An extension qualifier participates only when its registered extension specification explicitly defines how it contributes to auction-unit identity. A media-buy bid_amount or max_bid is valid only when every inheriting package resolves the same auction-unit identity. Every affected pricing option MUST use the media-buy currency; split currency-mismatched packages into separate buys. Seller-optimized media-buy cost_per/roas bind to the primary budget_allocation.optimization_goals goal. Package-authored cost_per/roas bind to the package primary optimization goal. The primary goal is the earliest array entry among goals with the lowest explicit numeric priority; unprioritized goals follow explicitly prioritized goals; when all priorities are absent, the first entry is primary. In fixed allocation, an inherited media-buy cost_per is valid only when all inheriting packages have compatible primary-goal result units; inherited roas requires value-bearing primary goals on every inheriting package. Canonical ROAS requires each value-bearing event source to declare the media-buy currency in value_currencies; each buy consumes only exact-currency records and sellers MUST NOT convert them. Absence invokes inheritance or provider automatic delivery; `{automatic:true}` is an explicit authored policy that overrides inheritance. Sellers MUST reject unsupported modes, combinations, units, currency, goal bindings, or native placements before any provider mutation and MUST NOT silently translate semantics.","type":"object","properties":{"automatic":{"type":"boolean","const":true,"description":"Explicitly use seller/provider automatic bidding at this authored scope. At package scope this is a complete override of a media-buy policy, not inheritance. It MUST be the only field in the block and MUST be preserved on readback."},"bid_amount":{"type":"number","exclusiveMinimum":0,"description":"Manual auction bid denominated in the media-buy currency and expressed per the selected pricing option's auction unit. For example, a CPM option interprets the amount per thousand impressions. This is the amount submitted to the auction, not a promise that the clearing price equals it. Requires an auction-priced pricing option whose currency equals the media-buy currency."},"max_bid":{"type":"number","exclusiveMinimum":0,"description":"Hard per-auction ceiling denominated in the media-buy currency and expressed per the selected pricing option's auction unit. This is the only canonical hard auction ceiling and MUST NOT be translated into an average outcome-cost control. Requires an auction-priced pricing option whose currency equals the media-buy currency. May stand alone or supplement cost_per/roas only when the relevant scope capability advertises that combination."},"cost_per":{"type":"object","description":"Average cost control per result of the scope-bound primary optimization goal. At seller-optimized media-buy scope it binds to budget_allocation.optimization_goals; at package scope it binds to that package's optimization_goals; at fixed media-buy scope it binds independently to each inheriting package and is valid only when their primary-goal result units are compatible. Metric goals are compatible only when metric and every result-defining qualifier match; vendor_metric goals only when vendor and metric_id match; event goals only when the event_type/custom_event_name set and resolved attribution_window match. Primary is the earliest array entry among goals tied for the lowest explicit numeric priority; unprioritized goals follow explicitly prioritized goals; when all priorities are absent, the first entry is primary.","properties":{"amount":{"type":"number","exclusiveMinimum":0,"description":"Average cost amount per scope-bound primary-goal result, denominated in the media-buy currency."},"strength":{"type":"string","enum":["cap","target"],"description":"`cap` optimizes for an average at or below the amount and accepts underdelivery when necessary; `target` optimizes around the amount while balancing volume and spend. Neither is a per-result or per-auction guarantee."}},"required":["amount","strength"],"additionalProperties":false},"roas":{"type":"object","description":"Dimensionless return-on-ad-spend control bound to the same scope-specific primary goal rules as cost_per. The bound goal must be value-bearing; a fixed media-buy default requires a value-bearing primary goal on every inheriting package. Every referenced value-bearing event source MUST declare value_currencies containing the media-buy currency. The seller validates this at buy creation; each buy consumes only exact-currency records, while other declared currencies remain available to other buys. Sellers MUST NOT perform currency conversion.","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Return per unit of ad spend; 4 means 4 units of value per 1 unit spent."},"strength":{"type":"string","enum":["floor","target"],"description":"`floor` prefers underdelivery to knowingly optimizing below the requested return; `target` optimizes around the requested return. Neither guarantees realized return."}},"required":["value","strength"],"additionalProperties":false}},"minProperties":1,"allOf":[{"not":{"anyOf":[{"required":["automatic","bid_amount"]},{"required":["automatic","max_bid"]},{"required":["automatic","cost_per"]},{"required":["automatic","roas"]},{"required":["bid_amount","max_bid"]},{"required":["bid_amount","cost_per"]},{"required":["bid_amount","roas"]},{"required":["cost_per","roas"]}]}}],"additionalProperties":false},"external:core/catalog.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/catalog.json","title":"Catalog","description":"A typed data feed. Catalogs carry the items, locations, stock levels, or pricing that publishers use to render ads. They can be synced to a platform via sync_catalogs (managed lifecycle with approval), provided inline, or fetched from an external URL. The catalog type determines the item schema and can be structural (offering, product, inventory, store, promotion) or vertical-specific (hotel, flight, job, vehicle, real_estate, education, destination, app). Selectors (ids, tags, category, query) filter items regardless of sourcing method.","type":"object","properties":{"catalog_id":{"type":"string","description":"Buyer's identifier for this catalog. Required when syncing via sync_catalogs. When used in creatives, references a previously synced catalog on the account.","x-entity":"catalog"},"name":{"type":"string","description":"Human-readable name for this catalog (e.g., 'Summer Products 2025', 'Amsterdam Store Locations')."},"type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1catalog-type.json","description":"Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema."},"url":{"type":"string","format":"uri","description":"URL to an external catalog feed. The platform fetches and resolves items from this URL. For offering-type catalogs, the feed contains an array of Offering objects. For other types, the feed format is determined by feed_format. When omitted with type 'product', the platform uses its synced copy of the brand's product catalog."},"feed_format":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1feed-format.json","description":"Format of the external feed at url. Required when url points to a non-AdCP feed (e.g., Google Merchant Center XML, Meta Product Catalog). Omit for offering-type catalogs where the feed is native AdCP JSON."},"update_frequency":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1update-frequency.json","description":"How often the platform should re-fetch the feed from url. Only applicable when url is provided. Platforms may use this as a hint for polling schedules."},"items":{"type":"array","description":"Inline catalog data. The item schema depends on the catalog type: Offering objects for 'offering', StoreItem for 'store', HotelItem for 'hotel', FlightItem for 'flight', JobItem for 'job', VehicleItem for 'vehicle', RealEstateItem for 'real_estate', EducationItem for 'education', DestinationItem for 'destination', AppItem for 'app', or freeform objects for 'product', 'inventory', and 'promotion'. Mutually exclusive with url — provide one or the other, not both. Implementations should validate items against the type-specific schema.","items":{"type":"object"},"minItems":1},"ids":{"type":"array","description":"Filter catalog to exact canonical item keys. The key field is offering_id for offering, store_id for store, hotel_id for hotel, flight_id for flight, job_id for job, vehicle_id for vehicle, listing_id for real_estate, program_id for education, destination_id for destination, and app_id for app. Product, inventory, and promotion catalogs use the stable normalized source identifier retained during ingestion (for example a retailer SKU). The same canonical key is used by catalog availability item_id.","items":{"type":"string"},"minItems":1},"gtins":{"type":"array","description":"Filter product-type catalogs by GTIN identifiers for cross-retailer catalog matching. Accepts standard GTIN formats (GTIN-8, UPC-A/GTIN-12, EAN-13/GTIN-13, GTIN-14). Only applicable when type is 'product'.","items":{"type":"string","pattern":"^[0-9]{8,14}$"},"minItems":1},"tags":{"type":"array","description":"Filter catalog to items with these tags. Tags are matched using OR logic — items matching any tag are included.","items":{"type":"string"},"minItems":1},"category":{"type":"string","description":"Filter catalog to items in this category (e.g., 'beverages/soft-drinks', 'chef-positions')."},"query":{"type":"string","description":"Natural language filter for catalog items (e.g., 'all pasta sauces under $5', 'amsterdam vacancies')."},"conversion_events":{"type":"array","description":"Event types that represent conversions for items in this catalog. Declares what events the platform should attribute to catalog items — e.g., a job catalog converts via submit_application, a product catalog via purchase. The event's content_ids field carries the item IDs that connect back to catalog items. Use content_id_type to declare what identifier type content_ids values represent.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1event-type.json"},"minItems":1,"uniqueItems":true},"content_id_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1content-id-type.json","description":"Identifier type that the event's content_ids field should be matched against for items in this catalog. For example, 'gtin' means content_ids values are Global Trade Item Numbers, 'sku' means retailer SKUs. Omit when using a custom identifier scheme not listed in the enum."},"feed_field_mappings":{"type":"array","description":"Declarative normalization rules for external feeds. Maps non-standard feed field names, date formats, price encodings, and image URLs to the AdCP catalog item schema. Applied during sync_catalogs ingestion. Supports field renames, named transforms (date, divide, boolean, split), static literal injection, and assignment of image URLs to typed asset pools.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1catalog-field-mapping.json"},"minItems":1}},"required":["type"],"additionalProperties":true,"examples":[{"description":"Synced product catalog from Google Merchant Center","data":{"catalog_id":"gmc-primary","name":"Primary Product Feed","type":"product","url":"https://feeds.acmecorp.com/products.xml","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inventory feed for store-level stock data","data":{"catalog_id":"store-inventory","name":"Store Inventory","type":"inventory","url":"https://feeds.acmecorp.com/inventory.json","feed_format":"custom","update_frequency":"hourly"}},{"description":"Store locator feed","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","url":"https://feeds.acmecorp.com/stores.json","feed_format":"custom","update_frequency":"weekly"}},{"description":"Promotional pricing feed","data":{"catalog_id":"summer-sale","name":"Summer Sale Promotions","type":"promotion","url":"https://feeds.acmecorp.com/promotions.json","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inline offering catalog (no sync needed)","data":{"type":"offering","items":[{"offering_id":"summer-sale","name":"Summer Sale","landing_url":"https://acme.com/summer"}]}},{"description":"Reference to a previously synced catalog by ID","data":{"catalog_id":"gmc-primary","type":"product","ids":["SKU-12345","SKU-67890"]}},{"description":"Product catalog with GTIN cross-retailer matching and attribution","data":{"type":"product","gtins":["00013000006040","00013000006057"],"content_id_type":"gtin","conversion_events":["purchase","add_to_cart"]}},{"description":"Inline store catalog with catchment areas","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","items":[{"store_id":"amsterdam-flagship","name":"Amsterdam Flagship","location":{"lat":52.3676,"lng":4.9041},"catchments":[{"catchment_id":"walk","travel_time":{"value":10,"unit":"min"},"transport_mode":"walking"},{"catchment_id":"drive","travel_time":{"value":15,"unit":"min"},"transport_mode":"driving"}]}]}}]},"external:enums/catalog-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/catalog-type.json","title":"Catalog Type","description":"The type of catalog feed. Determines the item schema and how the platform resolves catalog items. Multiple catalog types can be synced to the same account and referenced together in creatives.","type":"string","enum":["offering","product","inventory","store","promotion","hotel","flight","job","vehicle","real_estate","education","destination","app"]},"external:enums/feed-format.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/feed-format.json","title":"Feed Format","description":"Catalog feed formats. Determines how the platform (seller) parses items from an external feed URL. Each named value is an externally-documented feed specification a seller parses natively without buyer-supplied feed_field_mappings; values are vendor spec names (proper nouns), not semantic categories. Use `custom` + feed_field_mappings for any feed whose shape is not one of the named formats.","type":"string","enum":["google_merchant_center","facebook_catalog","shopify","linkedin_jobs","tiktok_shop","pinterest_catalog","openai_product_feed","custom"],"enumDescriptions":{"google_merchant_center":"Google Merchant Center / Google Shopping product data specification — the de-facto e-commerce product-feed lingua franca that the other named commerce formats derive from.","facebook_catalog":"Meta (Facebook / Instagram) product catalog feed — a Google-Merchant-Center-derived dialect, the closest clone of the GMC field set.","shopify":"Shopify product feed export.","linkedin_jobs":"LinkedIn job-posting feed (XML).","tiktok_shop":"TikTok Shop product catalog feed — a GMC-derived dialect with material deltas (sku_id as the primary identifier rather than id, and a first-class video_link) that a GMC parser keyed on id would mis-parse.","pinterest_catalog":"Pinterest product catalog feed — a GMC-derived dialect with stricter serialization (composite-encoded price and shipping, a mandatory google_product_category, space-delimited availability enums) that a strict GMC parser would mis-handle.","openai_product_feed":"OpenAI Commerce product feed for ChatGPT shopping — a GMC-derived dialect adding ChatGPT-specific eligibility flags (is_eligible_search / is_eligible_checkout / is_eligible_ads). Spec: https://developers.openai.com/commerce/specs/file-upload/products","custom":"A feed whose shape is not one of the named formats above. The buyer MUST supply feed_field_mappings to normalize it to the AdCP catalog item schema."}},"external:enums/update-frequency.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/update-frequency.json","title":"Update Frequency","description":"Frequency of product catalog updates","type":"string","enum":["realtime","hourly","daily","weekly"]},"external:enums/content-id-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/content-id-type.json","title":"Content ID Type","description":"Identifier type used in content_ids on conversion events to match back to catalog items. Omit when the identifier type is custom or not listed here.","type":"string","enum":["sku","gtin","offering_id","job_id","hotel_id","flight_id","vehicle_id","listing_id","store_id","program_id","destination_id","app_id"]},"external:core/catalog-field-mapping.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/catalog-field-mapping.json","title":"Catalog Field Mapping","description":"Declares how a field in an external feed maps to the AdCP catalog item schema. Used in sync_catalogs feed_field_mappings to normalize non-AdCP feeds (Google Merchant Center, LinkedIn Jobs XML, hotel XML, etc.) to the standard catalog item schema without requiring the buyer to preprocess every feed. Multiple mappings can assemble a nested object via dot notation (e.g., separate mappings for price.amount and price.currency).","type":"object","properties":{"feed_field":{"type":"string","description":"Field name in the external feed record. Omit when injecting a static literal value (use the value property instead)."},"catalog_field":{"type":"string","description":"Target field on the catalog item schema, using dot notation for nested fields (e.g., 'name', 'price.amount', 'location.city'). Mutually exclusive with asset_group_id."},"asset_group_id":{"type":"string","description":"Places the feed field value (a URL) into a typed asset pool on the catalog item's assets array. The value is wrapped as an image or video asset in a group with this ID. Use standard group IDs: 'images_landscape', 'images_vertical', 'images_square', 'logo', 'video'. Mutually exclusive with catalog_field."},"value":{"description":"Static literal value to inject into catalog_field for every item, regardless of what the feed contains. Mutually exclusive with feed_field. Useful for fields the feed omits (e.g., currency when price is always USD, or a constant category value)."},"transform":{"type":"string","description":"Named transform to apply to the feed field value before writing to the catalog schema. See transform-specific parameters (format, timezone, by, separator).","enum":["date","divide","boolean","split"]},"format":{"type":"string","description":"For transform 'date': the input date format string (e.g., 'YYYYMMDD', 'MM/DD/YYYY', 'DD-MM-YYYY'). Output is always ISO 8601 (e.g., '2025-03-01'). Uses Unicode date pattern tokens."},"timezone":{"type":"string","description":"For transform 'date': the timezone of the input value. IANA timezone identifier (e.g., 'UTC', 'America/New_York', 'Europe/Amsterdam'). Defaults to UTC when omitted."},"by":{"type":"number","description":"For transform 'divide': the divisor to apply (e.g., 100 to convert integer cents to decimal dollars).","exclusiveMinimum":0},"separator":{"type":"string","description":"For transform 'split': the separator character or string to split on. Defaults to ','.","default":","},"default":{"description":"Fallback value to use when feed_field is absent, null, or empty. Applied after any transform would have been applied. Allows optional feed fields to have a guaranteed baseline value."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"allOf":[{"not":{"required":["feed_field","value"]}},{"not":{"required":["catalog_field","asset_group_id"]}}],"additionalProperties":true,"examples":[{"description":"Simple field rename","data":{"feed_field":"hotel_name","catalog_field":"name"}},{"description":"Date format transform — YYYYMMDD to ISO 8601","data":{"feed_field":"available_from","catalog_field":"valid_from","transform":"date","format":"YYYYMMDD","timezone":"UTC"}},{"description":"Divide cents to dollars","data":{"feed_field":"price_cents","catalog_field":"price.amount","transform":"divide","by":100}},{"description":"Static literal injection — currency not in feed","data":{"catalog_field":"price.currency","value":"USD"}},{"description":"Image URL assigned to typed asset pool","data":{"feed_field":"primary_photo_url","asset_group_id":"images_landscape"}},{"description":"Vertical photo URL assigned to vertical pool","data":{"feed_field":"portrait_photo_url","asset_group_id":"images_vertical"}},{"description":"Split comma-separated tags to array","data":{"feed_field":"amenity_list","catalog_field":"amenities","transform":"split","separator":","}},{"description":"Boolean coercion with default","data":{"feed_field":"is_available","catalog_field":"available","transform":"boolean","default":false}}]},"external:core/targeting-input.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting-input.json","title":"Targeting Overlay Input","description":"Request-only targeting mutation input. Each known dimension has three states: omission inherits the product default on create or leaves the stored dimension unchanged on update; null explicitly suppresses the product default on create or clears the stored dimension on update; and a non-null value replaces that dimension and MUST satisfy the corresponding strict targeting.json constraint. Null is a command and MUST NOT appear in discovery criteria, accepted commercial terms, package responses, or package readback. Sellers apply all supplied dimensions atomically and return only the resulting non-null effective targeting state.","type":"object","properties":{"geo_countries":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_countries"},{"type":"null"}]},"geo_countries_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_countries_exclude"},{"type":"null"}]},"geo_regions":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_regions"},{"type":"null"}]},"geo_regions_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_regions_exclude"},{"type":"null"}]},"geo_metros":{"title":"Targeting Geo Metros","type":["array","null"],"description":"Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-metro.json"},"minItems":1},"geo_metros_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_metros_exclude"},{"type":"null"}]},"geo_postal_areas":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_postal_areas"},{"type":"null"}]},"geo_postal_areas_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_postal_areas_exclude"},{"type":"null"}]},"geo_places":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_places"},{"type":"null"}]},"geo_places_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_places_exclude"},{"type":"null"}]},"daypart_targets":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/daypart_targets"},{"type":"null"}]},"axe_include_segment":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/axe_include_segment"},{"type":"null"}]},"axe_exclude_segment":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/axe_exclude_segment"},{"type":"null"}]},"audience_include":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/audience_include"},{"type":"null"}]},"audience_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/audience_exclude"},{"type":"null"}]},"signal_targeting_groups":{"anyOf":[{"title":"Targeting Signal Groups","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting-groups.json","description":"Basic Boolean grouping for seller-offered signals. v1 supports a required top-level operator 'all' and child groups with operator 'any' for include groups or 'none' for exclusion groups. Example semantics: group 1 any(A, B) plus group 2 none(C, D) means (A OR B) AND NOT (C OR D). Signal entries reference named signal definitions with signal_ref scope 'product' for product-local signal options or scope 'data_provider' for external signals published in adagents.json signals[]. For simple include-only targeting, send one child group with operator 'any'. Sellers SHOULD reject entries that are not available for the product through inline signal_targeting_options or get_signals, are not active for the account, or exceed the product's signal_targeting_allowed/signal_targeting_rules/product terms. Signal targeting limits are product-scoped, not declared in get_adcp_capabilities, because products may be backed by different ad servers. Sellers MUST echo applied signal_targeting_groups on the resulting package state, including fixed/default selections. Sellers MAY return REQUOTE_REQUIRED when a targeting mutation changes commercial terms."},{"type":"null"}]},"signal_targeting":{"type":["array","null"],"description":"DEPRECATED. Use signal_targeting_groups for package-level signal targeting. Legacy flat signal_targeting remains accepted during the SignalRef migration window but cannot express grouped include/exclude composition or product-scoped pricing.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-targeting.json"},"minItems":1},"demographics":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/demographics"},{"type":"null"}]},"frequency_cap":{"anyOf":[{"title":"Targeting Frequency Cap","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1frequency-cap.json"},{"type":"null"}]},"property_list":{"anyOf":[{"title":"Targeting Property List","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false."},{"type":"null"}]},"property_list_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/property_list_exclude"},{"type":"null"}]},"collection_list":{"anyOf":[{"title":"Targeting Collection List","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for including specific collections (programs, publications, channels) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities."},{"type":"null"}]},"collection_list_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/collection_list_exclude"},{"type":"null"}]},"placement_selection":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/placement_selection"},{"type":"null"}]},"collection_selection":{"anyOf":[{"title":"Targeting Collection Selection","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-selection.json","description":"Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},{"type":"null"}]},"age_restriction":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/age_restriction"},{"type":"null"}]},"device_platform":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_platform"},{"type":"null"}]},"device_platform_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_platform_exclude"},{"type":"null"}]},"device_type":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_type"},{"type":"null"}]},"device_type_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_type_exclude"},{"type":"null"}]},"browser":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/browser"},{"type":"null"}]},"browser_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/browser_exclude"},{"type":"null"}]},"store_catchments":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/store_catchments"},{"type":"null"}]},"geo_proximity":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_proximity"},{"type":"null"}]},"language":{"title":"Targeting Languages","type":["array","null"],"description":"Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1},"keyword_targets":{"title":"Targeting Keywords","type":["array","null"],"description":"Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1match-type.json"},"bid_price":{"type":"number","minimum":0,"description":"Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."}},"required":["keyword","match_type"],"additionalProperties":false},"minItems":1},"negative_keywords":{"title":"Targeting Negative Keywords","type":["array","null"],"description":"Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1negative-keyword.json"},"minItems":1}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-unknown-age-eligibility-constraint.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-verified-age-basis-constraint.json"}],"additionalProperties":true},"external:core/targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting.json","title":"Targeting Overlay","description":"Strict non-null targeting state used during product discovery, commercial snapshots, and media-buy readback. Targeting includes both audience eligibility and purchased-inventory selection: geography, demographics, placements, properties, collections, device compatibility, language, keywords, and other explicit controls. Sellers resolve requested outcomes against inherent product scope or selectable execution. Request-side create and update mutations use targeting-input.json so null can explicitly clear one dimension; resolved effective targeting omits cleared dimensions and MUST NOT contain null. A fresh create/update request MUST be applied exactly or rejected; get_products may instead return a request-scoped configured product with sparse, buyer-reviewable targeting_resolution modifications.","x-adcp-validation":{"disjoint_place_fields":{"include":"geo_places","exclude":"geo_places_exclude","identity":["country","system","place_type","value"]},"description":"JSON Schema draft-07 cannot compare values across sibling arrays. Conformance tooling MUST reject any place identity present in both geo_places and geo_places_exclude. Catalog version is deliberately not part of place identity: a stable ID cannot be both included and excluded by assigning different versions."},"type":"object","properties":{"geo_countries":{"type":"array","description":"Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_countries_exclude":{"type":"array","description":"Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_regions":{"type":"array","description":"Restrict delivery to exact canonical ISO 3166-2 subdivisions (states, provinces, regions, departments, or other subdivision categories). Unknown identifiers are invalid. At create or update, sellers MUST reject unsupported identifiers and MUST NOT silently widen, drop, or partially apply the list. During get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome. Exact internal translation preserves accepted identifiers in package readback.","items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_regions_exclude":{"type":"array","description":"Exclude exact canonical ISO 3166-2 subdivisions. Support is independent from geo_regions inclusion support. Unknown identifiers and values also present in geo_regions are invalid. At create or update, sellers MUST reject unsupported identifiers and partial application; during get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome.","x-adcp-validation":{"disjoint_with":"geo_regions","spec":"docs/media-buy/advanced-topics/targeting.mdx#geo_regions_exclude"},"items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_metros":{"title":"Targeting Geo Metros","type":"array","description":"Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-metro.json"},"minItems":1},"geo_metros_exclude":{"type":"array","description":"Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.","items":{"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"minItems":1},"geo_postal_areas":{"type":"array","description":"Restrict delivery to specific postal areas. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_postal_areas_exclude":{"type":"array","description":"Exclude specific postal areas from delivery. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_places":{"type":"array","description":"Restrict delivery to catalog-backed named places. Values MUST be stable identifiers in the declared system, not display names. Sellers must declare supported systems, countries, and place types in get_adcp_capabilities and reject unsupported entries rather than silently dropping them.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"geo_places_exclude":{"type":"array","description":"Exclude catalog-backed named places. Uses the same identifier-based shape as geo_places. Sellers MUST reject overlap with geo_places for the same country, system, place_type, and value.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"daypart_targets":{"type":"array","description":"Restrict delivery to specific time windows. Each entry specifies days of week, an hour range, and an optional timezone that defaults to inventory_local. A concrete IANA zone uses one shared civil-time clock, while inventory_local evaluates each inventory unit in its seller-assigned local timezone. Entries are independent and MAY use different clocks.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1daypart-target.json"},"minItems":1},"axe_include_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to include for targeting.","deprecated":true},"axe_exclude_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to exclude from targeting.","deprecated":true},"audience_include":{"type":"array","description":"Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"audience_exclude":{"type":"array","description":"Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"signal_targeting_groups":{"title":"Targeting Signal Groups","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting-groups.json","description":"Basic Boolean grouping for seller-offered signals. v1 supports a required top-level operator 'all' and child groups with operator 'any' for include groups or 'none' for exclusion groups. Example semantics: group 1 any(A, B) plus group 2 none(C, D) means (A OR B) AND NOT (C OR D). Signal entries reference named signal definitions with signal_ref scope 'product' for product-local signal options or scope 'data_provider' for external signals published in adagents.json signals[]. For simple include-only targeting, send one child group with operator 'any'. Sellers SHOULD reject entries that are not available for the product through inline signal_targeting_options or get_signals, are not active for the account, or exceed the product's signal_targeting_allowed/signal_targeting_rules/product terms. Signal targeting limits are product-scoped, not declared in get_adcp_capabilities, because products may be backed by different ad servers. Sellers MUST echo applied signal_targeting_groups on the resulting package state, including fixed/default selections. Sellers MAY return REQUOTE_REQUIRED when a targeting mutation changes commercial terms."},"signal_targeting":{"type":"array","description":"DEPRECATED. Use signal_targeting_groups for package-level signal targeting. Legacy flat signal_targeting remains accepted during the SignalRef migration window but cannot express grouped include/exclude composition or product-scoped pricing.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-targeting.json"},"minItems":1},"demographics":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1demographic-targeting-intent.json","description":"Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis."},"frequency_cap":{"title":"Targeting Frequency Cap","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1frequency-cap.json"},"property_list":{"title":"Targeting Property List","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false."},"property_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list whose properties must not carry the buyer's ads. Matched properties are removed from delivery. Use for brand-safety do-not-run lists (apps, sites). Exclude wins on overlap with property_list, and applies regardless of the product's property_targeting_allowed flag. Seller must declare support in get_adcp_capabilities."},"collection_list":{"title":"Targeting Collection List","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for including specific collections (programs, publications, channels) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities."},"collection_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for excluding specific collections (programs, publications, channels) from this product. Matched collections must not carry the buyer's ads. Use for brand safety do-not-air lists. Seller must declare support in get_adcp_capabilities."},"placement_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-selection.json","description":"Purchased placement selection within the product. This constrains package inventory; it is distinct from creative_assignments[].placement_refs, which only route individual creatives within the purchased set. On create, mode selected supplies the complete selected set and mode default uses the product default. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"collection_selection":{"title":"Targeting Collection Selection","$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-selection.json","description":"Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"age_restriction":{"type":"object","description":"Age restriction for compliance. Use for legal requirements (alcohol, gambling), not audience targeting.","properties":{"min":{"type":"integer","minimum":13,"maximum":99,"description":"Minimum age required"},"verification_required":{"type":"boolean","default":false,"description":"Whether verified age (not inferred) is required for compliance"},"accepted_methods":{"type":"array","description":"Accepted verification methods. If omitted, any method the platform supports is acceptable.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1}},"required":["min"],"additionalProperties":false},"device_platform":{"type":"array","description":"Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_platform_exclude":{"type":"array","description":"Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_type":{"type":"array","description":"Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"device_type_exclude":{"type":"array","description":"Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"browser":{"type":"array","description":"Restrict delivery to specific canonical browser families in the impression delivery and rendering environment, not the post-click landing-page browser. Values MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. Values in this array use OR semantics. When browser is supplied, families not listed are ineligible: other includes a seller-recognized family that is not explicitly enumerated, while unknown includes a browser the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Browser and device constraints intersect; a seller that cannot enforce the exact combination MUST exclude or explicitly reconfigure the product during discovery and MUST reject it at create or update rather than silently widening delivery. Browser versions and seller-native IDs are intentionally unsupported.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"browser_exclude":{"type":"array","description":"Exclude specific canonical browser families from delivery. other excludes seller-recognized families that are not explicitly enumerated; unknown excludes browsers the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"store_catchments":{"type":"array","description":"Target users within store catchment areas from a synced store catalog. Each entry references a store-type catalog and optionally narrows to specific stores or catchment zones.","items":{"type":"object","properties":{"catalog_id":{"type":"string","description":"Synced store-type catalog ID from sync_catalogs."},"store_ids":{"type":"array","description":"Filter to specific stores within the catalog. Omit to target all stores.","items":{"type":"string"},"minItems":1},"catchment_ids":{"type":"array","description":"Catchment zone IDs to target (e.g., 'walk', 'drive'). Omit to target all catchment zones.","items":{"type":"string"},"minItems":1}},"required":["catalog_id"],"additionalProperties":true},"minItems":1},"geo_proximity":{"type":"array","description":"Target users within travel time, distance, or a custom boundary around arbitrary geographic points. Multiple entries use OR semantics — a user within range of any listed point is eligible. For campaigns targeting 10+ locations, consider using store_catchments with a location catalog instead. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"lng":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"label":{"type":"string","description":"Human-readable label for this entry (e.g., 'Düsseldorf', 'Heathrow Airport', 'Primary trade area')."},"travel_time":{"type":"object","description":"Travel time limit for isochrone calculation. The platform resolves this to a geographic boundary based on actual transportation networks.","properties":{"value":{"type":"number","minimum":1,"description":"Travel time limit."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1travel-time-unit.json"}},"required":["value","unit"],"additionalProperties":false},"transport_mode":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1transport-mode.json","description":"Transportation mode for isochrone calculation. Required when travel_time is provided."},"radius":{"type":"object","description":"Simple radius from the point. The platform draws a circle of this distance around the coordinates.","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Radius distance."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1distance-unit.json","description":"Distance unit."}},"required":["value","unit"],"additionalProperties":false},"geometry":{"type":"object","description":"Pre-computed GeoJSON geometry defining the proximity boundary. Use when the buyer has already calculated isochrones (via TravelTime, Mapbox, etc.) or has custom boundaries. When geometry is provided, lat/lng are not required.","properties":{"type":{"type":"string","enum":["Polygon","MultiPolygon"],"description":"GeoJSON geometry type."},"coordinates":{"type":"array","description":"GeoJSON coordinates array. For Polygon: array of linear rings. For MultiPolygon: array of polygons."}},"required":["type","coordinates"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"oneOf":[{"required":["lat","lng","travel_time","transport_mode"],"not":{"anyOf":[{"required":["radius"]},{"required":["geometry"]}]}},{"required":["lat","lng","radius"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["geometry"]}]}},{"required":["geometry"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["radius"]}]}}],"additionalProperties":true},"minItems":1},"language":{"title":"Targeting Languages","type":"array","description":"Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1},"keyword_targets":{"title":"Targeting Keywords","type":"array","description":"Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1match-type.json"},"bid_price":{"type":"number","minimum":0,"description":"Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."}},"required":["keyword","match_type"],"additionalProperties":false},"minItems":1},"negative_keywords":{"title":"Targeting Negative Keywords","type":"array","description":"Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1negative-keyword.json"},"minItems":1}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-unknown-age-eligibility-constraint.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-verified-age-basis-constraint.json"}],"additionalProperties":true},"external:core/geo-metro.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-metro.json","title":"Geo Metro","description":"A targeted metro area.","type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"external:enums/metro-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/metro-system.json","title":"Metro Area System","description":"Metro area classification systems for geographic targeting","type":"string","enum":["nielsen_dma","uk_itl1","uk_itl2","eurostat_nuts2","custom"]},"external:core/postal-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/postal-area.json","title":"Postal Area","description":"Postal area values. Prefer the native country + postal system form. Deprecated legacy country-fused postal-system tokens remain accepted for compatibility.","anyOf":[{"title":"PostalArea","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1postal-country-system.json"}],"properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code for the postal values."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system (e.g., 'zip', 'outward', 'plz', 'postal_code')."},"values":{"type":"array","description":"Postal codes within the country and system.","items":{"type":"string"},"minItems":1}},"required":["country","system","values"],"additionalProperties":false},{"title":"PostalAreaWithFusedSystem","deprecated":true,"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1legacy-postal-system.json","deprecated":true,"description":"Deprecated country-fused postal code system (e.g., 'us_zip', 'gb_outward'). Prefer country + postal-system."},"values":{"type":"array","description":"Postal codes within the legacy system.","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false}]},"external:core/postal-country-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/postal-country-system.json","title":"Postal Country System","description":"Valid country-local postal system pairing. Registered countries only accept their registered local systems; countries without a registered local system use postal_code or custom.","type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system."}},"required":["country","system"],"anyOf":[{"properties":{"country":{"const":"US"},"system":{"enum":["zip","zip_plus_four"]}}},{"properties":{"country":{"const":"GB"},"system":{"enum":["outward","full"]}}},{"properties":{"country":{"const":"CA"},"system":{"enum":["fsa","full"]}}},{"properties":{"country":{"enum":["DE","CH","AT"]},"system":{"const":"plz"}}},{"properties":{"country":{"const":"FR"},"system":{"const":"code_postal"}}},{"properties":{"country":{"const":"AU"},"system":{"const":"postcode"}}},{"properties":{"country":{"const":"BR"},"system":{"const":"cep"}}},{"properties":{"country":{"const":"IN"},"system":{"const":"pin"}}},{"properties":{"country":{"const":"ZA"},"system":{"const":"postal_code"}}},{"properties":{"country":{"not":{"enum":["US","GB","CA","DE","CH","AT","FR","AU","BR","IN","ZA"]}},"system":{"enum":["postal_code","custom"]}}}]},"external:enums/postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/postal-system.json","title":"Postal Code System","description":"Postal code system names for geographic targeting. Prefer country-local values with an explicit ISO 3166-1 alpha-2 country. Deprecated country-fused values remain in this published enum for 3.x compatibility.","type":"string","enum":["postal_code","zip","zip_plus_four","outward","full","fsa","plz","code_postal","postcode","cep","pin","custom","us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:enums/legacy-postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/legacy-postal-system.json","title":"Country-Fused Postal Code System","description":"Deprecated country-fused postal code systems for geographic targeting. Prefer postal-system with an explicit ISO 3166-1 alpha-2 country on postal area objects.","type":"string","deprecated":true,"enum":["us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:core/geo-place-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-place-area.json","title":"Geographic Place Area","description":"A catalog-backed named place target. Values are stable identifiers in the declared system. Entries within geo_places form a union; different geographic inclusion dimensions intersect. value_labels are diagnostic only and MUST NOT be used to resolve targeting.","x-adcp-validation":{"map_keys_subset_of_array":{"map_field":"value_labels","array_field":"values"},"description":"Every value_labels key MUST also appear in values. JSON Schema draft-07 cannot express this sibling-field key membership constraint, so conformance tooling must enforce it."},"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code containing the place."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-system.json"},"system_version":{"type":"string","minLength":1,"description":"Optional exact catalog version from the seller's declared supported_versions. When omitted, the seller applies catalog.current_version and MUST echo that version on persisted package state."},"place_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-type.json"},"values":{"type":"array","description":"Stable place identifiers in the declared system. Display names are not valid targeting values.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"value_labels":{"type":"object","description":"Optional human-readable diagnostic labels keyed by identifiers present in values. Extra keys are a conformance error. Labels are non-authoritative and MUST NOT be used to resolve or apply targeting.","additionalProperties":{"type":"string","minLength":1}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["country","system","place_type","values"],"allOf":[{"if":{"properties":{"system":{"enum":["geonames","google_ads","microsoft_ads"]}},"required":["system"]},"then":{"properties":{"values":{"items":{"type":"string","pattern":"^[0-9]+$"}}}}}],"additionalProperties":false},"external:core/geo-place-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-place-system.json","title":"Geographic Place Identifier System","description":"Collision-safe identifier namespace for geographic places. Registered tokens have protocol-defined semantics. Unregistered systems MUST use an absolute HTTPS URI controlled by the catalog owner; consumers compare URI systems as exact opaque strings.","anyOf":[{"type":"string","enum":["geonames","google_ads","microsoft_ads"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["geonames","google_ads","microsoft_ads","https://seller.example/geo/catalogs/places"]},"external:core/geo-place-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/geo-place-type.json","title":"Geographic Place Type","description":"Canonical place classification. Registered tokens have protocol-defined meanings. Catalog-specific classifications without a registered mapping MUST use an absolute HTTPS URI controlled by the vocabulary owner; consumers compare URI types as exact opaque strings.","anyOf":[{"type":"string","enum":["airport","borough","city","city_region","commune","county","district","municipality","neighborhood","post_town","prefecture","province","quarter","state","territory","ward"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["city","municipality","borough","neighborhood","post_town","city_region","county","https://seller.example/geo/place-types/trade-area"]},"external:core/daypart-target.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/daypart-target.json","title":"Daypart Target","description":"A time window for daypart targeting. Specifies days of week, an hour range, and the civil-time clock used to evaluate it. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.","type":"object","properties":{"days":{"type":"array","description":"Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1day-of-week.json"},"minItems":1},"start_hour":{"type":"integer","description":"Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.","minimum":0,"maximum":23},"end_hour":{"type":"integer","description":"End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.","minimum":1,"maximum":24},"timezone":{"description":"Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and hour with the half-open window: a skipped DST hour has no matching instants, while both occurrences of a repeated hour match. This delivery clock is independent of reporting_capabilities.timezone.","default":"inventory_local","x-added-in":"3.2.0","anyOf":[{"type":"string","const":"inventory_local"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1iana-timezone.json"}]},"label":{"type":"string","description":"Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')"}},"required":["days","start_hour","end_hour"],"additionalProperties":false},"external:enums/day-of-week.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/day-of-week.json","title":"Day of Week","description":"Days of the week for daypart targeting","type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"external:core/iana-timezone.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/iana-timezone.json","title":"IANA Timezone Identifier","description":"Concrete timezone identifier in the implementation's supported IANA Time Zone Database, such as America/New_York, CET, or UTC.","type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._+-]+(?:/[A-Za-z0-9._+-]+)*$","not":{"const":"inventory_local"},"x-added-in":"3.2.0","x-adcp-validation":{"iana_timezone":"value_must_resolve_in_the_implementations_supported_IANA_TZDB"}},"external:core/package-signal-targeting-groups.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/package-signal-targeting-groups.json","title":"Package Signal Targeting Groups","description":"Top-level basic Boolean composition for package signal targeting. The groups-level operator is required; v1 supports operator 'all', meaning every child group must be satisfied. This represents the portable baseline: (any of include group 1) AND (any of include group 2) AND NOT (any of exclude group N).","type":"object","properties":{"operator":{"type":"string","enum":["all"],"description":"Groups-level operator. Required even though v1 only supports 'all': every child group must be satisfied."},"groups":{"type":"array","description":"Signal targeting groups to evaluate. Use operator 'any' for include groups and 'none' for exclusion groups.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting-group.json"},"minItems":1}},"required":["operator","groups"],"additionalProperties":true},"external:core/package-signal-targeting-group.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/package-signal-targeting-group.json","title":"Package Signal Targeting Group","description":"A basic Boolean group of package-level signal targeting entries. 'any' means the user must match at least one signal in the group. 'none' means the user must match none of the signals in the group. Use groups for portable include/exclude composition such as (A OR B) AND NOT (C OR D).","type":"object","properties":{"operator":{"type":"string","description":"How to evaluate the signals in this group. 'any' is an OR include group. 'none' is an exclusion group equivalent to NOT (A OR B OR C).","enum":["any","none"]},"signals":{"type":"array","description":"Signal targeting entries evaluated by this group. Each entry uses the package signal targeting shape, including signal_ref, value expression, and optional pricing, execution-handle, or activation fields.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting.json"},"minItems":1}},"required":["operator","signals"],"additionalProperties":true},"external:core/package-signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/package-signal-targeting.json","title":"Package Signal Targeting","description":"Buy-time selection of one seller-offered signal inside a package signal targeting group. The signal_ref uses scope 'product' for a product-local signal option, scope 'data_provider' for a signal defined in a data provider's published adagents.json signals[], or scope 'signal_source' for a source-native signal that is not published in adagents.json signals[]. The selected product's inline Product.signal_targeting_options, get_signals feed when inline options are omitted, and signal_targeting_rules define buy-time eligibility. Inclusion and exclusion are controlled by the parent group operator: use operator 'any' to include users matching the signal expression and operator 'none' to exclude users matching the signal expression. For binary signals, value MUST be true; do not use value=false for exclusion inside signal_targeting_groups. Use audience_include/audience_exclude only for buyer-managed first-party audiences registered through sync_audiences.","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-targeting-expression.json"}],"properties":{"pricing_option_id":{"type":"string","description":"Pricing option selected for this signal. Use the pricing_option_id from the product's signal_targeting_options entry when product-scoped pricing is present; otherwise use the seller get_signals pricing only when the product option does not override it. Required when the selected signal has pricing_options; omit only when the signal is bundled into the product price or has no incremental cost.","x-entity":"vendor_pricing_option"},"signal_agent_segment_id":{"type":"string","description":"Optional opaque resolved-segment or seller execution handle for this signal. Omit when signal_ref plus the value expression is sufficient for the seller to resolve the signal. Include when the product option exposes a separate runtime or activation handle, and pass it verbatim. Buyers SHOULD prefer an exposed segment handle over reconstructing condition identity from categorical values because the handle can carry provider namespace and methodology distinctions.","x-entity":"signal_activation_id"},"activation_key":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1activation-key.json","description":"Destination-specific activation key returned by get_signals or activate_signal. Usually omitted for seller-offered signals selected directly through the same seller; include only when the selected signal was separately activated and the seller requires the activation key to correlate the package selection."}},"additionalProperties":true},"external:core/signal-targeting-expression.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-targeting-expression.json","title":"Signal Targeting Expression","description":"Predicate over a named signal definition. Signals are typed dimensions, similar to feature values: binary signals match true, categorical signals match one of a set of values, and numeric signals match a range. In package signal targeting groups, include/exclude semantics are controlled by the parent group operator, not by negating the expression.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal expression. In grouped package targeting, value is always true; use a parent group with operator 'none' for exclusion.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals."},"value":{"type":"boolean","const":true,"description":"Binary package signal entries match users for whom the signal is true. Use the parent group operator for include/exclude."}},"required":["signal_ref","value_type","value"],"additionalProperties":true},{"type":"object","description":"Categorical signal expression - target users with one of the listed values.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals."},"values":{"type":"array","description":"Values to target. Users with any of these values match the expression.","items":{"type":"string"},"minItems":1}},"required":["signal_ref","value_type","values"],"additionalProperties":true},{"type":"object","description":"Numeric signal expression - target users within a value range. At least one of min_value or max_value is required. If both min_value and max_value are provided, min_value MUST be <= max_value.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals."},"min_value":{"type":"number","description":"Minimum value, inclusive. Omit for no minimum. Should be within the signal definition's range when declared."},"max_value":{"type":"number","description":"Maximum value, inclusive. Omit for no maximum. Should be within the signal definition's range when declared."}},"required":["signal_ref","value_type"],"anyOf":[{"required":["min_value"]},{"required":["max_value"]}],"additionalProperties":true}]},"external:core/signal-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-ref.json","title":"Signal Ref","description":"Reference to a named signal definition. Uses scope as discriminator: 'data_provider' for a signal resolved through published adagents.json signals[], 'signal_source' for a source-native signal resolved through the issuing signal source, or 'product' for a product-local signal option. Scope is the resolution path, not provenance; authoritative enrichment lives on the seller, signal source, or data-provider signal definition, not on this reference.","x-entity":"signal","discriminator":{"propertyName":"scope"},"oneOf":[{"type":"object","description":"Product-scoped signal. The signal_id is meaningful only within the selected product/package context and MUST match a Product.included_signals[].signal_ref.signal_id or Product.signal_targeting_options[].signal_ref.signal_id for that product, depending on whether the signal is descriptive or selectable.","properties":{"scope":{"type":"string","const":"product","description":"Discriminator indicating the signal resolves through the selected product's included_signals or signal_targeting_options."},"signal_id":{"type":"string","description":"Product-local signal identifier. For local signals exposed on both get_signals and get_products, this MUST match get_signals.signals[].signal_ref.signal_id for the same signal.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["signal_source_url"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Data-provider-scoped signal. The signal_id resolves through the data provider's published adagents.json signals[] and can be authorization-verified there.","properties":{"scope":{"type":"string","const":"data_provider","description":"Discriminator indicating the signal resolves through a data provider's published adagents.json signals[]."},"data_provider_domain":{"type":"string","description":"Domain that publishes the signal definition in its adagents.json signals[].","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"signal_id":{"type":"string","description":"Signal identifier within the data provider's published adagents.json signals[].","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","data_provider_domain","signal_id"],"not":{"anyOf":[{"required":["agent_url"]},{"required":["signal_source_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Signal-source-scoped signal. Use this for source-native signals that are not published in upstream adagents.json signals[]. The buyer trusts the issuing signal source for this identity; use scope 'data_provider' instead when the signal is published in adagents.json signals[], even if the publisher is also the seller or signal source.","properties":{"scope":{"type":"string","const":"signal_source","description":"Discriminator indicating the signal resolves through the issuing signal source."},"signal_source_url":{"type":"string","format":"uri","description":"URL of the signal source that issues this source-native signal."},"signal_id":{"type":"string","description":"Signal identifier within the issuing signal source's signal set.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_source_url","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true}]},"external:core/activation-key.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/activation-key.json","title":"Activation Key","description":"Universal identifier for using a signal on a destination platform. Can be either a segment ID or a key-value pair depending on the platform's targeting mechanism.","type":"object","discriminator":{"propertyName":"type"},"oneOf":[{"properties":{"type":{"type":"string","const":"segment_id","description":"Segment ID based targeting"},"segment_id":{"type":"string","description":"The platform-specific segment identifier to use in campaign targeting"}},"required":["type","segment_id"],"additionalProperties":true},{"properties":{"type":{"type":"string","const":"key_value","description":"Key-value pair based targeting"},"key":{"type":"string","description":"The targeting parameter key"},"value":{"type":"string","description":"The targeting parameter value"}},"required":["type","key","value"],"additionalProperties":true}]},"external:core/signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-targeting.json","title":"Signal Targeting","description":"Targeting constraint for a specific signal. Uses value_type as discriminator to determine the targeting expression format.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal targeting - user either matches or doesn't","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals"},"value":{"type":"boolean","description":"Whether to include (true) or exclude (false) users matching this signal"}},"required":["value_type","value"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Categorical signal targeting - target users with specific values","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals"},"values":{"type":"array","description":"Values to target. Users with any of these values will be included.","items":{"type":"string"},"minItems":1}},"required":["value_type","values"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Numeric signal targeting - target users within a value range. If min_value is provided, it must be <= max_value. Values should be within the signal's defined range (see signal definition).","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals"},"min_value":{"type":"number","description":"Minimum value (inclusive). Omit for no minimum. Must be <= max_value when both are provided. Should be >= signal's range.min if defined."},"max_value":{"type":"number","description":"Maximum value (inclusive). Omit for no maximum. Must be >= min_value when both are provided. Should be <= signal's range.max if defined."}},"required":["value_type"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true}]},"external:core/signal-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/signal-id.json","title":"Signal ID","description":"DEPRECATED. Use SignalRef for new discovery, activation, and media-buy signal identity surfaces. Legacy universal signal identifier used by older Signals Protocol clients. Uses 'source' as discriminator: 'catalog' for signals from a data provider's published catalog (verifiable), or 'agent' for signals native to a signal source identified by agent_url.","deprecated":true,"x-entity":"signal","discriminator":{"propertyName":"source"},"oneOf":[{"type":"object","description":"Data-provider signal - references a signal from a data provider's published adagents.json signals[]. Buyers can verify authorization by checking the data provider's adagents.json.","properties":{"source":{"type":"string","const":"catalog","description":"Discriminator indicating this signal is from a data provider's published adagents.json signals[]"},"data_provider_domain":{"type":"string","description":"Domain of the data provider that owns this signal (e.g., 'pinnacle-data.example'). The signal definition is published at this domain's /.well-known/adagents.json","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the data provider's catalog (e.g., 'likely_ev_buyers', 'income_100k_plus')"}},"required":["source","data_provider_domain","id"],"additionalProperties":true},{"type":"object","description":"Agent signal - references a signal native to a signal source identified by agent_url. Not externally verifiable through an upstream catalog; buyer trusts the issuing signal source's claim about the signal.","properties":{"source":{"type":"string","const":"agent","description":"Discriminator indicating this signal is native to the signal source identified by agent_url, not from a data provider's published signal definitions."},"agent_url":{"type":"string","format":"uri","description":"URL of the signal source that provides this signal (e.g., 'https://signals.example/.well-known/adcp/signals')"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')"}},"required":["source","agent_url","id"],"additionalProperties":true}]},"external:core/demographic-targeting-intent.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/demographic-targeting-intent.json","title":"Demographic Targeting Intent","description":"Portable demographic targeting intent plus buyer constraints on how the seller may determine user eligibility. The age predicate retains its canonical interval meaning; accepted_bases narrows execution provenance without changing which ages are requested.","type":"object","properties":{"age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1demographic-age-range.json"},{"type":"object","properties":{"accepted_bases":{"type":"array","description":"User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1age-determination-basis.json"},"minItems":1,"uniqueItems":true},"accepted_verification_methods":{"type":"array","description":"Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1,"uniqueItems":true}},"allOf":[{"if":{"required":["accepted_verification_methods"]},"then":{"required":["accepted_bases"],"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}],"additionalProperties":true}]}},"required":["age"],"additionalProperties":true},"external:core/demographic-age-range.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/demographic-age-range.json","title":"Demographic Age Range","description":"A canonical audience-age predicate in completed integer years. min and max are inclusive; omitting one bound means no restriction in that direction. At least one bound is required. include_unknown is always explicit because people whose age is unavailable are not members of any numeric interval. Implementations MUST reject min greater than max; JSON Schema draft-07 cannot compare sibling numeric values.","type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive minimum age in completed years. Omit for an open lower bound."},"max":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive maximum age in completed years. Omit for an open upper bound."},"include_unknown":{"type":"boolean","description":"Whether delivery to people whose age is unavailable is part of this predicate. This field has no default and MUST be supplied."}},"required":["include_unknown"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"external:enums/age-determination-basis.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/age-determination-basis.json","title":"Age Determination Basis","description":"User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.","type":"string","enum":["verified","declared","inferred"],"enumDescriptions":{"verified":"The user's applicable age claim was established through an age-assurance or identity-verification method.","declared":"The user supplied an age, date of birth, or threshold affirmation without independent verification.","inferred":"The user's age was predicted from behavior, attributes, or another model."}},"external:enums/age-verification-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/age-verification-method.json","title":"Age Verification Method","description":"Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.","type":"string","enum":["facial_age_estimation","id_document","digital_id","credit_card","world_id"]},"external:core/property-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/property-list-ref.json","title":"Property List Reference","description":"Reference to an externally managed property list. Enables passing large property sets (50,000+) without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the property list"},"list_id":{"type":"string","description":"Identifier for the property list within the agent","minLength":1,"x-entity":"property_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/collection-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/collection-list-ref.json","title":"Collection List Reference","description":"Reference to an externally managed collection list. Enables passing large collection exclusion/inclusion sets without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the collection list"},"list_id":{"type":"string","description":"Identifier for the collection list within the agent","minLength":1,"x-entity":"collection_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/placement-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/placement-selection.json","title":"Placement Selection","description":"Complete purchased placement set within a product. This is inventory targeting, not creative routing: creative_assignments[].placement_refs route a creative only within this purchased set. Requests use mode selected to name the complete required set or mode default to accept the product/seller default. Across discovery, create, and update, a selected set is satisfied inherently when it exactly equals a fixed product's complete included placement set; this exact restatement does not require overlay_support.placement_selection, while partial selection does. Included placements are never independently selectable. Products with any fixed mode:included placement cannot advertise selectable placement overlay support because the fixed placement would make a partial buyer-selected set incomplete; sellers expose separately selectable inventory when needed. Successful package readback MUST echo the committed selected set. Sellers reject unknown, duplicate, cross-publisher, incompatible, or partially applicable refs rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected placements","type":"object","properties":{"mode":{"type":"string","const":"selected"},"placement_refs":{"type":"array","description":"Complete required placement set. A reference normally identifies a mode targetable placement. It MAY identify a mode included placement only when the set exactly equals the product's complete fixed included set, which is an inherent match rather than independent selection. Legacy publisher refs use {publisher_domain, placement_id}; authority-discriminated 3.2 identities use placement-identity.json so seller-inline inventory is selected by {seller_agent, placement_id}. An item that exactly matches placement-identity uses that canonical identity; otherwise a released-compatible item with publisher_domain and placement_id uses legacy product-context matching, and tolerated product metadata such as kind, name, or mode has no selection effect.","items":{"anyOf":[{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-ref.json"},{"required":["publisher_domain"]}]},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-identity.json"}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode","placement_refs"],"additionalProperties":false},{"title":"Product default placements","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/placement-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/placement-ref.json","title":"Placement Reference","description":"Legacy-compatible product-context reference to a placement. For publisher-catalog placements, publisher_domain plus placement_id resolves the declaration in that publisher's adagents.json. For seller-inline placements, the enclosing seller and product supply scope. When publisher_domain is omitted on legacy inputs, receivers MAY interpret the ID relative to the enclosing single-publisher product. Use placement-identity.json when a self-contained cross-document identity is required.","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring a publisher-catalog placement is hosted, or the inventory publisher associated with an inline placement. Omitted only for legacy single-publisher product-context references.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"placement_id":{"type":"string","description":"Placement ID from the publisher's adagents.json placement catalog, or an inline seller-defined placement ID interpreted within the enclosing seller and product context.","x-entity":"placement"}},"required":["placement_id"],"additionalProperties":true},"external:core/placement-identity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/placement-identity.json","title":"Placement Identity","description":"Self-contained identity for either a publisher-catalog placement or a sales-agent-defined inline placement. The discriminator names which authority owns placement_id.","oneOf":[{"title":"Publisher catalog placement identity","type":"object","properties":{"kind":{"type":"string","const":"publisher_ref"},"publisher_domain":{"type":"string","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","description":"Domain whose adagents.json declares placement_id."},"placement_id":{"type":"string","minLength":1,"x-entity":"placement"}},"required":["kind","publisher_domain","placement_id"],"additionalProperties":false},{"title":"Seller inline placement identity","type":"object","properties":{"kind":{"type":"string","const":"seller_inline"},"seller_agent":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1seller-agent-ref.json","description":"Sales agent that defines and maintains the inline placement namespace."},"placement_id":{"type":"string","minLength":1,"description":"Stable placement ID within the defining sales agent's namespace. The agent MUST NOT reuse it for a different semantic placement.","x-entity":"placement"}},"required":["kind","seller_agent","placement_id"],"additionalProperties":false}]},"external:core/seller-agent-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/seller-agent-ref.json","title":"Seller Agent Reference","description":"Structured reference to a seller agent. The canonical identifier is the agent's URL as declared in the property publisher's adagents.json `authorized_agents[].url`. The optional `id` slot is reserved for a future registry-assigned stable identifier; it is not used today. This shape mirrors `format-id` and `ProviderEntry` — URL-first, with an ID slot for forward compatibility.","x-status":"experimental","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"The seller agent's API endpoint URL as declared in the property publisher's adagents.json `authorized_agents[].url`. MUST use the `https://` scheme. Receivers compare this URL against the `authorized_agents` list using the AdCP URL canonicalization rules — not byte-equality — and reject mismatches with `seller_not_authorized`. See docs/reference/url-canonicalization."},"id":{"type":"string","description":"Reserved for a future registry-assigned stable seller identifier. Not used today — senders MUST NOT populate this field until a registry is defined. When a future release populates both `agent_url` and `id`, `agent_url` remains authoritative and `id` is advisory.","pattern":"^[a-zA-Z0-9_-]+$","minLength":1}},"required":["agent_url"],"additionalProperties":false,"examples":[{"agent_url":"https://agent.acme.example"}]},"external:core/collection-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/collection-selection.json","title":"Collection Selection","description":"Complete purchased collection set within a product. Mode selected names the complete required set (partial selection requires product collection_targeting_allowed: true; exactly restating the full bundle is an inherent match); mode default accepts the product's full bundle. Package readback MUST echo the committed selection here as concrete selectors, materializing any collection_list composition; a purchase made with mode default therefore reads back as mode selected naming the product's complete bundle. Rejection of a schema-valid selector that references an unknown collection_id or publisher_domain uses REFERENCE_NOT_FOUND per the error-code registry (INVALID_REQUEST applies only to schema-invalid shapes such as a selected-mode item omitting collection_ids). Sellers reject unknown, duplicate, or partially applicable selectors rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected collections","type":"object","properties":{"mode":{"type":"string","const":"selected"},"collections":{"type":"array","description":"Complete required collection set as domain-qualified selectors with explicit collection_ids; the domain-only bulk-grant form is authorization scoping, not selection. publisher_domain may be an external channel owner's domain.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-selector.json"},{"required":["collection_ids"]}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode","collections"],"additionalProperties":false},{"title":"Product default collections","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/collection-selector.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/collection-selector.json","title":"Collection Selector","description":"References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json — the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"collection_ids":{"type":"array","description":"Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.","items":{"type":"string","x-entity":"collection"},"minItems":1}},"required":["publisher_domain"],"additionalProperties":true},"external:enums/device-platform.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/device-platform.json","title":"Device Platform","description":"Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.","type":"string","enum":["ios","android","windows","macos","linux","chromeos","tvos","tizen","webos","fire_os","roku_os","unknown"]},"external:enums/device-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/device-type.json","title":"Device Type","description":"Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.","type":"string","enum":["desktop","mobile","tablet","ctv","dooh","unknown"]},"external:enums/browser-family.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/browser-family.json","title":"Browser Family","description":"Portable browser families for targeting the impression delivery and rendering environment, not a post-click landing-page browser. Values identify browser families, not versions or seller-native browser IDs, and MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. android_webview means an impression reliably classified as rendering in Android WebView. other means a seller-recognized browser family that is not explicitly enumerated; unknown means the seller cannot classify the browser into a recognized family.","type":"string","enum":["chrome","safari","firefox","edge","opera","samsung_internet","android_webview","other","unknown"]},"external:enums/travel-time-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/travel-time-unit.json","title":"Travel Time Unit","description":"Time unit for isochrone (travel-time catchment) calculations.","type":"string","enum":["min","hr"],"enumDescriptions":{"min":"Minutes","hr":"Hours"}},"external:enums/transport-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/transport-mode.json","title":"Transport Mode","description":"Transportation modes for isochrone-based catchment area calculations. Determines how travel time translates to geographic reach.","type":"string","enum":["walking","cycling","driving","public_transport"],"enumDescriptions":{"walking":"Pedestrian travel on walkable paths and sidewalks","cycling":"Bicycle travel on roads and cycle paths","driving":"Motor vehicle travel on road networks","public_transport":"Public transit including bus, rail, metro, and ferry"}},"external:enums/distance-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/distance-unit.json","title":"Distance Unit","description":"Units of distance measurement for radius-based catchment areas.","type":"string","enum":["km","mi","m"],"enumDescriptions":{"km":"Kilometers","mi":"Miles","m":"Meters"}},"external:core/locale-tag.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/locale-tag.json","title":"Language Tag","description":"A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.","x-adcp-validation":{"verifier_constraints":{"well_formed":"rfc5646","semantic_scope":"language_identity_only","canonical_wire_profile":"adcp_bcp47_casing","rfc5646_comparison":"case_insensitive","non_profile":"reject"},"spec":"docs/protocol/language-and-localization.mdx#one-language-tag-primitive"},"type":"string","minLength":2,"maxLength":63,"pattern":"^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$","examples":["en-US","es-ES","zh-Hant-TW","x-private"]},"external:enums/match-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/match-type.json","title":"Match Type","description":"Keyword targeting match type. broad: ads may serve on queries semantically related to the keyword. phrase: ads serve when the query contains the keyword phrase. exact: ads serve only when the query matches the keyword exactly.","type":"string","enum":["broad","phrase","exact"],"enumDescriptions":{"broad":"Ads may serve on queries semantically related to the keyword","phrase":"Ads serve when the query contains the keyword phrase in order","exact":"Ads serve only when the query matches the keyword exactly"}},"external:core/negative-keyword.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/negative-keyword.json","title":"Negative Keyword","description":"An excluded keyword.","type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to exclude"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1match-type.json"}},"required":["keyword","match_type"],"additionalProperties":false},"external:core/targeting-unknown-age-eligibility-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting-unknown-age-eligibility-constraint.json","title":"Targeting Unknown Age Eligibility Constraint","description":"Unknown-age delivery cannot satisfy a minimum-age eligibility policy. When demographic audience targeting and age_restriction are both present, include_unknown must be false.","if":{"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"include_unknown":{"const":false}}}}}}}},"external:core/targeting-verified-age-basis-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/targeting-verified-age-basis-constraint.json","title":"Targeting Verified Age Basis Constraint","description":"A legal verification requirement always narrows demographic targeting. When the buyer supplies accepted_bases and age_restriction requires verification, verified must be accepted; otherwise the constraints have an empty intersection and the request is invalid.","if":{"properties":{"age_restriction":{"properties":{"verification_required":{"const":true}},"required":["verification_required"]},"demographics":{"properties":{"age":{"required":["accepted_bases"]}},"required":["age"]}},"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}}}}},"external:core/audience-evidence-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/audience-evidence-requirements.json","title":"Audience Evidence Requirements","description":"Buyer-authored admissibility and ranking policy for product audience evidence. This reusable object attaches to get_products filters in 3.2, so the same semantics apply in brief, wholesale, and refine modes. It never requests exact audience targeting.","type":"object","properties":{"requirement_mode":{"type":"string","enum":["required","preferred"],"description":"required excludes products whose published evidence violates the constraints; preferred only affects ranking and explanation. When this policy affects inclusion or ranking, the seller MUST return the exact matching audience_evidence_selections even if get_products.fields omitted that field."},"evidence_presence":{"type":"string","enum":["required","when_available"],"description":"required applies the mode to evidence presence itself. when_available applies constraints only when a product publishes evidence: with requirement_mode required, a product with no evidence remains eligible but a product with evidence must have an admissible item; with preferred, presence and admissibility only affect ranking."},"accepted_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Allowed methodologies. excluded_methodologies always wins if a value appears in both lists."},"excluded_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Disallowed methodologies. Exclusion wins over accepted_methodologies when the lists overlap."},"accepted_evidence_types":{"type":"array","items":{"type":"string","enum":["measured","forecast","seller_declared"]},"minItems":1,"uniqueItems":true},"accepted_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Allowed evidence providers. excluded_providers always wins if the same canonical BrandRef appears in both lists."},"excluded_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Disallowed evidence providers. Exclusion wins over accepted_providers when the lists overlap."},"accepted_subject_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-subject-type.json"},"minItems":1,"uniqueItems":true},"accepted_resolution_methods":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-resolution-method.json"},"minItems":1,"uniqueItems":true},"minimum_confidence":{"type":"number","minimum":0,"maximum":1},"maximum_age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"},{"properties":{"unit":{"enum":["seconds","minutes","hours","days"]}}}],"description":"Maximum age at evaluation time measured from last_updated. Campaign-relative duration is not valid for evidence age."},"methodology_documentation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must carry methodology_url."},"independent_attestation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must have at least one exact reference/evaluation pair whose outcome is verified, whose reference is published in the evidence, and whose claim type and issuer match the buyer's accepted lists as well as the seller's issuer and resolver policy. Setting true requires accepted_attestation_issuers."},"accepted_attestation_issuers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-issuer.json"},"minItems":1,"uniqueItems":true,"description":"Buyer allowlist for independent attestation issuers. An exact reference/evaluation pair satisfies the requirement only when reference.issuer matches an entry here. This list narrows and never broadens the seller's accepted issuer policy."},"accepted_attestation_claim_types":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1,"uniqueItems":true,"description":"Optional acceptable claim types when attestation is used. Buyer-supplied claim types further constrain but never broaden seller policy."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["requirement_mode","evidence_presence"],"allOf":[{"if":{"properties":{"independent_attestation_required":{"const":true}},"required":["independent_attestation_required"]},"then":{"required":["accepted_attestation_issuers"]}}],"additionalProperties":false},"external:enums/audience-evidence-methodology.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audience-evidence-methodology.json","title":"Audience Evidence Methodology","description":"How a population-level audience-evidence estimate was produced. This vocabulary is intentionally separate from signal-definition methodology: `projected` describes expansion of a sample or panel to a reference population and does not become a user-level signal-membership method.","type":"string","enum":["observed","declared","derived","inferred","modeled","projected"]},"external:enums/audience-subject-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audience-subject-type.json","title":"Audience Subject Type","description":"The kind of subject characterized by audience data or population-level evidence.","type":"string","enum":["individual","household","business","contextual","none"]},"external:enums/audience-resolution-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audience-resolution-method.json","title":"Audience Resolution Method","description":"How subjects were resolved when producing a signal or population-level evidence estimate.","type":"string","enum":["deterministic_id","probabilistic_device","browser","geographic","content_signal","mixed"]},"external:core/attestation-issuer.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/attestation-issuer.json","title":"Attestation Issuer","description":"Canonical identity of the party that issued an attestation credential. The discriminator selects an existing AdCP identity when one exists and falls back to an HTTPS origin for other attestors. This identity is a claim carried by the presentation; evaluators MUST match it against their configured trust policy and verify it from the resolved or embedded credential before relying on it.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationBrandIssuer","type":"object","properties":{"type":{"type":"string","const":"brand","description":"The issuer is identified by an AdCP BrandRef."},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","brand"],"additionalProperties":false},{"title":"AttestationAgentIssuer","type":"object","properties":{"type":{"type":"string","const":"agent","description":"The issuer is an AdCP agent identified by its canonical HTTPS endpoint."},"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"Canonical HTTPS endpoint of the issuing agent. Evaluators compare it using AdCP URL canonicalization rules."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","agent_url"],"additionalProperties":false},{"title":"AttestationOriginIssuer","type":"object","properties":{"type":{"type":"string","const":"origin","description":"The issuer is identified by a canonical HTTPS origin because no AdCP brand or agent identity applies."},"origin":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+$","description":"Canonical HTTPS origin with no path, query, fragment, or userinfo. This identifies the issuer; it does not authorize a fetch."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","origin"],"additionalProperties":false}],"examples":[{"type":"brand","brand":{"domain":"nova-brands.example","brand_id":"nova_motors"}},{"type":"agent","agent_url":"https://attestor.example/adcp"},{"type":"origin","origin":"https://credentials.example"}]},"external:core/audience-evidence-pin.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/audience-evidence-pin.json","title":"Audience Evidence Pin","description":"Buyer-authored pin to one exact immutable audience-evidence snapshot selected during discovery. Sellers MUST match all four fields against a single published snapshot; they MUST reject the package rather than substitute a newer version or reuse snapshot_id with changed content. A confirmed package MUST return the same identity in audience_evidence_selections with decision_use package_construction.","type":"object","properties":{"evidence_id":{"type":"string","minLength":1,"x-entity":"audience_evidence"},"snapshot_id":{"type":"string","minLength":1,"x-entity":"audience_evidence_snapshot"},"version":{"type":"string","minLength":1},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["evidence_id","snapshot_id","version","content_digest"],"additionalProperties":false},"external:core/measurement-terms.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/measurement-terms.json","title":"Measurement Terms","description":"Billing measurement and makegood terms for media buys. Declares who counts the billing metric and what remedies apply when thresholds are breached. Appears on products (seller defaults), package requests (buyer proposals), and confirmed packages (agreed terms). All fields are optional — presence indicates the term is declared or proposed.","type":"object","properties":{"billing_measurement":{"type":"object","description":"Which vendor's value for the billing metric governs invoicing. The billing metric is determined by the pricing_model on the selected pricing_option (e.g., impressions for CPM, completed views for CPCV, commissionable_value for revenue_share).","properties":{"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor whose measurement of the billing metric is authoritative for invoicing (e.g., { domain: 'campaignmanager.google.com' } for buyer's DCM, { domain: 'admanager.google.com' } for seller's GAM)."},"max_variance_percent":{"type":"number","minimum":0,"exclusiveMaximum":100,"description":"Maximum acceptable variance between the billing vendor's count and the other party's count before resolution is triggered (e.g., 10 means a 10% divergence triggers review)."},"measurement_window":{"type":"string","description":"Which measurement maturation stage the billing metric is reconciled against. References a window_id from the product's reporting_capabilities.measurement_windows. Examples: 'c7' for broadcast TV guarantees (live + 7 days DVR), 'final' for DOOH after IVT/fraud-check processing, 'post_sivt' for digital after sophisticated invalid-traffic filtering, 'downloads_30d' for podcast. When absent, billing is based on the seller's standard reporting without windowed maturation.","examples":["live","c3","c7","tentative","final","post_ivt","post_sivt","downloads_30d"]},"finalization_deadline_hours":{"type":"integer","minimum":0,"description":"Maximum hours by which the authoritative party MUST publish a final record (`is_final: true` / `finalized_at` on `get_media_buy_delivery`, or `final: true` / `finalized_at` on `report_usage`). **Anchor:** when `measurement_window` is set, hours are counted from the close of that window (e.g., 240h after `c7` close = ~10 days after the 7-day DVR accumulation completes); when `measurement_window` is absent, hours are counted from `reporting_period.end`. Picking a single anchor avoids ambiguity for windowed channels where `reporting_period.end` and window close differ by days. The deadline applies to whichever party is named in `vendor` — seller, buyer, or third-party vendor — symmetrically. When the deadline elapses without a final record, the counterparty MAY fall back to its own attestation for invoicing (seller falls back to seller-attested numbers via `get_media_buy_delivery`; buyer falls back to a buyer-attested `report_usage` push), and the breach is treated like any other measurement-terms breach under `makegood_policy`. Absent means no contractual deadline — finalization is best-effort and disagreements resolve out of band."}},"required":["vendor"],"additionalProperties":true},"makegood_policy":{"type":"object","description":"Remedies available when a performance standard or billing measurement variance is breached. Seller declares which remedy types they support. When a breach occurs, the seller proposes a remedy from this menu; the buyer accepts or disputes.","properties":{"available_remedies":{"type":"array","description":"Remedy types the seller supports. Ordered by seller preference (first = preferred). Seller proposes from this list when a breach occurs; buyer accepts or disputes.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1makegood-remedy.json"},"minItems":1,"uniqueItems":true}},"required":["available_remedies"],"additionalProperties":true}},"additionalProperties":true},"external:enums/makegood-remedy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/makegood-remedy.json","title":"Makegood Remedy","description":"Remedy types available when a performance standard or billing measurement threshold is breached.","type":"string","enum":["additional_delivery","credit","invoice_adjustment"],"enumDescriptions":{"additional_delivery":"Seller extends or adds impressions to compensate for the shortfall. Delivery is like-for-like on the same campaign or a subsequent campaign within the same account.","credit":"Seller issues a credit toward future media buys on the same account.","invoice_adjustment":"Seller reduces the invoice for the current media buy to reflect actual delivered value."}},"external:core/performance-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/performance-standard.json","title":"Performance Standard","description":"A rate threshold for a performance metric, measured by a specified vendor. The threshold is a floor or ceiling depending on the metric: viewability, completion_rate, brand_safety, and attention_score are floors (must exceed); ivt is a ceiling (must not exceed).","type":"object","properties":{"metric":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1performance-standard-metric.json","description":"The performance metric this standard applies to."},"threshold":{"type":"number","minimum":0,"maximum":1,"description":"Rate threshold as a decimal (e.g., 0.70 for 70%). Whether this is a floor or ceiling depends on the metric: for viewability, completion_rate, brand_safety, attention_score the actual rate must be >= threshold; for ivt the actual rate must be <= threshold."},"standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json","description":"Measurement standard. Required when metric is 'viewability' (MRC and GroupM define materially different thresholds). Omit for other metrics."},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor measuring this metric (e.g., { domain: 'doubleverify.com' }). The vendor's brand.json agents array (type: 'measurement') is the discovery point for their measurement agent. When specified on a confirmed package, creatives MUST include tracker_script or tracker_pixel assets from this vendor."}},"required":["metric","threshold","vendor"],"additionalProperties":true},"external:enums/performance-standard-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/performance-standard-metric.json","title":"Performance Standard Metric","description":"Performance metrics that support rate thresholds on media buys — the verification subset of the broader metric vocabulary. Each metric specifies whether its threshold is a floor (must exceed) or ceiling (must not exceed). Shared values with `available-metric.json` mirror the delivery vocabulary (`viewability` → `viewable_rate` family, `completion_rate` → same name); verification-only values (`ivt`, `brand_safety`, `attention_score`) are typically vendor-attested and do not appear in `available-metric.json` because they're not seller-reportable scalars — they flow through `vendor_metric_values` or vendor-scope `committed_metrics` entries with the matching `performance_standard.vendor` BrandRef anchoring identity.","type":"string","enum":["viewability","ivt","completion_rate","brand_safety","attention_score"],"enumDescriptions":{"viewability":"Viewable impression rate (floor — must exceed threshold). Requires viewability_standard. Denominator: measurable_impressions.","ivt":"Invalid Traffic rate (ceiling — must not exceed threshold). Denominator: total_impressions.","completion_rate":"Video or audio completion rate (floor — must exceed threshold). Denominator: total_impressions.","brand_safety":"Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.","attention_score":"Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."}},"external:enums/available-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/available-metric.json","title":"Available Metric","description":"Standard delivery and performance metrics available for reporting. Most values name flat numeric fields of `core/delivery-metrics.json`. Leaf identities address a single numeric value nested inside an object-shaped metric so it can be declared, committed, aggregated, and sorted individually: `quartile_25`/`quartile_50`/`quartile_75`/`quartile_100` resolve to `quartile_data.q1_views`–`q4_views`, and `viewable_rate`/`viewable_impressions`/`measurable_impressions`/`viewed_seconds` resolve to the same-named fields of `viewability`. Structured nested identities `viewed_seconds_percentiles` and `viewed_seconds_histogram` make the corresponding optional distribution carriers discoverable, committable, and requestable, but not aggregatable or sortable. The nested object or array remains the canonical carrier — nested identities never introduce duplicate flat response fields. Container tokens such as `viewability`, `quartile_data`, `dooh_metrics`, and `time_based_views` declare their documented nested surface. **Container subsumption applies only to numeric leaves**: `viewability` subsumes `viewable_rate`, `viewable_impressions`, `measurable_impressions`, and `viewed_seconds`; `quartile_data` subsumes `quartile_25`, `quartile_50`, `quartile_75`, and `quartile_100`. This rule applies to capability declaration, `required_metrics` filtering, format `reported_metrics` intersection, and `requested_metrics` selection. Optional structured identities MUST be declared explicitly: `viewability` alone does not satisfy `viewed_seconds_percentiles` or `viewed_seconds_histogram`. Requesting any nested identity selects its canonical carrier in the response. A nested identity declaration does not imply sibling values or the carrier's non-metric fields.","type":"string","enum":["impressions","spend","clicks","ctr","views","completed_views","completion_rate","conversions","conversion_value","commissionable_value","roas","cost_per_acquisition","new_to_brand_rate","leads","reach","frequency","grps","engagements","engagement_rate","follows","saves","profile_visits","viewability","viewable_rate","viewable_impressions","measurable_impressions","viewed_seconds","viewed_seconds_percentiles","viewed_seconds_histogram","quartile_data","quartile_25","quartile_50","quartile_75","quartile_100","time_based_views","dooh_metrics","ooh_metrics","cost_per_click","cost_per_completed_view","cpm","downloads","units_sold","new_to_brand_units","plays","incremental_sales_lift","brand_lift","foot_traffic","conversion_lift","brand_search_lift"]},"external:enums/completion-source.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/completion-source.json","title":"Completion Source","description":"Trust-source disambiguator for `completion_rate` — *who* attested to the completion event, not *how* (methodology granularity is a separate dimension; future qualifier keys may add it if buyer demand surfaces). The two paths can yield materially different rates, particularly in SSAI environments where the player's view of completion may differ from a vendor's. Used as a `qualifier.completion_source` key on `committed_metrics`, `missing_metrics`, and package-level delivery values (`metric_values` or `vendor_metric_values`) to disambiguate which trust source the row represents. Edge cases: walled gardens where the seller is also the measurement vendor (YouTube, Spotify) collapse to `seller_attested` by trust-model logic — the same party served and counted. IAB-certified first-party podcast measurement (Podtrac, Triton on their own platforms; Art19 on its own platform) likewise collapses to `seller_attested`. The same vendor's offering on a third-party platform (Podtrac on a publisher who isn't Podtrac) is `vendor_attested`. The trust axis is *not* who runs the SDK — it's who is independent of the seller's revenue interest.","type":"string","enum":["seller_attested","vendor_attested"],"enumDescriptions":{"seller_attested":"The party serving the ad witnessed and counted the completion event. Includes ad-server / player completion beacons, walled-garden first-party measurement, and IAB-certified first-party podcast measurement on the platform's own inventory. Source of truth is the seller's delivery infrastructure.","vendor_attested":"An independent third-party measurement vendor (Nielsen, DV, IAS, Moat, HUMAN, Podtrac on third-party inventory, Edison Research panel, etc.) attested to the completion via SDK callbacks, server-beacon validation, or panel methodology. Source of truth is the vendor; vendor identity SHOULD be anchored on a matching `performance_standard.vendor` BrandRef in the buy contract — if a buyer wants vendor-attested completion for transparency without an accountability gate, they MAY commit a vendor metric via `vendor_metrics` on the product rather than `committed_metrics` with this qualifier."}},"external:enums/attribution-methodology.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/attribution-methodology.json","title":"Attribution Methodology","description":"How attribution between ad exposure and outcome events was computed. Used as a `qualifier.attribution_methodology` key on `committed_metrics`, `missing_metrics`, package-level delivery values (`metric_values` or `vendor_metric_values`), and `performance-feedback.metric` to disambiguate the same outcome metric reported under different methodologies — `conversion_value` measured deterministically (matched purchase IDs) is not the same number as `conversion_value` measured probabilistically (modeled match) and should never be summed across methodologies. The retail-media closed-loop pattern typically reports under `deterministic_purchase`; MMM and clean-room outputs typically report under `modeled` or `probabilistic`; panel-based measurement (Nielsen, comScore, Edison) reports under `panel_based`.","type":"string","enum":["deterministic_purchase","probabilistic","panel_based","modeled"],"enumDescriptions":{"deterministic_purchase":"1:1 deterministic match between exposed users and purchasers, typically via shared identifier (loyalty card, logged-in account, hashed email). Standard in retail-media closed-loop measurement (Walmart Connect, Kroger Precision, Amazon DSP attribution).","probabilistic":"Probabilistic match using statistical models over device graphs, IP/UA fingerprinting, or behavioral signals. No 1:1 identifier link.","panel_based":"Panel methodology — outcomes measured against a recruited respondent panel and projected to the population. Standard for Nielsen, comScore, Edison Research, and similar panel providers.","modeled":"Modeled output — Media Mix Modeling (MMM), Multi-Touch Attribution (MTA), incrementality testing, or other statistical inference that produces an estimated outcome rather than a directly-observed match. Includes most clean-room outputs."}},"external:enums/lift-dimension.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/lift-dimension.json","title":"Lift Dimension","description":"Brand-lift dimension disambiguator. Brand lift is multidimensional in production — Kantar, Upwave, Cint, DoubleVerify, and similar vendors report awareness, consideration, favorability, purchase intent, and ad recall as separate measurements with their own sample sizes and confidence intervals. Used as a `qualifier.lift_dimension` key on `committed_metrics`, `missing_metrics`, package-level delivery values (`metric_values` or `vendor_metric_values`), and `performance-feedback.metric` to disambiguate which dimension of `brand_lift` a row represents. Two `brand_lift` rows under different lift dimensions represent different surveyed outcomes and must not be combined into a single number.","type":"string","enum":["awareness","consideration","favorability","purchase_intent","ad_recall"],"enumDescriptions":{"awareness":"Lift in unaided or aided brand awareness — typically measured as 'have you heard of [brand]'.","consideration":"Lift in brand consideration — 'would you consider buying [brand] next time'.","favorability":"Lift in brand favorability or affinity — 'how favorable is your view of [brand]'.","purchase_intent":"Lift in stated purchase intent — 'are you likely to buy [brand] in the next [N] days'.","ad_recall":"Lift in unaided or aided ad recall — 'do you remember seeing an ad for [brand]'."}},"external:core/creative-assignment.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-assignment.json","title":"Creative Assignment","description":"Assignment of a creative asset to a package with optional rotation and placement routing. Used in create_media_buy and update_media_buy requests. Buyers identify the stored creative with `creative_id` only. A generic `id` alias, if present due to adapter-internal payload reuse, is not an AdCP identifier and sellers MUST ignore it on input. Note: sync_creatives does not support package rotation, placement_refs, or placement_ids - use create/update_media_buy for package-level trafficking controls.","type":"object","properties":{"creative_id":{"type":"string","description":"Unique identifier for the creative","x-entity":"creative"},"weight":{"type":"number","description":"Relative delivery weight for this creative (0–100). Valid when the package's effective rotation_mode is weighted, including the backward-compatible default when rotation_mode is omitted. Weights determine impression distribution proportionally — a creative with weight 2 gets twice the delivery of weight 1. When omitted, the creative receives equal weight with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).","minimum":0,"maximum":100},"rotation_mode":{"type":"string","enum":["weighted","even","sequential","random"],"description":"Package-scoped rotation policy repeated on assignment rows for wire compatibility. Omission means weighted, preserving existing weight behavior. Every assignment in a package MUST resolve to the same effective mode: weighted uses relative weights; even balances delivery across eligible assignments; sequential cycles through sequence_position in ascending order within each group; random makes an independent uniform selection from eligible assignments. Sellers MUST reject conflicting effective modes rather than choose one by array order."},"group_id":{"type":"string","minLength":1,"description":"Package-local creative pool identifier. The identifier has no meaning outside this package. Assignments that omit group_id belong to the package's default group; one eligible creative is selected from each applicable group per serving opportunity."},"sequence_position":{"type":"integer","minimum":1,"description":"One-based order within the assignment's package-local group. Required only for sequential rotation and unique within that group."},"placement_refs":{"type":"array","description":"Optional structured product-context refs routing this creative within already-purchased package inventory. These items always use placement-ref product-context semantics, even when tolerated additional members make an item resemble placement-identity. Receivers match only against the package's committed placement set; kind and seller_agent are non-authoritative for routing and MUST NOT expand or reinterpret that set. A receiver MUST reject a ref when the enclosing product and committed set do not yield one unambiguous match. This field never narrows purchased inventory; use targeting_overlay.placement_selection for that. Every ref MUST fall within the package's committed placement selection. New senders SHOULD include publisher_domain for publisher-catalog placements. When omitted, the creative runs across the purchased placements compatible with its format. If both placement_refs and legacy placement_ids are present, placement_refs wins.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-ref.json"},"minItems":1},"placement_ids":{"type":"array","deprecated":true,"description":"Legacy shorthand routing IDs within already-purchased inventory. This field never narrows purchased inventory; use targeting_overlay.placement_selection. New senders SHOULD use placement_refs because IDs are publisher-scoped. If placement_refs is also present, receivers MUST ignore this field.","items":{"type":"string"},"minItems":1}},"required":["creative_id"],"allOf":[{"if":{"properties":{"rotation_mode":{"const":"sequential"}},"required":["rotation_mode"]},"then":{"required":["sequence_position"]}},{"if":{"required":["sequence_position"]},"then":{"properties":{"rotation_mode":{"const":"sequential"}},"required":["rotation_mode"]}},{"if":{"properties":{"rotation_mode":{"enum":["even","sequential","random"]}},"required":["rotation_mode"]},"then":{"not":{"required":["weight"]}}}],"additionalProperties":true},"external:core/creative-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-asset.json","title":"Creative Asset","description":"Creative asset for upload to library — supports static assets, generative formats, and third-party snippets. Identifies which format this creative conforms to via EITHER a legacy `format_id` (structured `{agent_url, id}`) OR a 3.1+ `format_kind` (canonical format name), with optional `format_option_ref` when the target product needs disambiguation. Mutually exclusive — see the `oneOf` at the schema root.","type":"object","properties":{"creative_id":{"type":"string","description":"Unique identifier for the creative. Stable across legacy named-format and 3.1+ canonical-format paths — a creative registered against `format_id` retains the same `creative_id` when later viewed through a canonical-format flatten.","x-entity":"creative"},"name":{"type":"string","description":"Human-readable creative name"},"format_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format path retained for older 3.x peers. New creative assets use `format_kind` and optional `format_option_ref`."},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Canonical format name this creative targets (e.g., `image`, `video_hosted`). Mutually exclusive with deprecated `format_id`."},"format_option_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-option-ref.json","description":"3.1+ format-option path, optional. Structured format option reference matching one of the target product's `format_options[]` declarations. Publisher-catalog-backed options match by `{ scope: \"publisher\", publisher_domain, format_option_id }`; product-local options match by `{ scope: \"product\", format_option_id }`. Required when the target product has multiple `format_options` entries sharing the same `format_kind`; optional when `format_kind` alone routes the creative to a single declaration. Product-scoped refs require an enclosing target product/package context."},"representation_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1representation-selection.json","description":"Readback lineage to the complete CreativeRepresentationSet revision and representation selected before this seller-bound creative was synced."},"assets":{"type":"object","description":"Assets required by the format, keyed by asset_id or canonical asset_group_id. Each slot value is either a single asset object or an array of asset objects (for slots with `min`/`max > 1` like carousel `cards` or responsive_creative `headlines`). Each asset value carries an `asset_type` discriminator that selects the matching asset schema, including reference assets such as `published_post` when a product accepts already-published post references.","patternProperties":{"^[a-z0-9_]+$":{"oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":true},"component_assets":{"type":"object","description":"Component-addressed canonical asset maps for `coordinated_placements`. Keys match coordinated component IDs. This field is preserved by creative-library sync and list readback; it MUST be absent for every other format kind.","patternProperties":{"^[a-z][a-z0-9_]*$":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-assets.json"}},"additionalProperties":false},"inputs":{"type":"array","description":"Preview contexts for generative formats - defines what scenarios to generate previews for","items":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable name for this preview variant"},"macros":{"type":"object","description":"Macro values to apply for this preview","additionalProperties":{"type":"string"}},"context_description":{"type":"string","description":"Natural language description of the context for AI-generated content"}},"required":["name"],"additionalProperties":true}},"tags":{"type":"array","description":"User-defined tags for organization and searchability","items":{"type":"string"}},"status":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1creative-status.json","description":"For generative creatives: set to 'approved' to finalize, 'rejected' to request regeneration with updated assets/message. Omit for non-generative creatives (system will set based on processing state)."},"weight":{"type":"number","description":"Optional delivery weight for creative rotation when uploading via create_media_buy or update_media_buy (0-100). If omitted, platform determines rotation. Only used during upload to media buy - not stored in creative library.","minimum":0,"maximum":100},"placement_refs":{"type":"array","description":"Optional structured product-context placement references where this uploaded creative should run when uploading via create_media_buy or update_media_buy. These items always use placement-ref product-context semantics, even when tolerated additional members make an item resemble placement-identity. Receivers match only against the target package's committed placement set; kind and seller_agent are non-authoritative for routing and MUST NOT expand or reinterpret that set. A receiver MUST reject a ref when the enclosing product and committed set do not yield one unambiguous match. New senders SHOULD include publisher_domain for publisher-catalog placements. If omitted, creative runs on all buyer-targetable placements. If both `placement_refs` and legacy `placement_ids` are present, `placement_refs` wins and receivers MUST ignore `placement_ids`. Only used during upload to media buy - not stored in creative library.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-ref.json"},"minItems":1},"placement_ids":{"type":"array","deprecated":true,"description":"Legacy shorthand array of placement IDs where this creative should run when uploading via create_media_buy or update_media_buy. New senders SHOULD use `placement_refs` because placement IDs are publisher-scoped and strings are ambiguous in multi-publisher products. If omitted, creative runs on all buyer-targetable placements. If `placement_refs` is also present, receivers MUST ignore this field. Only used during upload to media buy - not stored in creative library.","items":{"type":"string"},"minItems":1},"industry_identifiers":{"type":"array","description":"Industry-standard or market-specific identifiers for this creative (e.g., Ad-ID, ISCI, Clearcast clock number, IDcrea). In broadcast and scheduled audio/video buying, these identifiers tie the creative to rotation instructions, clearance records, and traffic systems. A creative may have multiple identifiers when different systems reference the same asset. Add a PR to extend creative-identifier-type when another shared identifier scheme needs first-class support.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1industry-identifier.json"},"uniqueItems":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this creative. Serves as the default provenance for all manifests and assets within this creative. A manifest or asset with its own provenance replaces this object entirely (no field-level merging)."},"rights":{"type":"array","description":"Rights constraints that MUST survive sync, package assignment, and list readback. Buyer-carried constraints and references do not authorize serving; the seller evaluates them under media_buy.rights_attestations and its adcp.attestations policy.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1rights-constraint.json"},"minItems":1}},"required":["creative_id","name","assets"],"not":{"anyOf":[{"required":["capability_id"]},{"required":["capability_ref"]}]},"oneOf":[{"title":"v1 creative (named-format reference)","deprecated":true,"description":"Deprecated 3.x compatibility branch using a structured named-format reference.","required":["format_id"],"not":{"required":["format_kind"]}},{"title":"v2 creative (canonical format kind)","description":"Creative declares the portable canonical contract it targets via `format_kind` and optional `format_option_ref`.","required":["format_kind"],"not":{"required":["format_id"]}}],"allOf":[{"if":{"properties":{"format_kind":{"const":"coordinated_placements"}},"required":["format_kind"]},"then":{"required":["component_assets"]},"else":{"not":{"required":["component_assets"]}}}],"additionalProperties":true},"external:core/representation-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/representation-selection.json","title":"Representation Selection","description":"Readback lineage from a seller-bound manifest or CreativeAsset to the exact CreativeRepresentationSet revision and representation selected for it. This is selection lineage, not served-variant identity.","x-adcp-validation":{"verifier_constraints":{"source_set":{"creative_id":"must equal the source CreativeRepresentationSet creative_id","revision_id":"must equal the source CreativeRepresentationSet revision_id","revision_content_digest":"must equal the verified digest of the complete source CreativeRepresentationSet","selected_representation_id":"must identify exactly one member of the complete source representations array","strategy":"must equal the capability-advertised strategy requested for this resolution"},"derived_output":{"source_revision_unchanged":"selection, macro binding, translation, and transcoding MUST NOT change the source revision binding","canonical_content":"RFC 8785 JCS of the manifest projection after removing exactly top-level $schema, representation_selection, creative_id, revision_id, name, tags, status, weight, placement_refs, placement_ids, and inputs properties; every other field, including unknown delivery fields, is included","shared_projection":"apply the same exclusion list to the returned CreativeManifest and to its later CreativeAsset sync wrapper so library metadata never changes the digest","selected_output_digest":"must equal lowercase-hex SHA-256 of derived-output canonical content before receiving-seller normalization","review_identity":"the receiving seller tracks (selected_representation_id, selected_output_digest, execution_vast_version-or-null, execution_daast_version-or-null) separately from the source revision; changing any member is an updated execution that follows ordinary re-review without minting a buyer revision","execution_version":"each execution version MUST equal the verified representation destination and later immutable package snapshot; a package mismatch requires re-resolution and ordinary re-review rather than silent rebinding","approval_boundary":"the exact selected output MUST complete the receiving seller's ordinary validation and review before serving; approval of one candidate never approves another","runtime_selection":"selection is pinned at trafficking time and MUST NOT be changed per viewer or device; device and player fallback stays within the selected manifest or VAST document","selection_stability":"after sync_creatives accepts this lineage, later product, placement, VAST, macro, or seller-capability changes MUST NOT cause implicit re-resolution, lineage replacement, or buyer re-review; only an explicit buyer-submitted selected output may replace it","seller_inability":"if the seller can no longer serve the pinned execution, it MUST preserve this lineage and use ordinary seller/system creative-status and media-buy impairment surfaces rather than silently substituting another representation"}},"spec":"docs/creative/representation-sets.mdx#seller-bound-resolution"},"type":"object","properties":{"creative_id":{"type":"string","minLength":1,"x-entity":"creative"},"revision_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-revision-id.json"},"revision_content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Verified digest from the complete source representation set. A downstream seller uses this value, not the selected manifest bytes alone, to enforce immutable revision reuse."},"selected_representation_id":{"type":"string","minLength":1,"x-entity":"creative_representation"},"strategy":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1representation-selection-strategy.json","description":"Deterministic strategy applied after compatibility filtering."},"selected_output_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Digest of the derived seller-bound manifest projection, computed with RFC 8785 JCS after removing exactly top-level `$schema`, `representation_selection`, `creative_id`, `revision_id`, `name`, `tags`, `status`, `weight`, `placement_refs`, `placement_ids`, and `inputs`. Every other field, including unknown delivery fields, is included. The identical exclusion list applies to the returned CreativeManifest and its later CreativeAsset sync wrapper. A selected sync item cannot carry localization in this version. This is the review/execution fingerprint for the projection, distinct from revision_content_digest, which binds the complete source set."},"execution_vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-version.json","description":"Exact VAST version verified for seller-assembled first-class VAST trackers. This is selection lineage and part of the execution review identity; it is not included in selected_output_digest."},"execution_daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-version.json","description":"Exact DAAST version verified for seller-assembled first-class DAAST trackers. This is selection lineage and part of the execution review identity; it is not included in selected_output_digest."},"resolved_by":{"type":"string","enum":["buyer","seller"],"description":"Who performed deterministic compatibility resolution. A buyer may resolve locally from seller discovery. Seller resolution is valid only on the destination sales agent when it advertised representation_resolution; an independent creative agent cannot claim seller-bound compatibility."}},"required":["creative_id","revision_id","revision_content_digest","selected_representation_id","strategy","selected_output_digest","resolved_by"],"additionalProperties":false},"external:core/creative-revision-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-revision-id.json","title":"Creative Revision ID","description":"Buyer-assigned identity for one immutable input-content state of a durable creative. Scoped to the parent creative_id. Seller transcoding, normalization, and delivery representations do not change this identity.","type":"string","minLength":1,"maxLength":255,"x-entity":"creative_revision"},"external:enums/representation-selection-strategy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/representation-selection-strategy.json","title":"Representation Selection Strategy","description":"Deterministic strategy used after filtering a CreativeRepresentationSet against one seller destination contract. `representation_order` selects the first compatible representation in source array order. `highest_compatible_vast` is valid only when the destination format_kind is `video_vast` or `audio_vast`; it selects the compatible VAST representation with the highest exact VAST version, and equal-version ties are resolved by source array order. Using it for another format is INVALID_REQUEST and never falls back silently.","type":"string","enum":["representation_order","highest_compatible_vast"]},"external:enums/vast-version.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/vast-version.json","title":"VAST Version","description":"Supported VAST (Video Ad Serving Template) specification versions. Covers every version published by IAB Tech Lab, through VAST 4.3 (released December 2022). The value mirrors the `version` attribute a VAST document declares on its root element.","$comment":"VAST 4.3 ships no XSD of its own: IAB's `vast_4.2.xsd` remains the authoritative schema for 4.3 documents, so a validator MUST NOT reject a tag declaring `version=\"4.3\"` for want of a 4.3 schema. VAST 4.4 is deliberately absent because `vast_4.4.xsd` is annotated 'DRAFT for working group discussion' and is not a published specification; add it once IAB publishes it, not before. This file is the single source of truth for the roster, per the Enum Consolidation rule in docs/spec-guidelines.md, and other schemas `$ref` it rather than restating the list.","type":"string","enum":["2.0","3.0","4.0","4.1","4.2","4.3"]},"external:enums/daast-version.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/daast-version.json","title":"DAAST Version","description":"Supported DAAST (Digital Audio Ad Serving Template) specification versions","type":"string","enum":["1.0","1.1"]},"external:core/assets/asset-union.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/asset-union.json","title":"AssetVariant","description":"Canonical union of all asset variant schemas. Referenced from creative-asset.json and creative-manifest.json to ensure a single named type is emitted by schema-to-TypeScript tooling. Add new asset types here and to the creative/asset-types registry.","x-adcp-hoist":true,"type":"object","oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1video-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1audio-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1vast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1display-tag-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1text-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1url-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1html-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1javascript-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1zip-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1webhook-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1css-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1daast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1markdown-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1brief-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1catalog-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1published-post-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1card-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1pixel-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1vast-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1daast-tracker-asset.json"}],"discriminator":{"propertyName":"asset_type"}},"external:core/assets/video-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/video-asset.json","title":"Video Asset","description":"A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.","$comment":"Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.","type":"object","properties":{"asset_type":{"type":"string","const":"video","description":"Discriminator identifying this as a video asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the video asset"},"width":{"type":"integer","minimum":1,"description":"Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"},"height":{"type":"integer","minimum":1,"description":"Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"},"duration_ms":{"type":"integer","description":"Video duration in milliseconds","minimum":1},"file_size_bytes":{"type":"integer","description":"File size in bytes","minimum":1},"container_format":{"type":"string","description":"Video container format (mp4, webm, mov, etc.)"},"video_codec":{"type":"string","description":"Video codec used (h264, h265, vp9, av1, prores, etc.)"},"video_bitrate_kbps":{"type":"integer","description":"Video stream bitrate in kilobits per second","minimum":1},"frame_rate":{"type":"string","description":"Frame rate as string to preserve precision (e.g., '23.976', '29.97', '30')"},"frame_rate_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1frame-rate-type.json"},"scan_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1scan-type.json"},"color_space":{"type":"string","enum":["rec709","rec2020","rec2100","srgb","dci_p3"],"description":"Color space of the video"},"hdr_format":{"type":"string","enum":["sdr","hdr10","hdr10_plus","hlg","dolby_vision"],"description":"HDR format if applicable, or 'sdr' for standard dynamic range"},"chroma_subsampling":{"type":"string","enum":["4:2:0","4:2:2","4:4:4"],"description":"Chroma subsampling format"},"video_bit_depth":{"type":"integer","enum":[8,10,12],"description":"Video bit depth"},"gop_interval_seconds":{"type":"number","description":"GOP/keyframe interval in seconds"},"gop_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1gop-type.json"},"moov_atom_position":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1moov-atom-position.json"},"has_audio":{"type":"boolean","description":"Whether the video contains an audio track"},"audio_codec":{"type":"string","description":"Audio codec used (aac, aac_lc, he_aac, pcm, mp3, ac3, eac3, etc.)"},"audio_sampling_rate_hz":{"type":"integer","description":"Audio sampling rate in Hz (e.g., 44100, 48000)"},"audio_channels":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audio-channel-layout.json","description":"Audio channel configuration"},"audio_bit_depth":{"type":"integer","enum":[16,24,32],"description":"Audio bit depth"},"audio_bitrate_kbps":{"type":"integer","description":"Audio bitrate in kilobits per second","minimum":1},"audio_loudness_lufs":{"type":"number","description":"Integrated loudness in LUFS"},"audio_true_peak_dbfs":{"type":"number","description":"True peak level in dBFS"},"captions_url":{"type":"string","format":"uri","description":"URL to captions file (WebVTT, SRT, etc.)","x-accessibility":true},"transcript_url":{"type":"string","format":"uri","description":"URL to text transcript of the video content","x-accessibility":true},"audio_description_url":{"type":"string","format":"uri","description":"URL to audio description track for visually impaired users","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","width","height"],"additionalProperties":true},"external:enums/frame-rate-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/frame-rate-type.json","title":"Frame Rate Type","description":"Whether the video uses a constant or variable frame rate. Broadcast and SSAI contexts require constant frame rate for seamless splicing.","type":"string","enum":["constant","variable"],"enumDescriptions":{"constant":"Constant frame rate (CFR) — each frame occupies an identical time interval","variable":"Variable frame rate (VFR) — frame intervals may differ"}},"external:enums/scan-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/scan-type.json","title":"Scan Type","description":"Video scan method. Modern digital delivery requires progressive scan; interlaced is retained for broadcast legacy content.","type":"string","enum":["progressive","interlaced"],"enumDescriptions":{"progressive":"All lines of each frame are drawn in sequence","interlaced":"Alternating lines drawn in two passes per frame (legacy broadcast)"}},"external:enums/gop-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/gop-type.json","title":"GOP Type","description":"Group of Pictures structure. SSAI and broadcast require closed GOPs for clean splice points; open GOPs may produce artifacts at ad boundaries.","type":"string","enum":["closed","open"],"enumDescriptions":{"closed":"Each GOP is independently decodable — required for SSAI and broadcast splicing","open":"GOPs may reference frames from adjacent GOPs — not suitable for splicing"}},"external:enums/moov-atom-position.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/moov-atom-position.json","title":"Moov Atom Position","description":"Position of the moov atom in an MP4 container. 'start' enables progressive download without buffering the entire file; required for streaming ad delivery.","type":"string","enum":["start","end"],"enumDescriptions":{"start":"moov atom at beginning of file — enables progressive download and streaming delivery","end":"moov atom at end of file — requires full download before playback can begin"}},"external:enums/audio-channel-layout.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/audio-channel-layout.json","title":"Audio Channel Layout","description":"Audio channel configuration for audio and video assets","type":"string","enum":["mono","stereo","5.1","7.1"]},"external:core/assets/audio-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/audio-asset.json","title":"Audio Asset","description":"Audio asset with URL and technical specifications","type":"object","properties":{"asset_type":{"type":"string","const":"audio","description":"Discriminator identifying this as an audio asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the audio asset"},"duration_ms":{"type":"integer","description":"Audio duration in milliseconds","minimum":0},"file_size_bytes":{"type":"integer","description":"File size in bytes","minimum":1},"container_format":{"type":"string","description":"Audio container/file format (mp3, m4a, aac, wav, ogg, flac, etc.)"},"codec":{"type":"string","description":"Audio codec used (aac, aac_lc, he_aac, pcm, mp3, vorbis, opus, flac, ac3, eac3, etc.)"},"sampling_rate_hz":{"type":"integer","description":"Sampling rate in Hz (e.g., 44100, 48000, 96000)"},"channels":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audio-channel-layout.json","description":"Channel configuration"},"bit_depth":{"type":"integer","enum":[16,24,32],"description":"Bit depth"},"bitrate_kbps":{"type":"integer","description":"Bitrate in kilobits per second","minimum":1},"loudness_lufs":{"type":"number","description":"Integrated loudness in LUFS"},"true_peak_dbfs":{"type":"number","description":"True peak level in dBFS"},"transcript_url":{"type":"string","format":"uri","description":"URL to text transcript of the audio content","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url"],"additionalProperties":true},"external:core/assets/vast-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/vast-asset.json","title":"VAST Asset","description":"VAST (Video Ad Serving Template) tag for third-party video or audio ad serving. Unlike a hosted media asset, a VAST tag carries no single `width`/`height`: a response can return multiple renditions and the player selects one at serve time. Standardized VAST audio support begins at 4.1 and uses MediaFile width and height values of 0; older audio-in-VAST versions are seller-declared legacy interoperability. Dimensional, duration, MIME-type, and codec constraints live on the format/requirements layer, not on this asset.","type":"object","properties":{"asset_type":{"type":"string","const":"vast","description":"Discriminator identifying this as a VAST asset. See /schemas/creative/asset-types for the registry."},"vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-version.json","description":"Exact VAST version declared by the supplied URL response or inline document. Required by the 3.2 canonical `video_vast` and `audio_vast` manifest paths; optional only on the deprecated named-format compatibility path. Receivers MUST NOT relabel or synthesize a newer version merely because the destination accepts it."},"macro_declarations":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},"minItems":1,"description":"One declaration per exact occurrence in a field carried by this asset. A URL-delivered asset can declare only occurrences in its locator `url`; tokens discovered later in a fetched VAST response require document validation evidence or an inline/snapshotted asset and MUST NOT be guessed from the locator. IAB tokens cite a registry namespace and revision rather than copying the live registry into AdCP."},"vpaid_enabled":{"type":"boolean","description":"Whether VPAID (Video Player-Ad Interface Definition) is supported"},"duration_ms":{"type":"integer","description":"Expected media duration in milliseconds (if known)","minimum":0},"tracking_events":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-tracking-event.json"},"description":"Tracking events supported by this VAST tag"},"captions_url":{"type":"string","format":"uri","description":"URL to captions file (WebVTT, SRT, etc.)","x-accessibility":true},"audio_description_url":{"type":"string","format":"uri","description":"URL to audio description track for visually impaired users","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type"],"oneOf":[{"properties":{"delivery_type":{"type":"string","const":"url","description":"Discriminator indicating VAST is delivered via URL endpoint"},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"URL endpoint returning VAST XML. Macro delimiters remain byte-preserved; declarations distinguish occurrences in this locator URL from occurrences in inline or fetched VAST content."},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}}},"required":["delivery_type","url"]},{"properties":{"delivery_type":{"type":"string","const":"inline","description":"Discriminator indicating VAST is delivered as inline XML content"},"content":{"type":"string","description":"Inline VAST XML content"},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"content"}}}}}}},"required":["delivery_type","content"]}],"discriminator":{"propertyName":"delivery_type"},"additionalProperties":true},"external:core/macro-declaration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/macro-declaration.json","title":"Macro Declaration","description":"The source-faithful contract for one occurrence of one macro token. It identifies the current dialect, verified mapping status, exact asset-field occurrence, next processing operation, actor, and encoding. Translation and concrete value resolution are separate operations: a translator emits the declared native token and replaces this declaration with the target declaration. Unknown tokens are always byte-preserved.","x-adcp-validation":{"verifier_constraints":{"adcp_semantic_identity":"when dialect is adcp, dialect_semantic must equal universal_semantic","declaration_id_uniqueness":"declaration_id must be unique within the containing asset","token_occurrence":"location must identify the declared zero-based occurrence of token in location.field","asset_field":"location.field must exist on and be permitted by the containing asset type","catalog_universal_profile":"catalog semantics require seller resolve_value in a URL context with exactly one rfc3986 pass","omit_parameter_scope":"omit_parameter requires the token to occupy the complete URL query-parameter value"},"spec":"docs/creative/universal-macros.mdx#declared-source-token-contracts"},"type":"object","properties":{"declaration_id":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","minLength":1,"x-entity":"macro_declaration","description":"Identifier unique within the enclosing asset, used to correlate validation results."},"token":{"type":"string","minLength":1,"description":"Exact byte-preserved token expression at this occurrence, including delimiters."},"dialect":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-dialect.json"},"dialect_namespace":{"type":"string","format":"uri","description":"Authority-controlled registry or mapping URI. Required for IAB VAST, IAB DAAST, and vendor dialects."},"dialect_revision":{"type":"string","minLength":1,"description":"Immutable registry/mapping revision, release, commit, or digest. Required for IAB VAST, IAB DAAST, and vendor dialects."},"dialect_semantic":{"type":"string","minLength":1,"description":"Exact semantic identifier in the cited dialect, such as `CACHEBUSTING`, `PLAYERSTATE`, or a documented vendor name. This is not inferred from token spelling."},"mapping_status":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-mapping-status.json"},"universal_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json","description":"Verified AdCP universal meaning. Present only when mapping_status is `verified_universal`."},"operation":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-processing-operation.json"},"performed_by":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-resolver.json","description":"Actor authorized to perform the declared translation or value resolution. Omitted for preservation."},"translation_target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-translation-target.json","description":"Required only for `translate_to_native`. The output token contract that replaces this declaration after translation."},"location":{"type":"object","properties":{"field":{"type":"string","enum":["url","markup","content","ad_request_url","clickthrough_url"],"description":"Asset field containing this occurrence."},"occurrence":{"type":"integer","minimum":0,"description":"Zero-based occurrence of this exact token within the named field."},"context":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-value-context.json"}},"required":["field","occurrence","context"],"additionalProperties":false},"encoding":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-encoding.json","description":"Encoding for the concrete value. Translation/preservation uses `none` at depth zero."},"required":{"type":"boolean","description":"Whether terminal delivery must fail if the declared operation cannot complete."},"unavailable_behavior":{"type":"string","enum":["preserve","omit_parameter","dialect_sentinel","reject"],"description":"Action when the responsible actor has no value. Omission is legal only for a complete URL query-value occurrence; dialect sentinels require a cited dialect rule."}},"required":["declaration_id","token","dialect","dialect_semantic","mapping_status","operation","location","encoding","required","unavailable_behavior"],"additionalProperties":false,"allOf":[{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast","vendor"]}},"required":["dialect"]},"then":{"required":["dialect_namespace","dialect_revision"]}},{"if":{"properties":{"dialect":{"enum":["adcp","unknown"]}},"required":["dialect"]},"then":{"not":{"anyOf":[{"required":["dialect_namespace"]},{"required":["dialect_revision"]}]}}},{"if":{"properties":{"mapping_status":{"const":"verified_universal"}},"required":["mapping_status"]},"then":{"required":["universal_semantic"]},"else":{"not":{"required":["universal_semantic"]}}},{"if":{"properties":{"dialect":{"const":"adcp"}},"required":["dialect"]},"then":{"required":["universal_semantic"],"properties":{"dialect_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},"mapping_status":{"const":"verified_universal"}}}},{"if":{"properties":{"dialect":{"const":"unknown"}},"required":["dialect"]},"then":{"properties":{"mapping_status":{"const":"unresolved"},"operation":{"const":"preserve"},"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}},"required":{"const":false},"unavailable_behavior":{"const":"preserve"}},"not":{"anyOf":[{"required":["performed_by"]},{"required":["translation_target"]},{"required":["universal_semantic"]}]}}},{"if":{"properties":{"operation":{"const":"translate_to_native"}},"required":["operation"]},"then":{"required":["performed_by","translation_target"],"properties":{"mapping_status":{"enum":["verified_universal","dialect_defined"]},"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}}}}},{"if":{"properties":{"operation":{"const":"resolve_value"}},"required":["operation"]},"then":{"required":["performed_by"],"properties":{"mapping_status":{"enum":["verified_universal","dialect_defined"]}},"not":{"required":["translation_target"]}}},{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast"]},"operation":{"const":"resolve_value"}},"required":["dialect","operation"]},"then":{"properties":{"performed_by":{"const":"request_executor"}}}},{"if":{"properties":{"operation":{"const":"preserve"}},"required":["operation"]},"then":{"properties":{"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}},"required":{"const":false},"unavailable_behavior":{"const":"preserve"}},"not":{"anyOf":[{"required":["performed_by"]},{"required":["translation_target"]}]}}},{"if":{"properties":{"location":{"properties":{"context":{"const":"opaque"}},"required":["context"]}},"required":["location"]},"then":{"properties":{"operation":{"const":"preserve"},"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}},"required":{"const":false},"unavailable_behavior":{"const":"preserve"}}}},{"if":{"properties":{"universal_semantic":{"enum":["CATALOG_ID","SKU","GTIN","OFFERING_ID","JOB_ID","HOTEL_ID","FLIGHT_ID","VEHICLE_ID","LISTING_ID","STORE_ID","PROGRAM_ID","DESTINATION_ID","ITEM_NAME","ITEM_DESCRIPTION","ITEM_TAGLINE","ITEM_PRICE","ITEM_PRICE_CURRENCY"]}},"required":["universal_semantic"]},"then":{"properties":{"operation":{"const":"resolve_value"},"performed_by":{"const":"seller"},"location":{"properties":{"context":{"enum":["url_query_value","url_path_segment"]}}},"encoding":{"properties":{"kind":{"const":"rfc3986"},"depth":{"const":1}}}}}},{"if":{"properties":{"required":{"const":true}},"required":["required"]},"then":{"properties":{"unavailable_behavior":{"const":"reject"}}}},{"if":{"properties":{"unavailable_behavior":{"const":"omit_parameter"}},"required":["unavailable_behavior"]},"then":{"properties":{"operation":{"const":"resolve_value"},"location":{"properties":{"context":{"const":"url_query_value"}}}}}},{"if":{"properties":{"unavailable_behavior":{"const":"preserve"}},"required":["unavailable_behavior"]},"then":{"properties":{"operation":{"const":"preserve"}}}},{"if":{"properties":{"unavailable_behavior":{"const":"dialect_sentinel"}},"required":["unavailable_behavior"]},"then":{"properties":{"dialect":{"const":"iab_vast"},"operation":{"const":"resolve_value"},"required":{"const":false}}}}]},"external:enums/macro-dialect.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/macro-dialect.json","title":"Macro Dialect Family","description":"Governed family for a creative macro token. `vendor` is qualified by an authority-controlled namespace and immutable revision on the declaration/capability; AdCP does not enumerate companies as dialects. `unknown` is declaration-only and always byte-preserved.","type":"string","enum":["adcp","iab_vast","iab_daast","vendor","unknown"],"enumDescriptions":{"adcp":"AdCP universal macro syntax and semantics.","iab_vast":"IAB VAST macro syntax, qualified by the referenced live-registry revision.","iab_daast":"IAB DAAST macro syntax, qualified by the referenced specification/registry revision.","vendor":"A vendor- or platform-owned macro namespace, qualified by its authoritative URI and immutable revision.","unknown":"The token namespace cannot be established. Preserve the token unchanged and never advertise it as resolvable."}},"external:enums/macro-mapping-status.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/macro-mapping-status.json","title":"Macro Mapping Status","description":"Evidence level connecting a dialect-local macro meaning to the AdCP universal vocabulary.","type":"string","enum":["verified_universal","dialect_defined","unresolved"],"enumDescriptions":{"verified_universal":"The cited dialect mapping verifies an AdCP universal semantic.","dialect_defined":"The dialect defines the token, but no AdCP universal semantic is asserted.","unresolved":"No safe meaning is established; the token remains byte-preserved."}},"external:enums/universal-macro.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/universal-macro.json","title":"Universal Macro","description":"Standardized macro placeholders for dynamic value substitution in creative tracking URLs. Macros are replaced with actual values at impression time. See docs/creative/universal-macros.mdx for detailed documentation.","type":"string","enum":["MEDIA_BUY_ID","PACKAGE_ID","CREATIVE_ID","CACHEBUSTER","TIMESTAMP","CLICK_URL","GDPR","GDPR_CONSENT","US_PRIVACY","GPP_STRING","GPP_SID","IP_ADDRESS","LIMIT_AD_TRACKING","DEVICE_TYPE","OS","OS_VERSION","DEVICE_MAKE","DEVICE_MODEL","USER_AGENT","APP_BUNDLE","APP_NAME","COUNTRY","REGION","CITY","ZIP","DMA","LAT","LONG","DEVICE_ID","DEVICE_ID_TYPE","DOMAIN","PAGE_URL","REFERRER","KEYWORDS","PLACEMENT_ID","FOLD_POSITION","AD_WIDTH","AD_HEIGHT","VIDEO_ID","VIDEO_TITLE","VIDEO_DURATION","VIDEO_CATEGORY","CONTENT_GENRE","CONTENT_RATING","PLAYER_WIDTH","PLAYER_HEIGHT","POD_POSITION","POD_SIZE","AD_BREAK_ID","STATION_ID","COLLECTION_NAME","INSTALLMENT_ID","AUDIO_DURATION","TMPX","IMPRESSION_ID","AXEM","CATALOG_ID","SKU","GTIN","OFFERING_ID","JOB_ID","HOTEL_ID","FLIGHT_ID","VEHICLE_ID","LISTING_ID","STORE_ID","PROGRAM_ID","DESTINATION_ID","CREATIVE_VARIANT_ID","APP_ITEM_ID","ITEM_NAME","ITEM_DESCRIPTION","ITEM_TAGLINE","ITEM_PRICE","ITEM_PRICE_CURRENCY"],"enumDescriptions":{"MEDIA_BUY_ID":"AdCP media buy identifier","PACKAGE_ID":"AdCP package identifier","CREATIVE_ID":"AdCP creative identifier","CACHEBUSTER":"Random number to prevent caching","TIMESTAMP":"Unix timestamp in milliseconds","CLICK_URL":"Publisher's click tracking URL (auto-inserted by sales agent)","GDPR":"GDPR applicability flag (1=applies, 0=doesn't apply)","GDPR_CONSENT":"IAB TCF 2.0 consent string","US_PRIVACY":"US Privacy (CCPA) string","GPP_STRING":"Global Privacy Platform consent string","GPP_SID":"GPP Section ID(s) indicating applicable privacy framework sections","IP_ADDRESS":"User IP address (often masked for privacy, may return empty)","LIMIT_AD_TRACKING":"Limit Ad Tracking enabled (1=limited, 0=allowed)","DEVICE_TYPE":"Device category (mobile, tablet, desktop, ctv, dooh)","OS":"Operating system (iOS, Android, tvOS, Roku, etc.)","OS_VERSION":"OS version number","DEVICE_MAKE":"Device manufacturer","DEVICE_MODEL":"Device model identifier","USER_AGENT":"Full user agent string","APP_BUNDLE":"App bundle ID (domain or numeric)","APP_NAME":"Human-readable app name","COUNTRY":"ISO 3166-1 alpha-2 country code","REGION":"State/province/region code","CITY":"City name","ZIP":"Postal code","DMA":"Nielsen DMA code (US TV markets)","LAT":"Latitude coordinate","LONG":"Longitude coordinate","DEVICE_ID":"Mobile advertising ID (IDFA/AAID)","DEVICE_ID_TYPE":"Type of device ID (idfa, aaid)","DOMAIN":"Domain where ad is shown","PAGE_URL":"Full page URL (encoded)","REFERRER":"HTTP referrer URL","KEYWORDS":"Page keywords (comma-separated)","PLACEMENT_ID":"Global Placement ID (IAB standard)","FOLD_POSITION":"Position relative to fold (above_fold, below_fold)","AD_WIDTH":"Ad slot width in pixels","AD_HEIGHT":"Ad slot height in pixels","VIDEO_ID":"Content video identifier","VIDEO_TITLE":"Content video title","VIDEO_DURATION":"Content duration in seconds","VIDEO_CATEGORY":"IAB content category","CONTENT_GENRE":"Content genre (news, sports, comedy, etc.)","CONTENT_RATING":"Content rating (G, PG, TV-14, etc.)","PLAYER_WIDTH":"Video player width in pixels","PLAYER_HEIGHT":"Video player height in pixels","POD_POSITION":"Position within ad break","POD_SIZE":"Total ads in the ad break","AD_BREAK_ID":"Unique ad break identifier","STATION_ID":"Radio station or podcast identifier","COLLECTION_NAME":"Program or collection name","INSTALLMENT_ID":"Installment identifier (podcast episode, print issue, etc.)","AUDIO_DURATION":"Audio content duration in seconds","TMPX":"TMP exposure token — HPKE-encrypted identity tokens for per-user exposure tracking. Produced by Identity Match, substituted into creative tracking URLs, received by the buyer's impression pixel.","IMPRESSION_ID":"Opaque, collision-resistant identifier for one impression opportunity. Used for impression deduplication, cross-vendor reconciliation, pixel-retry dedup, and TMP cross-identity exposure dedup. Minted by the publisher, ad-decision layer, or buyer at {TMPX} decode; required upstream for TMP context-only impressions where {TMPX} is absent.","AXEM":"AXE contextual metadata (encoded blob). Legacy — in TMP, use Offer creative_data for dynamic creative values and TMPX for exposure tracking.","CATALOG_ID":"Buyer-defined catalog identifier from the catalog's catalog_id field","SKU":"Product SKU identifier for the catalog item being rendered","GTIN":"Global Trade Item Number for the catalog item being rendered","OFFERING_ID":"AdCP offering identifier for the catalog item being rendered","JOB_ID":"Job posting identifier for the catalog item being rendered","HOTEL_ID":"Hotel property identifier for the catalog item being rendered","FLIGHT_ID":"Flight route identifier for the catalog item being rendered","VEHICLE_ID":"Vehicle listing identifier for the catalog item being rendered","LISTING_ID":"Real estate listing identifier for the catalog item being rendered","STORE_ID":"Store location identifier for the catalog item being rendered","PROGRAM_ID":"Education program identifier for the catalog item being rendered","DESTINATION_ID":"Travel destination identifier for the catalog item being rendered","CREATIVE_VARIANT_ID":"Seller-assigned creative variant identifier, passed through at serve time","APP_ITEM_ID":"Mobile app identifier for the catalog item being rendered","ITEM_NAME":"Name/title of the catalog item being rendered (catalog_field: name). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_DESCRIPTION":"Description of the catalog item being rendered (catalog_field: description). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_TAGLINE":"Short promotional tagline of the catalog item being rendered (catalog_field: tagline). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_PRICE":"Price amount of the catalog item being rendered (catalog_field: price.amount). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_PRICE_CURRENCY":"ISO 4217 currency code of the catalog item being rendered (catalog_field: price.currency). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules."}},"external:enums/macro-processing-operation.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/macro-processing-operation.json","title":"Macro Processing Operation","description":"The next authorized operation on the current source token.","type":"string","enum":["translate_to_native","resolve_value","preserve"],"enumDescriptions":{"translate_to_native":"Replace the current token with a declared downstream-native token; no concrete runtime value is inserted at this step.","resolve_value":"Insert the concrete runtime value using the declared encoding contract.","preserve":"Leave the source bytes unchanged because no safe local operation is established."}},"external:enums/macro-resolver.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/macro-resolver.json","title":"Macro Processing Actor","description":"Protocol role authorized to translate the token or bind its concrete value.","type":"string","enum":["buyer","creative_agent","seller","request_executor","source_ad_server"],"enumDescriptions":{"buyer":"The buyer agent acts before submission.","creative_agent":"The creative agent executing build_creative, preview_creative, or validate_input performs the declared build-time operation.","seller":"The AdCP seller or its execution adapter acts during trafficking or serving.","request_executor":"The component executing the governed request acts, whether a client player, publisher player, SSAI service, or another request executor.","source_ad_server":"The originating creative/ad server acts on its own native token."}},"external:core/macro-translation-target.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/macro-translation-target.json","title":"Macro Translation Target","description":"The exact downstream-native token produced by a `translate_to_native` operation. The output asset replaces the source declaration with a declaration for this token and its next operation.","type":"object","properties":{"token":{"type":"string","minLength":1},"dialect":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-dialect.json"},"dialect_namespace":{"type":"string","format":"uri"},"dialect_revision":{"type":"string","minLength":1},"dialect_semantic":{"type":"string","minLength":1},"mapping_status":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-mapping-status.json"},"universal_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},"next_operation":{"type":"string","const":"resolve_value"},"performed_by":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-resolver.json"},"encoding":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-encoding.json"}},"required":["token","dialect","dialect_semantic","mapping_status","next_operation","performed_by","encoding"],"additionalProperties":false,"allOf":[{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast","vendor"]}},"required":["dialect"]},"then":{"required":["dialect_namespace","dialect_revision"]}},{"if":{"properties":{"dialect":{"enum":["adcp","unknown"]}},"required":["dialect"]},"then":{"not":{"anyOf":[{"required":["dialect_namespace"]},{"required":["dialect_revision"]}]}}},{"if":{"properties":{"dialect":{"const":"unknown"}},"required":["dialect"]},"then":false},{"if":{"properties":{"mapping_status":{"const":"verified_universal"}},"required":["mapping_status"]},"then":{"required":["universal_semantic"]},"else":{"not":{"required":["universal_semantic"]}}},{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast"]}},"required":["dialect"]},"then":{"properties":{"performed_by":{"const":"request_executor"}}}},{"if":{"properties":{"dialect":{"const":"adcp"}},"required":["dialect"]},"then":{"required":["universal_semantic"],"properties":{"dialect_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},"mapping_status":{"const":"verified_universal"}}}},{"if":{"properties":{"universal_semantic":{"enum":["CATALOG_ID","SKU","GTIN","OFFERING_ID","JOB_ID","HOTEL_ID","FLIGHT_ID","VEHICLE_ID","LISTING_ID","STORE_ID","PROGRAM_ID","DESTINATION_ID","ITEM_NAME","ITEM_DESCRIPTION","ITEM_TAGLINE","ITEM_PRICE","ITEM_PRICE_CURRENCY"]}},"required":["universal_semantic"]},"then":{"properties":{"performed_by":{"const":"seller"},"encoding":{"properties":{"kind":{"const":"rfc3986"},"depth":{"const":1}}}}}}]},"external:core/macro-encoding.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/macro-encoding.json","title":"Macro Encoding","description":"Exact encoding profile applied to a concrete substitution value. `rfc3986` encodes UTF-8 bytes outside the RFC 3986 unreserved set once per depth. `iab_vast_uri` follows the cited IAB VAST macro registry, including its array serialization rules, and is exactly one pass.","type":"object","properties":{"kind":{"type":"string","enum":["none","rfc3986","iab_vast_uri"]},"depth":{"type":"integer","minimum":0}},"required":["kind","depth"],"additionalProperties":false,"allOf":[{"if":{"properties":{"kind":{"const":"none"}},"required":["kind"]},"then":{"properties":{"depth":{"const":0}}}},{"if":{"properties":{"kind":{"const":"rfc3986"}},"required":["kind"]},"then":{"properties":{"depth":{"minimum":1}}}},{"if":{"properties":{"kind":{"const":"iab_vast_uri"}},"required":["kind"]},"then":{"properties":{"depth":{"const":1}}}}]},"external:enums/macro-value-context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/macro-value-context.json","title":"Macro Value Context","description":"Syntactic occurrence context supported by the first macro contract. Substitution inside arbitrary JavaScript, JSON, or HTML text is intentionally not inferred; use `opaque` and preserve it unless a later governed context is added.","type":"string","enum":["url_query_value","url_path_segment","opaque"]},"external:enums/vast-tracking-event.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/vast-tracking-event.json","title":"VAST Tracking Event","description":"Tracking events for VAST video and audio ads. Includes the IAB VAST 4.2 `Tracking@event` enumeration (vast_4.2.xsd `TrackingEvents_type`, lines 112–136), plus AdCP-flattened representations of the `Impression`, `Error`, `VideoClicks`, and `ViewableImpression` elements (which live in dedicated VAST elements, not under `<TrackingEvents>` — they are surfaced here so a single declared list can cover everything a measurement vendor wants to track). Audio players execute only events applicable to and present in the audio VAST document; visual viewability, fullscreen, expand, collapse, and interactive events are not implied by `audio_vast`. `fullscreen` / `exitFullscreen` are retained for VAST 2.x / 3.x video compatibility (VAST 4.0+ replaced them with `playerExpand` / `playerCollapse`). `measurableImpression` is an AdCP extension for MRC measurability signals.","type":"string","enum":["impression","creativeView","loaded","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","playerExpand","playerCollapse","fullscreen","exitFullscreen","progress","acceptInvitation","adExpand","adCollapse","minimize","overlayViewDuration","otherAdInteraction","interactiveStart","clickTracking","customClick","close","closeLinear","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]},"external:core/macro-bearing-url.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/macro-bearing-url.json","title":"Macro-bearing URL","description":"Backward-compatible URL value that preserves the existing `uri-template` branch (including deep links, protocol-relative references, and RFC 6570 host variables) while additionally accepting absolute HTTP(S) URLs with byte-preserved macro delimiters not legal in a strict URI, including `%%...%%`, `[...]`, and `${...}`. Macro-bearing HTTP(S) URLs require a valid lexical authority and valid percent triplets; an AdCP verifier replaces each recognized token with an unreserved sentinel and validates the resulting absolute URI. Token semantics are established only by `macro_declarations`.","x-adcp-validation":{"verifier_constraints":{"macro_aware_uri":"mask recognized token lexical forms with an RFC3986 unreserved sentinel, whether declared or on the undeclared 3.x compatibility path, then require a valid absolute HTTP or HTTPS URI; masking assigns no semantics"},"spec":"docs/creative/universal-macros.mdx#template-syntax"},"type":"string","anyOf":[{"format":"uri-template"},{"format":"uri","pattern":"^https?://(?:[A-Za-z0-9._~!$&'()*+,;=:%-]+@)?(?:[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?|\\[[0-9A-Fa-f:.]+\\])(?::[0-9]{1,5})?(?:[/?#]|$)"},{"pattern":"^https?://(?:[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?|\\[[0-9A-Fa-f:.]+\\])(?::[0-9]{1,5})?(?:[/?#](?:[^%\\s\\u0000-\\u001F\\u007F\"<>`\\\\]|%[0-9A-Fa-f]{2}|%%[A-Za-z0-9_.:-]+%%)*)?$"}]},"external:core/assets/display-tag-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/display-tag-asset.json","title":"Display Tag Asset","description":"One atomic third-party display delivery representation. `delivery_type` distinguishes a single ad-request URL, byte-preserved inline markup, and a paired redirect whose ad-request and click-through URLs MUST travel together. This is not an HTML5 bundle: seller-hosted HTML5 zip files use `asset_type: \"zip\"` under `format_kind: \"html5\"`.","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag","description":"Discriminator identifying an atomic third-party display-tag representation."},"macro_declarations":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},"minItems":1,"description":"Exact macro tokens present anywhere in this representation. Tokens remain byte-preserved until the resolver named by each declaration substitutes them."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overriding manifest-level provenance."}},"required":["asset_type"],"discriminator":{"propertyName":"delivery_type"},"oneOf":[{"title":"Tag URL","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag"},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json"},"delivery_type":{"type":"string","const":"tag_url"},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Ad-request URL invoked at impression time. It is equivalent to the backward-compatible `url` asset with `url_type: \"ad_request\"`."}},"required":["asset_type","delivery_type","url"],"not":{"anyOf":[{"required":["markup"]},{"required":["ad_request_url"]},{"required":["clickthrough_url"]}]}},{"title":"Inline markup","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag"},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"markup"}}}}}]},"minItems":1},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json"},"delivery_type":{"type":"string","const":"inline_markup"},"markup_type":{"type":"string","enum":["iframe_javascript","javascript","standard"],"description":"How the destination traffics the byte-preserved markup."},"markup":{"type":"string","minLength":1,"maxLength":1048576,"description":"Exact third-party tag markup. Receivers MUST preserve its bytes and MUST NOT reinterpret it as a seller-hosted HTML5 bundle."}},"required":["asset_type","delivery_type","markup_type","markup"],"not":{"anyOf":[{"required":["url"]},{"required":["ad_request_url"]},{"required":["clickthrough_url"]}]}},{"title":"Paired redirect","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag"},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"enum":["ad_request_url","clickthrough_url"]}}}}}]},"minItems":1},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json"},"delivery_type":{"type":"string","const":"paired_redirect"},"ad_request_url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Image or ad-request URL entered into the destination ad server. This field deliberately accepts byte-preserved vendor tokens that are not RFC 6570 URI templates."},"clickthrough_url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Click-through URL paired with `ad_request_url`. This field deliberately accepts byte-preserved vendor tokens that are not RFC 6570 URI templates. The pair MUST NOT be split, mixed, or revised independently."}},"required":["asset_type","delivery_type","ad_request_url","clickthrough_url"],"not":{"anyOf":[{"required":["url"]},{"required":["markup"]}]}}],"additionalProperties":true},"external:core/assets/text-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/text-asset.json","title":"Text Asset","description":"Text content asset","type":"object","properties":{"asset_type":{"type":"string","const":"text","description":"Discriminator identifying this as a text asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"Text content"},"language":{"type":"string","description":"Optional language claim for this text. In a materialized creative localization variant, localized-creative-asset.json requires this value to use /schemas/core/locale-tag.json and conformance requires exact equality with the enclosing variant locale. General non-localized assets retain the legacy unconstrained string for compatibility."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:core/assets/url-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/url-asset.json","title":"URL Asset","$comment":"Fallback table is also rendered in docs/creative/asset-types.mdx (URL Asset section). Keep the two in sync — schema description is the normative source for conformance tools; mdx is the human-readable copy.","description":"URL reference asset. `url_type` declares the mechanism a receiver uses to invoke the URL (`clickthrough`, display `ad_request`, `tracker_pixel`, or `tracker_script`) and is distinct from the URL's purpose, which the format declares in `url-asset-requirements.role`. Senders SHOULD include `url_type` on every URL asset. When `url_type` is absent, receivers SHOULD fall back to the format's role: clickthrough/landing_page → `clickthrough`; impression_tracker/click_tracker → `tracker_pixel`; viewability_tracker → `tracker_script`; third_party_tracker and display ad requests have no safe fallback. When neither `url_type` nor a format-side role is available, receivers MUST NOT silently pick a mechanism. VAST/DAAST tag URLs are not URL assets — use `asset_type: \"vast\"` or `asset_type: \"daast\"`.","type":"object","properties":{"asset_type":{"type":"string","const":"url","description":"Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"URL reference carrying plain, AdCP, IAB, or declared vendor macro syntax. Buyers preserve token delimiters; the authoritative declaration determines the processing operation and encoding."},"url_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1url-asset-type.json","description":"Mechanism a receiver uses to invoke this URL: `clickthrough` for a user destination, `ad_request` for a third-party display creative request, `tracker_pixel` for an event HTTP request, or `tracker_script` for a script include. SHOULD be present on every URL asset."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"One declaration per token occurrence in `url`; declaration_id values MUST be unique and every location MUST identify an existing occurrence. Absence retains legacy opaque transport behavior."},"description":{"type":"string","description":"Description of what this URL points to"},"state_id":{"type":"string","description":"Binding used only when this URL populates a `seller_rendered_stateful_display` `state_click_urls` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it); at most one entry per state. Omit for ordinary URL slots."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url"],"additionalProperties":true},"external:enums/url-asset-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/url-asset-type.json","title":"URL Asset Type","description":"Invocation mechanisms for URL assets. `ad_request` invokes a third-party display ad endpoint at impression time; it is not a tracker or click destination.","type":"string","enum":["clickthrough","ad_request","tracker_pixel","tracker_script"]},"external:core/assets/html-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/html-asset.json","title":"HTML Asset","description":"Inline HTML content asset. For seller-hosted HTML5 banner bundles, use the zip asset type. For third-party display markup or paired redirects, use the display_tag asset so the trafficking representation remains explicit.","type":"object","properties":{"asset_type":{"type":"string","const":"html","description":"Discriminator identifying this as an HTML asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"HTML content"},"version":{"type":"string","description":"HTML version (e.g., 'HTML5')"},"accessibility":{"type":"object","description":"Self-declared accessibility properties for this opaque creative","x-accessibility":true,"properties":{"alt_text":{"type":"string","description":"Text alternative describing the creative content"},"keyboard_navigable":{"type":"boolean","description":"Whether the creative can be fully operated via keyboard"},"motion_control":{"type":"boolean","description":"Whether the creative respects prefers-reduced-motion or provides pause/stop controls"},"screen_reader_tested":{"type":"boolean","description":"Whether the creative has been tested with screen readers"}}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:core/assets/javascript-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/javascript-asset.json","title":"JavaScript Asset","description":"Inline JavaScript content asset. For third-party display ad markup, use the display_tag asset with delivery_type `inline_markup`; for measurement scripts use a typed tracker; for seller-hosted HTML5 bundles use zip.","type":"object","properties":{"asset_type":{"type":"string","const":"javascript","description":"Discriminator identifying this as a JavaScript asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"JavaScript content"},"module_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1javascript-module-type.json","description":"JavaScript module type"},"accessibility":{"type":"object","description":"Self-declared accessibility properties for this opaque creative","x-accessibility":true,"properties":{"alt_text":{"type":"string","description":"Text alternative describing the creative content"},"keyboard_navigable":{"type":"boolean","description":"Whether the creative can be fully operated via keyboard"},"motion_control":{"type":"boolean","description":"Whether the creative respects prefers-reduced-motion or provides pause/stop controls"},"screen_reader_tested":{"type":"boolean","description":"Whether the creative has been tested with screen readers"}}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:enums/javascript-module-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/javascript-module-type.json","title":"JavaScript Module Type","description":"JavaScript module format types for creative assets","type":"string","enum":["esm","commonjs","script"]},"external:core/assets/zip-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/zip-asset.json","title":"Zip Asset","description":"Bundled creative asset delivered as a zip archive — typically an HTML5 banner with index.html plus supporting CSS, JS, images, and fonts. Receivers unpack the zip, validate internal structure, and serve contents from CDN. Distinct from inline HTML (html asset) and from third-party tag URLs (url asset with url_type tracker_script).","type":"object","properties":{"asset_type":{"type":"string","const":"zip","description":"Discriminator identifying this as a zip-bundled asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL where the zip archive is hosted. Must be HTTPS."},"max_file_size_kb":{"type":"integer","minimum":0,"description":"Maximum file size in kilobytes. Receivers should reject zips exceeding this."},"entry_point":{"type":"string","description":"Relative path to the entry file within the zip (typically 'index.html'). Receivers default to 'index.html' if absent."},"allowed_inner_extensions":{"type":"array","items":{"type":"string"},"description":"File extensions permitted inside the zip (e.g., ['html', 'css', 'js', 'png', 'jpg', 'svg', 'webp', 'json', 'woff2']). Receivers may reject zips containing other extensions."},"backup_image_url":{"type":"string","format":"uri","description":"Fallback image URL for environments that cannot render the bundled creative (e.g., non-HTML5 endpoints, ad blockers). Recommended for HTML5 banners."},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Optional SHA-256 content digest of the zip archive (sha256:<hex>) for integrity verification. Lets receivers detect tampered or stale archives."},"accessibility":{"type":"object","description":"Self-declared accessibility properties for this opaque creative","x-accessibility":true,"properties":{"alt_text":{"type":"string","description":"Text alternative describing the creative content"},"keyboard_navigable":{"type":"boolean","description":"Whether the creative can be fully operated via keyboard"},"motion_control":{"type":"boolean","description":"Whether the creative respects prefers-reduced-motion or provides pause/stop controls"},"screen_reader_tested":{"type":"boolean","description":"Whether the creative has been tested with screen readers"}}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url"],"additionalProperties":true,"examples":[{"description":"HTML5 banner bundle with backup image","data":{"asset_type":"zip","url":"https://cdn.acme.example/creatives/spring-300x250-html5.zip","max_file_size_kb":200,"entry_point":"index.html","allowed_inner_extensions":["html","css","js","png","jpg","svg","json"],"backup_image_url":"https://cdn.acme.example/creatives/spring-300x250-backup.jpg","digest":"sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}}]},"external:core/assets/webhook-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/webhook-asset.json","title":"Webhook Asset","description":"Webhook for server-side dynamic content rendering (DCO)","type":"object","properties":{"asset_type":{"type":"string","const":"webhook","description":"Discriminator identifying this as a webhook asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"Webhook URL to call for dynamic content"},"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1http-method.json","default":"POST","description":"HTTP method"},"timeout_ms":{"type":"integer","minimum":10,"maximum":5000,"default":500,"description":"Maximum time to wait for response in milliseconds"},"supported_macros":{"type":"array","items":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},{"type":"string","description":"Custom or publisher-specific macro name"}]},"description":"Universal macros that can be passed to webhook (e.g., DEVICE_TYPE, COUNTRY). See docs/creative/universal-macros.mdx for full list."},"required_macros":{"type":"array","items":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},{"type":"string","description":"Custom or publisher-specific macro name"}]},"description":"Universal macros that must be provided for webhook to function"},"response_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1webhook-response-type.json","description":"Expected content type of webhook response"},"security":{"type":"object","description":"Security configuration for webhook calls","properties":{"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1webhook-security-method.json","description":"Authentication method"},"hmac_header":{"type":"string","description":"Header name for HMAC signature (e.g., 'X-Signature')"},"api_key_header":{"type":"string","description":"Header name for API key (e.g., 'X-API-Key')"}},"required":["method"]},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","response_type","security"],"additionalProperties":true},"external:enums/http-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/http-method.json","title":"HTTP Method","description":"HTTP methods supported for webhook requests","type":"string","enum":["GET","POST"]},"external:enums/webhook-response-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/webhook-response-type.json","title":"Webhook Response Type","description":"Expected response content type from webhook endpoints","type":"string","enum":["html","json","xml","javascript"]},"external:enums/webhook-security-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/webhook-security-method.json","title":"Webhook Security Method","description":"Security methods for authenticating webhook requests","type":"string","enum":["hmac_sha256","api_key","none"]},"external:core/assets/css-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/css-asset.json","title":"CSS Asset","description":"CSS stylesheet asset","type":"object","properties":{"asset_type":{"type":"string","const":"css","description":"Discriminator identifying this as a CSS asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"CSS content"},"media":{"type":"string","description":"CSS media query context (e.g., 'screen', 'print')"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:core/assets/daast-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/daast-asset.json","title":"DAAST Asset","description":"DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving","type":"object","properties":{"asset_type":{"type":"string","const":"daast","description":"Discriminator identifying this as a DAAST asset. See /schemas/creative/asset-types for the registry."},"daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-version.json","description":"DAAST specification version"},"duration_ms":{"type":"integer","description":"Expected audio duration in milliseconds (if known)","minimum":0},"tracking_events":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-tracking-event.json"},"description":"Tracking events supported by this DAAST tag"},"companion_ads":{"type":"boolean","description":"Whether companion display ads are included"},"transcript_url":{"type":"string","format":"uri","description":"URL to text transcript of the audio content","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"},"macro_declarations":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},"minItems":1,"description":"One declaration per occurrence in a field carried by this asset. URL-delivered assets declare only locator-URL occurrences; receivers do not infer declarations for tokens discovered later in a fetched document."}},"required":["asset_type"],"oneOf":[{"properties":{"delivery_type":{"type":"string","const":"url","description":"Discriminator indicating DAAST is delivered via URL endpoint"},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"URL endpoint returning DAAST XML. Macro delimiters remain byte-preserved and are processed only under attached occurrence declarations."},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}}},"required":["delivery_type","url"]},{"properties":{"delivery_type":{"type":"string","const":"inline","description":"Discriminator indicating DAAST is delivered as inline XML content"},"content":{"type":"string","description":"Inline DAAST XML content"},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"content"}}}}}}},"required":["delivery_type","content"]}],"discriminator":{"propertyName":"delivery_type"},"additionalProperties":true},"external:enums/daast-tracking-event.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/daast-tracking-event.json","title":"DAAST Tracking Event","description":"Tracking events for audio ads. Aligned to the IAB DAAST 1.1 `Tracking@event` enumeration from §3.2.1.7 of the spec (creativeView, start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, rewind, resume, skip, progress) — plus `close` (referenced descriptively in DAAST 1.1 §3.2.4.2 contrasting it with `skip`), and AdCP-flattened representations of the `Impression`, `Error`, and click elements (`<Impression>`, `<Error>`, and the click children of `<AdInteractions>`) so a single declared list can cover everything a measurement vendor wants to track. `viewable` / `notViewable` / `viewUndetermined` and `measurableImpression` / `viewableImpression` are AdCP extensions for OM-SDK Audio measurability signals (DAAST 1.1 itself does not define a `<ViewableImpression>` element). DAAST 1.1 audio-incompatible video events are deliberately omitted: no `loaded`, `playerExpand` / `playerCollapse`, `fullscreen` / `exitFullscreen`, `acceptInvitation`, `adExpand` / `adCollapse`, `minimize`, `overlayViewDuration`, or `interactiveStart`.","type":"string","enum":["impression","creativeView","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","progress","clickTracking","customClick","close","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]},"external:core/assets/markdown-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/markdown-asset.json","title":"Markdown Asset","description":"Markdown-formatted text content following CommonMark specification","type":"object","properties":{"asset_type":{"type":"string","const":"markdown","description":"Discriminator identifying this as a markdown asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"Markdown content following CommonMark spec with optional GitHub Flavored Markdown extensions"},"language":{"type":"string","description":"Optional language claim for this markdown. In a materialized creative localization variant, localized-creative-asset.json requires this value to use /schemas/core/locale-tag.json and conformance requires exact equality with the enclosing variant locale. General non-localized assets retain the legacy unconstrained string for compatibility."},"markdown_flavor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1markdown-flavor.json","default":"commonmark","description":"Markdown flavor used. CommonMark for strict compatibility, GFM for tables/task lists/strikethrough."},"allow_raw_html":{"type":"boolean","default":false,"description":"Whether raw HTML blocks are allowed in the markdown. False recommended for security."}},"required":["asset_type","content"],"additionalProperties":true},"external:enums/markdown-flavor.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/markdown-flavor.json","title":"Markdown Flavor","description":"Markdown specification flavors supported for text assets","type":"string","enum":["commonmark","gfm"]},"external:core/assets/brief-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/brief-asset.json","title":"Brief Asset","description":"Campaign-level creative context as an asset. Carries the creative brief through the manifest so it travels with the creative through regeneration, resizing, and auditing.","type":"object","properties":{"asset_type":{"type":"string","const":"brief","description":"Discriminator identifying this as a brief asset. See /schemas/creative/asset-types for the registry."}},"required":["asset_type"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-brief.json"}]},"external:core/creative-brief.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-brief.json","title":"Creative Brief","description":"Campaign-level creative context for AI-powered creative generation. Provides the layer between brand identity (stable across campaigns) and individual creative execution (per-request). A brand has one identity (defined in brand.json) but different creative briefs for each campaign or flight.","type":"object","properties":{"name":{"type":"string","description":"Campaign or flight name for identification"},"objective":{"type":"string","enum":["awareness","consideration","conversion","retention","engagement"],"description":"Campaign objective that guides creative tone and call-to-action strategy"},"tone":{"type":"string","description":"Desired tone for this campaign, modulating the brand's base tone (e.g., 'playful and festive', 'premium and aspirational')"},"audience":{"type":"string","description":"Target audience description for this campaign"},"territory":{"type":"string","description":"Creative territory or positioning the campaign should occupy"},"messaging":{"type":"object","description":"Messaging framework for the campaign","properties":{"headline":{"type":"string","description":"Primary headline"},"tagline":{"type":"string","description":"Supporting tagline or sub-headline"},"cta":{"type":"string","description":"Call-to-action text"},"key_messages":{"type":"array","description":"Key messages to communicate in priority order","items":{"type":"string"}}},"additionalProperties":true},"reference_assets":{"type":"array","description":"Visual and strategic reference materials such as mood boards, product shots, example creatives, and strategy documents","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1reference-asset.json"}},"compliance":{"type":"object","description":"Regulatory and legal compliance requirements for this campaign. Campaign-specific, regional, and product-based — distinct from brand-level disclaimers in brand.json.","properties":{"required_disclosures":{"type":"array","description":"Disclosures that must appear in creatives for this campaign. Each disclosure specifies the text, where it should appear, and which jurisdictions require it.","items":{"type":"object","properties":{"text":{"type":"string","description":"The disclosure text that must appear in the creative"},"position":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-position.json","description":"Where the disclosure should appear within the creative. prominent: clearly visible in the main creative area; footer: at the bottom of visual creatives; audio: spoken in audio/video creatives; subtitle: displayed in the subtitle or closed-caption track; overlay: superimposed on video content; end_card: displayed on video end card; pre_roll: spoken or displayed before main content; companion: in companion ad unit alongside primary creative"},"jurisdictions":{"type":"array","description":"Jurisdictions where this disclosure is required. ISO 3166-1 alpha-2 country codes or ISO 3166-2 subdivision codes (e.g., 'US', 'GB', 'US-NJ', 'CA-QC'). If omitted, the disclosure applies to all jurisdictions in the campaign.","items":{"type":"string","pattern":"^[A-Z]{2}(-[A-Z0-9]{1,3})?$"},"minItems":1},"regulation":{"type":"string","description":"The regulation or legal authority requiring this disclosure (e.g., 'SEC Rule 156', 'FCA COBS 4.5', 'FDA 21 CFR 202')"},"min_duration_ms":{"type":"integer","minimum":1,"description":"Minimum display duration in milliseconds. For video/audio disclosures, how long the disclosure must be visible or audible. For static formats, how long the disclosure must remain on screen before any auto-advance."},"language":{"type":"string","description":"Language of the disclosure text as a BCP 47 language tag (e.g., 'en', 'fr-CA', 'es'). When omitted, the disclosure is assumed to match the creative's language."},"persistence":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-persistence.json","description":"How long the disclosure must persist during content playback or display. When omitted, the creative agent should use the most restrictive persistence mode supported by the target format."}},"required":["text"],"additionalProperties":true},"minItems":1},"prohibited_claims":{"type":"array","description":"Claims that must not appear in creatives for this campaign. Creative agents should ensure generated content avoids these claims.","items":{"type":"string"},"minItems":1}},"additionalProperties":true}},"required":["name"],"additionalProperties":true},"external:core/reference-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/reference-asset.json","title":"Reference Asset","description":"A reference asset that provides creative context. Carries visual materials (mood boards, product shots, example creatives) with semantic roles that tell creative agents how to use them.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"URL to the reference asset (image, video, or document)"},"role":{"type":"string","enum":["style_reference","product_shot","mood_board","example_creative","logo","strategy_doc","storyboard"],"description":"How the creative agent should use this asset. style_reference: match the visual style; product_shot: include this product; mood_board: overall look and feel; example_creative: example of a similar execution; logo: logo to use; strategy_doc: strategy or planning document for context; storyboard: sequential visual direction for video or multi-scene creative"},"description":{"type":"string","description":"Human-readable description of the asset and how it should inform creative generation"}},"required":["url","role"],"additionalProperties":true},"external:core/assets/catalog-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/catalog-asset.json","title":"Catalog Asset","description":"A typed data feed as a creative asset. Carries catalog context (products, stores, jobs, etc.) within the manifest's assets map.","type":"object","properties":{"asset_type":{"type":"string","const":"catalog","description":"Discriminator identifying this as a catalog asset. See /schemas/creative/asset-types for the registry."}},"required":["asset_type"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1catalog.json"}]},"external:core/assets/published-post-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/published-post-asset.json","title":"Published Post Asset","description":"Reference to an already-published post on a publisher, creator, or social platform. The buyer supplies a reference to the existing post; the seller resolves, authorizes, reviews, and serves the referenced post according to the target product's format declaration. This asset is for post references, not uploaded bytes and not catalog rows.","type":"object","properties":{"asset_type":{"type":"string","const":"published_post","description":"Discriminator identifying this as a published-post reference asset. See /schemas/creative/asset-types for the registry."},"post_url":{"type":"string","format":"uri","description":"Canonical URL for the published post. Preferred when the platform exposes a stable public or authenticated URL."},"platform":{"type":"string","description":"Optional platform or publisher namespace for the referenced post. Informational unless the seller's product declaration or platform extension narrows the accepted values."},"platform_post_id":{"type":"string","description":"Optional platform-native post identifier when a URL alone is not stable or not available. Buyers SHOULD include `platform` when using `platform_post_id` without `post_url`, unless the product or format declaration already narrows the platform. Platform-specific identifier semantics belong in platform_extensions; this field is only an opaque reference."},"identity_ref":{"type":"object","description":"Optional identity hint for the authoring handle/page/channel that owns the post. Sellers MUST verify authorization from platform state; buyers MUST NOT use this object as proof of authorization.","properties":{"handle":{"type":"string","description":"Human-readable handle or username when available."},"profile_url":{"type":"string","format":"uri","description":"URL for the authoring profile, page, or channel."},"platform_identity_id":{"type":"string","description":"Opaque platform-native identity identifier."}},"additionalProperties":true},"published_at":{"type":"string","format":"date-time","description":"When the referenced post was originally published, if known."},"reference_authorization":{"type":"object","readOnly":true,"description":"Server-emitted, seller-observed authorization state for the referenced post or identity. Sellers MAY return this object on read surfaces. On write requests, sellers MUST ignore buyer-supplied `reference_authorization.status` and other authorization-state claims unless a platform extension explicitly defines a signed proof shape and the seller verifies that proof.","properties":{"status":{"type":"string","enum":["authorized","pending","expired","revoked","not_required","unknown"],"description":"Current seller-observed authorization state. `authorized`: seller can serve the referenced post. `pending`: additional creator/account action is required. `expired` or `revoked`: authorization previously existed but no longer permits serving. `not_required`: the seller can legally and technically serve without a separate identity authorization. `unknown`: seller has not checked or cannot disclose the state."},"checked_at":{"type":"string","format":"date-time","description":"When the seller last checked the authorization state."},"expires_at":{"type":"string","format":"date-time","description":"When the authorization expires, if the platform exposes an expiry."},"authorization_url":{"type":"string","format":"uri","description":"Optional URL the buyer or creator can use to complete authorization."},"authorization_instructions":{"type":"string","description":"Human-readable instructions for completing or restoring authorization."}},"required":["status"],"additionalProperties":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this reference asset, overrides manifest-level provenance."}},"required":["asset_type"],"anyOf":[{"required":["post_url"]},{"required":["platform_post_id"]}],"additionalProperties":true},"external:core/assets/card-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/card-asset.json","title":"Card Asset","description":"A single card in a multi-card creative (image_carousel, future composed carousels). Carries: `media` (an image OR video asset), optional `headline` (short text), optional `description` (longer text), optional `cta` (call-to-action label), optional `landing_page_url` (url asset with `url_type: \"clickthrough\"`).\n\nCovers the multi-card patterns across Meta carousel, Pinterest sponsored pin, Snap Collection, TikTok carousel, and AI-surface result cards. The two-field text shape (`headline` + `description`) reflects how almost every adopter splits short labels from longer copy; Pinterest pin description and Meta per-card description both go in `description`.\n\nUsed as the array element type for the `cards` slot on image_carousel canonicals. Adopters MUST NOT invent per-card key conventions like `card_0_headline` / `cards.0.headline` — the manifest's `assets.cards` value is an array of card-asset objects, period. Per-card platform extensions (e.g., Meta-specific carousel attributes, Pinterest rich-pin metadata, Snap Collection price tags) attach via the `platform_extensions` field, never via inline non-canonical keys.","type":"object","required":["asset_type","media"],"properties":{"asset_type":{"type":"string","const":"card","description":"Discriminator identifying this as a card asset. See /schemas/creative/asset-types for the registry."},"media":{"description":"The card's primary visual asset. Either an `image` or `video` asset, matching the parent format's `allowed_card_media_asset_types` parameter.","oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1video-asset.json"}],"discriminator":{"propertyName":"asset_type"}},"headline":{"type":"string","description":"Optional per-card short text label (typically 25-40 chars). Length governed by `card_headline_max_chars` on the format declaration. Meta carousel headline, Pinterest pin title, Snap Collection sticker text, TikTok caption-short."},"description":{"type":"string","description":"Optional per-card longer text (typically 100-500 chars). Distinct from `headline`: `description` is body copy, `headline` is the label. Length governed by `card_description_max_chars` on the format declaration. Meta carousel description, Pinterest pin description, AI-surface result body text, TikTok long caption."},"cta":{"type":"string","description":"Optional per-card call-to-action label (e.g., 'SHOP_NOW', 'LEARN_MORE'). When the parent format declares `cta_values` (allowed CTA labels), the per-card `cta` MUST be one of those values. Lets a Meta or TikTok carousel show different CTAs per card."},"landing_page_url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1url-asset.json","description":"Optional per-card click-through URL. URL asset with `url_type: \"clickthrough\"`."},"platform_extensions":{"type":"array","description":"Per-card platform-specific extensions (URI+digest references). Same hosting model as format-level platform_extensions. Use this for Meta carousel-card attributes, Pinterest pin overrides, etc. — NEVER inline non-canonical keys on the card object directly.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1platform-extension-ref.json"}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this card, overrides manifest-level provenance."}},"additionalProperties":true},"external:core/platform-extension-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/platform-extension-ref.json","title":"Platform Extension Reference","description":"Reference to a platform extension definition. The agent that owns the URI is authoritative for the extension's schema. Buyers fetch the definition once per content digest and cache it. Platform extensions are typically bundled in `get_products` responses under an `extensions` map keyed by `uri@digest`, eliminating the need for a separate fetch.\n\n**Within a single response**, multiple references to the same `uri` MUST carry the same `digest` — divergent digests in one response indicate producer-side error (e.g., concurrent extension revision mid-render). Buyers encountering divergent digests for the same URI MUST fail closed: treat all references to that URI as unresolved and surface a validation error rather than picking one branch silently. **Across responses**, digest divergence is normal — extension authors revise their schemas, the new digest differs, the cache key changes, and the buyer refetches. Cache by `uri@digest`, not by `uri` alone.","type":"object","required":["uri","digest"],"properties":{"uri":{"type":"string","format":"uri","pattern":"^https://","description":"HTTPS URL identifying the extension. `https://` is mandatory — `http://`, `file://`, `data:`, and other schemes are rejected at the schema layer (defense-in-depth on top of the fetch-contract normative rules). The URI base is the owning agent's URL; the path identifies the extension within that agent. Example: 'https://creative.adcontextprotocol.org/translated/meta/extensions/meta_pixel'. The full fetch contract — SSRF allowlist, response-size cap, $ref sandbox, schema-compile bounds — is documented on `product-format-declaration.json#format_schema` and applies to ALL fetches of this reference shape regardless of whether the field is named `format_schema` (load-bearing for validation) or `platform_extensions` (informational); the *transport* rules are identical, only the *consumption* semantics differ."},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"SHA-256 content digest of the extension definition (sha256:<hex>). Used to detect drift — if the agent revises the extension, the digest changes and cached definitions become invalid."}},"additionalProperties":true,"examples":[{"uri":"https://creative.adcontextprotocol.org/translated/meta/extensions/meta_pixel","digest":"sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"}]},"external:core/assets/pixel-tracker-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/pixel-tracker-asset.json","title":"Pixel Tracker Asset","description":"A single renderer-fired HTTP tracker URL — image pixel or JavaScript include — bound to a measurement event (impression, viewability, click, custom). Generic web-pixel tracker primitive applicable to any web-rendered canonical format (image, html5, image_carousel, responsive_creative, sponsored_placement, native_*, plus the non-VAST/DAAST events of video_hosted and audio_hosted). The buyer's measurement vendor declares the tracker URL; the seller's renderer fires it at serve time without buyer-side involvement.\n\nThe discriminated-union shape and event/method enums are formalized in IAB OpenRTB Native 1.2 (`imptrackers[]` / `jstracker` / `eventtrackers[]` / `link.clicktrackers[]`); the same shape applies cleanly to image banners, html5, carousels, and any other format whose renderer fires HTTP pixels for measurement. The name `pixel_tracker` mirrors the industry's existing 'tracker pixel' terminology (already used in `url_type: \"tracker_pixel\"`) and applies equally to `method: img` and `method: js` (a JS include is still a measurement-pixel hop in vendor parlance).\n\n**Scope boundary (normative).** `pixel_tracker` covers RENDERER-FIRED trackers — measurement events that the ad's serving template invokes when the user sees, views, or clicks the creative. Conversion pixels that fire on the advertiser's site after the click (Meta Pixel, GA4 server-side, custom postbacks) MUST be modeled via `sync_event_sources` / `event_log` — they are campaign-scoped, not creative-asset-scoped. See `docs/creative/canonical-formats.mdx#what-format_kind-is-not-for`.\n\n**Format-specific tracker primitives.** Formats whose wire shape embeds tracker URLs in a format-specific structure use dedicated asset types instead:\n- `video_vast` / `audio_vast` → `vast_tracker` (VAST `<TrackingEvents>`: start, quartiles, complete, pause, mute)\n- `audio_daast` → `daast_tracker` (DAAST `<TrackingEvents>` parity)\n- `display_tag` → opaque (third-party server fires its own trackers)\n\nAll other web-rendered canonicals use `pixel_tracker`.\n\nMaps to IAB OpenRTB Native 1.2 / Dynamic Native Ads API tracker objects:\n- `imptrackers[]` → one `pixel_tracker` per entry with `event: impression`, `method: img`\n- `jstracker` → one `pixel_tracker` with `event: impression`, `method: js`\n- `eventtrackers[]` → one `pixel_tracker` per entry, `event` mapped from the IAB event enum\n- `link.clicktrackers[]` → one `pixel_tracker` per entry with `event: click`, `method: img` (click destinations live on `landing_page_url` slot)\n\n**Bidirectional v1↔v2 mapping (normative for SDK auto-negotiation).** A 3.1 buyer SDK talking to a 3.0.x seller MUST downgrade `pixel_tracker` to the v1 `{asset_type: url, url_type: tracker_pixel}` shape. The URL still emits on the wire; what's lost depends on the original event/method. A 3.1 SDK reading a v1 manifest MUST upgrade `{asset_type: url, url_type: tracker_pixel}` to `pixel_tracker` by inferring event/method from the v1 `asset_id`. Both directions are lossy-with-advisory; SDKs MUST emit the appropriate error code so consumers can see what was inferred or dropped.\n\n**v2 → v1 downgrade table:**\n| pixel_tracker source | v1 emit | Lost fields | Error code |\n|---|---|---|---|\n| `{event: impression, method: img, url}` | `{url_type: tracker_pixel, asset_id: impression_tracker, url}` | none | (no advisory) |\n| `{event: viewable_mrc_50, method: img, url}` | `{url_type: tracker_pixel, asset_id: viewability_tracker, url}` | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: viewable_mrc_100, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: viewable_video_50, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: audible_video_complete, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: click, method: img, url}` | `{url_type: tracker_pixel, asset_id: click_tracker, url}` | none meaningful | (no advisory) |\n| `{event: custom, custom_event_name: X, ...}` | `{url_type: tracker_pixel, asset_id: impression_tracker, url}` (defaults to impression timing) | custom event timing | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{method: js, any event, url}` | same shape with `url_type: tracker_pixel` | JS execution context — URL is hit via GET (counter increments), but JS body doesn't execute (OMID-style verification, viewability observers, cross-domain cookie setters won't fire) | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n\n**v1 → v2 upgrade table (inferred — SDK has no explicit event/method):**\n| v1 source (asset_id) | Inferred pixel_tracker | Inference basis |\n|---|---|---|\n| `impression_tracker` | `{event: impression, method: img}` | asset_id convention |\n| `viewability_tracker` | `{event: viewable_mrc_50, method: img}` | asset_id convention + most-common default (50% is the dominant variant in v1 catalogs) |\n| `click_tracker` | `{event: click, method: img}` | asset_id convention |\n| `<other asset_id>` | `{event: custom, custom_event_name: <original asset_id>, method: img}` | fallback — preserves the original asset_id as the custom name |\n\nAll v1→v2 upgrades surface `PIXEL_TRACKER_UPGRADE_INFERRED` so consumers can see that event/method were inferred rather than explicitly declared.","type":"object","properties":{"asset_type":{"type":"string","const":"pixel_tracker","description":"Discriminator identifying this as a renderer-fired pixel tracker asset. See /schemas/creative/asset-types for the registry."},"event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1pixel-tracking-event.json","description":"Which event this tracker fires on. The event enum maps its first four measurement values to IAB OpenRTB Native 1.2 event types 1-4 and adds explicit AdCP events for renderer behavior that Native does not assign a standard event type:\n- `impression` (IAB type 1) — fires when the ad is served. Covers both `imptrackers[]` and `jstracker` from the IAB shape, distinguished by `method`.\n- `viewable_mrc_50` (IAB type 2) — IAB MRC viewable, 50% pixels for ≥1 second.\n- `viewable_mrc_100` (IAB type 3) — IAB MRC viewable, 100% pixels for ≥1 second.\n- `viewable_video_50` (IAB type 4) — video-specific viewable, 50% pixels for ≥2 seconds. Native type 4 does not require audio. On video_hosted; ignored on image/html5.\n- `audible_video_complete` (AdCP-defined) — video reached 100% completion with audio on. Native reserves event types 500+ for exchange-specific use and does not assign this event a standard numeric type. Meaningful on non-VAST video formats where audible-complete is measured but VAST `<TrackingEvents>` is not the wire format; VAST formats use `vast_tracker` with `vast_event: complete` plus a separate audible tracker instead.\n- `click` — fires when the user clicks the creative (`link.clicktrackers[]`).\n- `custom` — adopter-defined event for anything not in the standardized enum. MUST also set `custom_event_name`; it can represent Native's exchange-specific 500+ range or another qualified vendor event without assigning an IAB numeric identity."},"method":{"type":"string","enum":["img","js"],"default":"img","description":"How the tracker URL is invoked at serve time:\n- `img` — fired as an image pixel (HTTP GET with `<img>`-like semantics; no JS execution)\n- `js` — fired as a script include (renderer evaluates the URL's response as JavaScript)\n\nMatches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Tracker URL fired when `event` occurs. Macro processing and encoding follow an attached occurrence declaration; absent declarations retain the legacy universal-macro path."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"One declaration per token occurrence in `url`; declaration_id values MUST be unique and locations MUST resolve. When omitted, legacy behavior applies."},"custom_event_name":{"type":"string","description":"REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. When tracker execution is undeclared, an unknown custom event is a forward-compatible probe and the seller silently no-ops instead of rejecting the creative. An effective tracker_execution_contract overrides that legacy fallback: with complete:true an unlisted custom selector is unsupported and rejects compatibility with tracker_contract_mismatch; a listed custom selector is an affirmative accept-and-initiate commitment."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance."}},"required":["asset_type","event","url"],"allOf":[{"if":{"properties":{"event":{"const":"custom"}},"required":["event"]},"then":{"required":["custom_event_name"]},"else":{"not":{"required":["custom_event_name"]}}}],"additionalProperties":true,"examples":[{"asset_type":"pixel_tracker","event":"impression","method":"img","url":"https://measurement.example.com/imp?cb={CACHEBUSTER}&cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"impression","method":"js","url":"https://measurement.example.com/jstracker.js?cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"viewable_mrc_50","method":"img","url":"https://measurement.example.com/mrc50?cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"click","method":"img","url":"https://measurement.example.com/click?cid={CREATIVE_ID}&cb={CACHEBUSTER}"},{"asset_type":"pixel_tracker","event":"audible_video_complete","method":"img","url":"https://measurement.example.com/audible_complete?cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"custom","custom_event_name":"engagement_3s","method":"img","url":"https://measurement.example.com/engagement?cid={CREATIVE_ID}&duration=3s"}]},"external:enums/pixel-tracking-event.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/pixel-tracking-event.json","title":"Pixel Tracking Event","description":"Closed AdCP event vocabulary for renderer-fired pixel trackers. Impression and viewability values through `viewable_video_50` map to IAB OpenRTB Native event tracker types 1-4. `audible_video_complete` is an AdCP-defined first-class event, not an assigned IAB Native event type; Native reserves 500+ for exchange-specific use. `click` represents Native click trackers and `custom` is the explicit adopter-defined extension point.","type":"string","enum":["impression","viewable_mrc_50","viewable_mrc_100","viewable_video_50","audible_video_complete","click","custom"]},"external:core/assets/vast-tracker-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/vast-tracker-asset.json","title":"VAST Tracker Asset","description":"A single tracker URL bound to a VAST `TrackingEvents` event. Emitted by the creative agent as a decomposed VAST-event URL; the sales agent assembles these into the VAST `TrackingEvents` block at serve time. IMPORTANT: this asset type is for `TrackingEvents` URLs only (start, quartiles, complete, pause, mute, etc.). The `Impression` URL MUST be modeled as a `url` asset with `url_type: \"tracker_pixel\"`, not as a vast_tracker with `vast_event: \"impression\"`. Decomposed trackers let format requirements bind specific measurement events (e.g., MRC viewable) without forcing the buyer to construct a full VAST tag.","type":"object","properties":{"asset_type":{"type":"string","const":"vast_tracker","description":"Discriminator identifying this as a VAST tracker asset. See /schemas/creative/asset-types for the registry."},"vast_event":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-tracking-event.json"},{"not":{"enum":["impression","clickTracking","customClick","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]}}],"description":"The VAST tracking event this URL fires on. Maps 1:1 to the VAST `Tracking event=\"...\"` attribute inside `TrackingEvents`. MUST NOT be `impression` (belongs in the VAST `Impression` element — model as a `url` asset with `url_type: \"tracker_pixel\"`), `clickTracking` / `customClick` (belong in `VideoClicks`), `error` (VAST `Error` element), or any of `viewable` / `notViewable` / `viewUndetermined` / `measurableImpression` / `viewableImpression` (children of the VAST `ViewableImpression` element, not `TrackingEvents`)."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Tracker URL fired for the VAST event. Attached declarations identify each macro occurrence, registry revision, processing actor, and exact encoding profile."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"Exact tokens in `url` and their resolver/encoding contracts."},"offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$","description":"VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise for compatibility with existing 3.x manifests. Format matches the VAST 4.2 XSD `Tracking@offset` pattern: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted — the VAST 4.2 XSD pattern does not allow a leading minus."},"target":{"type":"string","enum":["linear","non_linear","companion"],"default":"linear","description":"Which VAST creative element this tracker scopes to — `linear` for `<Linear>/<TrackingEvents>`, `non_linear` for `<NonLinearAds>/<TrackingEvents>`, `companion` for `<CompanionAds>/<Companion>/<TrackingEvents>`. Defaults to `linear`. Existing 3.x assets remain structurally permissive; a tracker execution contract applies the standards-valid event/target matrix when matching a creative to a product."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance."}},"required":["asset_type","vast_event","url"],"allOf":[{"if":{"properties":{"vast_event":{"const":"progress"}},"required":["vast_event"]},"then":{"required":["offset"]}}],"additionalProperties":true},"external:core/assets/daast-tracker-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/assets/daast-tracker-asset.json","title":"DAAST Tracker Asset","description":"A single tracker URL bound to a DAAST `TrackingEvents` event. Audio-side analogue of vast-tracker-asset. The `Impression` URL MUST be modeled as a `url` asset with `url_type: \"tracker_pixel\"`, not as a daast_tracker with `daast_event: \"impression\"`.","type":"object","properties":{"asset_type":{"type":"string","const":"daast_tracker","description":"Discriminator identifying this as a DAAST tracker asset. See /schemas/creative/asset-types for the registry."},"daast_event":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-tracking-event.json"},{"not":{"enum":["impression","clickTracking","customClick","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]}}],"description":"The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: \"tracker_pixel\"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`)."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Tracker URL fired for the DAAST event. Attached declarations identify each macro occurrence, processing actor, and exact encoding profile."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"Exact tokens in `url` and their resolver/encoding contracts."},"offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$","description":"DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise for compatibility with existing 3.x manifests. Same format as VAST 4.2 `Tracking@offset`: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted."},"target":{"type":"string","enum":["linear","companion"],"default":"linear","description":"Which DAAST creative element this tracker scopes to — `linear` for `<Linear>/<TrackingEvents>` (DAAST 1.1 §3.2.1.7), `companion` for `<CompanionAds>/<Companion>/<TrackingEvents>` (DAAST 1.1 §3.2.2.7). DAAST has no `<NonLinearAds>` element. Defaults to `linear`. Existing 3.x assets remain structurally permissive; a tracker execution contract applies the standards-valid event/target matrix when matching a creative to a product."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance."}},"required":["asset_type","daast_event","url"],"allOf":[{"if":{"properties":{"daast_event":{"const":"progress"}},"required":["daast_event"]},"then":{"required":["offset"]}}],"additionalProperties":true},"external:core/creative-assets.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-assets.json","title":"Creative Assets","description":"Map of canonical asset-group or legacy asset identifiers to supplied creative assets. Values are either a single discriminated asset or a non-empty repeatable asset array.","type":"object","patternProperties":{"^[a-z0-9_]+$":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":true},"external:enums/creative-status.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/creative-status.json","title":"Creative Status","description":"Lifecycle status of a creative asset in a creative library. See the Creative Protocol specification for transition rules.","type":"string","enum":["processing","pending_review","approved","suspended","rejected","archived"],"enumDescriptions":{"processing":"Creative is being ingested, transcoded, or validated. Automatically transitions to pending_review when processing completes, or to rejected if processing fails (e.g., corrupt file, unsupported codec).","pending_review":"Creative has passed processing and is awaiting platform content policy review. Transitions to approved or rejected after review.","approved":"Creative has been approved and is eligible for delivery. May be archived by the buyer, or transitioned by the seller to 'pending_review' (re-review), 'suspended' (recoverable dependency/authorization loss), or 'rejected' (post-approval revocation) when policy enforcement, takedown requests, or content drift require it. Sellers MUST surface a corresponding impairment on any active media buy that references this creative when transitioning 'approved' → 'suspended' or 'approved' → 'rejected'.","suspended":"Creative was approved but is temporarily ineligible for delivery due to a recoverable dependency state, such as an expired/revoked authorization for a `published_post` reference or a source post becoming private. Sellers MAY transition `suspended` back to `approved` after the dependency is restored and any required re-review passes, or to `rejected` when the seller determines the dependency cannot be restored for this creative and replacement/resubmission is required. Sellers MUST surface a corresponding impairment on any active media buy that references this creative while it is suspended.","rejected":"Creative was rejected due to content policy, technical issues, or terminal dependency/authorization loss. Reached from 'pending_review' (initial review failure), from 'approved' (post-approval revocation by the seller — policy change, takedown request, content drift), or from 'suspended' when a previously recoverable dependency is determined unrecoverable for this creative. Not terminal — the buyer may fix the issue and resubmit via sync_creatives, which returns the creative to processing.","archived":"Creative has been archived and is excluded from default queries. Archive MAY be buyer-initiated (explicit cleanup) or seller-initiated (inactivity, post-flight expiry, storage policy, account suspension) — seller-initiated archive is only valid when no active package assignments reference the creative. Archived creatives retain their data and may be unarchived back to approved by the buyer. Buyer-initiated archive is acknowledged on the `sync_creatives` response path. Seller-initiated archive (`approved → archived`) fires `creative.status_changed` against the account's `notification_configs[]` subscribers (see `notification-type.json` and `sync_accounts`); buyers MUST observe the new status on the next `list_creatives` read regardless of whether the webhook was delivered. Destruction is a distinct event (`creative.purged`); purged creatives do not appear in default `list_creatives` results and MAY surface as tombstones when `include_purged: true` is supplied — see `list_creatives` for the tombstone shape."}},"external:core/industry-identifier.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/industry-identifier.json","title":"Industry Identifier","description":"An industry-standard or market-specific identifier for an advertising creative (e.g., Ad-ID, ISCI, Clearcast clock number, IDcrea). These identifiers are managed by external registries or clearance bodies and used across the supply chain to track and reference specific creative assets. Add a PR to extend creative-identifier-type when another shared identifier scheme needs first-class support.","type":"object","properties":{"type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1creative-identifier-type.json"},"value":{"type":"string","maxLength":64,"description":"The identifier value (e.g., 'ABCD1234000H' for Ad-ID). Preserve the value exactly as the traffic or clearance system expects it."}},"required":["type","value"],"additionalProperties":true},"external:enums/creative-identifier-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/creative-identifier-type.json","title":"Creative Identifier Type","description":"Industry-standard or market-specific identifier types for advertising creatives. These identifiers are managed by external registries or clearance bodies and are used across the supply chain to track and reference specific creative assets. This enum is intentionally closed: add a PR for additional shared identifier schemes rather than using an escape hatch.","type":"string","enum":["ad_id","isci","clearcast_clock","idcrea"],"enumDescriptions":{"ad_id":"Ad-ID registry code. Common for US television workflows and accepted by some radio/audio workflows. Often 12-character alphanumeric (4-character company prefix + 8-character unique identifier, e.g., ABCD1234000H). Managed by the Ad-ID registry (ad-id.org). Ties creative assets to rotation instructions and traffic systems.","isci":"Industry Standard Coding Identification. Longstanding creative identifier still used by broadcast radio and legacy traffic systems, sometimes interchangeably with Ad-ID in audio workflows.","clearcast_clock":"Clearcast clock number. UK broadcast creative identifier assigned during the Clearcast clearance process and used from clearance through transmission and reporting.","idcrea":"IDcrea identifier. French ARPP.PUB creative identifier for current ARPP.PUB workflows; historical PubID values remain valid for older creatives."},"examples":["ad_id","isci","clearcast_clock","idcrea"]},"external:core/rights-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/rights-constraint.json","title":"Rights Constraint","description":"Rights metadata attached to a creative. Each entry represents constraints from a single rights holder. Buyer-carried fields are a presentation, not authorization. In AdCP 3.2, a serving party treats a constraint as machine-verified only after one attestation_refs entry evaluates to verified under its own adcp.attestations policy and matches the complete digest-pinned grant.","type":"object","properties":{"rights_id":{"type":"string","description":"Rights grant identifier from the acquire_rights response"},"rights_agent":{"type":"object","description":"The agent that granted these rights","properties":{"url":{"type":"string","format":"uri","description":"MCP endpoint URL of the rights agent"},"id":{"type":"string","description":"Agent identifier"}},"required":["url","id"]},"rights_holder":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Canonical BrandRef for the rights holder that issued the grant through an authorized rights agent. Required whenever attestation_refs is present. Evaluators first match this exact BrandRef against local issuer policy, then resolve the authoritative brand.json and bind the credential verification key to exactly one matching agents[] entry with type rights. Sibling-brand agents are never authority. Legacy unattested constraints may omit this field but remain machine-unverified."},"valid_from":{"type":"string","format":"date-time","description":"Start of the rights validity period"},"valid_until":{"type":"string","format":"date-time","description":"End of the rights validity period. Creative should not be served after this time."},"uses":{"type":"array","description":"Rights uses covered by this constraint","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1right-use.json"},"minItems":1},"countries":{"type":"array","description":"Countries where this creative may be served under these rights (ISO 3166-1 alpha-2). If omitted, no country restriction. When both countries and excluded_countries are present, the effective set is countries minus excluded_countries.","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"excluded_countries":{"type":"array","description":"Countries excluded from rights availability (ISO 3166-1 alpha-2). Use when the grant is worldwide except specific markets.","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"impression_cap":{"type":"integer","minimum":1,"description":"Maximum total impressions allowed for the full validity period (valid_from to valid_until). This is the absolute cap across all creatives using this rights grant, not a per-creative or per-period limit."},"right_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1right-type.json","description":"Type of rights (talent, music, etc.). Helps identify constraints when a creative combines multiple rights types."},"approval_status":{"type":"string","enum":["pending","approved","rejected"],"description":"Approval status from the rights holder at manifest creation time (snapshot, not a live value)"},"grant_status":{"type":"string","enum":["active","paused","revoked"],"description":"Authoritative lifecycle state bound into the grant digest and credential status evidence. Only active can evaluate to verified. paused and revoked credentials are ineligible for serving; resumption issues a fresh active credential and reference."},"restrictions":{"type":"array","description":"Normalized enforceable content and usage restrictions issued with the grant. When present these values are part of content_digest and cannot be omitted or changed without invalidating the attestation.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"disclosure":{"type":"object","description":"Disclosure obligation issued with the grant and bound by content_digest.","properties":{"required":{"type":"boolean"},"text":{"type":"string","minLength":1}},"required":["required"],"allOf":[{"if":{"properties":{"required":{"const":true}},"required":["required"]},"then":{"required":["text"]}}],"additionalProperties":false},"creative_approval_required":{"type":"boolean","description":"Whether each creative produced under this grant requires holder approval before distribution. This enforceable term is bound by content_digest."},"verification_url":{"type":"string","format":"uri","deprecated":true,"description":"DEPRECATED legacy informational locator. It is not proof of grant status, a revocation source, a credential locator, or permission to make a network request. Receivers MUST NOT fetch it during rights evaluation, and HTTP status codes have no AdCP authorization meaning. Rights authorization uses attestation_refs and a verifier-of-record evaluation under evaluator-owned policy."},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"SHA-256 of UTF8(JCS(rights_constraint minus content_digest, attestation_refs, and verification_url)), formatted as sha256:<lowercase hex>. This binds all serving-relevant grant fields, including future extension fields, while deliberately excluding the legacy non-authoritative URL."},"attestation_refs":{"type":"array","description":"Alternative portable presentations of a holder-issued rights-grant credential signed by its authorized rights agent. The buyer carries references only; the serving party remains verifier-of-record. At least one reference must evaluate to verified and match rights_holder, rights_id, rights_agent, content_digest, validity, revocation state, and local policy before this constraint can contribute to serving eligibility.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-reference.json"},{"type":"object","properties":{"issuer":{"type":"object","properties":{"type":{"type":"string","const":"brand"},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"}},"required":["type","brand"]},"claim_type":{"type":"string","const":"https://adcontextprotocol.org/claims/rights/grant"},"subject":{"type":"object","properties":{"type":{"type":"string","const":"resource"},"resource_type":{"type":"string","const":"https://adcontextprotocol.org/claims/subjects/rights-grant"}},"required":["type","resource_type","namespace","id","content_digest"]}}}]},"minItems":1,"maxItems":4,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["rights_id","rights_agent","uses"],"allOf":[{"if":{"required":["attestation_refs"]},"then":{"required":["rights_holder","grant_status","content_digest"]}}],"x-adcp-validation":{"rights_attestation_profile":{"claim_type":"https://adcontextprotocol.org/claims/rights/grant","subject_resource_type":"https://adcontextprotocol.org/claims/subjects/rights-grant","cross_field_equality":["attestation_ref.issuer.brand == rights_holder (exact BrandRef)","attestation_ref.subject.namespace == rights_agent.url (canonical URL)","attestation_ref.subject.id == rights_id","attestation_ref.subject.content_digest == content_digest"],"digest_excludes":["content_digest","attestation_refs","verification_url"],"resolution_limits":{"pre_network_checks":["accepted issuer","accepted claim","accepted proof format","accepted delivery method","accepted resolver or origin"],"maximum_references":4,"deduplicate_equivalent_references":true,"apply_account_and_evaluator_rate_limits":true}}},"additionalProperties":true},"external:enums/right-use.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/right-use.json","title":"Right Use","description":"Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.","x-status":"experimental","type":"string","enum":["likeness","voice","name","endorsement","motion_capture","signature","catchphrase","sync","background_music","editorial","commercial","ai_generated_image"],"enumDescriptions":{"likeness":"Visual representation of a person's appearance, including AI-generated imagery","voice":"Audio reproduction of a person's voice, including AI-generated speech","name":"Use of a person's name in advertising or promotional materials","endorsement":"Implied or explicit endorsement of a product or service by a person","motion_capture":"Use of a person's movement patterns for animation or video","signature":"Use of a person's signature or autograph","catchphrase":"Use of a person's well-known phrases or sayings","sync":"Synchronization of music with visual media (ads, video)","background_music":"Use of music as background audio in advertising","editorial":"Use in editorial or informational contexts","commercial":"Use in commercial advertising and promotional contexts","ai_generated_image":"License to produce AI-generated still imagery derived from the rights holder's IP (brand assets, character designs, talent likeness). Distinct from likeness/voice by output modality — a get_rights query filtered on ai_generated_image returns rights whose pricing options cover image generation, regardless of the underlying IP category."}},"external:enums/right-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/right-type.json","title":"Right Type","description":"Categories of intellectual property rights that can be licensed through the brand protocol.","x-status":"experimental","type":"string","enum":["talent","character","brand_ip","music","stock_media"],"enumDescriptions":{"talent":"Rights to a real person's likeness, voice, name, or endorsement (athletes, celebrities, influencers)","character":"Rights to fictional characters for advertising or co-branding","brand_ip":"Rights to brand intellectual property (logos, trademarks, trade dress)","music":"Rights to musical compositions or recordings (sync, background music)","stock_media":"Rights to stock photography, video, or audio collections"}},"external:core/attestation-reference.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/attestation-reference.json","title":"Attestation Reference","description":"Portable, reference-first presentation of an independently issued claim. It identifies the claimed issuer, claim vocabulary, subject, and either a stable credential locator or an embedded credential. A presentation is a locator and claim hint, not proof or a trust decision. The evaluator remains verifier-of-record and MUST resolve or inspect the credential only under its published attestation capabilities and local trust policy.","type":"object","properties":{"issuer":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-issuer.json"},"claim_type":{"type":"string","format":"uri","description":"Open, absolute URI identifying the claim vocabulary. The URI is an identifier and need not be dereferenceable. AdCP does not maintain an enum of approved claims."},"subject":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-subject.json"},"locator":{"description":"Stable locator for resolving the credential. Credential URLs are permitted only when their canonical origin is allowlisted for the matched issuer. Issuer-scoped IDs name a resolver_id already published by the evaluator; the presentation cannot introduce a resolver URL.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationCredentialUriLocator","type":"object","properties":{"type":{"type":"string","const":"credential_uri"},"credential_uri":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"HTTPS URI of the credential. Before any fetch, evaluators MUST match its canonical origin to credential_origins on the accepted issuer capability and then apply the attestation fetch contract."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","credential_uri"],"additionalProperties":false},{"title":"AttestationIssuerCredentialIdLocator","type":"object","properties":{"type":{"type":"string","const":"issuer_credential_id"},"credential_id":{"type":"string","minLength":1,"maxLength":1024,"description":"Stable credential identifier in the issuer's namespace. It is meaningful only together with issuer and resolver_id.","x-entity":"attestation_credential"},"resolver_id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$","description":"Identifier of a resolver already published in the matched accepted_issuers[].resolvers[] capability. A presenter cannot supply or override its URL."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","credential_id","resolver_id"],"additionalProperties":false}]},"embedded_credential":{"type":"object","description":"Optional inline credential for private, authenticated, or offline delivery. It may accompany locator or be the only delivery path. Its format must be supported by the evaluator, and the evaluator MUST verify the credential exactly as it would a resolved credential.","properties":{"format":{"type":"string","format":"uri","description":"Open, absolute URI identifying the credential/proof format. AdCP does not impose a universal issuer payload schema."},"value":{"description":"Credential encoded as a JSON object or a compact string, according to format.","type":["object","string"],"minLength":1},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["format","value"],"additionalProperties":false},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Optional SHA-256 digest pin for the exact credential bytes, formatted as sha256:<lowercase hex>. The credential format defines its canonical byte representation. A mismatch is invalid and MUST NOT fall back to the unpinned credential. REQUIRED when both locator and embedded_credential are present; both byte representations MUST match this digest."},"credential_version":{"type":"string","minLength":1,"maxLength":255,"description":"Optional issuer-defined credential version hint. It is advisory; the resolved credential is authoritative."},"validity_hint":{"type":"object","description":"Optional planning-time validity hint copied from issuer metadata. Evaluators MUST use the resolved or embedded credential's signed validity and revocation state as authoritative.","properties":{"not_before":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}},"additionalProperties":false,"minProperties":1},"verify_agent":{"type":"object","description":"Optional presenter nomination of a verifier already published by the evaluator. This is a representation, not routing authority: agent_url MUST match an accepted_verifiers[] entry after canonicalization, and the evaluator may choose another accepted verifier or verify locally.","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$"}},"required":["agent_url"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["issuer","claim_type","subject"],"anyOf":[{"required":["locator"]},{"required":["embedded_credential"]}],"allOf":[{"if":{"required":["locator","embedded_credential"]},"then":{"required":["content_digest"]}}],"additionalProperties":false,"examples":[{"issuer":{"type":"origin","origin":"https://credentials.example"},"claim_type":"https://claims.example/audience/methodology-reviewed","subject":{"type":"resource","resource_type":"https://adcontextprotocol.org/claims/subjects/signal","namespace":"https://signals.meridian.example/adcp","id":"signal_urban_commuters"},"locator":{"type":"issuer_credential_id","credential_id":"cred_01JATT7Y","resolver_id":"primary"},"content_digest":"sha256:5b6e8f7a4c3d2e1f00112233445566778899aabbccddeeff0011223344556677"}]},"external:core/attestation-subject.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/attestation-subject.json","title":"Attestation Subject","description":"Typed identity of the entity or object an attestation credential is about. Brand and agent subjects reuse canonical AdCP identities. Other resources use an open, URI-namespaced resource_type plus an identifier whose namespace is explicit. Evaluators MUST compare the resolved credential subject to this complete typed identity, not to id alone.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationBrandSubject","type":"object","properties":{"type":{"type":"string","const":"brand"},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","brand"],"additionalProperties":false},{"title":"AttestationAgentSubject","type":"object","properties":{"type":{"type":"string","const":"agent"},"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"Canonical HTTPS endpoint of the agent the claim concerns."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","agent_url"],"additionalProperties":false},{"title":"AttestationResourceSubject","type":"object","properties":{"type":{"type":"string","const":"resource"},"resource_type":{"type":"string","format":"uri","description":"Open, absolute URI naming the subject vocabulary, such as https://adcontextprotocol.org/claims/subjects/signal. AdCP does not maintain an exhaustive enum."},"namespace":{"type":"string","format":"uri","description":"Absolute URI identifying the namespace in which id is unique. This may be an AdCP agent endpoint, a catalog origin, or a domain-specific namespace URI."},"id":{"type":"string","minLength":1,"maxLength":1024,"description":"Stable identifier for the subject within namespace. It MUST NOT be compared without resource_type and namespace."},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Optional SHA-256 pin for the exact content or immutable snapshot identified by this resource subject. This is part of the complete typed subject identity and is distinct from AttestationReference.content_digest, which pins credential bytes."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","resource_type","namespace","id"],"additionalProperties":false}],"examples":[{"type":"brand","brand":{"domain":"nova-brands.example","brand_id":"nova_motors"}},{"type":"resource","resource_type":"https://adcontextprotocol.org/claims/subjects/signal","namespace":"https://signals.meridian.example/adcp","id":"signal_urban_commuters"}]},"external:core/context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/context.json","title":"Context Object","description":"Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.","type":"object","additionalProperties":true},"external:enums/advertiser-industry.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/advertiser-industry.json","title":"Advertiser Industry","description":"Standardized advertiser industry classification. Top-level categories classify the advertiser's primary business. Dot-notation subcategories (e.g., 'media_entertainment.podcasts') provide platform-specific precision where needed. Sellers map these to platform-native codes (Spotify ADV categories, LinkedIn industry IDs, IAB Content Taxonomy, etc.). Sellers MUST accept unknown values gracefully — treat unrecognized values as the parent category (strip the subcategory) or as uncategorized. This ensures forward compatibility as the taxonomy evolves.","type":"string","x-extensible":true,"x-pattern":"^[a-z][a-z0-9_]+(\\.[a-z][a-z0-9_]+)?$","enum":["automotive","automotive.electric_vehicles","automotive.parts_accessories","automotive.luxury","beauty_cosmetics","beauty_cosmetics.skincare","beauty_cosmetics.fragrance","beauty_cosmetics.haircare","cannabis","cpg","cpg.personal_care","cpg.household","dating","education","education.higher_education","education.online_learning","education.k12","energy_utilities","energy_utilities.renewable","fashion_apparel","fashion_apparel.luxury","fashion_apparel.sportswear","finance","finance.banking","finance.insurance","finance.investment","finance.cryptocurrency","food_beverage","food_beverage.alcohol","food_beverage.restaurants","food_beverage.packaged_goods","gambling_betting","gambling_betting.sports_betting","gambling_betting.casino","gaming","gaming.mobile","gaming.console_pc","gaming.esports","government_nonprofit","government_nonprofit.political","government_nonprofit.charity","healthcare","healthcare.pharmaceutical","healthcare.medical_devices","healthcare.wellness","home_garden","home_garden.furniture","home_garden.home_improvement","media_entertainment","media_entertainment.podcasts","media_entertainment.music","media_entertainment.film_tv","media_entertainment.publishing","media_entertainment.live_events","pets","professional_services","professional_services.legal","professional_services.consulting","real_estate","real_estate.residential","real_estate.commercial","recruitment_hr","retail","retail.ecommerce","retail.department_stores","sports_fitness","sports_fitness.equipment","sports_fitness.teams_leagues","technology","technology.software","technology.hardware","technology.ai_ml","telecom","telecom.mobile_carriers","telecom.internet_providers","transportation_logistics","travel_hospitality","travel_hospitality.airlines","travel_hospitality.hotels","travel_hospitality.cruise","travel_hospitality.tourism"],"enumDescriptions":{"automotive":"Automotive manufacturers, dealerships, and auto industry","automotive.electric_vehicles":"Electric vehicle manufacturers and charging infrastructure","automotive.parts_accessories":"Auto parts, accessories, and aftermarket products","automotive.luxury":"Luxury and premium automotive brands","beauty_cosmetics":"Beauty, cosmetics, and prestige skincare brands. Distinct from cpg.personal_care — use beauty_cosmetics for brands whose identity is rooted in beauty (L'Oreal Paris, Estee Lauder, Sephora) and cpg.personal_care for mass-market personal hygiene (Dove, Colgate)","beauty_cosmetics.skincare":"Skincare brands and dermatological products","beauty_cosmetics.fragrance":"Perfume and fragrance brands","beauty_cosmetics.haircare":"Professional and prestige haircare brands","cannabis":"Cannabis products and dispensaries. Subject to heavy platform restrictions — most platforms require explicit category declaration for ad acceptance","cpg":"Consumer packaged goods — mass-market products sold through retail. For food and beverage manufacturers, use food_beverage. For prestige beauty, use beauty_cosmetics","cpg.personal_care":"Mass-market personal care and hygiene products (deodorant, toothpaste, soap). For prestige beauty brands, use beauty_cosmetics","cpg.household":"Household cleaning and maintenance products","dating":"Dating apps and matchmaking services. Subject to platform restrictions similar to gambling_betting","education":"Educational institutions and learning services","education.higher_education":"Universities, colleges, and graduate programs","education.online_learning":"Online courses, MOOCs, and digital education platforms","education.k12":"Primary and secondary education","energy_utilities":"Energy companies and utilities","energy_utilities.renewable":"Renewable energy, solar, wind, and clean technology","fashion_apparel":"Clothing, footwear, and fashion accessories","fashion_apparel.luxury":"Luxury fashion and designer brands","fashion_apparel.sportswear":"Athletic and sportswear brands","finance":"Financial services, banking, and insurance","finance.banking":"Retail and commercial banking","finance.insurance":"Insurance products and services","finance.investment":"Investment, wealth management, and brokerage","finance.cryptocurrency":"Cryptocurrency exchanges and blockchain financial products","food_beverage":"Food and beverage companies — manufacturers (Coca-Cola, Nestle), restaurants, and alcohol brands. For non-food packaged goods, use cpg","food_beverage.alcohol":"Alcoholic beverages (beer, wine, spirits). Subject to platform age-gating and regional restrictions","food_beverage.restaurants":"Restaurants, fast food, and food delivery","food_beverage.packaged_goods":"Packaged food and non-alcoholic beverages","gambling_betting":"Gambling, sports betting, and wagering. Subject to heavy platform restrictions — most platforms require explicit category declaration","gambling_betting.sports_betting":"Sports betting and daily fantasy sports","gambling_betting.casino":"Online casinos and traditional gambling","gaming":"Video games and interactive entertainment","gaming.mobile":"Mobile gaming","gaming.console_pc":"Console and PC gaming","gaming.esports":"Esports teams, tournaments, and streaming","government_nonprofit":"Government agencies and nonprofit organizations","government_nonprofit.political":"Political advertising and advocacy. Subject to platform transparency and disclosure requirements","government_nonprofit.charity":"Charitable organizations and fundraising","healthcare":"Healthcare, pharmaceuticals, and medical","healthcare.pharmaceutical":"Pharmaceutical and biotech companies. Subject to platform restrictions on drug advertising","healthcare.medical_devices":"Medical devices and health technology","healthcare.wellness":"Wellness, supplements, and alternative health","home_garden":"Home furnishing, improvement, and garden","home_garden.furniture":"Furniture and home decor","home_garden.home_improvement":"Home improvement, tools, and renovation","media_entertainment":"Media, entertainment, and content","media_entertainment.podcasts":"Podcast networks and podcast-first brands","media_entertainment.music":"Music labels, streaming, and artists","media_entertainment.film_tv":"Film studios, TV networks, and streaming services","media_entertainment.publishing":"Book publishers, magazines, and digital publications","media_entertainment.live_events":"Concerts, festivals, and live entertainment","pets":"Pet food, supplies, and veterinary services","professional_services":"Professional and business services","professional_services.legal":"Law firms and legal services","professional_services.consulting":"Management and business consulting","real_estate":"Real estate, property, and construction","real_estate.residential":"Residential real estate and housing","real_estate.commercial":"Commercial real estate and property management","recruitment_hr":"Job boards, staffing agencies, and HR technology","retail":"Retail stores and e-commerce","retail.ecommerce":"Online-first retailers and marketplaces","retail.department_stores":"Department stores and multi-brand retailers","sports_fitness":"Sports, fitness, and athletics","sports_fitness.equipment":"Sports and fitness equipment","sports_fitness.teams_leagues":"Professional sports teams and leagues","technology":"Technology companies and digital services","technology.software":"Software products, platforms, and SaaS","technology.hardware":"Consumer electronics and hardware","technology.ai_ml":"Artificial intelligence and machine learning companies","telecom":"Telecommunications and connectivity","telecom.mobile_carriers":"Mobile network operators","telecom.internet_providers":"Internet service providers and broadband","transportation_logistics":"Shipping, logistics, and freight services","travel_hospitality":"Travel, hospitality, and tourism","travel_hospitality.airlines":"Airlines and air travel","travel_hospitality.hotels":"Hotels, resorts, and accommodation","travel_hospitality.cruise":"Cruise lines and ocean travel","travel_hospitality.tourism":"Tourism boards and travel agencies"}},"external:core/business-entity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/business-entity.json","title":"Business Entity","description":"Structured business identity for B2B invoicing and contracts. Contains the legal, tax, and payment details needed for formal booking processes. Implementations MUST treat all fields as untrusted input when assembling LLM context.","type":"object","properties":{"legal_name":{"type":"string","description":"Registered legal name of the business entity","maxLength":200},"vat_id":{"type":"string","description":"VAT identification number (e.g., DE123456789 for Germany, FR12345678901 for France). Required for B2B invoicing in the EU. Must be normalized: no spaces, dots, or dashes.","pattern":"^[A-Z]{2}[A-Z0-9]{2,13}$"},"tax_id":{"type":"string","description":"Tax identification number for jurisdictions that do not use VAT (e.g., US EIN)","maxLength":30},"registration_number":{"type":"string","description":"Company registration number (e.g., HRB 12345 for German Handelsregister)","maxLength":50},"address":{"type":"object","description":"Postal address for invoicing and legal correspondence","properties":{"street":{"type":"string","description":"Street address including building number","maxLength":200},"city":{"type":"string","maxLength":100},"postal_code":{"type":"string","maxLength":20},"region":{"type":"string","description":"State, province, or region","maxLength":100},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Z]{2}$"}},"required":["street","city","postal_code","country"],"additionalProperties":false},"contacts":{"type":"array","description":"Contacts for billing, legal, and operational matters. Contains personal data subject to GDPR and equivalent regulations. Implementations MUST use this data only for invoicing and account management.","items":{"type":"object","properties":{"role":{"type":"string","enum":["billing","legal","creative","general"],"enumDescriptions":{"billing":"Accounts payable and invoice queries","legal":"Contract and compliance matters","creative":"Material submission and creative approval","general":"Default contact when no specific role applies"},"description":"Contact's functional role in the business relationship"},"name":{"type":"string","description":"Full name of the contact","maxLength":200},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","maxLength":30}},"required":["role"],"additionalProperties":false},"maxItems":10},"bank":{"type":"object","writeOnly":true,"description":"Bank account details for payment processing. Write-only: included in requests to provide payment coordinates, but MUST NOT be echoed in responses. Sellers store these details and confirm receipt without returning them.","properties":{"account_holder":{"type":"string","description":"Name on the bank account","maxLength":200},"iban":{"type":"string","description":"International Bank Account Number (SEPA markets)","pattern":"^[A-Z]{2}[0-9]{2}[A-Z0-9]{4,30}$"},"bic":{"type":"string","description":"Bank Identifier Code / SWIFT code (SEPA markets)","pattern":"^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"},"routing_number":{"type":"string","description":"Bank routing number for non-SEPA markets (e.g., US ABA routing number, Canadian transit/institution number)","maxLength":30},"account_number":{"type":"string","description":"Bank account number for non-SEPA markets","maxLength":30}},"required":["account_holder"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["legal_name"],"additionalProperties":false,"examples":[{"description":"German agency with full B2B details","data":{"legal_name":"Pinnacle Media GmbH","vat_id":"DE123456789","registration_number":"HRB 12345","address":{"street":"Friedrichstrasse 100","city":"Berlin","postal_code":"10117","country":"DE"},"contacts":[{"role":"billing","name":"Sam Adeyemi","email":"billing@pinnacle-media.com","phone":"+49 30 12345678"}],"bank":{"account_holder":"Pinnacle Media GmbH","iban":"DE89370400440532013000","bic":"COBADEFFXXX"}}},{"description":"US advertiser with EIN and domestic bank details","data":{"legal_name":"Acme Corporation","tax_id":"12-3456789","address":{"street":"123 Main St","city":"New York","postal_code":"10001","region":"NY","country":"US"},"contacts":[{"role":"billing","name":"AP Department","email":"ap@acme-corp.com"}],"bank":{"account_holder":"Acme Corporation","routing_number":"021000021","account_number":"123456789"}}}]},"external:core/start-timing.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/start-timing.json","title":"Start Timing","description":"Campaign start timing: 'asap' or ISO 8601 date-time","oneOf":[{"type":"string","const":"asap","description":"Start campaign as soon as possible"},{"type":"string","format":"date-time","description":"Scheduled start date/time in ISO 8601 format"}]},"external:core/push-notification-config.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/push-notification-config.json","title":"Push Notification Config","description":"Webhook configuration for asynchronous task notifications. Uses A2A-compatible PushNotificationConfig structure. By default, webhooks are signed with the AdCP RFC 9421 profile (see docs/building/by-layer/L1/security.mdx#webhook-callbacks) — the seller signs outbound with a key published at the jwks_uri on its own brand.json `agents[]` entry and the buyer verifies against that JWKS, so no shared secret crosses the wire. The optional `authentication` block selects the legacy Bearer or HMAC-SHA256 fallback for compatibility with receivers that have not yet adopted the 9421 profile; this fallback is deprecated and will be removed in AdCP 4.0. Note: the `idempotency_key` that receivers dedup on lives inside the webhook **payload** body (see docs/building/by-layer/L3/webhooks.mdx#reliability and the mcp-webhook-payload schema), not in this configuration object — this schema only describes the receiver-side transport config sent to the seller. This schema is designed for composition via allOf - consuming schemas should define their own additionalProperties constraints.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for task status notifications. The wire contract is unconstrained beyond `format: \"uri\"` — in particular, publishers SHOULD NOT enforce a destination-port allowlist by default, since buyers legitimately host receivers on non-standard TLS ports (`:9443`, `:4443`, path-routed multi-tenant gateways). The SSRF guard the protocol relies on is the IP-range check + DNS-rebinding-resistant connect pin defined in [Webhook URL validation (SSRF)](/docs/building/by-layer/L1/security#webhook-url-validation-ssrf), not port filtering. Operators who want a hardened destination-port allowlist as defense-in-depth (e.g., locked-down enterprise egress) opt in explicitly — see [Destination port: permissive by default](/docs/building/by-layer/L1/security#destination-port-permissive-by-default)."},"operation_id":{"type":"string","description":"Buyer-supplied correlation identifier for the operation that will produce webhooks against this registration. The seller MUST echo this value verbatim into every webhook payload's `operation_id` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) and [Webhooks — Operation IDs](/docs/building/by-layer/L3/webhooks#operation-ids-and-url-templates)). Buyers SHOULD generate a unique value per task invocation (UUID recommended). This field is the canonical registration channel for `operation_id`; buyers MAY additionally embed routing values in the URL path or query as an aid for their own HTTP server, but the URL is opaque to the seller and the wire-level source of truth is this field. Sellers MUST NOT parse the URL to recover `operation_id`. For 3.x schema compatibility the member remains optional, but a seller MUST reject a task that registers an AdCP webhook without it using `INVALID_REQUEST`; otherwise the required webhook envelope cannot be emitted.","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{1,255}$"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. The seller MUST echo this value verbatim in every webhook payload's `token` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) for the receiver-side validation obligation). Length bounds give receivers a defensive range check on the echoed value; senders SHOULD generate tokens with at least 128 bits of entropy (≥22 base64url characters). This is a complementary authenticity mechanism that can layer on top of the RFC 9421 webhook signature — unlike the `authentication` block below, it is not on the 4.0 removal track. Receivers that registered both a signing key (RFC 9421) and a `token` MUST NOT treat a valid token echo as authorization to skip signature verification; both checks remain independent obligations.","minLength":16,"maxLength":4096},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration (A2A-compatible). Opts the seller into Bearer or HMAC-SHA256 signing instead of the default RFC 9421 webhook profile. Deprecated; removed in AdCP 4.0. **Precedence is a switch, not a fallback:** presence of this block selects the legacy scheme; absence selects 9421. A seller MUST NOT sign the same webhook both ways, and a buyer MUST NOT attempt 'try 9421 first, fall back to HMAC' verification — signature mode is determined solely by whether this block was present at registration time. The seller's baseline 9421 webhook key is published at its brand.json `agents[]` `jwks_uri` using `adcp_use: \"request-signing\"` (deprecated `webhook-signing` keys remain accepted during the compatibility window); it does not override this selector and is only used when `authentication` is omitted. See docs/building/by-layer/L1/security.mdx#webhook-callbacks for the full precedence and downgrade-resistance rules (including the `webhook_mode_mismatch` rejection a buyer MUST apply when a received webhook's signing mode does not match the registered mode).","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit `authentication` and use the RFC 9421 webhook profile.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false}},"required":["url"]},"external:enums/auth-scheme.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/auth-scheme.json","title":"Authentication Scheme","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication schemes for the webhook auth block. Bearer: token sent in Authorization header. HMAC-SHA256: legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit the authentication block and use the RFC 9421 webhook signing profile (applicable on schemas where authentication is optional). Removed in AdCP 4.0.","type":"string","enum":["Bearer","HMAC-SHA256"]},"external:core/reporting-webhook.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/reporting-webhook.json","title":"Reporting Webhook","description":"Webhook configuration for automated reporting delivery. Configures where and how campaign performance reports are sent.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for reporting notifications"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.","minLength":16},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration for webhook delivery (A2A-compatible). Opts the receiver into Bearer or HMAC-SHA256 signing. Both schemes are deprecated; the preferred signing profile for new integrations is RFC 9421, where the seller signs with a key published at its brand.json agents[] entry and the buyer verifies against the seller's JWKS — no shared secret crosses the wire (see docs/building/by-layer/L1/security.mdx#webhook-callbacks). This field is required in AdCP 3.x; the requirement is removed in AdCP 4.0 when the default RFC 9421 path becomes the only path.","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD use the RFC 9421 webhook signing profile instead.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false},"reporting_frequency":{"type":"string","enum":["hourly","daily","monthly"],"description":"Frequency for automated reporting delivery. Must be supported by all products in the media buy."},"requested_metrics":{"type":"array","description":"Optional list of metrics to include in webhook notifications. If omitted, all available metrics are included; an empty array has the same meaning as omission (it does not narrow to impressions and spend only). impressions and spend are always included regardless of this list. Must be a subset of the product's available_metrics. Subset evaluation and leaf resolution follow `enums/available-metric.json`: a numeric leaf may be covered by its container, while each structured distribution must be explicitly available. Requesting any nested identity selects its canonical carrier inside the payload's nested object. Same narrowing semantics as get_media_buy_delivery's requested_metrics (which additionally requires at least one entry when present).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1available-metric.json"},"uniqueItems":true}},"required":["url","authentication","reporting_frequency"],"additionalProperties":true}},"dependentRequired":{"proposal_id":["total_budget"]}}
1
+ {"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json","title":"Create Media Buy Request","description":"Deprecated AdCP 3.x compatibility request for creating a MediaBuy. New 3.2 callers use buy_products for direct published-offer purchases or accept_proposal for proposal execution. Existing package and proposal payloads remain valid throughout 3.x.","type":"object","deprecated":true,"x-deprecated-in":"3.2.0","x-superseded-by":["buy_products","accept_proposal"],"x-mutates-state":true,"x-governed-commitment":{"scope":"always"},"properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99},"governance_context":{"type":"string","description":"Opaque intent authorization for this media-buy commitment. Required when governance applies to the resolved account.","minLength":1,"maxLength":4096,"pattern":"^[\\x20-\\x7E]+$"},"idempotency_key":{"type":"string","description":"Client-generated unique key for this request. If a request with the same idempotency_key and account has already been processed, the seller returns the existing media buy rather than creating a duplicate. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.","minLength":16,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{16,255}$"},"plan_id":{"type":"string","description":"DEPRECATED on seller-facing requests. New buyers send the approved governance_context on the protocol envelope; the seller forwards that opaque context and does not need the plan identifier. If both are present, the governance agent MUST reject a mismatch. Removed in 4.0.","deprecated":true,"x-removed-in":"4.0.0","x-entity":"governance_plan"},"account":{"$ref":"#/$defs/external:core~1account-ref.json","description":"Account to bill for this media buy. Pass a natural key (brand, operator, optional sandbox) or a seller-assigned account_id from list_accounts."},"proposal_id":{"type":"string","x-entity":"proposal","description":"ID of the exact committed proposal snapshot to execute. With total_budget, the publisher creates packages using the proposal's fixed percentages or seller-optimized constraints. Mutually exclusive: provide packages or proposal_id, not both. AdCP 3.2 request_proposals and ordinary refine_proposals revisions issue drafts; refine_proposals action finalize creates the executable committed hold. Sellers reject draft, declined, or previously executed snapshots, while exact retries with the original idempotency key replay historical success. Changed commercial terms are issued under a new proposal_id, so no separate proposal version is required."},"opportunity":{"allOf":[{"$ref":"#/$defs/external:core~1opportunity-context.json"},{"properties":{"status":{"const":"closed"}},"if":{"properties":{"status":{"const":"closed"}},"required":["status"]},"then":{"properties":{"close_reason":{"const":"accepted_with_seller"}}}}],"description":"Optional planning-cycle closure. Sellers infer successful proposal execution as closed with close_reason accepted_with_seller when status is omitted; when status is present it MUST be closed with that reason. If the proposal was issued under an opportunity_id, a supplied ID MUST match it."},"total_budget":{"type":"object","description":"Hard aggregate lifetime budget for the media buy. Required when executing a proposal and for seller-optimized explicit packages. Optional in fixed explicit-package mode; when present there, amount MUST equal the sum of package budgets. For a fixed proposal, the publisher applies allocation percentages to this amount. For a seller-optimized proposal or explicit buy, packages draw dynamically from this shared total.","properties":{"amount":{"type":"number","description":"Total budget amount","minimum":0},"currency":{"type":"string","description":"ISO 4217 currency code","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},"daily_budget_cap":{"type":"number","minimum":0,"description":"Optional hard aggregate daily spend ceiling in the media-buy currency. It limits total spend without allocating package amounts. Package caps are subordinate and need not sum to it. Requires advertised media_buy budget-capping scope; otherwise rejected with UNSUPPORTED_FEATURE."},"frequency_cap":{"$ref":"#/$defs/external:core~1media-buy-frequency-cap.json","description":"Optional max-impression cap using one counter across explicit packages. Requires advertised aggregate_frequency_capping and compatible media_buy_support on every product; otherwise sellers MUST reject with UNSUPPORTED_FEATURE before any mutation and MUST NOT silently drop, soften, or clamp the cap. Omit when executing proposal_id because accepted terms are authoritative."},"budget_cap_timezone":{"type":"string","minLength":1,"description":"Optional shared IANA day boundary override for all caps. Requires buyer_timezone_override; otherwise rejected with UNSUPPORTED_FEATURE. When omitted, budget_capping.timezone_basis selects Account.timezone or the advertised fixed_timezone."},"budget_allocation":{"allOf":[{"$ref":"#/$defs/external:core~1budget-allocation.json"}],"description":"How budget is allocated across explicit packages. Omission means fixed allocation (legacy-compatible). Buyer agents SHOULD send budget_allocation explicitly ({mode: \"fixed\"} or seller_optimized) rather than rely on omission, and when the principal's instruction does not determine whether the budget is one shared pool across packages or split per package, SHOULD ask the principal rather than guess. seller_optimized requires advertised media_buy.features.seller_optimized_budget; inside it, package budget caps, min_spend_target, and package pacing each require their own advertised sub-capability (seller_optimized_package_budgets, seller_optimized_min_spend_targets, seller_optimized_package_pacing), otherwise the request is rejected with UNSUPPORTED_FEATURE before any over-subscription validation. In proposal mode the committed proposal supplies this configuration and callers MUST omit it here."},"packages":{"type":"array","description":"Array of package configurations. Required when not using proposal_id. Mutually exclusive: provide packages or proposal_id, not both. Fixed allocation requires budget on every package. Seller-optimized allocation permits package budget to be omitted or to act as a hard cap. When executing a proposal, omit packages; the seller derives them from the committed proposal.","items":{"$ref":"#/$defs/external:media-buy~1package-request.json"},"minItems":1},"brand":{"$ref":"#/$defs/external:core~1brand-ref.json","description":"Brand reference for this media buy. Resolved to full brand identity at execution time from brand.json or the registry."},"advertiser_industry":{"$ref":"#/$defs/external:enums~1advertiser-industry.json","description":"Industry classification for this specific campaign. A brand may operate across multiple industries (brand.json industries field), but each media buy targets one. For example, a consumer health company running a wellness campaign sends 'healthcare.wellness', not 'cpg'. Sellers map this to platform-native codes (e.g., Spotify ADV categories, LinkedIn industry IDs). When omitted, sellers may infer from the brand manifest's industries field."},"invoice_recipient":{"$ref":"#/$defs/external:core~1business-entity.json","description":"Override the account's default billing entity for this specific buy. When provided, the seller invoices this entity instead. The seller MUST validate the invoice recipient is authorized for this account. When governance_agents are configured, the seller MUST include invoice_recipient in the check_governance request."},"io_acceptance":{"type":"object","description":"Acceptance of an insertion order from a committed proposal. Required when the proposal's insertion_order has requires_signature: true. References the io_id from the proposal's insertion_order.","properties":{"io_id":{"type":"string","description":"The io_id from the proposal's insertion_order being accepted"},"accepted_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the IO was accepted"},"signatory":{"type":"string","description":"Who accepted the IO — agent identifier or human name","minLength":1,"maxLength":250},"signature_id":{"type":"string","description":"Reference to the electronic signature from the signing service, when signing_url was used"}},"required":["io_id","accepted_at","signatory"],"additionalProperties":true},"po_number":{"type":"string","description":"Purchase order number for tracking"},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"\\S","description":"Human-readable name for this media buy, shared by buyer and seller for trafficking UI display and operational communication. When supplied, the seller MUST persist it and echo it unchanged on the create success response and subsequent get_media_buys reads. This display label is not an identifier or financial reference."},"agency_estimate_number":{"type":"string","maxLength":100,"description":"Agency estimate or authorization number. Primary financial reference for broadcast buys — links the order to the agency's media plan and billing system. Travels with the order and creative traffic identifiers through the transaction lifecycle."},"start_time":{"$ref":"#/$defs/external:core~1start-timing.json"},"end_time":{"type":"string","format":"date-time","description":"Campaign end date/time in ISO 8601 format"},"pacing":{"$ref":"#/$defs/external:enums~1pacing.json","description":"Aggregate pacing strategy for the media-buy budget across the media-buy flight. This controls how much the buy spends over time. Package pacing is subordinate and influences which package receives the aggregate spend; package pacing MUST NOT cause aggregate delivery to exceed this strategy. Defaults to even when total_budget is present. When executing a proposal that carries pacing, omit this field or send the identical value; the seller MUST reject a conflicting override with TERMS_REJECTED. In a seller-optimized buy, a seller declaring media_buy.features.seller_optimized_budget MUST accept omission and `even`; it MAY reject `asap` or `front_loaded` with UNSUPPORTED_FEATURE (error.field `pacing`) before any provider mutation and MUST NOT silently coerce them to `even`. Pacing carried by the seller's own committed proposal is not subject to that rejection. Fixed-allocation semantics are unchanged."},"bidding":{"allOf":[{"$ref":"#/$defs/external:core~1bidding-policy.json"}],"description":"Complete media-buy bidding default inherited by packages that omit package.bidding. `{automatic:true}` records an explicit automatic policy. In seller-optimized mode, cost_per/roas bind to the primary budget_allocation.optimization_goals goal. In fixed mode, inherited cost_per is valid only when inheriting package primary-goal result units are compatible; inherited roas requires value-bearing primary goals. Every monetary field uses total_budget.currency or the single currency derived for the media buy, and every affected pricing option MUST declare that currency. Sellers MUST reject incompatible units, combinations, currency, or overrides before mutation with BIDDING_PLACEMENT_CONFLICT. Media-buy bidding combined with any inheriting package's legacy bid_price or legacy monetary optimization-goal target is ambiguous and MUST be rejected with AMBIGUOUS_BIDDING_POLICY."},"paused":{"type":"boolean","description":"Create the media buy in a paused delivery state. When true, and the buy would otherwise be active because creatives are assigned and the flight has started, the seller returns media_buy_status 'paused'. Setup blockers still take precedence: a buy with no creatives remains 'pending_creatives', and a future-dated buy remains 'pending_start' until its flight can start. Defaults to false.","default":false},"push_notification_config":{"$ref":"#/$defs/external:core~1push-notification-config.json","description":"Optional webhook configuration for async task status notifications. Publisher will send webhooks when status changes (working, input-required, completed, failed, canceled). Buyers SHOULD supply `push_notification_config.operation_id` as the canonical correlation value; publishers echo that field back verbatim in webhook payloads and MUST NOT parse the URL to derive it."},"reporting_webhook":{"$ref":"#/$defs/external:core~1reporting-webhook.json","description":"Optional webhook configuration for automated reporting delivery"},"artifact_webhook":{"$comment":"Webhook configuration for content artifact delivery - enables governance validation. Same authentication structure as reporting_webhook.","type":"object","description":"Optional webhook configuration for content artifact delivery. Used by governance agents to validate content adjacency. Seller pushes artifacts to this endpoint; orchestrator forwards to governance agent for validation.","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for artifact delivery"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.","minLength":16},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration for webhook delivery (A2A-compatible). Opts the receiver into Bearer or HMAC-SHA256 signing. Both schemes are deprecated; the preferred signing profile for new integrations is RFC 9421, where the seller signs with a key published at its brand.json agents[] entry and the buyer verifies against the seller's JWKS — no shared secret crosses the wire (see docs/building/by-layer/L1/security.mdx#webhook-callbacks). This field is required in AdCP 3.x; the requirement is removed in AdCP 4.0 when the default RFC 9421 path becomes the only path.","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD use the RFC 9421 webhook signing profile instead.","items":{"$ref":"#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false},"delivery_mode":{"type":"string","enum":["realtime","batched"],"description":"How artifacts are delivered. 'realtime' pushes artifacts as impressions occur. 'batched' aggregates artifacts and pushes periodically (see batch_frequency)."},"batch_frequency":{"type":"string","enum":["hourly","daily"],"description":"For batched delivery, how often to push artifacts. Required when delivery_mode is 'batched'."},"sampling_rate":{"type":"number","minimum":0,"maximum":1,"description":"Fraction of impressions to include (0-1). 1.0 = all impressions, 0.1 = 10% sample. Default: 1.0"}},"required":["url","authentication","delivery_mode"],"additionalProperties":true},"context":{"$ref":"#/$defs/external:core~1context.json"},"ext":{"$ref":"#/$defs/external:core~1ext.json"}},"required":["idempotency_key","account","brand","start_time","end_time"],"additionalProperties":true,"$defs":{"external:core/version-envelope.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/version-envelope.json","title":"AdCP Version Envelope","description":"Release-precision AdCP protocol version negotiation fields. Composed via `allOf` into AdCP request schemas and shared response components so the version semantics live in one place. Strict (`additionalProperties: false`) request schemas also redeclare these two fields in their own `properties` via `$ref`, because draft-07 does not evaluate properties across `allOf`. The Trusted Match match requests are the exception: they inline both fields for their strict privacy boundary. Distinct from `core/protocol-envelope.json`, which wraps responses at the transport layer (context_id / task_id / status / payload). This envelope is part of the payload itself.","type":"object","properties":{"adcp_version":{"type":"string","description":"Release-precision AdCP version (VERSION.RELEASE, e.g. \"3.0\", \"3.1\", \"3.1-beta\"). On a request: the buyer's release pin — the seller validates against its supported_versions and returns VERSION_UNSUPPORTED on cross-major mismatch, or downshifts to the highest supported release within the same major. On a response: the release the seller actually served — clients SHOULD validate the response against that release's schema, not against their pin. Patches are not negotiated; surface them as build_version on capabilities for operational visibility. When omitted, falls back to adcp_major_version (deprecated) or server default. Buyers SHOULD emit both adcp_version and adcp_major_version through 3.x to remain compatible with sellers that only read the legacy field. NORMALIZATION: SDKs that read full-semver values from bundle metadata (e.g. ComplianceIndex.published_version = \"3.1.0-beta.1\") MUST normalize to release-precision (\"3.1-beta.1\") before emitting on the wire — meta-field values are NOT valid wire values.","pattern":"^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?)?$","examples":["3.0","3.1","3.1-beta","3.1-rc.1"]},"adcp_major_version":{"type":"integer","deprecated":true,"x-removed-in":"4.0.0","description":"DEPRECATED in favor of adcp_version (release-precision string). Servers MUST continue to honor this field through 3.x. Removed in 4.0. Original semantics: the AdCP major version the buyer's payloads conform to. Sellers validate against their supported major_versions and return VERSION_UNSUPPORTED if unsupported. When omitted, the seller assumes its highest supported version.","minimum":1,"maximum":99}}},"external:core/account-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/account-ref.json","title":"Account Reference","description":"Reference to an advertiser account by seller-assigned ID or natural key. account_id is the seller/storefront handle returned by list_accounts. The natural key is brand + operator + optional operator_unit.id + optional fixed currency + optional buyer-selected account timezone + sandbox; it describes the advertiser object the seller resolves or provisions. After a capability-gated identity rekey, the former natural key is tombstoned and returns ACCOUNT_MOVED to authorized callers rather than resolving or provisioning another account. brand.countries qualifies the advertiser's geographic identity. operator_unit identifies the operator-owned buying seat or business unit and is distinct from the seller account. operator_unit.name is display metadata and does not participate in identity. Use account_id when the seller or upstream platform owns the canonical account namespace; use the natural key for buyer-declared accounts (require_operator_auth: false).","type":"object","oneOf":[{"properties":{"account_id":{"type":"string","description":"Seller-assigned account identifier. For upstream-managed account namespaces, this value comes from list_accounts; for seller-defined namespaces without a list_accounts surface, it is supplied out-of-band. Buyer-declared account sellers MAY echo account_id from sync_accounts as an internal handle, but they MUST continue accepting the account's current natural-key AccountRef on subsequent calls. Buyers of buyer-declared accounts send the natural key; a seller MAY also accept its echoed account_id, and buyers MUST NOT assume it does. A former key tombstoned by identity reconciliation returns ACCOUNT_MOVED to authorized callers.","x-entity":"account"}},"required":["account_id"],"additionalProperties":false},{"properties":{"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Brand reference identifying the advertiser"},"operator":{"type":"string","description":"Domain of the entity operating on the brand's behalf. When the brand operates directly, this is the brand's domain.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","x-entity":"operator"},"operator_unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1operator-unit.json","description":"Optional operator-owned business unit, agency seat, or platform account. Only id participates in the natural account key; name is mutable display metadata."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"Immutable ISO 4217 transaction currency when the seller's advertiser object is currency-bound. When present, this is part of the natural account key and media buys on the account MUST use it. Omit when currency is selected independently per media buy."},"timezone":{"type":"string","minLength":1,"description":"Immutable account timezone. Include it in the natural key when get_adcp_capabilities.account.timezone declares account_fixed with buyer_selected; omit it for seller_fixed or seller_assigned accounts."},"sandbox":{"type":"boolean","description":"When true, references the sandbox account for this brand/operator pair. Defaults to false (production account).","default":false}},"required":["brand","operator"],"additionalProperties":false}],"examples":[{"account_id":"acc_acme_001"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com"},{"brand":{"domain":"nova-brands.com","brand_id":"spark"},"operator":"pinnacle-media.com"},{"brand":{"domain":"nova-athletics.example","countries":["NL"]},"operator":"nova-athletics.example","operator_unit":{"id":"234284238","name":"Nova EMEA"},"currency":"EUR","timezone":"Europe/Amsterdam"},{"brand":{"domain":"acme-corp.com"},"operator":"acme-corp.com","sandbox":true}]},"external:core/brand-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/brand-ref.json","title":"Brand Reference","description":"Reference to a brand by domain and optional brand_id. The domain hosts /.well-known/brand.json or is registered in the brand registry. For single-brand domains, brand_id can be omitted. For house-of-brands domains, brand_id identifies the specific brand. For creative production, brand.json is the canonical source of master brand identity (logo, palette, fonts, voice, and visual guidelines), subject only to the supported per-call fields in brand_kit_override. Catalogs supply product or item payload; catalog item asset groups, including property- or franchise-level logos, are item identity and do not override these master brand fields.","type":"object","properties":{"domain":{"type":"string","description":"Domain where /.well-known/brand.json is hosted, or the brand's operating domain","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"brand_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-id.json","description":"Brand identifier within the house portfolio. Optional for single-brand domains."},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1,"uniqueItems":true,"description":"Canonical set of ISO 3166-1 alpha-2 countries for this advertiser identity. Omit for a global/default identity. Array order is not meaningful; producers MUST sort codes lexicographically before computing keys or signatures. This qualifies account identity and is not delivery targeting."},"industries":{"type":"array","items":{"type":"string"},"description":"Inline override for the brand's industries. Useful when the caller cannot modify the brand's canonical brand.json but needs to declare industries for governance (e.g., Annex III vertical detection). brand.json remains the canonical source; when omitted here, governance agents SHOULD resolve from brand.json."},"data_subject_contestation":{"type":"object","description":"Inline override for the brand's contestation contact point. Useful when the operator does not control brand.json but needs to discharge Art 22(3) for this plan. brand.json is canonical; when omitted, governance agents resolve brand → house → missing.","properties":{"url":{"type":"string","format":"uri","pattern":"^https://"},"email":{"type":"string","format":"email"},"languages":{"type":"array","items":{"type":"string"}}},"anyOf":[{"required":["url"]},{"required":["email"]}],"additionalProperties":false},"brand_kit_override":{"type":"object","description":"Inline override for brand-kit fields normally resolved from `/.well-known/brand.json` on `domain` (logo, colors, voice, tagline). Use when brand.json is missing, stale, or inappropriate for this specific call — e.g., a campaign-scoped tagline, a co-branded creative, a freshly-rebranded color palette the brand.json hasn't shipped yet. Same inline-override pattern as `industries` and `data_subject_contestation` above: brand.json is canonical, the override is per-call. Adopters needing to override fields outside this subset (`voice_attributes`, `prohibited_terms`, etc.) MUST publish a different brand.json and reference it via a different `domain` — the inline override is intentionally narrow to a small high-traffic subset.\n\n**Merge semantics (normative).** The merge is **field-level**, not whole-object replacement. Each field within `brand_kit_override` (`logo`, `colors`, `voice`, `tagline`) is evaluated independently — when a field is present on the override the override value applies; when a field is absent the brand.json value applies (or is absent if brand.json doesn't carry one either). For composite fields (`colors.primary`, `colors.secondary`, `colors.accent`), the merge is one level deeper: each color slot is evaluated independently — a producer can override `colors.primary` while still inheriting `colors.secondary` from brand.json. SDKs MUST NOT treat a present `brand_kit_override.colors` as wiping the brand.json `colors` block entirely; only the per-slot fields present in the override take precedence. Without this rule, a partial-override semantics would diverge across SDKs and produce inconsistent rendering for the same payload.","properties":{"logo":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1image-asset.json","description":"Override logo asset."},"colors":{"type":"object","description":"Override brand colors (hex strings).","properties":{"primary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"secondary":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"additionalProperties":true},"voice":{"type":"string","description":"Override brand-voice description for surface-composed text/audio output."},"tagline":{"type":"string","description":"Override tagline."}},"additionalProperties":true}},"required":["domain"],"additionalProperties":false,"examples":[{"domain":"nova-brands.com","brand_id":"spark"},{"domain":"nova-brands.com","brand_id":"glow"},{"domain":"acme-corp.com"},{"domain":"nova-athletics.example","countries":["NL"]}]},"external:core/brand-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/brand-id.json","title":"Brand ID","description":"Identifier for a brand within a house portfolio. Must be lowercase alphanumeric with underscores only. The house chooses this identifier.","type":"string","pattern":"^[a-z0-9_]+$","x-entity":"advertiser_brand","examples":["tide","cheerios","air_jordan","nike","pampers"]},"external:core/assets/image-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/image-asset.json","title":"Image Asset","description":"Image asset with URL and dimensions","type":"object","properties":{"asset_type":{"type":"string","const":"image","description":"Discriminator identifying this as an image asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the image asset"},"width":{"type":"integer","minimum":1,"description":"Width in pixels"},"height":{"type":"integer","minimum":1,"description":"Height in pixels"},"file_size_bytes":{"type":"integer","minimum":1,"description":"Image file size in bytes. Required by agents that advertise a max_file_size_kb constraint."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Intrinsic pixels per logical render pixel (for example `2` for a 600×500 image intended to render at 300×250). Optional because a validator can infer the ratio when the target format declares logical dimensions. When supplied, it MUST agree with both `width / logical_width` and `height / logical_height`; it is never a substitute for the intrinsic `width` and `height` fields."},"state_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it). Omit for ordinary image slots."},"breakpoint_id":{"type":"string","description":"Binding used only when this image populates a `seller_rendered_stateful_display` `state_canvases` slot. It MUST match one breakpoint declared on the selected state (semantic validators resolve it). Omit for ordinary image slots."},"focal_point":{"type":"array","items":{"type":"number","minimum":0,"maximum":1},"minItems":2,"maxItems":2,"description":"Normalized `[x, y]` coordinates (0–1 from top-left) of the image's visual anchor. Seller-side renderers crop toward the focal point when deriving renditions across breakpoints and aspect ratios; absent, cropping falls back to center-weighted defaults."},"format":{"type":"string","description":"Image file format (jpg, png, gif, webp, etc.)"},"alt_text":{"type":"string","description":"Alternative text for accessibility","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","width","height"],"additionalProperties":true},"external:core/provenance.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/provenance.json","title":"Provenance","description":"Declares how content was produced, whether AI was involved, and what disclosure obligations apply. Attaches to creative manifests, individual assets, or content-standards artifacts. When present at multiple levels, the most specific provenance object replaces the inherited one entirely (no field-level merging). Provenance is a claim by the declaring party — receiving parties should verify claims independently via their own detection tools.","type":"object","properties":{"digital_source_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1digital-source-type.json","description":"IPTC-aligned classification of AI involvement in producing this content"},"synthetic_depiction":{"type":"boolean","description":"Assessed declaration of whether the content synthetically depicts a real or fictional person performing or appearing in a way that was generated or materially manipulated rather than captured as depicted. `true` covers both a fully synthetic performer and material manipulation of a real performer; `false` is an assessed declaration that the content does not contain such a depiction. Absence means the content has not been assessed for synthetic depiction. This field does not claim consent, legality, or independent verification, and receivers MUST NOT derive it solely from `digital_source_type`."},"ai_tool":{"type":"object","description":"AI system used to generate or modify this content. Aligns with IPTC 2025.1 AI metadata fields and C2PA claim_generator.","properties":{"name":{"type":"string","description":"Name of the AI tool or model (e.g., 'DALL-E 3', 'Stable Diffusion XL', 'Gemini')"},"version":{"type":"string","description":"Version identifier for the AI tool or model (e.g., '25.1', '0125', '2.1'). For generative models, use the model version rather than the API version."},"provider":{"type":"string","description":"Organization that provides the AI tool (e.g., 'OpenAI', 'Stability AI', 'Google')"}},"required":["name"]},"human_oversight":{"type":"string","description":"Level of human involvement in the AI-assisted creation process. Independent of `disclosure.required` — the protocol does not derive disclosure obligations from oversight level. Some regulations include carve-outs for human-edited or human-directed AI output, but those carve-outs have factual prerequisites the schema cannot evaluate. Asserting `edited` or `directed` does not by itself justify `disclosure.required: false`.","enum":["none","prompt_only","selected","edited","directed"],"enumDescriptions":{"none":"Fully automated with no human involvement in generation","prompt_only":"Human provided the prompt or instructions but did not review outputs","selected":"Human selected from multiple AI-generated candidates","edited":"Human edited or refined AI-generated output","directed":"Human directed the creative process with AI as an assistive tool"}},"declared_by":{"type":"object","description":"Party declaring this provenance. Identifies who attached the provenance claim, enabling receiving parties to assess trust.","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent or service that declared this provenance"},"role":{"type":"string","enum":["creator","advertiser","agency","platform","tool"],"description":"Role of the declaring party in the supply chain","enumDescriptions":{"creator":"The party that created or generated the content","advertiser":"The brand or advertiser that owns the content","agency":"Agency acting on behalf of the advertiser","platform":"Ad platform or publisher that processed the content","tool":"Automated tool or service that attached provenance metadata"}}},"required":["role"]},"declared_at":{"type":"string","format":"date-time","description":"When this provenance claim was made (ISO 8601). Distinct from created_time, which records when the content itself was produced. A provenance claim may be attached well after content creation, for example when retroactively declaring AI involvement for regulatory compliance."},"created_time":{"type":"string","format":"date-time","description":"When this content was created or generated (ISO 8601)"},"c2pa":{"type":"object","description":"C2PA sidecar manifest reference. Links to a detached cryptographic provenance manifest for this content. Note: file-level C2PA bindings break when ad servers transcode, resize, or re-encode assets. For pipelines with intermediaries, consider embedded_provenance as the primary provenance mechanism.","properties":{"manifest_url":{"type":"string","format":"uri","description":"URL to the C2PA manifest store for this content"}},"required":["manifest_url"]},"embedded_provenance":{"type":"array","description":"Provenance metadata embedded within the content stream. Each entry declares one embedding layer: structured provenance data carried inside the content itself, as distinct from sidecar references (c2pa.manifest_url). Embedded provenance survives operations that break sidecar and file-level bindings: ad-server transcoding, CMS ingestion, copy-paste, reformatting, and CDN re-encoding. For ad-tech pipelines where content passes through multiple intermediaries, embedded provenance is the reliable path for provenance that persists from declaration through delivery. This is a declaration by the embedding party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1embedded-provenance-method.json","description":"How provenance data is carried within the content"},"standard":{"type":"string","description":"Standard the embedding conforms to, if any (e.g., 'c2pa' for C2PA Section A.7 text manifest embedding)"},"provider":{"type":"string","description":"Organization that performed the embedding (e.g., 'Encypher', 'Digimarc'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this embedding can be verified by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist). MAY be omitted for self-verifiable embeddings (e.g., a C2PA text manifest with a public key the seller already trusts).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to embed/verify this layer. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `encypher.markers_present_v2`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"embedded_at":{"type":"string","format":"date-time","description":"When the provenance data was embedded (ISO 8601)"}},"required":["method","provider"]}},"watermarks":{"type":"array","description":"Content watermarks applied to this asset. Each entry declares one watermarking layer: a content modification that encodes an identifier or fingerprint within the asset. Watermarks differ from embedded provenance: a watermark encodes an identifier (who generated it, who owns it), while embedded provenance carries or references a structured provenance record (the full chain of custody). A single asset may carry both. Aligns with C2PA action taxonomy: c2pa.watermarked.bound (watermark linked to a C2PA manifest) and c2pa.watermarked.unbound (watermark independent of any manifest). This is a declaration by the watermarking party. The receiving party (the seller) is the verifier-of-record: it confirms the claim by calling a governance agent it trusts (typically one published in `creative_policy.accepted_verifiers`).","minItems":1,"items":{"type":"object","properties":{"media_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1watermark-media-type.json","description":"Media category of the watermarked content"},"provider":{"type":"string","description":"Organization that applied the watermark (e.g., 'Imatag', 'Steg.AI', 'Encypher'). Display label and audit context — not a wire identifier."},"verify_agent":{"type":"object","description":"Buyer's representation that this watermark can be detected by a governance agent on the seller's `creative_policy.accepted_verifiers` list. The `agent_url` MUST match (canonicalized) one of the seller's published `accepted_verifiers[].agent_url` entries; sellers reject `sync_creatives` submissions whose `verify_agent.agent_url` is off-list with `PROVENANCE_VERIFIER_NOT_ACCEPTED`. This is buyer-supplied evidence, not buyer-driven routing — the seller is the verifier-of-record and the seller controls which agent it actually calls (the seller MAY use a different on-list agent if it determines this is more appropriate; the seller does not call buyer-asserted endpoints outside its allowlist).","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the governance agent the buyer represents was used to apply/detect this watermark. MUST use the `https://` scheme and MUST appear in the seller's `creative_policy.accepted_verifiers[].agent_url` list (canonicalized per /docs/reference/url-canonicalization: lowercase scheme and host, strip default port, normalize path dot-segments). Sellers MUST NOT call this URL until the canonicalized match is confirmed."},"feature_id":{"type":"string","description":"Optional `feature_id` the buyer represents the seller should request via `get_creative_features` (e.g., `imatag.watermark_detected`). SHOULD match the `feature_id` declared on the matching `accepted_verifiers[]` entry, or be omitted to defer the selector to the seller. When the seller's entry pins a `feature_id`, that value wins; when neither side pins, the seller selects from the agent's `governance.creative_features` catalog."}},"required":["agent_url"],"additionalProperties":false},"c2pa_action":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1c2pa-watermark-action.json","description":"C2PA action classification for this watermark"},"embedded_at":{"type":"string","format":"date-time","description":"When the watermark was applied (ISO 8601)"}},"required":["media_type","provider"]}},"disclosure":{"type":"object","description":"Regulatory disclosure requirements for this content. Indicates whether AI disclosure is required and under which jurisdictions.","properties":{"required":{"type":"boolean","description":"The declaring party's claim that AI disclosure is required for this content under applicable regulations. This is a declared signal carried through the supply chain — useful as a routing and audit input — not a regulatory determination made by the protocol. Receiving parties remain responsible for their own jurisdictional analysis and should not treat `required: false` as compliance cover."},"jurisdictions":{"type":"array","description":"Jurisdictions where disclosure obligations apply","items":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code (e.g., 'US', 'DE', 'CN')"},"region":{"type":"string","description":"Sub-national region code (e.g., 'CA' for California, 'BY' for Bavaria)"},"regulation":{"type":"string","description":"Regulation identifier (e.g., 'eu_ai_act_article_50', 'ca_sb_942', 'cn_deep_synthesis')"},"label_text":{"type":"string","description":"Required disclosure label text for this jurisdiction, in the local language"},"render_guidance":{"type":"object","description":"How the disclosure should be rendered for this jurisdiction. Expresses the declaring party's intent for persistence and position based on regulatory requirements. Publishers control actual rendering but governance agents can audit whether guidance was followed.","minProperties":1,"properties":{"persistence":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-persistence.json","description":"How long the disclosure must persist during content playback or display"},"min_duration_ms":{"type":"integer","minimum":1,"description":"Minimum display duration in milliseconds for initial persistence. Recommended when persistence is initial — without it, the duration is at the publisher's discretion. At serve time the publisher reads this from provenance since the brief is not available."},"positions":{"type":"array","description":"Preferred disclosure positions in priority order. The first position a format supports should be used.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-position.json"},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}}}},"required":["country","regulation"]},"minItems":1}},"required":["required"]},"verification":{"type":"array","description":"Third-party verification or detection results for this content. Multiple services may independently evaluate the same content. Provenance is a claim — verification results attached by the declaring party are supplementary. The enforcing party (e.g., seller/publisher) should run its own verification via get_creative_features or calibrate_content.","minItems":1,"items":{"type":"object","properties":{"verified_by":{"type":"string","description":"Name of the verification service (e.g., 'DoubleVerify', 'Hive Moderation', 'Reality Defender')"},"verified_time":{"type":"string","format":"date-time","description":"When the verification was performed (ISO 8601)"},"result":{"type":"string","enum":["authentic","ai_generated","ai_modified","inconclusive"],"description":"Verification outcome"},"confidence":{"type":"number","minimum":0,"maximum":1,"description":"Confidence score of the verification result (0.0 to 1.0)"},"details_url":{"type":"string","format":"uri","description":"URL to the full verification report"}},"required":["verified_by","result"]}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}}},"external:enums/digital-source-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/digital-source-type.json","title":"Digital Source Type","description":"Classification of AI involvement in content creation, aligned with IPTC digitalsourcetype vocabulary. Used in provenance metadata to declare how a creative asset, artifact, or individual asset was produced.","type":"string","enum":["digital_capture","digital_creation","trained_algorithmic_media","composite_with_trained_algorithmic_media","algorithmic_media","composite_capture","composite_synthetic","human_edits","data_driven_media"],"enumDescriptions":{"digital_capture":"Captured by a digital device (camera, scanner, screen recording) with no AI involvement","digital_creation":"Created by a human using digital tools (Photoshop, Illustrator, After Effects) without AI generation","trained_algorithmic_media":"Generated entirely by a trained AI model (DALL-E, Midjourney, Stable Diffusion, Sora)","composite_with_trained_algorithmic_media":"Human-created content combined with AI-generated elements (e.g., photo with AI background)","algorithmic_media":"Produced by deterministic algorithms without machine learning (procedural generation, rule-based systems)","composite_capture":"Multiple digital captures composited together without AI","composite_synthetic":"Composite of multiple elements where at least one is AI-generated (e.g., stock photo composited with AI-generated background)","human_edits":"Content augmented, corrected, or enhanced by humans using non-generative tools","data_driven_media":"Assembled from structured data feeds (DCO templates, product catalogs, weather-triggered variants)"}},"external:enums/embedded-provenance-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/embedded-provenance-method.json","title":"Embedded Provenance Method","description":"How provenance data is carried within the content stream. Distinguishes between format-level manifest embedding (where the manifest travels inside the file container) and provenance markers (where invisible markers in the content itself encode or reference a provenance record). Both survive operations that strip sidecar metadata, but provenance markers additionally survive content-level transformations such as copy-paste, reformatting, and CMS re-encoding.","type":"string","enum":["manifest_wrapper","provenance_markers"],"enumDescriptions":{"manifest_wrapper":"A provenance manifest embedded in the file container per format-specific rules (e.g., JUMBF box in JPEG, C2PATextManifestWrapper in plaintext per C2PA Section A.7). The manifest travels with the file but is tied to the file's byte structure.","provenance_markers":"Invisible markers embedded within the content stream that encode or reference a provenance record. Designed to survive reformatting, copy-paste, CMS ingestion, and ad-server transcoding that breaks file-level bindings."}},"external:enums/watermark-media-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/watermark-media-type.json","title":"Watermark Media Type","description":"Media category of a content watermark. Identifies what kind of content the watermark is applied to, which determines the detection and verification methods required.","type":"string","enum":["audio","image","video","text"],"enumDescriptions":{"audio":"Watermark applied to audio content (e.g., spread-spectrum, echo hiding)","image":"Watermark applied to image content (e.g., spatial domain, frequency domain)","video":"Watermark applied to video content (e.g., per-frame image watermarking, temporal watermarking)","text":"Watermark applied to text content (e.g., synonym substitution, structural modification)"}},"external:enums/c2pa-watermark-action.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/c2pa-watermark-action.json","title":"C2PA Watermark Action","description":"C2PA action classification for a content watermark. Distinguishes watermarks that are cryptographically linked to a C2PA manifest (bound) from watermarks that exist independently (unbound). Aligns with the c2pa.watermarked.* action family in the C2PA action taxonomy.","type":"string","enum":["c2pa.watermarked.bound","c2pa.watermarked.unbound"],"enumDescriptions":{"c2pa.watermarked.bound":"Watermark linked to a C2PA manifest for this asset. The watermark and manifest are mutually reinforcing: the manifest references the watermark, and the watermark can be used to locate the manifest.","c2pa.watermarked.unbound":"Watermark independent of any C2PA manifest. Applied before any provenance signing event (e.g., by the AI generator at creation time) or in pipelines where no manifest is present."}},"external:enums/disclosure-persistence.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/disclosure-persistence.json","title":"Disclosure Persistence","description":"How long a disclosure must persist during content playback or display. Different jurisdictions and regulations require different persistence behaviors for AI-generated content labels. When multiple sources specify persistence for the same jurisdiction (e.g., brief and provenance), the most restrictive mode applies: continuous > initial > flexible.","type":"string","enum":["continuous","initial","flexible"],"enumDescriptions":{"continuous":"Disclosure must remain visible or audible throughout the entire content display duration. For video and audio, this means the full playback duration. For static formats (display, DOOH), this means the full display slot. For DOOH specifically, 'content duration' means the ad's display slot within the rotation, not the screen's full rotation cycle.","initial":"Disclosure must appear at the start of content for a minimum duration before it may be removed. Pair with min_duration_ms in render_guidance or creative brief to specify the required duration.","flexible":"Disclosure presence is sufficient; placement timing and duration are at the publisher's discretion"}},"external:enums/disclosure-position.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/disclosure-position.json","title":"Disclosure Position","description":"Where a required disclosure should appear within a creative. Used by creative briefs to specify disclosure placement and by formats to declare which positions they can render.","type":"string","enum":["prominent","footer","audio","subtitle","overlay","end_card","pre_roll","companion"]},"external:core/ext.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/ext.json","title":"Extension Object","description":"Extension object for platform-specific, vendor-namespaced parameters. Extensions are always optional and must be namespaced under a vendor/platform key (e.g., ext.gam, ext.roku). Used for custom capabilities, partner-specific configuration, and features being proposed for standardization.","type":"object","additionalProperties":true},"external:core/operator-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/operator-unit.json","title":"Operator Unit","description":"Operator-owned buying context used to distinguish business units, agency seats, or platform accounts beneath one operator domain. The id is stable identity in the operator's namespace; name is mutable display metadata and never participates in account identity.","x-entity":"operator_unit","type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*$","description":"Stable identifier assigned by the operator. Numeric platform IDs and durable slugs are both valid. Scoped by the enclosing operator domain."},"name":{"type":"string","minLength":1,"maxLength":200,"description":"Human-readable seat or business-unit name, such as Nova EMEA. This label may change and is not part of the natural account key."}},"required":["id"],"additionalProperties":false,"examples":[{"id":"234284238","name":"Nova EMEA"},{"id":"benelux-seat","name":"Nova Benelux"}]},"external:core/opportunity-context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/opportunity-context.json","title":"Opportunity Context","description":"Buyer-supplied context for one planning cycle across proposal request, decline, and media-buy creation. The opaque opportunity_id is stable within the seller and account scope; sellers associate it with proposals without treating it as proposal identity.","type":"object","properties":{"opportunity_id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{1,255}$","x-entity":"opportunity","description":"Opaque buyer-assigned identifier for this planning cycle, scoped to the seller and account."},"phase":{"type":"string","enum":["exploratory","planning","active_sourcing"],"description":"Current stage of buyer planning."},"intent":{"type":"string","enum":["test","speculative","planning","live_rfp"],"description":"How seriously the buyer is evaluating supply in this cycle."},"planning_horizon":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1date-range.json","description":"Inclusive calendar range in which the buyer expects the campaign to run."},"response_deadline":{"type":"string","format":"date-time","description":"Deadline by which the buyer needs a seller response."},"status":{"type":"string","enum":["open","closed"],"description":"Whether the planning cycle remains open. On calls after initial creation, omission means no status update and MUST NOT reopen or close the opportunity implicitly, except that successful create_media_buy proposal execution explicitly infers accepted closure."},"close_reason":{"type":"string","enum":["accepted_with_seller","purchased_elsewhere","selected_alternative","not_pursued","budget_changed","timing_changed","other"],"description":"Why the opportunity closed. Required when status is closed."},"close_detail":{"type":"string","minLength":1,"maxLength":500,"description":"Optional non-sensitive context about closure. MUST NOT identify a competitor or disclose confidential clearing terms."}},"required":["opportunity_id"],"allOf":[{"if":{"properties":{"status":{"const":"closed"}},"required":["status"]},"then":{"required":["close_reason"]},"else":{"not":{"anyOf":[{"required":["close_reason"]},{"required":["close_detail"]}]}}},{"if":{"properties":{"close_reason":{"const":"other"}},"required":["close_reason"]},"then":{"required":["close_detail"]}}],"additionalProperties":true},"external:core/date-range.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/date-range.json","title":"Date Range","description":"A date range with inclusive start and end dates (ISO 8601 calendar dates). Used for billing periods, flight dates, and other calendar-day boundaries.","type":"object","properties":{"start":{"type":"string","format":"date","description":"Start date (inclusive), ISO 8601"},"end":{"type":"string","format":"date","description":"End date (inclusive), ISO 8601"}},"required":["start","end"],"additionalProperties":true},"external:core/media-buy-frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/media-buy-frequency-cap.json","title":"Media Buy Frequency Cap","description":"A MediaBuy-level maximum-impression cap. The counter is shared across participating packages for the declared per unit. Duration windows are rolling elapsed windows; campaign spans the MediaBuy flight. Aggregate suppression is not defined in 3.2 because suppress-only FrequencyCap values do not identify a counter entity.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1frequency-cap.json"},{"required":["max_impressions"],"not":{"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]}]}}]},"external:core/frequency-cap.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/frequency-cap.json","title":"Frequency Cap","description":"Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.","type":"object","properties":{"suppress":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {\"interval\": 60, \"unit\": \"minutes\"} for a 1-hour cooldown). Preferred over suppress_minutes."},"suppress_minutes":{"type":"number","deprecated":true,"description":"Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).","minimum":0},"max_impressions":{"type":"integer","description":"Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window. campaign applies across the owning field's full flight: the package flight for a targeting overlay, or the MediaBuy flight for a root cap.","minimum":1},"per":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1reach-unit.json"}],"description":"Entity granularity for impression counting. Required when max_impressions is set."},"window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Time window for the max_impressions cap (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Required when max_impressions is set."}},"anyOf":[{"required":["suppress"]},{"required":["suppress_minutes"]},{"required":["max_impressions"]}],"additionalProperties":true,"dependentRequired":{"max_impressions":["per","window"],"per":["max_impressions"],"window":["max_impressions"]}},"external:core/duration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/duration.json","title":"Duration","description":"A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.","type":"object","properties":{"interval":{"type":"integer","minimum":1,"description":"Number of time units. Must be 1 when unit is 'campaign'."},"unit":{"type":"string","enum":["seconds","minutes","hours","days","campaign"],"description":"Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."}},"required":["interval","unit"],"additionalProperties":false},"external:enums/reach-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/reach-unit.json","title":"Reach Unit","description":"Unit of measurement for reach and audience size metrics. Different channels and measurement providers count reach in fundamentally different units, making cross-channel comparison impossible without declaring the unit.","type":"string","enum":["individuals","households","devices","accounts","cookies","custom"],"enumDescriptions":{"individuals":"Unique people. Panel-based or identity-resolved measurement.","households":"Unique households or TV homes.","devices":"Unique device identifiers (IDFA, GAID, CTV device ID).","accounts":"Unique logged-in accounts (platform-specific identity).","cookies":"Unique browser cookies.","custom":"Seller-defined reach unit. Describe in ext. For a Product.identity declaration with persistent_identifier false, describe the unit in Product.identity.reach_methodology."}},"external:core/budget-allocation.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/budget-allocation.json","title":"Budget Allocation","description":"How a media buy's total budget is allocated across its packages. Omission on a request means fixed allocation (legacy-compatible); buyer agents SHOULD send this block explicitly ({mode: \"fixed\"} or seller_optimized) rather than rely on omission, and SHOULD ask the principal rather than guess when the instruction does not determine whether the budget is one shared pool or split per package. Fixed allocation preserves independent package budgets. Seller-optimized allocation delegates continuous cross-package allocation to the seller within the media-buy total, package caps, minimum-spend targets, flight windows, and pacing controls. The core seller-optimized contract is gated by media_buy.features.seller_optimized_budget; package caps, minimum-spend targets, and package pacing are separately gated by seller_optimized_package_budgets, seller_optimized_min_spend_targets, and seller_optimized_package_pacing; an undeclared package control is rejected with UNSUPPORTED_FEATURE before any over-subscription validation. Core seller-optimized pacing guarantees only omitted or `even` media-buy pacing; sellers MAY reject `asap` or `front_loaded` with UNSUPPORTED_FEATURE and MUST NOT coerce them to `even`. When a seller-optimized media-buy BiddingPolicy carries cost_per or roas, that control binds to this allocation block's primary optimization goal rather than independently to each package goal.","x-adcp-hoist":true,"discriminator":{"propertyName":"mode"},"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"fixed","description":"Packages have independent budgets. The seller does not automatically move budget between packages."}},"required":["mode"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"seller_optimized","description":"Packages draw from a shared media-buy budget. The seller continuously allocates spend across packages to optimize the declared goals."},"optimization_goals":{"type":"array","description":"Goals the seller uses to allocate the shared budget across packages. These are distinct from packages[].optimization_goals, which optimize delivery within an individual package. The primary goal is the earliest array entry among goals with the lowest explicit numeric priority; goals without priority follow all explicitly prioritized goals; when all priorities are omitted, the first entry is primary. It supplies the result unit/value source for media-buy bidding.cost_per or bidding.roas. Legacy monetary target kinds are prohibited at allocation scope because canonical controls belong in media-buy bidding. Every participating product MUST support the primary cross-package goal; otherwise the seller MUST reject the request with TERMS_REJECTED or UNSUPPORTED_FEATURE and identify the incompatible package.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1optimization-goal.json"},{"not":{"properties":{"target":{"properties":{"kind":{"enum":["cost_per","per_ad_spend"]}},"required":["kind"]}},"required":["target"]}}]},"minItems":1}},"required":["mode","optimization_goals"],"additionalProperties":false}]},"external:core/optimization-goal.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/optimization-goal.json","title":"Optimization Goal","description":"A single objective function: what to maximize or optimize, in what units, and in what priority order. Used on packages to optimize delivery within one package and on seller-optimized budget allocations to allocate spend across packages. Currency-bearing execution policy belongs in BiddingPolicy in 3.2. Legacy target.cost_per and target.per_ad_spend remain accepted only on package goals for migration and are deprecated. The primary goal is the earliest array entry among goals with the lowest explicit numeric priority; goals without priority follow all explicitly prioritized goals; when all priorities are omitted, the first entry is primary. This array-order tie-break makes duplicate priorities deterministic.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","description":"Optimize for a seller-tracked delivery metric. No event source required — the seller tracks these natively.","properties":{"kind":{"type":"string","const":"metric"},"metric":{"type":"string","enum":["clicks","views","completed_views","viewed_seconds","viewable_rate","attention_seconds","attention_score","engagements","follows","saves","profile_visits","reach"],"description":"Seller-native metric to optimize for. Delivery metrics: clicks (link clicks, swipe-throughs, CTA taps that navigate away), views (content views at the billable view threshold, as defined by delivery-metrics `views`; for viewability use viewable_rate), completed_views (video/audio completions — see view_duration_seconds), reach (unique audience reach — see reach_unit and target_frequency). Duration/score metrics: viewed_seconds (time in view per impression — reported back via `delivery-metrics.viewability.viewed_seconds`, governed by the viewability `standard`). Quality-rate metrics: viewable_rate (viewable / measurable impressions under the goal's `standard`; requires `standard`). Audience action metrics: engagements (any direct interaction with the ad unit beyond viewing — social reactions/comments/shares, story/unit opens, interactive overlay taps, companion banner interactions on audio and CTV), follows (new followers, page likes, artist/podcast/channel follows, or free channel/feed subscribes; paid subscriptions use event_type: subscribe), saves (saves, bookmarks, playlist adds, pins — signals of intent to return), profile_visits (visits to the brand's in-platform page — profile, artist page, channel, or storefront. Does not include external website clicks, which are covered by 'clicks'). **DEPRECATED values** (slated for removal at next major): `attention_seconds` and `attention_score` — these have no industry-graduated definition (DoubleVerify, IAS, Adelaide, TVision, Lumen each define them differently) and cannot be meaningfully optimized for without a vendor binding. Use `kind: 'vendor_metric'` with an explicit `vendor` and `metric_id` instead — that path binds the goal to a specific measurement vendor and reconciles to the same `(vendor, metric_id)` key in delivery's `vendor_metric_values[]`. Sellers MAY reject the deprecated values with `TERMS_REJECTED` and a suggestion to use the `vendor_metric` kind."},"standard":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json"}],"description":"Viewability standard the goal is judged against. Required when metric is 'viewable_rate'; optional for 'viewed_seconds' (seller default standard when omitted); not allowed for other metrics. Must be in metric_optimization.supported_viewability_standards when declared. A goal below a same-standard viewability performance_standard never relaxes that standard."},"vendor":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"}],"description":"Measurement vendor judging a viewable_rate or viewed_seconds goal; not allowed for other metrics. When omitted, the seller's default viewability measurement applies. Sellers MUST reject a vendor they cannot optimize against rather than substitute another."},"reach_unit":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1reach-unit.json"}],"description":"Unit for reach measurement. Required when metric is 'reach'. Must be a value declared in the product's metric_optimization.supported_reach_units."},"target_frequency":{"type":"object","description":"Target frequency band for reach optimization. Only applicable when metric is 'reach'. Frames frequency as an optimization signal: the seller should treat impressions toward entities already within the [min, max] band as lower-value, and impressions toward unreached entities as higher-value. This shifts budget toward fresh reach rather than re-reaching known users. When omitted, the seller maximizes unique reach without a frequency constraint. A hard cap can still be layered via targeting_overlay.frequency_cap if a ceiling is needed.","properties":{"min":{"type":"integer","minimum":1,"description":"Minimum frequency for an entity to be considered meaningfully reached within the window. Impressions that would bring an entity below this threshold are treated as high-value (growing reach). When omitted, the seller uses their platform default (typically 1)."},"max":{"type":"integer","minimum":1,"description":"Frequency at which an entity is considered saturated within the window. Impressions toward entities at or above this threshold are treated as lower-value. When both min and max are present, max must be greater than or equal to min. When omitted, the seller determines the saturation point."},"window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Time window over which frequency is measured (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Weekly windows are typical for brand campaigns; daily windows suit high-cadence direct response."}},"required":["window"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"view_duration_seconds":{"type":"number","exclusiveMinimum":0,"description":"Minimum video view duration in seconds that qualifies as a completed_view for this goal. Only applicable when metric is 'completed_views'. When omitted, the seller uses their platform default (typically 2–15 seconds). Common values: 2 (Snap/LinkedIn default), 6 (TikTok), 15 (Snap 15-second views, Meta ThruPlay). Sellers declare which durations they support in metric_optimization.supported_view_durations. Sellers must reject goals with unsupported values — silent rounding would create measurement discrepancies."},"target":{"description":"Target for this metric. When omitted, the seller optimizes for maximum metric volume within budget.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","deprecated":true,"description":"DEPRECATED legacy target cost per unit of the metric. Normalize to package.bidding.cost_per with strength target while retaining this goal as the objective.","properties":{"kind":{"type":"string","const":"cost_per"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target cost per metric unit in the buy currency"}},"required":["kind","value"],"additionalProperties":true},{"type":"object","description":"Minimum per-impression rate for this metric. The metric defines the units: proportions for count metrics (e.g., 0.001 for 0.1% CTR, 0.70 for 70% viewable_rate), seconds for duration metrics (e.g., 3.0 for 3s in view), or score for score metrics.","properties":{"kind":{"type":"string","const":"threshold_rate"},"value":{"type":"number","exclusiveMinimum":0,"description":"Minimum per-impression value. Units depend on the metric: proportion (clicks, views, completed_views, viewable_rate), seconds (viewed_seconds, attention_seconds), or score (attention_score)."}},"required":["kind","value"],"additionalProperties":true}]},"priority":{"type":"integer","minimum":1,"description":"Relative priority among sibling goals. Lower numbers rank first. Goals without priority follow explicitly prioritized goals. Ties use array order, so the earliest goal at the lowest explicit priority is primary; when all priorities are omitted, the first goal is primary."}},"required":["kind","metric"],"allOf":[{"if":{"properties":{"metric":{"const":"viewable_rate"}},"required":["metric"]},"then":{"required":["standard"],"properties":{"target":{"properties":{"kind":{"const":"threshold_rate"},"value":{"maximum":1}}}}}},{"if":{"properties":{"metric":{"enum":["viewable_rate","viewed_seconds"]}},"required":["metric"]},"else":{"not":{"anyOf":[{"required":["standard"]},{"required":["vendor"]}]}}}],"additionalProperties":true},{"type":"object","description":"Optimize for advertiser-tracked conversion events. Requires event sources registered via sync_event_sources.","properties":{"kind":{"type":"string","const":"event"},"event_sources":{"type":"array","description":"Event source and type pairs that feed this goal. Each entry identifies a source and event type to include. When the seller supports multi_source_event_dedup (declared in get_adcp_capabilities), they deduplicate by event_id across all entries — the same business event from multiple sources counts once, using value_field and value_factor from the first matching entry. When multi_source_event_dedup is false or absent, buyers should use a single entry per goal; the seller will use only the first entry. All event sources must be configured via sync_event_sources.","items":{"type":"object","properties":{"event_source_id":{"type":"string","minLength":1,"description":"Event source to include (must be configured on this account via sync_event_sources)"},"event_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1event-type.json","description":"Event type to include from this source (e.g., purchase, lead, app_install, refund)"},"custom_event_name":{"type":"string","description":"Required when event_type is 'custom'. Platform-specific name for the custom event."},"value_field":{"type":"string","description":"Which field in the event's custom_data carries the monetary value. The seller must use this field for value extraction and aggregation when computing ROAS and conversion value metrics. Required on at least one entry when target.kind is 'per_ad_spend' or 'maximize_value' — sellers must reject these target kinds when no event source entry includes value_field. When canonical bidding.roas binds to this goal, every referenced value-bearing source MUST declare value_currencies containing the media-buy currency; the seller validates this at buy creation. Once that source contract is declared, log_event rejects monetary records whose currency is missing or absent from the list. For each buy, only records exactly matching its media-buy currency contribute to ROAS; records in other declared currencies remain available to matching buys, and sellers MUST NOT convert between them. When present without a value-oriented target, the seller may use it for delivery reporting but must not change the objective. Common values: 'value', 'order_total', 'profit_margin'. This is not passed as a parameter to underlying platform APIs — the seller maps it to their platform's value ingestion mechanism."},"value_factor":{"type":"number","default":1,"description":"Unit-scaling multiplier the seller must apply to value_field before aggregation. Use -1 for refund events (negate the value), 0.01 for values in cents, -0.01 for refunds in cents. It MUST NOT be used for currency conversion. A value of 0 zeroes out this source's value contribution (the source still counts for event dedup). Defaults to 1. This is not passed as a parameter to underlying platform APIs — the seller applies it when computing aggregated value metrics."}},"required":["event_source_id","event_type"],"additionalProperties":true},"minItems":1},"target":{"description":"Target cost or return for this event goal. When omitted, the seller optimizes for maximum conversion count within budget — regardless of whether value_field is present on event sources. The presence of value_field alone does not change the optimization objective; it only makes value available for reporting. An explicit target of maximize_value or per_ad_spend is required to steer toward value.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","deprecated":true,"description":"DEPRECATED legacy target cost per conversion event. Normalize to package.bidding.cost_per with strength target while retaining this event goal as the objective.","properties":{"kind":{"type":"string","const":"cost_per"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target cost per event in the buy currency"}},"required":["kind","value"],"additionalProperties":true},{"type":"object","deprecated":true,"description":"DEPRECATED legacy target return per unit of ad spend. Normalize to package.bidding.roas with strength target while retaining this event goal and its value-bearing event source. Requires value_field on at least one event_sources entry.","properties":{"kind":{"type":"string","const":"per_ad_spend"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target return ratio (e.g., 4.0 means $4 of value per $1 spent)"}},"required":["kind","value"],"additionalProperties":true},{"type":"object","description":"Maximize total conversion value within budget, without a specific return ratio target. Steers spend toward higher-value conversions rather than maximizing conversion count. Requires value_field on at least one event_sources entry.","properties":{"kind":{"type":"string","const":"maximize_value"}},"required":["kind"],"additionalProperties":true}]},"attribution_window":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attribution-window.json"}],"description":"Attribution window for this optimization goal — references the canonical `attribution-window` shape (post_click, post_view, model). Values must match an option declared in the seller's `conversion_tracking.attribution_windows` capability. Sellers MUST reject windows not in their declared capabilities. When the entire field is omitted, the seller uses their default window."},"priority":{"type":"integer","minimum":1,"description":"Relative priority among sibling goals. Lower numbers rank first. Goals without priority follow explicitly prioritized goals. Ties use array order, so the earliest goal at the lowest explicit priority is primary; when all priorities are omitted, the first goal is primary."}},"required":["kind","event_sources"],"additionalProperties":true},{"type":"object","description":"Optimize for a vendor-attested measurement metric. Use when the metric has no graduated industry-standard definition and must be reconciled to a specific vendor — e.g., attention (DoubleVerify, IAS, Adelaide, TVision, Lumen), panel-based brand lift (Kantar, Upwave, Cint), emissions (Scope3, Good-Loop), retail-media partner metrics. The vendor + metric_id pair binds buyer→seller→vendor end-to-end: the seller's bidding stack steers toward this specific vendor's measurement, and delivery reports the value via `vendor_metric_values[]` with the same `(vendor, metric_id)` key. Three preconditions for goal acceptance: (1) Discovery — the `metric_id` SHOULD appear in the vendor's published `measurement.metrics[]` catalog (queried from the vendor's `brand.json` `agents[type='measurement']`). Sellers SHOULD verify against a cached snapshot of the vendor's capability response; staleness handling is implementation-defined. SHOULD this minor while measurement-vendor adoption of AdCP-conformant capability publication catches up; tightens to MUST at the next minor. (2) Capability — the `(vendor, metric_id)` pair MUST appear in the product's `vendor_metric_optimization.supported_metrics[]`, and the goal's `target.kind` MUST appear in that entry's `supported_targets`. (3) Reporting coherence — the package's `committed_metrics[]` MUST include a matching `{ scope: 'vendor', vendor, metric_id }` entry. Sellers MUST reject goals failing the capability or reporting-coherence preconditions. Optimization without committed reporting is unverifiable and is therefore disallowed at the wire level. Precondition checks are seller-runtime; the schema's `required` only validates structural presence of `kind`, `vendor`, and `metric_id`.","properties":{"kind":{"type":"string","const":"vendor_metric"},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor that defines and computes this metric. Same shape as `vendor_metric_values.vendor`, `reporting_capabilities.vendor_metrics[].vendor`, and `vendor_metric_optimization.supported_metrics[].vendor` — symmetric across discovery, capability, commitment, optimization, and reporting surfaces."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1vendor-metric-id.json","description":"Identifier for the metric within the vendor's vocabulary (e.g., `attention_score`, `attention_seconds`, `gco2e_per_impression`, `awareness_lift`). MUST be present in the vendor's published `measurement.metrics[]` catalog and in the product's `vendor_metric_optimization.supported_metrics[]`."},"target":{"description":"Target for this vendor metric. When omitted, the seller optimizes for maximum metric volume / score within budget. `cost_per` and `threshold_rate` semantics mirror the same target kinds on the `metric` kind — units are vendor-defined and depend on the vendor's `measurement.metrics[]` declaration for this `metric_id`.","discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","deprecated":true,"description":"DEPRECATED legacy target cost per vendor-metric unit. Normalize to package.bidding.cost_per with strength target while retaining this vendor-metric goal as the objective.","properties":{"kind":{"type":"string","const":"cost_per"},"value":{"type":"number","exclusiveMinimum":0,"description":"Target cost per metric unit in the buy currency. Units of the metric are vendor-defined."}},"required":["kind","value"],"additionalProperties":true},{"type":"object","description":"Minimum per-impression value for this vendor metric (e.g., attention_score ≥ 70).","properties":{"kind":{"type":"string","const":"threshold_rate"},"value":{"type":"number","exclusiveMinimum":0,"description":"Minimum per-impression value. Units of the metric are vendor-defined."}},"required":["kind","value"],"additionalProperties":true}]},"priority":{"type":"integer","minimum":1,"description":"Relative priority among sibling goals. Lower numbers rank first. Goals without priority follow explicitly prioritized goals. Ties use array order, so the earliest goal at the lowest explicit priority is primary; when all priorities are omitted, the first goal is primary."}},"required":["kind","vendor","metric_id"],"additionalProperties":true}]},"external:enums/viewability-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/viewability-standard.json","title":"Viewability Standard","description":"Viewability measurement standard applied to determine whether an impression qualifies as viewable. These are materially different thresholds and should not be compared across standards.","type":"string","enum":["mrc","groupm"],"enumDescriptions":{"mrc":"MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).","groupm":"GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."}},"external:enums/event-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/event-type.json","title":"Event Type","description":"Standard marketing event types for event logging, aligned with IAB ECAPI","type":"string","enum":["page_view","view_content","select_content","select_item","search","share","add_to_cart","remove_from_cart","viewed_cart","add_to_wishlist","initiate_checkout","add_payment_info","purchase","refund","lead","qualify_lead","close_convert_lead","disqualify_lead","complete_registration","subscribe","follow","content_view","watch_milestone","start_trial","app_install","app_launch","contact","schedule","donate","submit_application","custom"],"enumDescriptions":{"page_view":"User viewed a page","view_content":"User viewed specific content (product, article, etc.)","select_content":"User selected or clicked on content (article, video, etc.)","select_item":"User selected a specific product or item from a list","search":"User performed a search","share":"User shared content via social or messaging","add_to_cart":"User added an item to cart","remove_from_cart":"User removed an item from cart","viewed_cart":"User viewed their shopping cart","add_to_wishlist":"User added an item to a wishlist","initiate_checkout":"User started checkout process","add_payment_info":"User added payment information","purchase":"User completed a purchase","refund":"A purchase was fully or partially refunded (adjusts ROAS)","lead":"User expressed interest (form submission, signup, etc.)","qualify_lead":"Lead qualified by sales or scoring criteria","close_convert_lead":"Lead converted to a customer or closed deal","disqualify_lead":"Lead disqualified or marked as not viable","complete_registration":"User completed account registration","subscribe":"User started a paid subscription or paid membership","follow":"User made a free, durable opt-in to an account, channel, feed, list, podcast, or similar owned property","content_view":"User meaningfully consumed a content unit, such as a watch, listen, stream, episode play, or read","watch_milestone":"User reached a content progress threshold, such as 25%, 50%, 75%, 100%, or a seconds-viewed milestone","start_trial":"User started a free trial","app_install":"User installed an application","app_launch":"User launched an application","contact":"User initiated contact (call, message, etc.)","schedule":"User scheduled an appointment or event","donate":"User made a donation","submit_application":"User submitted an application (loan, job, etc.)","custom":"Custom event type (specify in custom_event_name)"}},"external:core/attribution-window.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/attribution-window.json","title":"Attribution Window","description":"Describes the attribution methodology and lookback windows used for conversion measurement. Enables cross-platform comparison by making attribution methodology transparent. Used as a `$ref` from `optimization-goal.json` (buyer's optimization-time attribution choice), `get-media-buy-delivery-response.json` (seller-declared attribution methodology in delivery reports), and similar surfaces. All fields are optional individually but at least one of `post_click`, `post_view`, or `model` SHOULD be populated; absence of `model` means the seller's default attribution model applies (typically `last_touch` per industry convention) — sellers SHOULD populate `model` explicitly when committing to a specific methodology.","type":"object","properties":{"post_click":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Post-click attribution window. Conversions occurring within this duration after a click are attributed to the ad."},"post_view":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"}],"description":"Post-view attribution window. Conversions occurring within this duration after an ad impression (without click) are attributed to the ad."},"model":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1attribution-model.json","description":"Attribution model used to assign credit when multiple touchpoints exist. SHOULD be populated when committing to a specific model; when absent, the seller's default applies."}},"additionalProperties":true},"external:enums/attribution-model.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/attribution-model.json","title":"Attribution Model","description":"Attribution model used for conversion measurement","type":"string","enum":["last_touch","first_touch","linear","time_decay","data_driven"]},"external:core/vendor-metric-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/vendor-metric-id.json","title":"Vendor Metric ID","description":"Identifier for a vendor-defined metric within the vendor's vocabulary. Stable lookup key; the vendor publishes the canonical list (with category, methodology, and standard alignment) in `brand.json` `agents[type='measurement']`. Lowercase with underscores so a future enum promotion into `available-metric.json` is a literal string lift. Identifier is namespaced by the vendor — the same `metric_id` may mean different things in different vendors' vocabularies.","type":"string","x-entity":"vendor_metric","minLength":1,"maxLength":64,"pattern":"^[a-z][a-z0-9_]*$","examples":["attention_units","gco2e_per_impression","demographic_reach","co_view_index","incremental_lift_percent"]},"external:media-buy/package-request.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/media-buy/package-request.json","title":"Package Request","description":"Package configuration for media buy creation.\n\n**Format selector contract (normative).** New 3.2 buyers author at most one canonical selector route: `format_option_refs`, or `format_kind` with optional `params`; omitting both selects all formats supported by the product. New buyers MUST NOT emit deprecated `format_ids`. During the 3.x compatibility window, receivers MUST continue to accept legacy-only `format_ids` and older requests that carry more than one selector route.\n\nReceivers process selectors in this order: (1) independently resolve each present route to canonical declarations, without applying route precedence; an unresolved `format_option_ref` or a legacy `format_id` that cannot be normalized through the canonical mapping path MUST be rejected with `UNSUPPORTED_FEATURE`; (2) when every route resolves, derive the product `format_options[]` entries selected by each route using directional product satisfaction, and require the selected option sets to match; legacy-to-canonical parameter compatibility uses the asymmetric [v2 narrows v1](/docs/creative/canonical-formats#narrows-formal-definition-normative) relation, not raw object equality; (3) reject different format shapes, selected option sets, or incompatible dimensions with `CONFLICTING_SELECTORS`; and only then (4) apply precedence: `format_option_refs`, then `format_kind` plus `params`, then `format_ids`. Equivalent legacy dual emission remains valid. A single resolved route that does not satisfy the product is rejected with `UNSUPPORTED_FEATURE`. `params` requires `format_kind`; for fixed-size image selectors, `width` and `height` MUST either both be present or both be absent.","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1version-envelope.json"},{"if":{"required":["bidding"]},"then":{"properties":{"optimization_goals":{"not":{"contains":{"properties":{"target":{"properties":{"kind":{"enum":["cost_per","per_ad_spend"]}},"required":["kind"]}},"required":["target"]}}}}}},{"if":{"properties":{"format_kind":{"const":"image"}},"required":["format_kind","params"]},"then":{"properties":{"params":{"dependentRequired":{"width":["height"],"height":["width"]}}}}}],"not":{"anyOf":[{"required":["capability_ids"]},{"required":["bidding","bid_price"]},{"required":["budget_cap_timezone"]}]},"properties":{"product_id":{"type":"string","description":"Opaque configured product ID returned by get_products. Selecting it accepts the product's disclosed targeting_resolution, pricing, forecast assumptions, and terms. Sellers MUST echo this value on every response package object that represents this requested package.","x-entity":"product"},"format_ids":{"type":"array","deprecated":true,"x-removed-in":"4.0.0","description":"Deprecated in AdCP 3.2; removed in AdCP 4.0. Legacy named-format selector retained for older 3.x peers. New buyers MUST NOT emit this field. Sellers MUST normalize every entry through the canonical mapping path before product satisfaction checks; an entry that cannot be normalized is rejected with `UNSUPPORTED_FEATURE` before any equivalence check. When this field coexists with `format_option_refs` or `format_kind` plus `params`, sellers MUST compare the product option sets selected by each resolved route. Legacy parameter compatibility follows the asymmetric v2-narrows-v1 relation defined by canonical formats, not raw object equality. Different format shapes, selected option sets, or incompatible dimensions are rejected with `CONFLICTING_SELECTORS`; sellers MUST NOT silently ignore the legacy projection. Equivalent dual emission remains valid during the 3.x compatibility window. If omitted and no canonical selector is present, all formats supported by the product are active.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-id.json"},"minItems":1},"format_option_refs":{"type":"array","description":"Canonical 3.2 format-option selector. Each reference matches one target product `format_options[]` entry. Publisher-backed options match `{ scope: \"publisher\", publisher_domain, format_option_id }`; product-local options match `{ scope: \"product\", format_option_id }`. Sellers reject unresolved options with `UNSUPPORTED_FEATURE` and a field path to the failing entry before comparing co-present routes. New buyers MUST use this route by itself and MUST NOT dual-emit either a direct canonical selector or deprecated `format_ids`. Receivers handling older 3.x multi-route requests MUST resolve every present route, require each route to select the same product option set, and reject disagreement with `CONFLICTING_SELECTORS` before treating `format_option_refs` as authoritative.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-option-ref.json"},"minItems":1},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Canonical 3.2 direct selector. Names the canonical format shape this package targets when the buyer is not selecting a published `format_option_ref`. Pair with `params` for dimensions, duration, codecs, or other constraints. New buyers MUST NOT combine this route with `format_option_refs` or deprecated `format_ids`. Receivers handling older 3.x multi-route requests MUST equivalence-check every present route before applying precedence and reject disagreement with `CONFLICTING_SELECTORS`. Product satisfaction is directional: broad `{ format_kind: \"image\" }` does not satisfy a fixed-size product declaration."},"params":{"type":"object","description":"Parameters for the direct canonical selector in `format_kind`. Shape follows the selected canonical's parameter vocabulary: dimensions (`width`, `height`, `sizes`), duration (`duration_ms_exact`, `duration_ms_range`), codecs, asset-source and slot narrowing, or other canonical-specific constraints. Requires `format_kind`. For fixed-size image selectors, `width` and `height` MUST co-occur; a selector containing only one dimension is schema-invalid. New buyers omit `params` when selecting by `format_option_refs` or `format_ids`; older multi-route requests are accepted only when every route selects the same product option set.","additionalProperties":true},"budget":{"type":"number","description":"Hard lifetime spend cap for this package in the media buy's currency. Required in fixed allocation mode. Optional in seller-optimized mode; when omitted, the package is bounded by the shared total_budget and any other package constraints. In seller-optimized mode this is a ceiling, not a reserved or current allocation, and requires advertised media_buy.features.seller_optimized_package_budgets; otherwise rejected with UNSUPPORTED_FEATURE before any over-subscription validation.","minimum":0},"min_spend_target":{"type":"number","description":"Soft lifetime spend target for this package in the media buy's currency. Only valid with seller-optimized budget allocation. Requires advertised media_buy.features.seller_optimized_min_spend_targets; otherwise rejected with UNSUPPORTED_FEATURE before any over-subscription validation. The seller SHOULD attempt to deliver at least this amount before allocating incremental spend elsewhere, but inventory, policy, optimization targets, or other delivery constraints may prevent it. This is not a billing guarantee. Must not exceed the package budget when both are present; a seller advertising both seller_optimized_min_spend_targets and seller_optimized_package_budgets MUST reject a violation with `INVALID_REQUEST`, while a seller missing either capability rejects the undeclared control with UNSUPPORTED_FEATURE before any over-subscription validation.","minimum":0},"pacing":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1pacing.json","description":"Package pacing, subordinate to media-buy pacing. In seller-optimized mode, pacing that differs from the media-buy pacing requires advertised media_buy.features.seller_optimized_package_pacing; otherwise rejected with UNSUPPORTED_FEATURE."},"pricing_option_id":{"type":"string","description":"ID of the selected pricing option from the product's pricing_options array","x-entity":"product_pricing_option"},"bid_price":{"type":"number","deprecated":true,"description":"DEPRECATED in 3.2 and removed in the next major. Use bidding.bid_amount or bidding.max_bid. Legacy normalization: selected pricing_option.max_bid=true maps to bidding.max_bid; otherwise maps to bidding.bid_amount. A package MUST NOT supply both representations.","minimum":0},"bidding":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1bidding-policy.json"}],"description":"Package-authored bidding policy. This complete block replaces, rather than field-merges with, any media-buy bidding policy for this package. `{automatic:true}` explicitly overrides a media-buy policy with provider automatic bidding; omission inherits the complete media-buy block. Monetary fields use the media-buy currency, while the selected pricing option supplies only the auction unit and MUST declare that same currency. Sellers MUST reject a new bidding block combined with legacy bid_price or legacy monetary optimization-goal targets on the same effective package with AMBIGUOUS_BIDDING_POLICY."},"impressions":{"type":"number","description":"Impression goal for this package","minimum":0},"daily_budget_cap":{"type":"number","minimum":0,"description":"Optional hard package daily spend ceiling in the media-buy currency. It is subordinate, not a reserved allocation; package caps need not sum to the aggregate cap. Uses the media buy's cap timezone. Requires advertised package budget-capping scope; otherwise rejected with UNSUPPORTED_FEATURE."},"start_time":{"type":"string","format":"date-time","not":{"const":"asap"},"description":"Flight start date/time for this package in ISO 8601 format. When omitted, the package inherits the media buy's start_time. Must fall within the media buy's date range."},"end_time":{"type":"string","format":"date-time","description":"Flight end date/time for this package in ISO 8601 format. When omitted, the package inherits the media buy's end_time. Must fall within the media buy's date range."},"paused":{"type":"boolean","description":"Whether this package should be created in a paused state. Paused packages do not deliver impressions. Defaults to false.","default":false},"catalogs":{"type":"array","description":"Catalogs this package promotes. Each catalog MUST have a distinct type (e.g., one product catalog, one store catalog). This constraint is enforced at the application level — sellers MUST reject requests containing multiple catalogs of the same type with a validation_error. Makes the package catalog-driven: one budget envelope, platform optimizes across items.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1catalog.json"}},"optimization_goals":{"type":"array","description":"Optimization targets for this package. The seller optimizes delivery toward these goals in priority order. Common pattern: event goals (purchase, install) as primary targets at priority 1; metric goals (clicks, views) as secondary proxy signals at priority 2+.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1optimization-goal.json"},"minItems":1},"targeting_overlay":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-input.json","description":"Optional package-specific targeting input with three states per dimension. Omission inherits targeting already bound to the configured product, a non-null value replaces that dimension, and null explicitly suppresses the configured/product default for that dimension. Null cannot remove inherent product scope: sellers reject a clear the product cannot execute rather than silently retaining the default. Non-null fields MUST be declared in the product's overlay_support unless they were already accepted during discovery. The one fixed-inventory restatement exception is placement_selection equal to the product's complete, explicitly enumerated mode: included placement set: that set is an inherent exact match across discovery, create, and update and does not require overlay_support.placement_selection; partial selection still requires a selectable product. Opaque property_list and collection_list references have no equivalent exception because their membership can change independently and cannot be proven equal from the product wire representation. Package readback echoes the complete effective targeting without null dimensions. A supported value with no current inventory returns PRODUCT_UNAVAILABLE rather than a silent substitute or reprice."},"audience_evidence_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1audience-evidence-requirements.json","description":"Buyer policy that the selected product and constructed package MUST satisfy using product audience evidence. This remains planning and suitability evidence, not a targeting instruction. Sellers MUST reject an unsatisfied required policy rather than silently drop it, and a confirmed package MUST include every evidence snapshot used to satisfy this policy in audience_evidence_selections with decision_use package_construction."},"audience_evidence_pins":{"type":"array","description":"Exact immutable evidence snapshots selected by the buyer during discovery. The seller MUST match evidence_id, snapshot_id, version, and content_digest against one published snapshot and MUST reject catalog mutation, snapshot reuse, missing snapshots, or substitutions. Every accepted pin MUST be echoed in the confirmed package's audience_evidence_selections with decision_use package_construction.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1audience-evidence-pin.json"},"minItems":1},"measurement_terms":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1measurement-terms.json","description":"Buyer's proposed billing measurement and makegood terms. Overrides product defaults. Seller accepts (echoed on confirmed package), rejects with TERMS_REJECTED, or adjusts. When absent, product's measurement_terms apply."},"performance_standards":{"type":"array","description":"Buyer's proposed performance standards for this package. Overrides product defaults. Seller accepts, rejects with TERMS_REJECTED, or adjusts. When absent, product's performance_standards apply.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1performance-standard.json"},"minItems":1},"committed_metrics":{"type":"array","description":"Buyer's proposed reporting contract for this package — the metrics the buyer wants the seller to commit to populating in delivery reports. Same negotiation pattern as `measurement_terms` and `performance_standards`: seller accepts (echoes on confirmed package with `committed_at` stamped), rejects with `TERMS_REJECTED` (with explanation of which entries were unworkable), or normalizes (echoes a different but compatible list — buyer can accept by retrying with the normalized terms). When absent, the seller decides what to commit based on the product's `available_metrics` and the buyer's `required_metrics` filter on `get_products`. Each entry uses an explicit `scope` discriminator (`standard` or `vendor`) and identifies the metric — request-side entries do NOT carry `committed_at`; that timestamp is stamped by the seller on accept. Constraints on what the buyer MAY propose: each `scope: standard` entry's `metric_id` MUST be in the product's `available_metrics`, and each `scope: vendor` entry's `(vendor, metric_id)` MUST appear in the product's `vendor_metrics` — sellers SHOULD reject with `TERMS_REJECTED` and reference the offending entry when the proposal exceeds product capability.","items":{"type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"properties":{"scope":{"type":"string","const":"standard","description":"Standard metric from the closed `available-metric.json` enum."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1available-metric.json","description":"Identifier for the standard metric. MUST be present in the product's `reporting_capabilities.available_metrics`."},"qualifier":{"type":"object","description":"Disambiguator — same shape as on the response-side `committed_metrics`. Required when the buyer wants to pin a specific measurement path: `viewability_standard` for MRC vs GroupM viewability; `completion_source` for seller- vs vendor-attested `completion_rate`; `attribution_methodology` for how attribution was computed (deterministic_purchase, probabilistic, panel_based, modeled); `attribution_window` for the time window over which outcomes are attributed. See response-side description for full semantics.","properties":{"viewability_standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json"},"completion_source":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1completion-source.json"},"attribution_methodology":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1attribution-methodology.json"},"attribution_window":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"},"lift_dimension":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1lift-dimension.json"}},"additionalProperties":false}},"required":["scope","metric_id"],"additionalProperties":false},{"properties":{"scope":{"type":"string","const":"vendor","description":"Vendor-defined metric, identified by the tuple `(vendor, metric_id)`."},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor that defines and computes this metric. The vendor's `brand.json` `agents[type='measurement']` is the canonical anchor."},"metric_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1vendor-metric-id.json","description":"Identifier for the metric within the vendor's vocabulary. MUST be present in the product's `reporting_capabilities.vendor_metrics` for the same vendor."},"methodology_version":{"type":"string","description":"Optional buyer-proposed pin of the vendor's `measurement.metrics[].methodology_version`. The seller accepts by echoing it on the confirmed package's `committed_metrics` entry, normalizes to the version it can actually deliver, or rejects with `TERMS_REJECTED`. Opaque string — equality comparison only."},"qualifier":{"type":"object","description":"Optional disambiguator for vendor metrics committed under more than one methodology or window — same closed key set as standard-scope entries.","properties":{"viewability_standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json"},"completion_source":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1completion-source.json"},"attribution_methodology":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1attribution-methodology.json"},"attribution_window":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"},"lift_dimension":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1lift-dimension.json"}},"additionalProperties":false}},"required":["scope","vendor","metric_id"],"additionalProperties":false}]},"minItems":1},"creative_assignments":{"type":"array","description":"Assign existing library creatives to this package with optional rotation, grouping, weights, and placement targeting. rotation_mode is package-scoped: omission resolves to weighted, and every assignment MUST resolve to the same effective mode. In sequential mode, sequence_position MUST be unique within each package-local group. Sellers reject conflicts with VALIDATION_ERROR before creating the package.","x-adcp-validation":{"verifier_constraints":{"package_rotation_policy":{"effective_mode":"assignment.rotation_mode_or_weighted_default","mode_consistency":"all_assignments_equal","sequence_positions":"required_and_unique_per_effective_group_when_sequential","effective_group":"assignment.group_id_or_package_default","group_namespace":"package_id","on_violation":"reject_before_mutation_with_VALIDATION_ERROR"}},"spec":"docs/reference/migration/creatives.mdx#rotation-modes-and-groups"},"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-assignment.json"},"minItems":1},"creatives":{"type":"array","description":"Upload creative assets inline and assign to this package. Native localization is not accepted on this path; use sync_creatives before assigning the library creative. When the seller also advertises creative.has_creative_library: true, these creatives enter the seller's creative library and can be reused by creative_id while retained; inline-only sellers may store them as package-scoped assets. Use creative_assignments instead for existing library creatives.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-asset.json"},{"not":{"required":["localization"]}}]},"minItems":1,"maxItems":100},"agency_estimate_number":{"type":"string","maxLength":100,"description":"Agency estimate or authorization number for this package. Overrides the media buy-level estimate number when different packages correspond to different agency estimates (e.g., different stations or flights within the same buy)."},"context":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1context.json","description":"Opaque package-level correlation data echoed unchanged in the package response, webhooks, and read surfaces. Buyers targeting mixed seller populations SHOULD include a per-package correlation value here, commonly context.buyer_ref, so responses from legacy sellers that do not echo product_id can still be mapped back to the requested product or line item. Do not use deprecated top-level buyer_ref for v3 correlation."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["product_id","pricing_option_id"],"additionalProperties":true,"dependentRequired":{"params":["format_kind"]}},"external:core/format-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/format-id.json","title":"Format Reference (Structured Object)","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format reference retained for 3.x compatibility. This JSON object — never a plain string — identifies a format by its declaring agent and local slug, and may carry legacy logical dimensions, pixel ratio, or duration parameters. New products and manifests use canonical `format_options`, `format_kind`, and `format_option_ref`; creative-agent build routing uses `creative.supported_formats[].capability_id`.","x-entity":"creative_format","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent that defines this format (e.g., 'https://creative.adcontextprotocol.org' for standard formats, or 'https://publisher.com/.well-known/adcp/sales' for custom formats). Callers comparing two `format-id` values MUST canonicalize `agent_url` per the AdCP URL canonicalization rules before treating two formats as the same. See docs/reference/url-canonicalization."},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Format identifier within the agent's namespace (e.g., 'display_static', 'video_hosted', 'audio_standard'). When used alone, references a template format. When combined with dimension/duration fields, creates a parameterized format ID for a specific variant."},"width":{"type":"integer","minimum":1,"description":"Width in pixels for visual formats. When specified, height must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"height":{"type":"integer","minimum":1,"description":"Height in pixels for visual formats. When specified, width must also be specified. Both fields together create a parameterized format ID for dimension-specific variants."},"duration_ms":{"type":"number","minimum":1,"description":"Duration in milliseconds for time-based formats (video, audio). When specified, creates a parameterized format ID. Omit to reference a template format without parameters."},"pixel_ratio":{"type":"number","exclusiveMinimum":0,"description":"Required intrinsic-pixel density for a parameterized visual format, expressed as intrinsic pixels per logical pixel. Requires `width` and `height`. Example: `{id: \"display_image\", width: 300, height: 250, pixel_ratio: 2}` identifies a 300×250 logical render supplied by a 600×500 image. Omit for the backward-compatible 1x variant."}},"required":["agent_url","id"],"additionalProperties":true,"dependentRequired":{"width":["height"],"height":["width"],"pixel_ratio":["width","height"]}},"external:core/format-option-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/format-option-ref.json","title":"Format Option Reference","description":"Discriminated reference to a product format option. The global canonical shape is still named by `format_kind`; this reference selects one concrete product `format_options[]` entry. `scope: \"publisher\"` identifies a publisher-declared catalog option by `{ publisher_domain, format_option_id }`. `scope: \"product\"` identifies a product-local option by `format_option_id`; the enclosing package/product context supplies the namespace.","type":"object","discriminator":{"propertyName":"scope"},"oneOf":[{"title":"Publisher Catalog Format Option Reference","description":"Selects a publisher-catalog-backed product format option by publisher domain and format option ID.","type":"object","properties":{"scope":{"type":"string","const":"publisher","description":"Reference resolves against the named publisher's adagents.json top-level `formats[]` catalog."},"publisher_domain":{"type":"string","description":"Publisher domain where the adagents.json declaring this format option is hosted.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"format_option_id":{"type":"string","description":"Stable format option ID from the publisher's adagents.json top-level `formats[]`, matching a publisher-catalog-backed entry in the target product's `format_options[]`."}},"required":["scope","publisher_domain","format_option_id"],"additionalProperties":true},{"title":"Product-Local Format Option Reference","description":"Selects a product-local format option by ID within the enclosing package/product context. This branch deliberately forbids `publisher_domain` (`publisher_domain: false` in the schema) because product-local references are namespaced by the enclosing product only; include `scope: \"publisher\"` when the selector must cross into a publisher catalog.","type":"object","properties":{"scope":{"type":"string","const":"product","description":"Reference resolves only against the target product's inline `format_options[]`."},"format_option_id":{"type":"string","description":"Stable format option ID from the target product's inline `format_options[]`."},"publisher_domain":false},"required":["scope","format_option_id"],"additionalProperties":true}],"additionalProperties":true},"external:core/canonical-format-kind.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/canonical-format-kind.json","title":"Canonical Format Kind","description":"Discriminator naming one of the 15 AdCP 3.2 canonical creative formats, plus `custom` for adopter-defined shapes. AdCP 3.2 adds `audio_vast` for VAST-tag-delivered audio (the standards-conformant profile starts at VAST 4.1, with older versions available only as seller-declared legacy interoperability) and promotes the legacy `multi_state_display` and `multi_placement_takeover` custom shapes to `seller_rendered_stateful_display` and `coordinated_placements`. When `format_kind` is `custom`, the declaration also carries `format_shape` and `format_schema`. The enum mirrors the branches in `product-format-declaration.json` and is closed for producer validation: sellers do not mint ad-hoc values. SDKs may retain unknown future values in tolerant in-memory parsers, but that does not change versioned JSON Schema validation. A seller responding to a 3.1-or-earlier request MUST project away 3.2-only kinds and emit a compatible legacy declaration; a strict older schema correctly rejects an unprojected newer kind. See adcp#3666 and the promotion migration contract in canonical-formats.mdx.","type":"string","enum":["image","html5","display_tag","image_carousel","video_hosted","video_vast","audio_hosted","audio_vast","audio_daast","sponsored_placement","native_in_feed","responsive_creative","agent_placement","seller_rendered_stateful_display","coordinated_placements","custom"]},"external:enums/pacing.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/pacing.json","title":"Pacing","description":"Budget pacing strategy","type":"string","enum":["even","asap","front_loaded"],"enumDescriptions":{"even":"Allocate remaining budget evenly over remaining campaign duration (default)","asap":"Spend remaining budget as quickly as possible","front_loaded":"Allocate more remaining budget earlier in the remaining campaign period"}},"external:core/bidding-policy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/bidding-policy.json","title":"Bidding Policy","description":"Buyer-authored execution policy for automatic delivery, auction bidding, average outcome cost, or return on ad spend. The containing object determines authored scope: media-buy `bidding` is a complete inherited default and package `bidding` is a complete package override. Sellers MUST preserve authored scope on readback and MUST NOT copy an inherited media-buy policy into package `bidding`. Every monetary field in this block is denominated in the media-buy currency; the selected pricing option supplies the auction unit, never another denomination. Auction-unit identity is the pricing_model plus every canonical billing-event qualifier after defaults are applied: for example CPV view threshold, CPP demographic system/demographic, CPA event tuple, time time_unit, and flat-rate/DOOH parameters. An extension qualifier participates only when its registered extension specification explicitly defines how it contributes to auction-unit identity. A media-buy bid_amount or max_bid is valid only when every inheriting package resolves the same auction-unit identity. Every affected pricing option MUST use the media-buy currency; split currency-mismatched packages into separate buys. Seller-optimized media-buy cost_per/roas bind to the primary budget_allocation.optimization_goals goal. Package-authored cost_per/roas bind to the package primary optimization goal. The primary goal is the earliest array entry among goals with the lowest explicit numeric priority; unprioritized goals follow explicitly prioritized goals; when all priorities are absent, the first entry is primary. In fixed allocation, an inherited media-buy cost_per is valid only when all inheriting packages have compatible primary-goal result units; inherited roas requires value-bearing primary goals on every inheriting package. Canonical ROAS requires each value-bearing event source to declare the media-buy currency in value_currencies; each buy consumes only exact-currency records and sellers MUST NOT convert them. Absence invokes inheritance or provider automatic delivery; `{automatic:true}` is an explicit authored policy that overrides inheritance. Sellers MUST reject unsupported modes, combinations, units, currency, goal bindings, or native placements before any provider mutation and MUST NOT silently translate semantics.","type":"object","properties":{"automatic":{"type":"boolean","const":true,"description":"Explicitly use seller/provider automatic bidding at this authored scope. At package scope this is a complete override of a media-buy policy, not inheritance. It MUST be the only field in the block and MUST be preserved on readback."},"bid_amount":{"type":"number","exclusiveMinimum":0,"description":"Manual auction bid denominated in the media-buy currency and expressed per the selected pricing option's auction unit. For example, a CPM option interprets the amount per thousand impressions. This is the amount submitted to the auction, not a promise that the clearing price equals it. Requires an auction-priced pricing option whose currency equals the media-buy currency."},"max_bid":{"type":"number","exclusiveMinimum":0,"description":"Hard per-auction ceiling denominated in the media-buy currency and expressed per the selected pricing option's auction unit. This is the only canonical hard auction ceiling and MUST NOT be translated into an average outcome-cost control. Requires an auction-priced pricing option whose currency equals the media-buy currency. May stand alone or supplement cost_per/roas only when the relevant scope capability advertises that combination."},"cost_per":{"type":"object","description":"Average cost control per result of the scope-bound primary optimization goal. At seller-optimized media-buy scope it binds to budget_allocation.optimization_goals; at package scope it binds to that package's optimization_goals; at fixed media-buy scope it binds independently to each inheriting package and is valid only when their primary-goal result units are compatible. Metric goals are compatible only when metric and every result-defining qualifier match; vendor_metric goals only when vendor and metric_id match; event goals only when the event_type/custom_event_name set and resolved attribution_window match. Primary is the earliest array entry among goals tied for the lowest explicit numeric priority; unprioritized goals follow explicitly prioritized goals; when all priorities are absent, the first entry is primary.","properties":{"amount":{"type":"number","exclusiveMinimum":0,"description":"Average cost amount per scope-bound primary-goal result, denominated in the media-buy currency."},"strength":{"type":"string","enum":["cap","target"],"description":"`cap` optimizes for an average at or below the amount and accepts underdelivery when necessary; `target` optimizes around the amount while balancing volume and spend. Neither is a per-result or per-auction guarantee."}},"required":["amount","strength"],"additionalProperties":false},"roas":{"type":"object","description":"Dimensionless return-on-ad-spend control bound to the same scope-specific primary goal rules as cost_per. The bound goal must be value-bearing; a fixed media-buy default requires a value-bearing primary goal on every inheriting package. Every referenced value-bearing event source MUST declare value_currencies containing the media-buy currency. The seller validates this at buy creation; each buy consumes only exact-currency records, while other declared currencies remain available to other buys. Sellers MUST NOT perform currency conversion.","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Return per unit of ad spend; 4 means 4 units of value per 1 unit spent."},"strength":{"type":"string","enum":["floor","target"],"description":"`floor` prefers underdelivery to knowingly optimizing below the requested return; `target` optimizes around the requested return. Neither guarantees realized return."}},"required":["value","strength"],"additionalProperties":false}},"minProperties":1,"allOf":[{"not":{"anyOf":[{"required":["automatic","bid_amount"]},{"required":["automatic","max_bid"]},{"required":["automatic","cost_per"]},{"required":["automatic","roas"]},{"required":["bid_amount","max_bid"]},{"required":["bid_amount","cost_per"]},{"required":["bid_amount","roas"]},{"required":["cost_per","roas"]}]}}],"additionalProperties":false},"external:core/catalog.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/catalog.json","title":"Catalog","description":"A typed data feed. Catalogs carry the items, locations, stock levels, or pricing that publishers use to render ads. They can be synced to a platform via sync_catalogs (managed lifecycle with approval), provided inline, or fetched from an external URL. The catalog type determines the item schema and can be structural (offering, product, inventory, store, promotion) or vertical-specific (hotel, flight, job, vehicle, real_estate, education, destination, app). Selectors (ids, tags, category, query) filter items regardless of sourcing method.","type":"object","properties":{"catalog_id":{"type":"string","description":"Buyer's identifier for this catalog. Required when syncing via sync_catalogs. When used in creatives, references a previously synced catalog on the account.","x-entity":"catalog"},"name":{"type":"string","description":"Human-readable name for this catalog (e.g., 'Summer Products 2025', 'Amsterdam Store Locations')."},"type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1catalog-type.json","description":"Catalog type. Structural types: 'offering' (AdCP Offering objects), 'product' (ecommerce entries), 'inventory' (stock per location), 'store' (physical locations), 'promotion' (deals and pricing). Vertical types: 'hotel', 'flight', 'job', 'vehicle', 'real_estate', 'education', 'destination', 'app' — each with an industry-specific item schema."},"url":{"type":"string","format":"uri","description":"URL to an external catalog feed. The platform fetches and resolves items from this URL. For offering-type catalogs, the feed contains an array of Offering objects. For other types, the feed format is determined by feed_format. When omitted with type 'product', the platform uses its synced copy of the brand's product catalog."},"feed_format":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1feed-format.json","description":"Format of the external feed at url. Required when url points to a non-AdCP feed (e.g., Google Merchant Center XML, Meta Product Catalog). Omit for offering-type catalogs where the feed is native AdCP JSON."},"update_frequency":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1update-frequency.json","description":"How often the platform should re-fetch the feed from url. Only applicable when url is provided. Platforms may use this as a hint for polling schedules."},"items":{"type":"array","description":"Inline catalog data. The item schema depends on the catalog type: Offering objects for 'offering', StoreItem for 'store', HotelItem for 'hotel', FlightItem for 'flight', JobItem for 'job', VehicleItem for 'vehicle', RealEstateItem for 'real_estate', EducationItem for 'education', DestinationItem for 'destination', AppItem for 'app', or freeform objects for 'product', 'inventory', and 'promotion'. Mutually exclusive with url — provide one or the other, not both. Implementations should validate items against the type-specific schema.","items":{"type":"object"},"minItems":1},"ids":{"type":"array","description":"Filter catalog to exact canonical item keys. The key field is offering_id for offering, store_id for store, hotel_id for hotel, flight_id for flight, job_id for job, vehicle_id for vehicle, listing_id for real_estate, program_id for education, destination_id for destination, and app_id for app. Product, inventory, and promotion catalogs use the stable normalized source identifier retained during ingestion (for example a retailer SKU). The same canonical key is used by catalog availability item_id.","items":{"type":"string"},"minItems":1},"gtins":{"type":"array","description":"Filter product-type catalogs by GTIN identifiers for cross-retailer catalog matching. Accepts standard GTIN formats (GTIN-8, UPC-A/GTIN-12, EAN-13/GTIN-13, GTIN-14). Only applicable when type is 'product'.","items":{"type":"string","pattern":"^[0-9]{8,14}$"},"minItems":1},"tags":{"type":"array","description":"Filter catalog to items with these tags. Tags are matched using OR logic — items matching any tag are included.","items":{"type":"string"},"minItems":1},"category":{"type":"string","description":"Filter catalog to items in this category (e.g., 'beverages/soft-drinks', 'chef-positions')."},"query":{"type":"string","description":"Natural language filter for catalog items (e.g., 'all pasta sauces under $5', 'amsterdam vacancies')."},"conversion_events":{"type":"array","description":"Event types that represent conversions for items in this catalog. Declares what events the platform should attribute to catalog items — e.g., a job catalog converts via submit_application, a product catalog via purchase. The event's content_ids field carries the item IDs that connect back to catalog items. Use content_id_type to declare what identifier type content_ids values represent.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1event-type.json"},"minItems":1,"uniqueItems":true},"content_id_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1content-id-type.json","description":"Identifier type that the event's content_ids field should be matched against for items in this catalog. For example, 'gtin' means content_ids values are Global Trade Item Numbers, 'sku' means retailer SKUs. Omit when using a custom identifier scheme not listed in the enum."},"feed_field_mappings":{"type":"array","description":"Declarative normalization rules for external feeds. Maps non-standard feed field names, date formats, price encodings, and image URLs to the AdCP catalog item schema. Applied during sync_catalogs ingestion. Supports field renames, named transforms (date, divide, boolean, split), static literal injection, and assignment of image URLs to typed asset pools.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1catalog-field-mapping.json"},"minItems":1}},"required":["type"],"additionalProperties":true,"examples":[{"description":"Synced product catalog from Google Merchant Center","data":{"catalog_id":"gmc-primary","name":"Primary Product Feed","type":"product","url":"https://feeds.acmecorp.com/products.xml","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inventory feed for store-level stock data","data":{"catalog_id":"store-inventory","name":"Store Inventory","type":"inventory","url":"https://feeds.acmecorp.com/inventory.json","feed_format":"custom","update_frequency":"hourly"}},{"description":"Store locator feed","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","url":"https://feeds.acmecorp.com/stores.json","feed_format":"custom","update_frequency":"weekly"}},{"description":"Promotional pricing feed","data":{"catalog_id":"summer-sale","name":"Summer Sale Promotions","type":"promotion","url":"https://feeds.acmecorp.com/promotions.json","feed_format":"google_merchant_center","update_frequency":"daily"}},{"description":"Inline offering catalog (no sync needed)","data":{"type":"offering","items":[{"offering_id":"summer-sale","name":"Summer Sale","landing_url":"https://acme.com/summer"}]}},{"description":"Reference to a previously synced catalog by ID","data":{"catalog_id":"gmc-primary","type":"product","ids":["SKU-12345","SKU-67890"]}},{"description":"Product catalog with GTIN cross-retailer matching and attribution","data":{"type":"product","gtins":["00013000006040","00013000006057"],"content_id_type":"gtin","conversion_events":["purchase","add_to_cart"]}},{"description":"Inline store catalog with catchment areas","data":{"catalog_id":"retail-locations","name":"Retail Locations","type":"store","items":[{"store_id":"amsterdam-flagship","name":"Amsterdam Flagship","location":{"lat":52.3676,"lng":4.9041},"catchments":[{"catchment_id":"walk","travel_time":{"value":10,"unit":"min"},"transport_mode":"walking"},{"catchment_id":"drive","travel_time":{"value":15,"unit":"min"},"transport_mode":"driving"}]}]}}]},"external:enums/catalog-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/catalog-type.json","title":"Catalog Type","description":"The type of catalog feed. Determines the item schema and how the platform resolves catalog items. Multiple catalog types can be synced to the same account and referenced together in creatives.","type":"string","enum":["offering","product","inventory","store","promotion","hotel","flight","job","vehicle","real_estate","education","destination","app"]},"external:enums/feed-format.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/feed-format.json","title":"Feed Format","description":"Catalog feed formats. Determines how the platform (seller) parses items from an external feed URL. Each named value is an externally-documented feed specification a seller parses natively without buyer-supplied feed_field_mappings; values are vendor spec names (proper nouns), not semantic categories. Use `custom` + feed_field_mappings for any feed whose shape is not one of the named formats.","type":"string","enum":["google_merchant_center","facebook_catalog","shopify","linkedin_jobs","tiktok_shop","pinterest_catalog","openai_product_feed","custom"],"enumDescriptions":{"google_merchant_center":"Google Merchant Center / Google Shopping product data specification — the de-facto e-commerce product-feed lingua franca that the other named commerce formats derive from.","facebook_catalog":"Meta (Facebook / Instagram) product catalog feed — a Google-Merchant-Center-derived dialect, the closest clone of the GMC field set.","shopify":"Shopify product feed export.","linkedin_jobs":"LinkedIn job-posting feed (XML).","tiktok_shop":"TikTok Shop product catalog feed — a GMC-derived dialect with material deltas (sku_id as the primary identifier rather than id, and a first-class video_link) that a GMC parser keyed on id would mis-parse.","pinterest_catalog":"Pinterest product catalog feed — a GMC-derived dialect with stricter serialization (composite-encoded price and shipping, a mandatory google_product_category, space-delimited availability enums) that a strict GMC parser would mis-handle.","openai_product_feed":"OpenAI Commerce product feed for ChatGPT shopping — a GMC-derived dialect adding ChatGPT-specific eligibility flags (is_eligible_search / is_eligible_checkout / is_eligible_ads). Spec: https://developers.openai.com/commerce/specs/file-upload/products","custom":"A feed whose shape is not one of the named formats above. The buyer MUST supply feed_field_mappings to normalize it to the AdCP catalog item schema."}},"external:enums/update-frequency.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/update-frequency.json","title":"Update Frequency","description":"Frequency of product catalog updates","type":"string","enum":["realtime","hourly","daily","weekly"]},"external:enums/content-id-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/content-id-type.json","title":"Content ID Type","description":"Identifier type used in content_ids on conversion events to match back to catalog items. Omit when the identifier type is custom or not listed here.","type":"string","enum":["sku","gtin","offering_id","job_id","hotel_id","flight_id","vehicle_id","listing_id","store_id","program_id","destination_id","app_id"]},"external:core/catalog-field-mapping.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/catalog-field-mapping.json","title":"Catalog Field Mapping","description":"Declares how a field in an external feed maps to the AdCP catalog item schema. Used in sync_catalogs feed_field_mappings to normalize non-AdCP feeds (Google Merchant Center, LinkedIn Jobs XML, hotel XML, etc.) to the standard catalog item schema without requiring the buyer to preprocess every feed. Multiple mappings can assemble a nested object via dot notation (e.g., separate mappings for price.amount and price.currency).","type":"object","properties":{"feed_field":{"type":"string","description":"Field name in the external feed record. Omit when injecting a static literal value (use the value property instead)."},"catalog_field":{"type":"string","description":"Target field on the catalog item schema, using dot notation for nested fields (e.g., 'name', 'price.amount', 'location.city'). Mutually exclusive with asset_group_id."},"asset_group_id":{"type":"string","description":"Places the feed field value (a URL) into a typed asset pool on the catalog item's assets array. The value is wrapped as an image or video asset in a group with this ID. Use standard group IDs: 'images_landscape', 'images_vertical', 'images_square', 'logo', 'video'. Mutually exclusive with catalog_field."},"value":{"description":"Static literal value to inject into catalog_field for every item, regardless of what the feed contains. Mutually exclusive with feed_field. Useful for fields the feed omits (e.g., currency when price is always USD, or a constant category value)."},"transform":{"type":"string","description":"Named transform to apply to the feed field value before writing to the catalog schema. See transform-specific parameters (format, timezone, by, separator).","enum":["date","divide","boolean","split"]},"format":{"type":"string","description":"For transform 'date': the input date format string (e.g., 'YYYYMMDD', 'MM/DD/YYYY', 'DD-MM-YYYY'). Output is always ISO 8601 (e.g., '2025-03-01'). Uses Unicode date pattern tokens."},"timezone":{"type":"string","description":"For transform 'date': the timezone of the input value. IANA timezone identifier (e.g., 'UTC', 'America/New_York', 'Europe/Amsterdam'). Defaults to UTC when omitted."},"by":{"type":"number","description":"For transform 'divide': the divisor to apply (e.g., 100 to convert integer cents to decimal dollars).","exclusiveMinimum":0},"separator":{"type":"string","description":"For transform 'split': the separator character or string to split on. Defaults to ','.","default":","},"default":{"description":"Fallback value to use when feed_field is absent, null, or empty. Applied after any transform would have been applied. Allows optional feed fields to have a guaranteed baseline value."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"allOf":[{"not":{"required":["feed_field","value"]}},{"not":{"required":["catalog_field","asset_group_id"]}}],"additionalProperties":true,"examples":[{"description":"Simple field rename","data":{"feed_field":"hotel_name","catalog_field":"name"}},{"description":"Date format transform — YYYYMMDD to ISO 8601","data":{"feed_field":"available_from","catalog_field":"valid_from","transform":"date","format":"YYYYMMDD","timezone":"UTC"}},{"description":"Divide cents to dollars","data":{"feed_field":"price_cents","catalog_field":"price.amount","transform":"divide","by":100}},{"description":"Static literal injection — currency not in feed","data":{"catalog_field":"price.currency","value":"USD"}},{"description":"Image URL assigned to typed asset pool","data":{"feed_field":"primary_photo_url","asset_group_id":"images_landscape"}},{"description":"Vertical photo URL assigned to vertical pool","data":{"feed_field":"portrait_photo_url","asset_group_id":"images_vertical"}},{"description":"Split comma-separated tags to array","data":{"feed_field":"amenity_list","catalog_field":"amenities","transform":"split","separator":","}},{"description":"Boolean coercion with default","data":{"feed_field":"is_available","catalog_field":"available","transform":"boolean","default":false}}]},"external:core/targeting-input.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting-input.json","title":"Targeting Overlay Input","description":"Request-only targeting mutation input. Each known dimension has three states: omission inherits the product default on create or leaves the stored dimension unchanged on update; null explicitly suppresses the product default on create or clears the stored dimension on update; and a non-null value replaces that dimension and MUST satisfy the corresponding strict targeting.json constraint. Null is a command and MUST NOT appear in discovery criteria, accepted commercial terms, package responses, or package readback. Sellers apply all supplied dimensions atomically and return only the resulting non-null effective targeting state.","type":"object","properties":{"geo_countries":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_countries"},{"type":"null"}]},"geo_countries_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_countries_exclude"},{"type":"null"}]},"geo_regions":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_regions"},{"type":"null"}]},"geo_regions_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_regions_exclude"},{"type":"null"}]},"geo_metros":{"title":"Targeting Geo Metros","type":["array","null"],"description":"Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-metro.json"},"minItems":1},"geo_metros_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_metros_exclude"},{"type":"null"}]},"geo_postal_areas":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_postal_areas"},{"type":"null"}]},"geo_postal_areas_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_postal_areas_exclude"},{"type":"null"}]},"geo_places":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_places"},{"type":"null"}]},"geo_places_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_places_exclude"},{"type":"null"}]},"daypart_targets":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/daypart_targets"},{"type":"null"}]},"axe_include_segment":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/axe_include_segment"},{"type":"null"}]},"axe_exclude_segment":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/axe_exclude_segment"},{"type":"null"}]},"audience_include":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/audience_include"},{"type":"null"}]},"audience_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/audience_exclude"},{"type":"null"}]},"signal_targeting_groups":{"anyOf":[{"title":"Targeting Signal Groups","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting-groups.json","description":"Basic Boolean grouping for seller-offered signals. v1 supports a required top-level operator 'all' and child groups with operator 'any' for include groups or 'none' for exclusion groups. Example semantics: group 1 any(A, B) plus group 2 none(C, D) means (A OR B) AND NOT (C OR D). Signal entries reference named signal definitions with signal_ref scope 'product' for product-local signal options or scope 'data_provider' for external signals published in adagents.json signals[]. For simple include-only targeting, send one child group with operator 'any'. Sellers SHOULD reject entries that are not available for the product through inline signal_targeting_options or get_signals, are not active for the account, or exceed the product's signal_targeting_allowed/signal_targeting_rules/product terms. Signal targeting limits are product-scoped, not declared in get_adcp_capabilities, because products may be backed by different ad servers. Sellers MUST echo applied signal_targeting_groups on the resulting package state, including fixed/default selections. Sellers MAY return REQUOTE_REQUIRED when a targeting mutation changes commercial terms."},{"type":"null"}]},"signal_targeting":{"type":["array","null"],"description":"DEPRECATED. Use signal_targeting_groups for package-level signal targeting. Legacy flat signal_targeting remains accepted during the SignalRef migration window but cannot express grouped include/exclude composition or product-scoped pricing.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-targeting.json"},"minItems":1},"demographics":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/demographics"},{"type":"null"}]},"frequency_cap":{"anyOf":[{"title":"Targeting Frequency Cap","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1frequency-cap.json"},{"type":"null"}]},"property_list":{"anyOf":[{"title":"Targeting Property List","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false."},{"type":"null"}]},"property_list_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/property_list_exclude"},{"type":"null"}]},"collection_list":{"anyOf":[{"title":"Targeting Collection List","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for including specific collections (programs, publications, channels) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities."},{"type":"null"}]},"collection_list_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/collection_list_exclude"},{"type":"null"}]},"placement_selection":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/placement_selection"},{"type":"null"}]},"collection_selection":{"anyOf":[{"title":"Targeting Collection Selection","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-selection.json","description":"Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},{"type":"null"}]},"age_restriction":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/age_restriction"},{"type":"null"}]},"device_platform":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_platform"},{"type":"null"}]},"device_platform_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_platform_exclude"},{"type":"null"}]},"device_type":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_type"},{"type":"null"}]},"device_type_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/device_type_exclude"},{"type":"null"}]},"browser":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/browser"},{"type":"null"}]},"browser_exclude":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/browser_exclude"},{"type":"null"}]},"store_catchments":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/store_catchments"},{"type":"null"}]},"geo_proximity":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting.json/properties/geo_proximity"},{"type":"null"}]},"language":{"title":"Targeting Languages","type":["array","null"],"description":"Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1},"keyword_targets":{"title":"Targeting Keywords","type":["array","null"],"description":"Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1match-type.json"},"bid_price":{"type":"number","minimum":0,"description":"Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."}},"required":["keyword","match_type"],"additionalProperties":false},"minItems":1},"negative_keywords":{"title":"Targeting Negative Keywords","type":["array","null"],"description":"Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1negative-keyword.json"},"minItems":1}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-unknown-age-eligibility-constraint.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-verified-age-basis-constraint.json"}],"additionalProperties":true},"external:core/targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting.json","title":"Targeting Overlay","description":"Strict non-null targeting state used during product discovery, commercial snapshots, and media-buy readback. Targeting includes both audience eligibility and purchased-inventory selection: geography, demographics, placements, properties, collections, device compatibility, language, keywords, and other explicit controls. Sellers resolve requested outcomes against inherent product scope or selectable execution. Request-side create and update mutations use targeting-input.json so null can explicitly clear one dimension; resolved effective targeting omits cleared dimensions and MUST NOT contain null. A fresh create/update request MUST be applied exactly or rejected; get_products may instead return a request-scoped configured product with sparse, buyer-reviewable targeting_resolution modifications.","x-adcp-validation":{"disjoint_place_fields":{"include":"geo_places","exclude":"geo_places_exclude","identity":["country","system","place_type","value"]},"description":"JSON Schema draft-07 cannot compare values across sibling arrays. Conformance tooling MUST reject any place identity present in both geo_places and geo_places_exclude. Catalog version is deliberately not part of place identity: a stable ID cannot be both included and excluded by assigning different versions."},"type":"object","properties":{"geo_countries":{"type":"array","description":"Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_countries_exclude":{"type":"array","description":"Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').","items":{"type":"string","pattern":"^[A-Z]{2}$"},"minItems":1},"geo_regions":{"type":"array","description":"Restrict delivery to exact canonical ISO 3166-2 subdivisions (states, provinces, regions, departments, or other subdivision categories). Unknown identifiers are invalid. At create or update, sellers MUST reject unsupported identifiers and MUST NOT silently widen, drop, or partially apply the list. During get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome. Exact internal translation preserves accepted identifiers in package readback.","items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_regions_exclude":{"type":"array","description":"Exclude exact canonical ISO 3166-2 subdivisions. Support is independent from geo_regions inclusion support. Unknown identifiers and values also present in geo_regions are invalid. At create or update, sellers MUST reject unsupported identifiers and partial application; during get_products, a seller may instead return a sparse, buyer-reviewable targeting_resolution modification for a valid but unsupported requested outcome.","x-adcp-validation":{"disjoint_with":"geo_regions","spec":"docs/media-buy/advanced-topics/targeting.mdx#geo_regions_exclude"},"items":{"type":"string","pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$"},"minItems":1},"geo_metros":{"title":"Targeting Geo Metros","type":"array","description":"Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-metro.json"},"minItems":1},"geo_metros_exclude":{"type":"array","description":"Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.","items":{"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"minItems":1},"geo_postal_areas":{"type":"array","description":"Restrict delivery to specific postal areas. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_postal_areas_exclude":{"type":"array","description":"Exclude specific postal areas from delivery. Prefer the native country + postal system form. The deprecated legacy country-fused postal-system tokens remain accepted for compatibility. Seller must declare supported systems in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1postal-area.json"},"minItems":1},"geo_places":{"type":"array","description":"Restrict delivery to catalog-backed named places. Values MUST be stable identifiers in the declared system, not display names. Sellers must declare supported systems, countries, and place types in get_adcp_capabilities and reject unsupported entries rather than silently dropping them.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"geo_places_exclude":{"type":"array","description":"Exclude catalog-backed named places. Uses the same identifier-based shape as geo_places. Sellers MUST reject overlap with geo_places for the same country, system, place_type, and value.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-area.json","x-adcp-schema-uri":"/schemas/core/geo-place-area.json"},"minItems":1},"daypart_targets":{"type":"array","description":"Restrict delivery to specific time windows. Each entry specifies days of week, an hour range, and an optional timezone that defaults to inventory_local. A concrete IANA zone uses one shared civil-time clock, while inventory_local evaluates each inventory unit in its seller-assigned local timezone. Entries are independent and MAY use different clocks.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1daypart-target.json"},"minItems":1},"axe_include_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to include for targeting.","deprecated":true},"axe_exclude_segment":{"type":"string","description":"Deprecated: Use TMP provider fields instead. AXE segment ID to exclude from targeting.","deprecated":true},"audience_include":{"type":"array","description":"Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"audience_exclude":{"type":"array","description":"Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.","items":{"type":"string"},"minItems":1},"signal_targeting_groups":{"title":"Targeting Signal Groups","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting-groups.json","description":"Basic Boolean grouping for seller-offered signals. v1 supports a required top-level operator 'all' and child groups with operator 'any' for include groups or 'none' for exclusion groups. Example semantics: group 1 any(A, B) plus group 2 none(C, D) means (A OR B) AND NOT (C OR D). Signal entries reference named signal definitions with signal_ref scope 'product' for product-local signal options or scope 'data_provider' for external signals published in adagents.json signals[]. For simple include-only targeting, send one child group with operator 'any'. Sellers SHOULD reject entries that are not available for the product through inline signal_targeting_options or get_signals, are not active for the account, or exceed the product's signal_targeting_allowed/signal_targeting_rules/product terms. Signal targeting limits are product-scoped, not declared in get_adcp_capabilities, because products may be backed by different ad servers. Sellers MUST echo applied signal_targeting_groups on the resulting package state, including fixed/default selections. Sellers MAY return REQUOTE_REQUIRED when a targeting mutation changes commercial terms."},"signal_targeting":{"type":"array","description":"DEPRECATED. Use signal_targeting_groups for package-level signal targeting. Legacy flat signal_targeting remains accepted during the SignalRef migration window but cannot express grouped include/exclude composition or product-scoped pricing.","deprecated":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-targeting.json"},"minItems":1},"demographics":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1demographic-targeting-intent.json","description":"Canonical demographic audience targeting intent with optional constraints on how age may be determined. This is distinct from age_restriction: demographics selects an audience, while age_restriction expresses a legal eligibility or verification floor. Fresh create/update targeting MUST compile exactly or be rejected. During get_products, a seller may offer a different configured predicate only through sparse targeting_resolution modifications on a distinguishable product_id; selecting that product accepts the alternative. Sellers never silently broaden, narrow, default, drop, or substitute the basis."},"frequency_cap":{"title":"Targeting Frequency Cap","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1frequency-cap.json"},"property_list":{"title":"Targeting Property List","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false."},"property_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1property-list-ref.json","description":"Reference to a property list whose properties must not carry the buyer's ads. Matched properties are removed from delivery. Use for brand-safety do-not-run lists (apps, sites). Exclude wins on overlap with property_list, and applies regardless of the product's property_targeting_allowed flag. Seller must declare support in get_adcp_capabilities."},"collection_list":{"title":"Targeting Collection List","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for including specific collections (programs, publications, channels) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities."},"collection_list_exclude":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-list-ref.json","description":"Reference to a collection list for excluding specific collections (programs, publications, channels) from this product. Matched collections must not carry the buyer's ads. Use for brand safety do-not-air lists. Seller must declare support in get_adcp_capabilities."},"placement_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-selection.json","description":"Purchased placement selection within the product. This constrains package inventory; it is distinct from creative_assignments[].placement_refs, which only route individual creatives within the purchased set. On create, mode selected supplies the complete selected set and mode default uses the product default. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"collection_selection":{"title":"Targeting Collection Selection","$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-selection.json","description":"Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set."},"age_restriction":{"type":"object","description":"Age restriction for compliance. Use for legal requirements (alcohol, gambling), not audience targeting.","properties":{"min":{"type":"integer","minimum":13,"maximum":99,"description":"Minimum age required"},"verification_required":{"type":"boolean","default":false,"description":"Whether verified age (not inferred) is required for compliance"},"accepted_methods":{"type":"array","description":"Accepted verification methods. If omitted, any method the platform supports is acceptable.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1}},"required":["min"],"additionalProperties":false},"device_platform":{"type":"array","description":"Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_platform_exclude":{"type":"array","description":"Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-platform.json"},"minItems":1},"device_type":{"type":"array","description":"Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"device_type_exclude":{"type":"array","description":"Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1device-type.json"},"minItems":1},"browser":{"type":"array","description":"Restrict delivery to specific canonical browser families in the impression delivery and rendering environment, not the post-click landing-page browser. Values MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. Values in this array use OR semantics. When browser is supplied, families not listed are ineligible: other includes a seller-recognized family that is not explicitly enumerated, while unknown includes a browser the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Browser and device constraints intersect; a seller that cannot enforce the exact combination MUST exclude or explicitly reconfigure the product during discovery and MUST reject it at create or update rather than silently widening delivery. Browser versions and seller-native IDs are intentionally unsupported.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"browser_exclude":{"type":"array","description":"Exclude specific canonical browser families from delivery. other excludes seller-recognized families that are not explicitly enumerated; unknown excludes browsers the seller cannot classify into a recognized family. When the same family appears in browser and browser_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1browser-family.json"},"minItems":1,"uniqueItems":true},"store_catchments":{"type":"array","description":"Target users within store catchment areas from a synced store catalog. Each entry references a store-type catalog and optionally narrows to specific stores or catchment zones.","items":{"type":"object","properties":{"catalog_id":{"type":"string","description":"Synced store-type catalog ID from sync_catalogs."},"store_ids":{"type":"array","description":"Filter to specific stores within the catalog. Omit to target all stores.","items":{"type":"string"},"minItems":1},"catchment_ids":{"type":"array","description":"Catchment zone IDs to target (e.g., 'walk', 'drive'). Omit to target all catchment zones.","items":{"type":"string"},"minItems":1}},"required":["catalog_id"],"additionalProperties":true},"minItems":1},"geo_proximity":{"type":"array","description":"Target users within travel time, distance, or a custom boundary around arbitrary geographic points. Multiple entries use OR semantics — a user within range of any listed point is eligible. For campaigns targeting 10+ locations, consider using store_catchments with a location catalog instead. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"lng":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees (WGS 84). Required for travel_time and radius methods."},"label":{"type":"string","description":"Human-readable label for this entry (e.g., 'Düsseldorf', 'Heathrow Airport', 'Primary trade area')."},"travel_time":{"type":"object","description":"Travel time limit for isochrone calculation. The platform resolves this to a geographic boundary based on actual transportation networks.","properties":{"value":{"type":"number","minimum":1,"description":"Travel time limit."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1travel-time-unit.json"}},"required":["value","unit"],"additionalProperties":false},"transport_mode":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1transport-mode.json","description":"Transportation mode for isochrone calculation. Required when travel_time is provided."},"radius":{"type":"object","description":"Simple radius from the point. The platform draws a circle of this distance around the coordinates.","properties":{"value":{"type":"number","exclusiveMinimum":0,"description":"Radius distance."},"unit":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1distance-unit.json","description":"Distance unit."}},"required":["value","unit"],"additionalProperties":false},"geometry":{"type":"object","description":"Pre-computed GeoJSON geometry defining the proximity boundary. Use when the buyer has already calculated isochrones (via TravelTime, Mapbox, etc.) or has custom boundaries. When geometry is provided, lat/lng are not required.","properties":{"type":{"type":"string","enum":["Polygon","MultiPolygon"],"description":"GeoJSON geometry type."},"coordinates":{"type":"array","description":"GeoJSON coordinates array. For Polygon: array of linear rings. For MultiPolygon: array of polygons."}},"required":["type","coordinates"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"oneOf":[{"required":["lat","lng","travel_time","transport_mode"],"not":{"anyOf":[{"required":["radius"]},{"required":["geometry"]}]}},{"required":["lat","lng","radius"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["geometry"]}]}},{"required":["geometry"],"not":{"anyOf":[{"required":["travel_time"]},{"required":["radius"]}]}}],"additionalProperties":true},"minItems":1},"language":{"title":"Targeting Languages","type":"array","description":"Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1},"keyword_targets":{"title":"Targeting Keywords","type":"array","description":"Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.","items":{"type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to target"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1match-type.json"},"bid_price":{"type":"number","minimum":0,"description":"Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."}},"required":["keyword","match_type"],"additionalProperties":false},"minItems":1},"negative_keywords":{"title":"Targeting Negative Keywords","type":"array","description":"Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1negative-keyword.json"},"minItems":1}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-unknown-age-eligibility-constraint.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1targeting-verified-age-basis-constraint.json"}],"additionalProperties":true},"external:core/geo-metro.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-metro.json","title":"Geo Metro","description":"A targeted metro area.","type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1metro-system.json","description":"Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')"},"values":{"type":"array","description":"Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false},"external:enums/metro-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/metro-system.json","title":"Metro Area System","description":"Metro area classification systems for geographic targeting","type":"string","enum":["nielsen_dma","uk_itl1","uk_itl2","eurostat_nuts2","custom"]},"external:core/postal-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/postal-area.json","title":"Postal Area","description":"Postal area values. Prefer the native country + postal system form. Deprecated legacy country-fused postal-system tokens remain accepted for compatibility.","anyOf":[{"title":"PostalArea","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1postal-country-system.json"}],"properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code for the postal values."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system (e.g., 'zip', 'outward', 'plz', 'postal_code')."},"values":{"type":"array","description":"Postal codes within the country and system.","items":{"type":"string"},"minItems":1}},"required":["country","system","values"],"additionalProperties":false},{"title":"PostalAreaWithFusedSystem","deprecated":true,"type":"object","properties":{"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1legacy-postal-system.json","deprecated":true,"description":"Deprecated country-fused postal code system (e.g., 'us_zip', 'gb_outward'). Prefer country + postal-system."},"values":{"type":"array","description":"Postal codes within the legacy system.","items":{"type":"string"},"minItems":1}},"required":["system","values"],"additionalProperties":false}]},"external:core/postal-country-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/postal-country-system.json","title":"Postal Country System","description":"Valid country-local postal system pairing. Registered countries only accept their registered local systems; countries without a registered local system use postal_code or custom.","type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1postal-system.json","description":"Country-local postal code system."}},"required":["country","system"],"anyOf":[{"properties":{"country":{"const":"US"},"system":{"enum":["zip","zip_plus_four"]}}},{"properties":{"country":{"const":"GB"},"system":{"enum":["outward","full"]}}},{"properties":{"country":{"const":"CA"},"system":{"enum":["fsa","full"]}}},{"properties":{"country":{"enum":["DE","CH","AT"]},"system":{"const":"plz"}}},{"properties":{"country":{"const":"FR"},"system":{"const":"code_postal"}}},{"properties":{"country":{"const":"AU"},"system":{"const":"postcode"}}},{"properties":{"country":{"const":"BR"},"system":{"const":"cep"}}},{"properties":{"country":{"const":"IN"},"system":{"const":"pin"}}},{"properties":{"country":{"const":"ZA"},"system":{"const":"postal_code"}}},{"properties":{"country":{"not":{"enum":["US","GB","CA","DE","CH","AT","FR","AU","BR","IN","ZA"]}},"system":{"enum":["postal_code","custom"]}}}]},"external:enums/postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/postal-system.json","title":"Postal Code System","description":"Postal code system names for geographic targeting. Prefer country-local values with an explicit ISO 3166-1 alpha-2 country. Deprecated country-fused values remain in this published enum for 3.x compatibility.","type":"string","enum":["postal_code","zip","zip_plus_four","outward","full","fsa","plz","code_postal","postcode","cep","pin","custom","us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:enums/legacy-postal-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/legacy-postal-system.json","title":"Country-Fused Postal Code System","description":"Deprecated country-fused postal code systems for geographic targeting. Prefer postal-system with an explicit ISO 3166-1 alpha-2 country on postal area objects.","type":"string","deprecated":true,"enum":["us_zip","us_zip_plus_four","gb_outward","gb_full","ca_fsa","ca_full","de_plz","fr_code_postal","au_postcode","ch_plz","at_plz"]},"external:core/geo-place-area.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-place-area.json","title":"Geographic Place Area","description":"A catalog-backed named place target. Values are stable identifiers in the declared system. Entries within geo_places form a union; different geographic inclusion dimensions intersect. value_labels are diagnostic only and MUST NOT be used to resolve targeting.","x-adcp-validation":{"map_keys_subset_of_array":{"map_field":"value_labels","array_field":"values"},"description":"Every value_labels key MUST also appear in values. JSON Schema draft-07 cannot express this sibling-field key membership constraint, so conformance tooling must enforce it."},"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code containing the place."},"system":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-system.json"},"system_version":{"type":"string","minLength":1,"description":"Optional exact catalog version from the seller's declared supported_versions. When omitted, the seller applies catalog.current_version and MUST echo that version on persisted package state."},"place_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1geo-place-type.json"},"values":{"type":"array","description":"Stable place identifiers in the declared system. Display names are not valid targeting values.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"value_labels":{"type":"object","description":"Optional human-readable diagnostic labels keyed by identifiers present in values. Extra keys are a conformance error. Labels are non-authoritative and MUST NOT be used to resolve or apply targeting.","additionalProperties":{"type":"string","minLength":1}},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["country","system","place_type","values"],"allOf":[{"if":{"properties":{"system":{"enum":["geonames","google_ads","microsoft_ads"]}},"required":["system"]},"then":{"properties":{"values":{"items":{"type":"string","pattern":"^[0-9]+$"}}}}}],"additionalProperties":false},"external:core/geo-place-system.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-place-system.json","title":"Geographic Place Identifier System","description":"Collision-safe identifier namespace for geographic places. Registered tokens have protocol-defined semantics. Unregistered systems MUST use an absolute HTTPS URI controlled by the catalog owner; consumers compare URI systems as exact opaque strings.","anyOf":[{"type":"string","enum":["geonames","google_ads","microsoft_ads"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["geonames","google_ads","microsoft_ads","https://seller.example/geo/catalogs/places"]},"external:core/geo-place-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/geo-place-type.json","title":"Geographic Place Type","description":"Canonical place classification. Registered tokens have protocol-defined meanings. Catalog-specific classifications without a registered mapping MUST use an absolute HTTPS URI controlled by the vocabulary owner; consumers compare URI types as exact opaque strings.","anyOf":[{"type":"string","enum":["airport","borough","city","city_region","commune","county","district","municipality","neighborhood","post_town","prefecture","province","quarter","state","territory","ward"]},{"type":"string","format":"uri","pattern":"^https://"}],"examples":["city","municipality","borough","neighborhood","post_town","city_region","county","https://seller.example/geo/place-types/trade-area"]},"external:core/daypart-target.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/daypart-target.json","title":"Daypart Target","description":"A time window for daypart targeting. Specifies days of week, an hour range, and the civil-time clock used to evaluate it. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.","type":"object","properties":{"days":{"type":"array","description":"Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1day-of-week.json"},"minItems":1},"start_hour":{"type":"integer","description":"Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.","minimum":0,"maximum":23},"end_hour":{"type":"integer","description":"End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.","minimum":1,"maximum":24},"timezone":{"description":"Civil-time clock used to evaluate this window. 'inventory_local' evaluates the hours in the seller-assigned local timezone of each inventory unit that can deliver the impression, such as a screen, venue, station, or publisher property; it never means the buyer, account, or server timezone. A concrete IANA timezone identifier (for example, 'America/New_York', 'CET', or 'UTC') evaluates one shared civil-time clock across the targeted inventory. Omission defaults to 'inventory_local'. Buyers that begin with a user or account preference MUST resolve it to a concrete IANA identifier before sending the daypart; 'user_timezone' and 'account_timezone' are not wire values. For each candidate delivery instant, convert the instant into this clock and compare its resulting local day and hour with the half-open window: a skipped DST hour has no matching instants, while both occurrences of a repeated hour match. This delivery clock is independent of reporting_capabilities.timezone.","default":"inventory_local","x-added-in":"3.2.0","anyOf":[{"type":"string","const":"inventory_local"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1iana-timezone.json"}]},"label":{"type":"string","description":"Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')"}},"required":["days","start_hour","end_hour"],"additionalProperties":false},"external:enums/day-of-week.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/day-of-week.json","title":"Day of Week","description":"Days of the week for daypart targeting","type":"string","enum":["monday","tuesday","wednesday","thursday","friday","saturday","sunday"]},"external:core/iana-timezone.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/iana-timezone.json","title":"IANA Timezone Identifier","description":"Concrete timezone identifier in the implementation's supported IANA Time Zone Database, such as America/New_York, CET, or UTC.","type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._+-]+(?:/[A-Za-z0-9._+-]+)*$","not":{"const":"inventory_local"},"x-added-in":"3.2.0","x-adcp-validation":{"iana_timezone":"value_must_resolve_in_the_implementations_supported_IANA_TZDB"}},"external:core/package-signal-targeting-groups.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/package-signal-targeting-groups.json","title":"Package Signal Targeting Groups","description":"Top-level basic Boolean composition for package signal targeting. The groups-level operator is required; v1 supports operator 'all', meaning every child group must be satisfied. This represents the portable baseline: (any of include group 1) AND (any of include group 2) AND NOT (any of exclude group N).","type":"object","properties":{"operator":{"type":"string","enum":["all"],"description":"Groups-level operator. Required even though v1 only supports 'all': every child group must be satisfied."},"groups":{"type":"array","description":"Signal targeting groups to evaluate. Use operator 'any' for include groups and 'none' for exclusion groups.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting-group.json"},"minItems":1}},"required":["operator","groups"],"additionalProperties":true},"external:core/package-signal-targeting-group.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/package-signal-targeting-group.json","title":"Package Signal Targeting Group","description":"A basic Boolean group of package-level signal targeting entries. 'any' means the user must match at least one signal in the group. 'none' means the user must match none of the signals in the group. Use groups for portable include/exclude composition such as (A OR B) AND NOT (C OR D).","type":"object","properties":{"operator":{"type":"string","description":"How to evaluate the signals in this group. 'any' is an OR include group. 'none' is an exclusion group equivalent to NOT (A OR B OR C).","enum":["any","none"]},"signals":{"type":"array","description":"Signal targeting entries evaluated by this group. Each entry uses the package signal targeting shape, including signal_ref, value expression, and optional pricing, execution-handle, or activation fields.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1package-signal-targeting.json"},"minItems":1}},"required":["operator","signals"],"additionalProperties":true},"external:core/package-signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/package-signal-targeting.json","title":"Package Signal Targeting","description":"Buy-time selection of one seller-offered signal inside a package signal targeting group. The signal_ref uses scope 'product' for a product-local signal option, scope 'data_provider' for a signal defined in a data provider's published adagents.json signals[], or scope 'signal_source' for a source-native signal that is not published in adagents.json signals[]. The selected product's inline Product.signal_targeting_options, get_signals feed when inline options are omitted, and signal_targeting_rules define buy-time eligibility. Inclusion and exclusion are controlled by the parent group operator: use operator 'any' to include users matching the signal expression and operator 'none' to exclude users matching the signal expression. For binary signals, value MUST be true; do not use value=false for exclusion inside signal_targeting_groups. Use audience_include/audience_exclude only for buyer-managed first-party audiences registered through sync_audiences.","type":"object","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-targeting-expression.json"}],"properties":{"pricing_option_id":{"type":"string","description":"Pricing option selected for this signal. Use the pricing_option_id from the product's signal_targeting_options entry when product-scoped pricing is present; otherwise use the seller get_signals pricing only when the product option does not override it. Required when the selected signal has pricing_options; omit only when the signal is bundled into the product price or has no incremental cost.","x-entity":"vendor_pricing_option"},"signal_agent_segment_id":{"type":"string","description":"Optional opaque resolved-segment or seller execution handle for this signal. Omit when signal_ref plus the value expression is sufficient for the seller to resolve the signal. Include when the product option exposes a separate runtime or activation handle, and pass it verbatim. Buyers SHOULD prefer an exposed segment handle over reconstructing condition identity from categorical values because the handle can carry provider namespace and methodology distinctions.","x-entity":"signal_activation_id"},"activation_key":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1activation-key.json","description":"Destination-specific activation key returned by get_signals or activate_signal. Usually omitted for seller-offered signals selected directly through the same seller; include only when the selected signal was separately activated and the seller requires the activation key to correlate the package selection."}},"additionalProperties":true},"external:core/signal-targeting-expression.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-targeting-expression.json","title":"Signal Targeting Expression","description":"Predicate over a named signal definition. Signals are typed dimensions, similar to feature values: binary signals match true, categorical signals match one of a set of values, and numeric signals match a range. In package signal targeting groups, include/exclude semantics are controlled by the parent group operator, not by negating the expression.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal expression. In grouped package targeting, value is always true; use a parent group with operator 'none' for exclusion.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals."},"value":{"type":"boolean","const":true,"description":"Binary package signal entries match users for whom the signal is true. Use the parent group operator for include/exclude."}},"required":["signal_ref","value_type","value"],"additionalProperties":true},{"type":"object","description":"Categorical signal expression - target users with one of the listed values.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals."},"values":{"type":"array","description":"Values to target. Users with any of these values match the expression.","items":{"type":"string"},"minItems":1}},"required":["signal_ref","value_type","values"],"additionalProperties":true},{"type":"object","description":"Numeric signal expression - target users within a value range. At least one of min_value or max_value is required. If both min_value and max_value are provided, min_value MUST be <= max_value.","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"Named signal being targeted."},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals."},"min_value":{"type":"number","description":"Minimum value, inclusive. Omit for no minimum. Should be within the signal definition's range when declared."},"max_value":{"type":"number","description":"Maximum value, inclusive. Omit for no maximum. Should be within the signal definition's range when declared."}},"required":["signal_ref","value_type"],"anyOf":[{"required":["min_value"]},{"required":["max_value"]}],"additionalProperties":true}]},"external:core/signal-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-ref.json","title":"Signal Ref","description":"Reference to a named signal definition. Uses scope as discriminator: 'data_provider' for a signal resolved through published adagents.json signals[], 'signal_source' for a source-native signal resolved through the issuing signal source, or 'product' for a product-local signal option. Scope is the resolution path, not provenance; authoritative enrichment lives on the seller, signal source, or data-provider signal definition, not on this reference.","x-entity":"signal","discriminator":{"propertyName":"scope"},"oneOf":[{"type":"object","description":"Product-scoped signal. The signal_id is meaningful only within the selected product/package context and MUST match a Product.included_signals[].signal_ref.signal_id or Product.signal_targeting_options[].signal_ref.signal_id for that product, depending on whether the signal is descriptive or selectable.","properties":{"scope":{"type":"string","const":"product","description":"Discriminator indicating the signal resolves through the selected product's included_signals or signal_targeting_options."},"signal_id":{"type":"string","description":"Product-local signal identifier. For local signals exposed on both get_signals and get_products, this MUST match get_signals.signals[].signal_ref.signal_id for the same signal.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["signal_source_url"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Data-provider-scoped signal. The signal_id resolves through the data provider's published adagents.json signals[] and can be authorization-verified there.","properties":{"scope":{"type":"string","const":"data_provider","description":"Discriminator indicating the signal resolves through a data provider's published adagents.json signals[]."},"data_provider_domain":{"type":"string","description":"Domain that publishes the signal definition in its adagents.json signals[].","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"signal_id":{"type":"string","description":"Signal identifier within the data provider's published adagents.json signals[].","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","data_provider_domain","signal_id"],"not":{"anyOf":[{"required":["agent_url"]},{"required":["signal_source_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true},{"type":"object","description":"Signal-source-scoped signal. Use this for source-native signals that are not published in upstream adagents.json signals[]. The buyer trusts the issuing signal source for this identity; use scope 'data_provider' instead when the signal is published in adagents.json signals[], even if the publisher is also the seller or signal source.","properties":{"scope":{"type":"string","const":"signal_source","description":"Discriminator indicating the signal resolves through the issuing signal source."},"signal_source_url":{"type":"string","format":"uri","description":"URL of the signal source that issues this source-native signal."},"signal_id":{"type":"string","description":"Signal identifier within the issuing signal source's signal set.","pattern":"^[a-zA-Z0-9_-]+$"}},"required":["scope","signal_source_url","signal_id"],"not":{"anyOf":[{"required":["data_provider_domain"]},{"required":["agent_url"]},{"required":["source"]},{"required":["id"]}]},"additionalProperties":true}]},"external:core/activation-key.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/activation-key.json","title":"Activation Key","description":"Universal identifier for using a signal on a destination platform. Can be either a segment ID or a key-value pair depending on the platform's targeting mechanism.","type":"object","discriminator":{"propertyName":"type"},"oneOf":[{"properties":{"type":{"type":"string","const":"segment_id","description":"Segment ID based targeting"},"segment_id":{"type":"string","description":"The platform-specific segment identifier to use in campaign targeting"}},"required":["type","segment_id"],"additionalProperties":true},{"properties":{"type":{"type":"string","const":"key_value","description":"Key-value pair based targeting"},"key":{"type":"string","description":"The targeting parameter key"},"value":{"type":"string","description":"The targeting parameter value"}},"required":["type","key","value"],"additionalProperties":true}]},"external:core/signal-targeting.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-targeting.json","title":"Signal Targeting","description":"Targeting constraint for a specific signal. Uses value_type as discriminator to determine the targeting expression format.","discriminator":{"propertyName":"value_type"},"oneOf":[{"type":"object","description":"Binary signal targeting - user either matches or doesn't","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"binary","description":"Discriminator for binary signals"},"value":{"type":"boolean","description":"Whether to include (true) or exclude (false) users matching this signal"}},"required":["value_type","value"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Categorical signal targeting - target users with specific values","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"categorical","description":"Discriminator for categorical signals"},"values":{"type":"array","description":"Values to target. Users with any of these values will be included.","items":{"type":"string"},"minItems":1}},"required":["value_type","values"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true},{"type":"object","description":"Numeric signal targeting - target users within a value range. If min_value is provided, it must be <= max_value. Values should be within the signal's defined range (see signal definition).","properties":{"signal_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-ref.json","description":"The signal to target. New targeting constraints SHOULD use signal_ref."},"signal_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1signal-id.json","description":"DEPRECATED. Use signal_ref instead. Legacy SignalId retained for compatibility with older clients.","deprecated":true},"value_type":{"type":"string","const":"numeric","description":"Discriminator for numeric signals"},"min_value":{"type":"number","description":"Minimum value (inclusive). Omit for no minimum. Must be <= max_value when both are provided. Should be >= signal's range.min if defined."},"max_value":{"type":"number","description":"Maximum value (inclusive). Omit for no maximum. Must be >= min_value when both are provided. Should be <= signal's range.max if defined."}},"required":["value_type"],"anyOf":[{"required":["signal_ref"]},{"required":["signal_id"]}],"additionalProperties":true}]},"external:core/signal-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/signal-id.json","title":"Signal ID","description":"DEPRECATED. Use SignalRef for new discovery, activation, and media-buy signal identity surfaces. Legacy universal signal identifier used by older Signals Protocol clients. Uses 'source' as discriminator: 'catalog' for signals from a data provider's published catalog (verifiable), or 'agent' for signals native to a signal source identified by agent_url.","deprecated":true,"x-entity":"signal","discriminator":{"propertyName":"source"},"oneOf":[{"type":"object","description":"Data-provider signal - references a signal from a data provider's published adagents.json signals[]. Buyers can verify authorization by checking the data provider's adagents.json.","properties":{"source":{"type":"string","const":"catalog","description":"Discriminator indicating this signal is from a data provider's published adagents.json signals[]"},"data_provider_domain":{"type":"string","description":"Domain of the data provider that owns this signal (e.g., 'pinnacle-data.example'). The signal definition is published at this domain's /.well-known/adagents.json","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the data provider's catalog (e.g., 'likely_ev_buyers', 'income_100k_plus')"}},"required":["source","data_provider_domain","id"],"additionalProperties":true},{"type":"object","description":"Agent signal - references a signal native to a signal source identified by agent_url. Not externally verifiable through an upstream catalog; buyer trusts the issuing signal source's claim about the signal.","properties":{"source":{"type":"string","const":"agent","description":"Discriminator indicating this signal is native to the signal source identified by agent_url, not from a data provider's published signal definitions."},"agent_url":{"type":"string","format":"uri","description":"URL of the signal source that provides this signal (e.g., 'https://signals.example/.well-known/adcp/signals')"},"id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Signal identifier within the agent's signal set (e.g., 'custom_auto_intenders')"}},"required":["source","agent_url","id"],"additionalProperties":true}]},"external:core/demographic-targeting-intent.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/demographic-targeting-intent.json","title":"Demographic Targeting Intent","description":"Portable demographic targeting intent plus buyer constraints on how the seller may determine user eligibility. The age predicate retains its canonical interval meaning; accepted_bases narrows execution provenance without changing which ages are requested.","type":"object","properties":{"age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1demographic-age-range.json"},{"type":"object","properties":{"accepted_bases":{"type":"array","description":"User-level age determination bases the buyer permits for this predicate. Sellers MUST use only these bases or reject the request; they MUST NOT silently fall back to another basis. When omitted, the buyer imposes no determination-basis constraint beyond product capability and any age_restriction. population_estimate is structurally unavailable because aggregate evidence cannot identify an eligible user.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1age-determination-basis.json"},"minItems":1,"uniqueItems":true},"accepted_verification_methods":{"type":"array","description":"Verification methods acceptable when verified is an accepted basis. This field narrows verified demographic execution; age_restriction.accepted_methods independently governs legal eligibility and the two sets are intersected when both are present.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1age-verification-method.json"},"minItems":1,"uniqueItems":true}},"allOf":[{"if":{"required":["accepted_verification_methods"]},"then":{"required":["accepted_bases"],"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}],"additionalProperties":true}]}},"required":["age"],"additionalProperties":true},"external:core/demographic-age-range.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/demographic-age-range.json","title":"Demographic Age Range","description":"A canonical audience-age predicate in completed integer years. min and max are inclusive; omitting one bound means no restriction in that direction. At least one bound is required. include_unknown is always explicit because people whose age is unavailable are not members of any numeric interval. Implementations MUST reject min greater than max; JSON Schema draft-07 cannot compare sibling numeric values.","type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive minimum age in completed years. Omit for an open lower bound."},"max":{"type":"integer","minimum":0,"maximum":150,"description":"Inclusive maximum age in completed years. Omit for an open upper bound."},"include_unknown":{"type":"boolean","description":"Whether delivery to people whose age is unavailable is part of this predicate. This field has no default and MUST be supplied."}},"required":["include_unknown"],"anyOf":[{"required":["min"]},{"required":["max"]}],"additionalProperties":true},"external:enums/age-determination-basis.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/age-determination-basis.json","title":"Age Determination Basis","description":"User-level bases that may resolve age for demographic targeting execution. Population estimates are deliberately absent because aggregate composition cannot establish an individual impression's age.","type":"string","enum":["verified","declared","inferred"],"enumDescriptions":{"verified":"The user's applicable age claim was established through an age-assurance or identity-verification method.","declared":"The user supplied an age, date of birth, or threshold affirmation without independent verification.","inferred":"The user's age was predicted from behavior, attributes, or another model."}},"external:enums/age-verification-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/age-verification-method.json","title":"Age Verification Method","description":"Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.","type":"string","enum":["facial_age_estimation","id_document","digital_id","credit_card","world_id"]},"external:core/property-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/property-list-ref.json","title":"Property List Reference","description":"Reference to an externally managed property list. Enables passing large property sets (50,000+) without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the property list"},"list_id":{"type":"string","description":"Identifier for the property list within the agent","minLength":1,"x-entity":"property_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/collection-list-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/collection-list-ref.json","title":"Collection List Reference","description":"Reference to an externally managed collection list. Enables passing large collection exclusion/inclusion sets without embedding them in requests. The receiving agent fetches and caches the list independently.","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"URL of the agent managing the collection list"},"list_id":{"type":"string","description":"Identifier for the collection list within the agent","minLength":1,"x-entity":"collection_list"},"auth_token":{"type":"string","description":"JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."}},"required":["agent_url","list_id"],"additionalProperties":false},"external:core/placement-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/placement-selection.json","title":"Placement Selection","description":"Complete purchased placement set within a product. This is inventory targeting, not creative routing: creative_assignments[].placement_refs route a creative only within this purchased set. Requests use mode selected to name the complete required set or mode default to accept the product/seller default. Across discovery, create, and update, a selected set is satisfied inherently when it exactly equals a fixed product's complete included placement set; this exact restatement does not require overlay_support.placement_selection, while partial selection does. Included placements are never independently selectable. Products with any fixed mode:included placement cannot advertise selectable placement overlay support because the fixed placement would make a partial buyer-selected set incomplete; sellers expose separately selectable inventory when needed. Successful package readback MUST echo the committed selected set. Sellers reject unknown, duplicate, cross-publisher, incompatible, or partially applicable refs rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected placements","type":"object","properties":{"mode":{"type":"string","const":"selected"},"placement_refs":{"type":"array","description":"Complete required placement set. A reference normally identifies a mode targetable placement. It MAY identify a mode included placement only when the set exactly equals the product's complete fixed included set, which is an inherent match rather than independent selection. Legacy publisher refs use {publisher_domain, placement_id}; authority-discriminated 3.2 identities use placement-identity.json so seller-inline inventory is selected by {seller_agent, placement_id}. An item that exactly matches placement-identity uses that canonical identity; otherwise a released-compatible item with publisher_domain and placement_id uses legacy product-context matching, and tolerated product metadata such as kind, name, or mode has no selection effect.","items":{"anyOf":[{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-ref.json"},{"required":["publisher_domain"]}]},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-identity.json"}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode","placement_refs"],"additionalProperties":false},{"title":"Product default placements","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/placement-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/placement-ref.json","title":"Placement Reference","description":"Legacy-compatible product-context reference to a placement. For publisher-catalog placements, publisher_domain plus placement_id resolves the declaration in that publisher's adagents.json. For seller-inline placements, the enclosing seller and product supply scope. When publisher_domain is omitted on legacy inputs, receivers MAY interpret the ID relative to the enclosing single-publisher product. Use placement-identity.json when a self-contained cross-document identity is required.","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring a publisher-catalog placement is hosted, or the inventory publisher associated with an inline placement. Omitted only for legacy single-publisher product-context references.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"placement_id":{"type":"string","description":"Placement ID from the publisher's adagents.json placement catalog, or an inline seller-defined placement ID interpreted within the enclosing seller and product context.","x-entity":"placement"}},"required":["placement_id"],"additionalProperties":true},"external:core/placement-identity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/placement-identity.json","title":"Placement Identity","description":"Self-contained identity for either a publisher-catalog placement or a sales-agent-defined inline placement. The discriminator names which authority owns placement_id.","oneOf":[{"title":"Publisher catalog placement identity","type":"object","properties":{"kind":{"type":"string","const":"publisher_ref"},"publisher_domain":{"type":"string","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","description":"Domain whose adagents.json declares placement_id."},"placement_id":{"type":"string","minLength":1,"x-entity":"placement"}},"required":["kind","publisher_domain","placement_id"],"additionalProperties":false},{"title":"Seller inline placement identity","type":"object","properties":{"kind":{"type":"string","const":"seller_inline"},"seller_agent":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1seller-agent-ref.json","description":"Sales agent that defines and maintains the inline placement namespace."},"placement_id":{"type":"string","minLength":1,"description":"Stable placement ID within the defining sales agent's namespace. The agent MUST NOT reuse it for a different semantic placement.","x-entity":"placement"}},"required":["kind","seller_agent","placement_id"],"additionalProperties":false}]},"external:core/seller-agent-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/seller-agent-ref.json","title":"Seller Agent Reference","description":"Structured reference to a seller agent. The canonical identifier is the agent's URL as declared in the property publisher's adagents.json `authorized_agents[].url`. The optional `id` slot is reserved for a future registry-assigned stable identifier; it is not used today. This shape mirrors `format-id` and `ProviderEntry` — URL-first, with an ID slot for forward compatibility.","x-status":"experimental","type":"object","properties":{"agent_url":{"type":"string","format":"uri","description":"The seller agent's API endpoint URL as declared in the property publisher's adagents.json `authorized_agents[].url`. MUST use the `https://` scheme. Receivers compare this URL against the `authorized_agents` list using the AdCP URL canonicalization rules — not byte-equality — and reject mismatches with `seller_not_authorized`. See docs/reference/url-canonicalization."},"id":{"type":"string","description":"Reserved for a future registry-assigned stable seller identifier. Not used today — senders MUST NOT populate this field until a registry is defined. When a future release populates both `agent_url` and `id`, `agent_url` remains authoritative and `id` is advisory.","pattern":"^[a-zA-Z0-9_-]+$","minLength":1}},"required":["agent_url"],"additionalProperties":false,"examples":[{"agent_url":"https://agent.acme.example"}]},"external:core/collection-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/collection-selection.json","title":"Collection Selection","description":"Complete purchased collection set within a product. Mode selected names the complete required set (partial selection requires product collection_targeting_allowed: true; exactly restating the full bundle is an inherent match); mode default accepts the product's full bundle. Package readback MUST echo the committed selection here as concrete selectors, materializing any collection_list composition; a purchase made with mode default therefore reads back as mode selected naming the product's complete bundle. Rejection of a schema-valid selector that references an unknown collection_id or publisher_domain uses REFERENCE_NOT_FOUND per the error-code registry (INVALID_REQUEST applies only to schema-invalid shapes such as a selected-mode item omitting collection_ids). Sellers reject unknown, duplicate, or partially applicable selectors rather than silently changing the selection.","type":"object","discriminator":{"propertyName":"mode"},"oneOf":[{"title":"Selected collections","type":"object","properties":{"mode":{"type":"string","const":"selected"},"collections":{"type":"array","description":"Complete required collection set as domain-qualified selectors with explicit collection_ids; the domain-only bulk-grant form is authorization scoping, not selection. publisher_domain may be an external channel owner's domain.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1collection-selector.json"},{"required":["collection_ids"]}]},"minItems":1,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode","collections"],"additionalProperties":false},{"title":"Product default collections","type":"object","properties":{"mode":{"type":"string","const":"default"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["mode"],"additionalProperties":false}]},"external:core/collection-selector.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/collection-selector.json","title":"Collection Selector","description":"References collections declared in an adagents.json. Buyers resolve full collection objects by fetching the adagents.json at the given domain and matching collection_ids against its collections array. When collection_ids is omitted, the selector references every collection declared in that adagents.json — the bulk-grant form for authorization scoping (e.g., a host authorizing a channel owner's sales agent for all of the owner's collections without tracking owner-assigned IDs).","type":"object","properties":{"publisher_domain":{"type":"string","description":"Domain where the adagents.json declaring these collections is hosted (e.g., 'mrbeast.com'). The collections array in that file contains the authoritative collection definitions.","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$"},"collection_ids":{"type":"array","description":"Collection IDs from the adagents.json collections array. Each ID must match a collection_id declared in that file. Omit to reference all collections declared in that file.","items":{"type":"string","x-entity":"collection"},"minItems":1}},"required":["publisher_domain"],"additionalProperties":true},"external:enums/device-platform.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/device-platform.json","title":"Device Platform","description":"Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.","type":"string","enum":["ios","android","windows","macos","linux","chromeos","tvos","tizen","webos","fire_os","roku_os","unknown"]},"external:enums/device-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/device-type.json","title":"Device Type","description":"Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.","type":"string","enum":["desktop","mobile","tablet","ctv","dooh","unknown"]},"external:enums/browser-family.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/browser-family.json","title":"Browser Family","description":"Portable browser families for targeting the impression delivery and rendering environment, not a post-click landing-page browser. Values identify browser families, not versions or seller-native browser IDs, and MUST NOT be inferred solely from operating system, device, web/mobile-web inventory, or placement. android_webview means an impression reliably classified as rendering in Android WebView. other means a seller-recognized browser family that is not explicitly enumerated; unknown means the seller cannot classify the browser into a recognized family.","type":"string","enum":["chrome","safari","firefox","edge","opera","samsung_internet","android_webview","other","unknown"]},"external:enums/travel-time-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/travel-time-unit.json","title":"Travel Time Unit","description":"Time unit for isochrone (travel-time catchment) calculations.","type":"string","enum":["min","hr"],"enumDescriptions":{"min":"Minutes","hr":"Hours"}},"external:enums/transport-mode.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/transport-mode.json","title":"Transport Mode","description":"Transportation modes for isochrone-based catchment area calculations. Determines how travel time translates to geographic reach.","type":"string","enum":["walking","cycling","driving","public_transport"],"enumDescriptions":{"walking":"Pedestrian travel on walkable paths and sidewalks","cycling":"Bicycle travel on roads and cycle paths","driving":"Motor vehicle travel on road networks","public_transport":"Public transit including bus, rail, metro, and ferry"}},"external:enums/distance-unit.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/distance-unit.json","title":"Distance Unit","description":"Units of distance measurement for radius-based catchment areas.","type":"string","enum":["km","mi","m"],"enumDescriptions":{"km":"Kilometers","mi":"Miles","m":"Meters"}},"external:core/locale-tag.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/locale-tag.json","title":"Language Tag","description":"A well-formed BCP 47 language tag used by AdCP only as language identity. Script and region may refine that identity; other valid BCP 47 subtags remain part of tag matching but do not make this a general locale-settings object. It does not determine currency, time zone, number/date formatting, market, or legal jurisdiction. The AdCP canonical wire profile requires lower-case language and variants, title-case script, and upper-case region (for example `en-US`, `zh-Hant-TW`, or `x-private`). RFC 5646 comparisons are case-insensitive and its case regularization is optional; AdCP intentionally requires this stricter single wire spelling and receivers MUST reject differently cased tags rather than silently normalizing them. The schema pattern enforces the AdCP casing profile and extension structure for commonly used tags; conforming receivers additionally validate the complete RFC 5646 grammar and registry rules. Every new AdCP field carrying BCP 47 language identity or a concrete language range MUST reference this schema instead of declaring independent string constraints.","x-adcp-validation":{"verifier_constraints":{"well_formed":"rfc5646","semantic_scope":"language_identity_only","canonical_wire_profile":"adcp_bcp47_casing","rfc5646_comparison":"case_insensitive","non_profile":"reject"},"spec":"docs/protocol/language-and-localization.mdx#one-language-tag-primitive"},"type":"string","minLength":2,"maxLength":63,"pattern":"^(?:[a-z]{2,8}(?:-[A-Z][a-z]{3})?(?:-(?:[A-Z]{2}|[0-9]{3}))?(?:-(?:[a-z0-9]{5,8}|[0-9][a-z0-9]{3}))*(?:-[0-9a-wy-z](?:-[a-z0-9]{2,8})+)*(?:-x(?:-[a-z0-9]{1,8})+)?|x(?:-[a-z0-9]{1,8})+)$","examples":["en-US","es-ES","zh-Hant-TW","x-private"]},"external:enums/match-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/match-type.json","title":"Match Type","description":"Keyword targeting match type. broad: ads may serve on queries semantically related to the keyword. phrase: ads serve when the query contains the keyword phrase. exact: ads serve only when the query matches the keyword exactly.","type":"string","enum":["broad","phrase","exact"],"enumDescriptions":{"broad":"Ads may serve on queries semantically related to the keyword","phrase":"Ads serve when the query contains the keyword phrase in order","exact":"Ads serve only when the query matches the keyword exactly"}},"external:core/negative-keyword.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/negative-keyword.json","title":"Negative Keyword","description":"An excluded keyword.","type":"object","properties":{"keyword":{"type":"string","minLength":1,"description":"The keyword to exclude"},"match_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1match-type.json"}},"required":["keyword","match_type"],"additionalProperties":false},"external:core/targeting-unknown-age-eligibility-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting-unknown-age-eligibility-constraint.json","title":"Targeting Unknown Age Eligibility Constraint","description":"Unknown-age delivery cannot satisfy a minimum-age eligibility policy. When demographic audience targeting and age_restriction are both present, include_unknown must be false.","if":{"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"include_unknown":{"const":false}}}}}}}},"external:core/targeting-verified-age-basis-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/targeting-verified-age-basis-constraint.json","title":"Targeting Verified Age Basis Constraint","description":"A legal verification requirement always narrows demographic targeting. When the buyer supplies accepted_bases and age_restriction requires verification, verified must be accepted; otherwise the constraints have an empty intersection and the request is invalid.","if":{"properties":{"age_restriction":{"properties":{"verification_required":{"const":true}},"required":["verification_required"]},"demographics":{"properties":{"age":{"required":["accepted_bases"]}},"required":["age"]}},"required":["demographics","age_restriction"]},"then":{"properties":{"demographics":{"properties":{"age":{"properties":{"accepted_bases":{"contains":{"const":"verified"}}}}}}}}},"external:core/audience-evidence-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/audience-evidence-requirements.json","title":"Audience Evidence Requirements","description":"Buyer-authored admissibility and ranking policy for product audience evidence. This reusable object attaches to get_products filters in 3.2, so the same semantics apply in brief, wholesale, and refine modes. It never requests exact audience targeting.","type":"object","properties":{"requirement_mode":{"type":"string","enum":["required","preferred"],"description":"required excludes products whose published evidence violates the constraints; preferred only affects ranking and explanation. When this policy affects inclusion or ranking, the seller MUST return the exact matching audience_evidence_selections even if get_products.fields omitted that field."},"evidence_presence":{"type":"string","enum":["required","when_available"],"description":"required applies the mode to evidence presence itself. when_available applies constraints only when a product publishes evidence: with requirement_mode required, a product with no evidence remains eligible but a product with evidence must have an admissible item; with preferred, presence and admissibility only affect ranking."},"accepted_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Allowed methodologies. excluded_methodologies always wins if a value appears in both lists."},"excluded_methodologies":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-evidence-methodology.json"},"minItems":1,"uniqueItems":true,"description":"Disallowed methodologies. Exclusion wins over accepted_methodologies when the lists overlap."},"accepted_evidence_types":{"type":"array","items":{"type":"string","enum":["measured","forecast","seller_declared"]},"minItems":1,"uniqueItems":true},"accepted_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Allowed evidence providers. excluded_providers always wins if the same canonical BrandRef appears in both lists."},"excluded_providers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"minItems":1,"description":"Disallowed evidence providers. Exclusion wins over accepted_providers when the lists overlap."},"accepted_subject_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-subject-type.json"},"minItems":1,"uniqueItems":true},"accepted_resolution_methods":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audience-resolution-method.json"},"minItems":1,"uniqueItems":true},"minimum_confidence":{"type":"number","minimum":0,"maximum":1},"maximum_age":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1duration.json"},{"properties":{"unit":{"enum":["seconds","minutes","hours","days"]}}}],"description":"Maximum age at evaluation time measured from last_updated. Campaign-relative duration is not valid for evidence age."},"methodology_documentation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must carry methodology_url."},"independent_attestation_required":{"type":"boolean","default":false,"description":"Whether an admissible item must have at least one exact reference/evaluation pair whose outcome is verified, whose reference is published in the evidence, and whose claim type and issuer match the buyer's accepted lists as well as the seller's issuer and resolver policy. Setting true requires accepted_attestation_issuers."},"accepted_attestation_issuers":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-issuer.json"},"minItems":1,"uniqueItems":true,"description":"Buyer allowlist for independent attestation issuers. An exact reference/evaluation pair satisfies the requirement only when reference.issuer matches an entry here. This list narrows and never broadens the seller's accepted issuer policy."},"accepted_attestation_claim_types":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1,"uniqueItems":true,"description":"Optional acceptable claim types when attestation is used. Buyer-supplied claim types further constrain but never broaden seller policy."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["requirement_mode","evidence_presence"],"allOf":[{"if":{"properties":{"independent_attestation_required":{"const":true}},"required":["independent_attestation_required"]},"then":{"required":["accepted_attestation_issuers"]}}],"additionalProperties":false},"external:enums/audience-evidence-methodology.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audience-evidence-methodology.json","title":"Audience Evidence Methodology","description":"How a population-level audience-evidence estimate was produced. This vocabulary is intentionally separate from signal-definition methodology: `projected` describes expansion of a sample or panel to a reference population and does not become a user-level signal-membership method.","type":"string","enum":["observed","declared","derived","inferred","modeled","projected"]},"external:enums/audience-subject-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audience-subject-type.json","title":"Audience Subject Type","description":"The kind of subject characterized by audience data or population-level evidence.","type":"string","enum":["individual","household","business","contextual","none"]},"external:enums/audience-resolution-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audience-resolution-method.json","title":"Audience Resolution Method","description":"How subjects were resolved when producing a signal or population-level evidence estimate.","type":"string","enum":["deterministic_id","probabilistic_device","browser","geographic","content_signal","mixed"]},"external:core/attestation-issuer.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/attestation-issuer.json","title":"Attestation Issuer","description":"Canonical identity of the party that issued an attestation credential. The discriminator selects an existing AdCP identity when one exists and falls back to an HTTPS origin for other attestors. This identity is a claim carried by the presentation; evaluators MUST match it against their configured trust policy and verify it from the resolved or embedded credential before relying on it.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationBrandIssuer","type":"object","properties":{"type":{"type":"string","const":"brand","description":"The issuer is identified by an AdCP BrandRef."},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","brand"],"additionalProperties":false},{"title":"AttestationAgentIssuer","type":"object","properties":{"type":{"type":"string","const":"agent","description":"The issuer is an AdCP agent identified by its canonical HTTPS endpoint."},"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"Canonical HTTPS endpoint of the issuing agent. Evaluators compare it using AdCP URL canonicalization rules."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","agent_url"],"additionalProperties":false},{"title":"AttestationOriginIssuer","type":"object","properties":{"type":{"type":"string","const":"origin","description":"The issuer is identified by a canonical HTTPS origin because no AdCP brand or agent identity applies."},"origin":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+$","description":"Canonical HTTPS origin with no path, query, fragment, or userinfo. This identifies the issuer; it does not authorize a fetch."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","origin"],"additionalProperties":false}],"examples":[{"type":"brand","brand":{"domain":"nova-brands.example","brand_id":"nova_motors"}},{"type":"agent","agent_url":"https://attestor.example/adcp"},{"type":"origin","origin":"https://credentials.example"}]},"external:core/audience-evidence-pin.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/audience-evidence-pin.json","title":"Audience Evidence Pin","description":"Buyer-authored pin to one exact immutable audience-evidence snapshot selected during discovery. Sellers MUST match all four fields against a single published snapshot; they MUST reject the package rather than substitute a newer version or reuse snapshot_id with changed content. A confirmed package MUST return the same identity in audience_evidence_selections with decision_use package_construction.","type":"object","properties":{"evidence_id":{"type":"string","minLength":1,"x-entity":"audience_evidence"},"snapshot_id":{"type":"string","minLength":1,"x-entity":"audience_evidence_snapshot"},"version":{"type":"string","minLength":1},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["evidence_id","snapshot_id","version","content_digest"],"additionalProperties":false},"external:core/measurement-terms.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/measurement-terms.json","title":"Measurement Terms","description":"Billing measurement and makegood terms for media buys. Declares who counts the billing metric and what remedies apply when thresholds are breached. Appears on products (seller defaults), package requests (buyer proposals), and confirmed packages (agreed terms). All fields are optional — presence indicates the term is declared or proposed.","type":"object","properties":{"billing_measurement":{"type":"object","description":"Which vendor's value for the billing metric governs invoicing. The billing metric is determined by the pricing_model on the selected pricing_option (e.g., impressions for CPM, completed views for CPCV, commissionable_value for revenue_share).","properties":{"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor whose measurement of the billing metric is authoritative for invoicing (e.g., { domain: 'campaignmanager.google.com' } for buyer's DCM, { domain: 'admanager.google.com' } for seller's GAM)."},"max_variance_percent":{"type":"number","minimum":0,"exclusiveMaximum":100,"description":"Maximum acceptable variance between the billing vendor's count and the other party's count before resolution is triggered (e.g., 10 means a 10% divergence triggers review)."},"measurement_window":{"type":"string","description":"Which measurement maturation stage the billing metric is reconciled against. References a window_id from the product's reporting_capabilities.measurement_windows. Examples: 'c7' for broadcast TV guarantees (live + 7 days DVR), 'final' for DOOH after IVT/fraud-check processing, 'post_sivt' for digital after sophisticated invalid-traffic filtering, 'downloads_30d' for podcast. When absent, billing is based on the seller's standard reporting without windowed maturation.","examples":["live","c3","c7","tentative","final","post_ivt","post_sivt","downloads_30d"]},"finalization_deadline_hours":{"type":"integer","minimum":0,"description":"Maximum hours by which the authoritative party MUST publish a final record (`is_final: true` / `finalized_at` on `get_media_buy_delivery`, or `final: true` / `finalized_at` on `report_usage`). **Anchor:** when `measurement_window` is set, hours are counted from the close of that window (e.g., 240h after `c7` close = ~10 days after the 7-day DVR accumulation completes); when `measurement_window` is absent, hours are counted from `reporting_period.end`. Picking a single anchor avoids ambiguity for windowed channels where `reporting_period.end` and window close differ by days. The deadline applies to whichever party is named in `vendor` — seller, buyer, or third-party vendor — symmetrically. When the deadline elapses without a final record, the counterparty MAY fall back to its own attestation for invoicing (seller falls back to seller-attested numbers via `get_media_buy_delivery`; buyer falls back to a buyer-attested `report_usage` push), and the breach is treated like any other measurement-terms breach under `makegood_policy`. Absent means no contractual deadline — finalization is best-effort and disagreements resolve out of band."}},"required":["vendor"],"additionalProperties":true},"makegood_policy":{"type":"object","description":"Remedies available when a performance standard or billing measurement variance is breached. Seller declares which remedy types they support. When a breach occurs, the seller proposes a remedy from this menu; the buyer accepts or disputes.","properties":{"available_remedies":{"type":"array","description":"Remedy types the seller supports. Ordered by seller preference (first = preferred). Seller proposes from this list when a breach occurs; buyer accepts or disputes.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1makegood-remedy.json"},"minItems":1,"uniqueItems":true}},"required":["available_remedies"],"additionalProperties":true}},"additionalProperties":true},"external:enums/makegood-remedy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/makegood-remedy.json","title":"Makegood Remedy","description":"Remedy types available when a performance standard or billing measurement threshold is breached.","type":"string","enum":["additional_delivery","credit","invoice_adjustment"],"enumDescriptions":{"additional_delivery":"Seller extends or adds impressions to compensate for the shortfall. Delivery is like-for-like on the same campaign or a subsequent campaign within the same account.","credit":"Seller issues a credit toward future media buys on the same account.","invoice_adjustment":"Seller reduces the invoice for the current media buy to reflect actual delivered value."}},"external:core/performance-standard.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/performance-standard.json","title":"Performance Standard","description":"A rate threshold for a performance metric, measured by a specified vendor. The threshold is a floor or ceiling depending on the metric: viewability, completion_rate, brand_safety, and attention_score are floors (must exceed); ivt is a ceiling (must not exceed).","type":"object","properties":{"metric":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1performance-standard-metric.json","description":"The performance metric this standard applies to."},"threshold":{"type":"number","minimum":0,"maximum":1,"description":"Rate threshold as a decimal (e.g., 0.70 for 70%). Whether this is a floor or ceiling depends on the metric: for viewability, completion_rate, brand_safety, attention_score the actual rate must be >= threshold; for ivt the actual rate must be <= threshold."},"standard":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1viewability-standard.json","description":"Measurement standard. Required when metric is 'viewability' (MRC and GroupM define materially different thresholds). Omit for other metrics."},"vendor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Vendor measuring this metric (e.g., { domain: 'doubleverify.com' }). The vendor's brand.json agents array (type: 'measurement') is the discovery point for their measurement agent. When specified on a confirmed package, creatives MUST include tracker_script or tracker_pixel assets from this vendor."}},"required":["metric","threshold","vendor"],"additionalProperties":true},"external:enums/performance-standard-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/performance-standard-metric.json","title":"Performance Standard Metric","description":"Performance metrics that support rate thresholds on media buys — the verification subset of the broader metric vocabulary. Each metric specifies whether its threshold is a floor (must exceed) or ceiling (must not exceed). Shared values with `available-metric.json` mirror the delivery vocabulary (`viewability` → `viewable_rate` family, `completion_rate` → same name); verification-only values (`ivt`, `brand_safety`, `attention_score`) are typically vendor-attested and do not appear in `available-metric.json` because they're not seller-reportable scalars — they flow through `vendor_metric_values` or vendor-scope `committed_metrics` entries with the matching `performance_standard.vendor` BrandRef anchoring identity.","type":"string","enum":["viewability","ivt","completion_rate","brand_safety","attention_score"],"enumDescriptions":{"viewability":"Viewable impression rate (floor — must exceed threshold). Requires viewability_standard. Denominator: measurable_impressions.","ivt":"Invalid Traffic rate (ceiling — must not exceed threshold). Denominator: total_impressions.","completion_rate":"Video or audio completion rate (floor — must exceed threshold). Denominator: total_impressions.","brand_safety":"Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.","attention_score":"Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."}},"external:enums/available-metric.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/available-metric.json","title":"Available Metric","description":"Standard delivery and performance metrics available for reporting. Most values name flat numeric fields of `core/delivery-metrics.json`. Leaf identities address a single numeric value nested inside an object-shaped metric so it can be declared, committed, aggregated, and sorted individually: `quartile_25`/`quartile_50`/`quartile_75`/`quartile_100` resolve to `quartile_data.q1_views`–`q4_views`, and `viewable_rate`/`viewable_impressions`/`measurable_impressions`/`viewed_seconds` resolve to the same-named fields of `viewability`. Structured nested identities `viewed_seconds_percentiles` and `viewed_seconds_histogram` make the corresponding optional distribution carriers discoverable, committable, and requestable, but not aggregatable or sortable. The nested object or array remains the canonical carrier — nested identities never introduce duplicate flat response fields. Container tokens such as `viewability`, `quartile_data`, `dooh_metrics`, and `time_based_views` declare their documented nested surface. **Container subsumption applies only to numeric leaves**: `viewability` subsumes `viewable_rate`, `viewable_impressions`, `measurable_impressions`, and `viewed_seconds`; `quartile_data` subsumes `quartile_25`, `quartile_50`, `quartile_75`, and `quartile_100`. This rule applies to capability declaration, `required_metrics` filtering, format `reported_metrics` intersection, and `requested_metrics` selection. Optional structured identities MUST be declared explicitly: `viewability` alone does not satisfy `viewed_seconds_percentiles` or `viewed_seconds_histogram`. Requesting any nested identity selects its canonical carrier in the response. A nested identity declaration does not imply sibling values or the carrier's non-metric fields.","type":"string","enum":["impressions","spend","clicks","ctr","views","completed_views","completion_rate","conversions","conversion_value","commissionable_value","roas","cost_per_acquisition","new_to_brand_rate","leads","reach","frequency","grps","engagements","engagement_rate","follows","saves","profile_visits","viewability","viewable_rate","viewable_impressions","measurable_impressions","viewed_seconds","viewed_seconds_percentiles","viewed_seconds_histogram","quartile_data","quartile_25","quartile_50","quartile_75","quartile_100","time_based_views","dooh_metrics","ooh_metrics","cost_per_click","cost_per_completed_view","cpm","downloads","units_sold","new_to_brand_units","plays","incremental_sales_lift","brand_lift","foot_traffic","conversion_lift","brand_search_lift"]},"external:enums/completion-source.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/completion-source.json","title":"Completion Source","description":"Trust-source disambiguator for `completion_rate` — *who* attested to the completion event, not *how* (methodology granularity is a separate dimension; future qualifier keys may add it if buyer demand surfaces). The two paths can yield materially different rates, particularly in SSAI environments where the player's view of completion may differ from a vendor's. Used as a `qualifier.completion_source` key on `committed_metrics`, `missing_metrics`, and package-level delivery values (`metric_values` or `vendor_metric_values`) to disambiguate which trust source the row represents. Edge cases: walled gardens where the seller is also the measurement vendor (YouTube, Spotify) collapse to `seller_attested` by trust-model logic — the same party served and counted. IAB-certified first-party podcast measurement (Podtrac, Triton on their own platforms; Art19 on its own platform) likewise collapses to `seller_attested`. The same vendor's offering on a third-party platform (Podtrac on a publisher who isn't Podtrac) is `vendor_attested`. The trust axis is *not* who runs the SDK — it's who is independent of the seller's revenue interest.","type":"string","enum":["seller_attested","vendor_attested"],"enumDescriptions":{"seller_attested":"The party serving the ad witnessed and counted the completion event. Includes ad-server / player completion beacons, walled-garden first-party measurement, and IAB-certified first-party podcast measurement on the platform's own inventory. Source of truth is the seller's delivery infrastructure.","vendor_attested":"An independent third-party measurement vendor (Nielsen, DV, IAS, Moat, HUMAN, Podtrac on third-party inventory, Edison Research panel, etc.) attested to the completion via SDK callbacks, server-beacon validation, or panel methodology. Source of truth is the vendor; vendor identity SHOULD be anchored on a matching `performance_standard.vendor` BrandRef in the buy contract — if a buyer wants vendor-attested completion for transparency without an accountability gate, they MAY commit a vendor metric via `vendor_metrics` on the product rather than `committed_metrics` with this qualifier."}},"external:enums/attribution-methodology.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/attribution-methodology.json","title":"Attribution Methodology","description":"How attribution between ad exposure and outcome events was computed. Used as a `qualifier.attribution_methodology` key on `committed_metrics`, `missing_metrics`, package-level delivery values (`metric_values` or `vendor_metric_values`), and `performance-feedback.metric` to disambiguate the same outcome metric reported under different methodologies — `conversion_value` measured deterministically (matched purchase IDs) is not the same number as `conversion_value` measured probabilistically (modeled match) and should never be summed across methodologies. The retail-media closed-loop pattern typically reports under `deterministic_purchase`; MMM and clean-room outputs typically report under `modeled` or `probabilistic`; panel-based measurement (Nielsen, comScore, Edison) reports under `panel_based`.","type":"string","enum":["deterministic_purchase","probabilistic","panel_based","modeled"],"enumDescriptions":{"deterministic_purchase":"1:1 deterministic match between exposed users and purchasers, typically via shared identifier (loyalty card, logged-in account, hashed email). Standard in retail-media closed-loop measurement (Walmart Connect, Kroger Precision, Amazon DSP attribution).","probabilistic":"Probabilistic match using statistical models over device graphs, IP/UA fingerprinting, or behavioral signals. No 1:1 identifier link.","panel_based":"Panel methodology — outcomes measured against a recruited respondent panel and projected to the population. Standard for Nielsen, comScore, Edison Research, and similar panel providers.","modeled":"Modeled output — Media Mix Modeling (MMM), Multi-Touch Attribution (MTA), incrementality testing, or other statistical inference that produces an estimated outcome rather than a directly-observed match. Includes most clean-room outputs."}},"external:enums/lift-dimension.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/lift-dimension.json","title":"Lift Dimension","description":"Brand-lift dimension disambiguator. Brand lift is multidimensional in production — Kantar, Upwave, Cint, DoubleVerify, and similar vendors report awareness, consideration, favorability, purchase intent, and ad recall as separate measurements with their own sample sizes and confidence intervals. Used as a `qualifier.lift_dimension` key on `committed_metrics`, `missing_metrics`, package-level delivery values (`metric_values` or `vendor_metric_values`), and `performance-feedback.metric` to disambiguate which dimension of `brand_lift` a row represents. Two `brand_lift` rows under different lift dimensions represent different surveyed outcomes and must not be combined into a single number.","type":"string","enum":["awareness","consideration","favorability","purchase_intent","ad_recall"],"enumDescriptions":{"awareness":"Lift in unaided or aided brand awareness — typically measured as 'have you heard of [brand]'.","consideration":"Lift in brand consideration — 'would you consider buying [brand] next time'.","favorability":"Lift in brand favorability or affinity — 'how favorable is your view of [brand]'.","purchase_intent":"Lift in stated purchase intent — 'are you likely to buy [brand] in the next [N] days'.","ad_recall":"Lift in unaided or aided ad recall — 'do you remember seeing an ad for [brand]'."}},"external:core/creative-assignment.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-assignment.json","title":"Creative Assignment","description":"Assignment of a creative asset to a package with optional rotation and placement routing. Used in create_media_buy and update_media_buy requests. Buyers identify the stored creative with `creative_id` only. A generic `id` alias, if present due to adapter-internal payload reuse, is not an AdCP identifier and sellers MUST ignore it on input. Note: sync_creatives does not support package rotation, placement_refs, or placement_ids - use create/update_media_buy for package-level trafficking controls.","type":"object","properties":{"creative_id":{"type":"string","description":"Unique identifier for the creative","x-entity":"creative"},"weight":{"type":"number","description":"Relative delivery weight for this creative (0–100). Valid when the package's effective rotation_mode is weighted, including the backward-compatible default when rotation_mode is omitted. Weights determine impression distribution proportionally — a creative with weight 2 gets twice the delivery of weight 1. When omitted, the creative receives equal weight with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).","minimum":0,"maximum":100},"rotation_mode":{"type":"string","enum":["weighted","even","sequential","random"],"description":"Package-scoped rotation policy repeated on assignment rows for wire compatibility. Omission means weighted, preserving existing weight behavior. Every assignment in a package MUST resolve to the same effective mode: weighted uses relative weights; even balances delivery across eligible assignments; sequential cycles through sequence_position in ascending order within each group; random makes an independent uniform selection from eligible assignments. Sellers MUST reject conflicting effective modes rather than choose one by array order."},"group_id":{"type":"string","minLength":1,"description":"Package-local creative pool identifier. The identifier has no meaning outside this package. Assignments that omit group_id belong to the package's default group; one eligible creative is selected from each applicable group per serving opportunity."},"sequence_position":{"type":"integer","minimum":1,"description":"One-based order within the assignment's package-local group. Required only for sequential rotation and unique within that group."},"placement_refs":{"type":"array","description":"Optional structured product-context refs routing this creative within already-purchased package inventory. These items always use placement-ref product-context semantics, even when tolerated additional members make an item resemble placement-identity. Receivers match only against the package's committed placement set; kind and seller_agent are non-authoritative for routing and MUST NOT expand or reinterpret that set. A receiver MUST reject a ref when the enclosing product and committed set do not yield one unambiguous match. This field never narrows purchased inventory; use targeting_overlay.placement_selection for that. Every ref MUST fall within the package's committed placement selection. New senders SHOULD include publisher_domain for publisher-catalog placements. When omitted, the creative runs across the purchased placements compatible with its format. If both placement_refs and legacy placement_ids are present, placement_refs wins.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-ref.json"},"minItems":1},"placement_ids":{"type":"array","deprecated":true,"description":"Legacy shorthand routing IDs within already-purchased inventory. This field never narrows purchased inventory; use targeting_overlay.placement_selection. New senders SHOULD use placement_refs because IDs are publisher-scoped. If placement_refs is also present, receivers MUST ignore this field.","items":{"type":"string"},"minItems":1}},"required":["creative_id"],"allOf":[{"if":{"properties":{"rotation_mode":{"const":"sequential"}},"required":["rotation_mode"]},"then":{"required":["sequence_position"]}},{"if":{"required":["sequence_position"]},"then":{"properties":{"rotation_mode":{"const":"sequential"}},"required":["rotation_mode"]}},{"if":{"properties":{"rotation_mode":{"enum":["even","sequential","random"]}},"required":["rotation_mode"]},"then":{"not":{"required":["weight"]}}}],"additionalProperties":true},"external:core/creative-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-asset.json","title":"Creative Asset","description":"Creative asset for upload to library — supports static assets, generative formats, and third-party snippets. Identifies which format this creative conforms to via EITHER a legacy `format_id` (structured `{agent_url, id}`) OR a 3.1+ `format_kind` (canonical format name), with optional `format_option_ref` when the target product needs disambiguation. Mutually exclusive — see the `oneOf` at the schema root.","type":"object","properties":{"creative_id":{"type":"string","description":"Unique identifier for the creative. Stable across legacy named-format and 3.1+ canonical-format paths — a creative registered against `format_id` retains the same `creative_id` when later viewed through a canonical-format flatten.","x-entity":"creative"},"name":{"type":"string","description":"Human-readable creative name"},"format_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format path retained for older 3.x peers. New creative assets use `format_kind` and optional `format_option_ref`."},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Canonical format name this creative targets (e.g., `image`, `video_hosted`). Mutually exclusive with deprecated `format_id`."},"format_option_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1format-option-ref.json","description":"3.1+ format-option path, optional. Structured format option reference matching one of the target product's `format_options[]` declarations. Publisher-catalog-backed options match by `{ scope: \"publisher\", publisher_domain, format_option_id }`; product-local options match by `{ scope: \"product\", format_option_id }`. Required when the target product has multiple `format_options` entries sharing the same `format_kind`; optional when `format_kind` alone routes the creative to a single declaration. Product-scoped refs require an enclosing target product/package context."},"representation_selection":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1representation-selection.json","description":"Readback lineage to the complete CreativeRepresentationSet revision and representation selected before this seller-bound creative was synced."},"assets":{"type":"object","description":"Assets required by the format, keyed by asset_id or canonical asset_group_id. Each slot value is either a single asset object or an array of asset objects (for slots with `min`/`max > 1` like carousel `cards` or responsive_creative `headlines`). Each asset value carries an `asset_type` discriminator that selects the matching asset schema, including reference assets such as `published_post` when a product accepts already-published post references.","patternProperties":{"^[a-z0-9_]+$":{"oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":true},"component_assets":{"type":"object","description":"Component-addressed canonical asset maps for `coordinated_placements`. Keys match coordinated component IDs. This field is preserved by creative-library sync and list readback; it MUST be absent for every other format kind.","patternProperties":{"^[a-z][a-z0-9_]*$":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-assets.json"}},"additionalProperties":false},"inputs":{"type":"array","description":"Preview contexts for generative formats - defines what scenarios to generate previews for","items":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable name for this preview variant"},"macros":{"type":"object","description":"Macro values to apply for this preview","additionalProperties":{"type":"string"}},"context_description":{"type":"string","description":"Natural language description of the context for AI-generated content"}},"required":["name"],"additionalProperties":true}},"tags":{"type":"array","description":"User-defined tags for organization and searchability","items":{"type":"string"}},"status":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1creative-status.json","description":"For generative creatives: set to 'approved' to finalize, 'rejected' to request regeneration with updated assets/message. Omit for non-generative creatives (system will set based on processing state)."},"weight":{"type":"number","description":"Optional delivery weight for creative rotation when uploading via create_media_buy or update_media_buy (0-100). If omitted, platform determines rotation. Only used during upload to media buy - not stored in creative library.","minimum":0,"maximum":100},"placement_refs":{"type":"array","description":"Optional structured product-context placement references where this uploaded creative should run when uploading via create_media_buy or update_media_buy. These items always use placement-ref product-context semantics, even when tolerated additional members make an item resemble placement-identity. Receivers match only against the target package's committed placement set; kind and seller_agent are non-authoritative for routing and MUST NOT expand or reinterpret that set. A receiver MUST reject a ref when the enclosing product and committed set do not yield one unambiguous match. New senders SHOULD include publisher_domain for publisher-catalog placements. If omitted, creative runs on all buyer-targetable placements. If both `placement_refs` and legacy `placement_ids` are present, `placement_refs` wins and receivers MUST ignore `placement_ids`. Only used during upload to media buy - not stored in creative library.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1placement-ref.json"},"minItems":1},"placement_ids":{"type":"array","deprecated":true,"description":"Legacy shorthand array of placement IDs where this creative should run when uploading via create_media_buy or update_media_buy. New senders SHOULD use `placement_refs` because placement IDs are publisher-scoped and strings are ambiguous in multi-publisher products. If omitted, creative runs on all buyer-targetable placements. If `placement_refs` is also present, receivers MUST ignore this field. Only used during upload to media buy - not stored in creative library.","items":{"type":"string"},"minItems":1},"industry_identifiers":{"type":"array","description":"Industry-standard or market-specific identifiers for this creative (e.g., Ad-ID, ISCI, Clearcast clock number, IDcrea). In broadcast and scheduled audio/video buying, these identifiers tie the creative to rotation instructions, clearance records, and traffic systems. A creative may have multiple identifiers when different systems reference the same asset. Add a PR to extend creative-identifier-type when another shared identifier scheme needs first-class support.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1industry-identifier.json"},"uniqueItems":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this creative. Serves as the default provenance for all manifests and assets within this creative. A manifest or asset with its own provenance replaces this object entirely (no field-level merging)."},"rights":{"type":"array","description":"Rights constraints that MUST survive sync, package assignment, and list readback. Buyer-carried constraints and references do not authorize serving; the seller evaluates them under media_buy.rights_attestations and its adcp.attestations policy.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1rights-constraint.json"},"minItems":1}},"required":["creative_id","name","assets"],"not":{"anyOf":[{"required":["capability_id"]},{"required":["capability_ref"]}]},"oneOf":[{"title":"v1 creative (named-format reference)","deprecated":true,"description":"Deprecated 3.x compatibility branch using a structured named-format reference.","required":["format_id"],"not":{"required":["format_kind"]}},{"title":"v2 creative (canonical format kind)","description":"Creative declares the portable canonical contract it targets via `format_kind` and optional `format_option_ref`.","required":["format_kind"],"not":{"required":["format_id"]}}],"allOf":[{"if":{"properties":{"format_kind":{"const":"coordinated_placements"}},"required":["format_kind"]},"then":{"required":["component_assets"]},"else":{"not":{"required":["component_assets"]}}}],"additionalProperties":true},"external:core/representation-selection.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/representation-selection.json","title":"Representation Selection","description":"Readback lineage from a seller-bound manifest or CreativeAsset to the exact CreativeRepresentationSet revision and representation selected for it. This is selection lineage, not served-variant identity.","x-adcp-validation":{"verifier_constraints":{"source_set":{"creative_id":"must equal the source CreativeRepresentationSet creative_id","revision_id":"must equal the source CreativeRepresentationSet revision_id","revision_content_digest":"must equal the verified digest of the complete source CreativeRepresentationSet","selected_representation_id":"must identify exactly one member of the complete source representations array","strategy":"must equal the capability-advertised strategy requested for this resolution"},"derived_output":{"source_revision_unchanged":"selection, macro binding, translation, and transcoding MUST NOT change the source revision binding","canonical_content":"RFC 8785 JCS of the manifest projection after removing exactly top-level $schema, representation_selection, creative_id, revision_id, name, tags, status, weight, placement_refs, placement_ids, and inputs properties; every other field, including unknown delivery fields, is included","shared_projection":"apply the same exclusion list to the returned CreativeManifest and to its later CreativeAsset sync wrapper so library metadata never changes the digest","selected_output_digest":"must equal lowercase-hex SHA-256 of derived-output canonical content before receiving-seller normalization","review_identity":"the receiving seller tracks (selected_representation_id, selected_output_digest, execution_vast_version-or-null, execution_daast_version-or-null) separately from the source revision; changing any member is an updated execution that follows ordinary re-review without minting a buyer revision","execution_version":"each execution version MUST equal the verified representation destination and later immutable package snapshot; a package mismatch requires re-resolution and ordinary re-review rather than silent rebinding","approval_boundary":"the exact selected output MUST complete the receiving seller's ordinary validation and review before serving; approval of one candidate never approves another","runtime_selection":"selection is pinned at trafficking time and MUST NOT be changed per viewer or device; device and player fallback stays within the selected manifest or VAST document","selection_stability":"after sync_creatives accepts this lineage, later product, placement, VAST, macro, or seller-capability changes MUST NOT cause implicit re-resolution, lineage replacement, or buyer re-review; only an explicit buyer-submitted selected output may replace it","seller_inability":"if the seller can no longer serve the pinned execution, it MUST preserve this lineage and use ordinary seller/system creative-status and media-buy impairment surfaces rather than silently substituting another representation"}},"spec":"docs/creative/representation-sets.mdx#seller-bound-resolution"},"type":"object","properties":{"creative_id":{"type":"string","minLength":1,"x-entity":"creative"},"revision_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-revision-id.json"},"revision_content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Verified digest from the complete source representation set. A downstream seller uses this value, not the selected manifest bytes alone, to enforce immutable revision reuse."},"selected_representation_id":{"type":"string","minLength":1,"x-entity":"creative_representation"},"strategy":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1representation-selection-strategy.json","description":"Deterministic strategy applied after compatibility filtering."},"selected_output_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Digest of the derived seller-bound manifest projection, computed with RFC 8785 JCS after removing exactly top-level `$schema`, `representation_selection`, `creative_id`, `revision_id`, `name`, `tags`, `status`, `weight`, `placement_refs`, `placement_ids`, and `inputs`. Every other field, including unknown delivery fields, is included. The identical exclusion list applies to the returned CreativeManifest and its later CreativeAsset sync wrapper. A selected sync item cannot carry localization in this version. This is the review/execution fingerprint for the projection, distinct from revision_content_digest, which binds the complete source set."},"execution_vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-version.json","description":"Exact VAST version verified for seller-assembled first-class VAST trackers. This is selection lineage and part of the execution review identity; it is not included in selected_output_digest."},"execution_daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-version.json","description":"Exact DAAST version verified for seller-assembled first-class DAAST trackers. This is selection lineage and part of the execution review identity; it is not included in selected_output_digest."},"resolved_by":{"type":"string","enum":["buyer","seller"],"description":"Who performed deterministic compatibility resolution. A buyer may resolve locally from seller discovery. Seller resolution is valid only on the destination sales agent when it advertised representation_resolution; an independent creative agent cannot claim seller-bound compatibility."}},"required":["creative_id","revision_id","revision_content_digest","selected_representation_id","strategy","selected_output_digest","resolved_by"],"additionalProperties":false},"external:core/creative-revision-id.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-revision-id.json","title":"Creative Revision ID","description":"Buyer-assigned identity for one immutable input-content state of a durable creative. Scoped to the parent creative_id. Seller transcoding, normalization, and delivery representations do not change this identity.","type":"string","minLength":1,"maxLength":255,"x-entity":"creative_revision"},"external:enums/representation-selection-strategy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/representation-selection-strategy.json","title":"Representation Selection Strategy","description":"Deterministic strategy used after filtering a CreativeRepresentationSet against one seller destination contract. `representation_order` selects the first compatible representation in source array order. `highest_compatible_vast` is valid only when the destination format_kind is `video_vast` or `audio_vast`; it selects the compatible VAST representation with the highest exact VAST version, and equal-version ties are resolved by source array order. Using it for another format is INVALID_REQUEST and never falls back silently.","type":"string","enum":["representation_order","highest_compatible_vast"]},"external:enums/vast-version.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/vast-version.json","title":"VAST Version","description":"Supported VAST (Video Ad Serving Template) specification versions. Covers every version published by IAB Tech Lab, through VAST 4.3 (released December 2022). The value mirrors the `version` attribute a VAST document declares on its root element.","$comment":"VAST 4.3 ships no XSD of its own: IAB's `vast_4.2.xsd` remains the authoritative schema for 4.3 documents, so a validator MUST NOT reject a tag declaring `version=\"4.3\"` for want of a 4.3 schema. VAST 4.4 is deliberately absent because `vast_4.4.xsd` is annotated 'DRAFT for working group discussion' and is not a published specification; add it once IAB publishes it, not before. This file is the single source of truth for the roster, per the Enum Consolidation rule in docs/spec-guidelines.md, and other schemas `$ref` it rather than restating the list.","type":"string","enum":["2.0","3.0","4.0","4.1","4.2","4.3"]},"external:enums/daast-version.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/daast-version.json","title":"DAAST Version","description":"Supported DAAST (Digital Audio Ad Serving Template) specification versions","type":"string","enum":["1.0","1.1"]},"external:core/assets/asset-union.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/asset-union.json","title":"AssetVariant","description":"Canonical union of all asset variant schemas. Referenced from creative-asset.json and creative-manifest.json to ensure a single named type is emitted by schema-to-TypeScript tooling. Add new asset types here and to the creative/asset-types registry.","x-adcp-hoist":true,"type":"object","oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1video-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1audio-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1vast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1display-tag-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1text-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1url-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1html-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1javascript-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1zip-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1webhook-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1css-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1daast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1markdown-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1brief-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1catalog-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1published-post-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1card-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1pixel-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1vast-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1daast-tracker-asset.json"}],"discriminator":{"propertyName":"asset_type"}},"external:core/assets/video-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/video-asset.json","title":"Video Asset","description":"A hosted video file delivered directly (e.g., an MP4 you host), with URL and technical specifications including audio track properties. `width` and `height` are required because a hosted video file has intrinsic, native pixel dimensions that are known when the file is created. Tag-delivered video uses the separate `vast` asset, which carries no `width`/`height`: a VAST response resolves geometry per-`MediaFile` at serve time, so there is no single width/height for the ad. Aspect-ratio and size *constraints* (what a placement accepts) belong on the format/requirements layer, not on the asset.","$comment":"Dimension policy is deliberate and differs by asset type: a hosted `video` asset requires width/height (intrinsic pixels of a concrete file), while the `vast` asset omits them entirely (renditions are selected per-MediaFile by the player at serve time). Do not infer that AdCP forces a single width/height onto all video — only onto hosted files.","type":"object","properties":{"asset_type":{"type":"string","const":"video","description":"Discriminator identifying this as a video asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the video asset"},"width":{"type":"integer","minimum":1,"description":"Width in pixels — the video file's intrinsic native width. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no width; see the `vast` asset.)"},"height":{"type":"integer","minimum":1,"description":"Height in pixels — the video file's intrinsic native height. Required: a hosted file always has concrete dimensions. (Tag-delivered video carries no height; see the `vast` asset.)"},"duration_ms":{"type":"integer","description":"Video duration in milliseconds","minimum":1},"file_size_bytes":{"type":"integer","description":"File size in bytes","minimum":1},"container_format":{"type":"string","description":"Video container format (mp4, webm, mov, etc.)"},"video_codec":{"type":"string","description":"Video codec used (h264, h265, vp9, av1, prores, etc.)"},"video_bitrate_kbps":{"type":"integer","description":"Video stream bitrate in kilobits per second","minimum":1},"frame_rate":{"type":"string","description":"Frame rate as string to preserve precision (e.g., '23.976', '29.97', '30')"},"frame_rate_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1frame-rate-type.json"},"scan_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1scan-type.json"},"color_space":{"type":"string","enum":["rec709","rec2020","rec2100","srgb","dci_p3"],"description":"Color space of the video"},"hdr_format":{"type":"string","enum":["sdr","hdr10","hdr10_plus","hlg","dolby_vision"],"description":"HDR format if applicable, or 'sdr' for standard dynamic range"},"chroma_subsampling":{"type":"string","enum":["4:2:0","4:2:2","4:4:4"],"description":"Chroma subsampling format"},"video_bit_depth":{"type":"integer","enum":[8,10,12],"description":"Video bit depth"},"gop_interval_seconds":{"type":"number","description":"GOP/keyframe interval in seconds"},"gop_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1gop-type.json"},"moov_atom_position":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1moov-atom-position.json"},"has_audio":{"type":"boolean","description":"Whether the video contains an audio track"},"audio_codec":{"type":"string","description":"Audio codec used (aac, aac_lc, he_aac, pcm, mp3, ac3, eac3, etc.)"},"audio_sampling_rate_hz":{"type":"integer","description":"Audio sampling rate in Hz (e.g., 44100, 48000)"},"audio_channels":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audio-channel-layout.json","description":"Audio channel configuration"},"audio_bit_depth":{"type":"integer","enum":[16,24,32],"description":"Audio bit depth"},"audio_bitrate_kbps":{"type":"integer","description":"Audio bitrate in kilobits per second","minimum":1},"audio_loudness_lufs":{"type":"number","description":"Integrated loudness in LUFS"},"audio_true_peak_dbfs":{"type":"number","description":"True peak level in dBFS"},"captions_url":{"type":"string","format":"uri","description":"URL to captions file (WebVTT, SRT, etc.)","x-accessibility":true},"transcript_url":{"type":"string","format":"uri","description":"URL to text transcript of the video content","x-accessibility":true},"audio_description_url":{"type":"string","format":"uri","description":"URL to audio description track for visually impaired users","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","width","height"],"additionalProperties":true},"external:enums/frame-rate-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/frame-rate-type.json","title":"Frame Rate Type","description":"Whether the video uses a constant or variable frame rate. Broadcast and SSAI contexts require constant frame rate for seamless splicing.","type":"string","enum":["constant","variable"],"enumDescriptions":{"constant":"Constant frame rate (CFR) — each frame occupies an identical time interval","variable":"Variable frame rate (VFR) — frame intervals may differ"}},"external:enums/scan-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/scan-type.json","title":"Scan Type","description":"Video scan method. Modern digital delivery requires progressive scan; interlaced is retained for broadcast legacy content.","type":"string","enum":["progressive","interlaced"],"enumDescriptions":{"progressive":"All lines of each frame are drawn in sequence","interlaced":"Alternating lines drawn in two passes per frame (legacy broadcast)"}},"external:enums/gop-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/gop-type.json","title":"GOP Type","description":"Group of Pictures structure. SSAI and broadcast require closed GOPs for clean splice points; open GOPs may produce artifacts at ad boundaries.","type":"string","enum":["closed","open"],"enumDescriptions":{"closed":"Each GOP is independently decodable — required for SSAI and broadcast splicing","open":"GOPs may reference frames from adjacent GOPs — not suitable for splicing"}},"external:enums/moov-atom-position.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/moov-atom-position.json","title":"Moov Atom Position","description":"Position of the moov atom in an MP4 container. 'start' enables progressive download without buffering the entire file; required for streaming ad delivery.","type":"string","enum":["start","end"],"enumDescriptions":{"start":"moov atom at beginning of file — enables progressive download and streaming delivery","end":"moov atom at end of file — requires full download before playback can begin"}},"external:enums/audio-channel-layout.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/audio-channel-layout.json","title":"Audio Channel Layout","description":"Audio channel configuration for audio and video assets","type":"string","enum":["mono","stereo","5.1","7.1"]},"external:core/assets/audio-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/audio-asset.json","title":"Audio Asset","description":"Audio asset with URL and technical specifications","type":"object","properties":{"asset_type":{"type":"string","const":"audio","description":"Discriminator identifying this as an audio asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL to the audio asset"},"duration_ms":{"type":"integer","description":"Audio duration in milliseconds","minimum":0},"file_size_bytes":{"type":"integer","description":"File size in bytes","minimum":1},"container_format":{"type":"string","description":"Audio container/file format (mp3, m4a, aac, wav, ogg, flac, etc.)"},"codec":{"type":"string","description":"Audio codec used (aac, aac_lc, he_aac, pcm, mp3, vorbis, opus, flac, ac3, eac3, etc.)"},"sampling_rate_hz":{"type":"integer","description":"Sampling rate in Hz (e.g., 44100, 48000, 96000)"},"channels":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1audio-channel-layout.json","description":"Channel configuration"},"bit_depth":{"type":"integer","enum":[16,24,32],"description":"Bit depth"},"bitrate_kbps":{"type":"integer","description":"Bitrate in kilobits per second","minimum":1},"loudness_lufs":{"type":"number","description":"Integrated loudness in LUFS"},"true_peak_dbfs":{"type":"number","description":"True peak level in dBFS"},"transcript_url":{"type":"string","format":"uri","description":"URL to text transcript of the audio content","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url"],"additionalProperties":true},"external:core/assets/vast-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/vast-asset.json","title":"VAST Asset","description":"VAST (Video Ad Serving Template) tag for third-party video or audio ad serving. Unlike a hosted media asset, a VAST tag carries no single `width`/`height`: a response can return multiple renditions and the player selects one at serve time. Standardized VAST audio support begins at 4.1 and uses MediaFile width and height values of 0; older audio-in-VAST versions are seller-declared legacy interoperability. Dimensional, duration, MIME-type, and codec constraints live on the format/requirements layer, not on this asset.","type":"object","properties":{"asset_type":{"type":"string","const":"vast","description":"Discriminator identifying this as a VAST asset. See /schemas/creative/asset-types for the registry."},"vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-version.json","description":"Exact VAST version declared by the supplied URL response or inline document. Required by the 3.2 canonical `video_vast` and `audio_vast` manifest paths; optional only on the deprecated named-format compatibility path. Receivers MUST NOT relabel or synthesize a newer version merely because the destination accepts it."},"macro_declarations":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},"minItems":1,"description":"One declaration per exact occurrence in a field carried by this asset. A URL-delivered asset can declare only occurrences in its locator `url`; tokens discovered later in a fetched VAST response require document validation evidence or an inline/snapshotted asset and MUST NOT be guessed from the locator. IAB tokens cite a registry namespace and revision rather than copying the live registry into AdCP."},"vpaid_enabled":{"type":"boolean","description":"Whether VPAID (Video Player-Ad Interface Definition) is supported"},"duration_ms":{"type":"integer","description":"Expected media duration in milliseconds (if known)","minimum":0},"tracking_events":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-tracking-event.json"},"description":"Tracking events supported by this VAST tag"},"captions_url":{"type":"string","format":"uri","description":"URL to captions file (WebVTT, SRT, etc.)","x-accessibility":true},"audio_description_url":{"type":"string","format":"uri","description":"URL to audio description track for visually impaired users","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type"],"oneOf":[{"properties":{"delivery_type":{"type":"string","const":"url","description":"Discriminator indicating VAST is delivered via URL endpoint"},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"URL endpoint returning VAST XML. Macro delimiters remain byte-preserved; declarations distinguish occurrences in this locator URL from occurrences in inline or fetched VAST content."},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}}},"required":["delivery_type","url"]},{"properties":{"delivery_type":{"type":"string","const":"inline","description":"Discriminator indicating VAST is delivered as inline XML content"},"content":{"type":"string","description":"Inline VAST XML content"},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"content"}}}}}}},"required":["delivery_type","content"]}],"discriminator":{"propertyName":"delivery_type"},"additionalProperties":true},"external:core/macro-declaration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/macro-declaration.json","title":"Macro Declaration","description":"The source-faithful contract for one occurrence of one macro token. It identifies the current dialect, verified mapping status, exact asset-field occurrence, next processing operation, actor, and encoding. Translation and concrete value resolution are separate operations: a translator emits the declared native token and replaces this declaration with the target declaration. Unknown tokens are always byte-preserved.","x-adcp-validation":{"verifier_constraints":{"adcp_semantic_identity":"when dialect is adcp, dialect_semantic must equal universal_semantic","declaration_id_uniqueness":"declaration_id must be unique within the containing asset","token_occurrence":"location must identify the declared zero-based occurrence of token in location.field","asset_field":"location.field must exist on and be permitted by the containing asset type","catalog_universal_profile":"catalog semantics require seller resolve_value in a URL context with exactly one rfc3986 pass","omit_parameter_scope":"omit_parameter requires the token to occupy the complete URL query-parameter value"},"spec":"docs/creative/universal-macros.mdx#declared-source-token-contracts"},"type":"object","properties":{"declaration_id":{"type":"string","pattern":"^[A-Za-z0-9_-]+$","minLength":1,"x-entity":"macro_declaration","description":"Identifier unique within the enclosing asset, used to correlate validation results."},"token":{"type":"string","minLength":1,"description":"Exact byte-preserved token expression at this occurrence, including delimiters."},"dialect":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-dialect.json"},"dialect_namespace":{"type":"string","format":"uri","description":"Authority-controlled registry or mapping URI. Required for IAB VAST, IAB DAAST, and vendor dialects."},"dialect_revision":{"type":"string","minLength":1,"description":"Immutable registry/mapping revision, release, commit, or digest. Required for IAB VAST, IAB DAAST, and vendor dialects."},"dialect_semantic":{"type":"string","minLength":1,"description":"Exact semantic identifier in the cited dialect, such as `CACHEBUSTING`, `PLAYERSTATE`, or a documented vendor name. This is not inferred from token spelling."},"mapping_status":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-mapping-status.json"},"universal_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json","description":"Verified AdCP universal meaning. Present only when mapping_status is `verified_universal`."},"operation":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-processing-operation.json"},"performed_by":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-resolver.json","description":"Actor authorized to perform the declared translation or value resolution. Omitted for preservation."},"translation_target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-translation-target.json","description":"Required only for `translate_to_native`. The output token contract that replaces this declaration after translation."},"location":{"type":"object","properties":{"field":{"type":"string","enum":["url","markup","content","ad_request_url","clickthrough_url"],"description":"Asset field containing this occurrence."},"occurrence":{"type":"integer","minimum":0,"description":"Zero-based occurrence of this exact token within the named field."},"context":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-value-context.json"}},"required":["field","occurrence","context"],"additionalProperties":false},"encoding":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-encoding.json","description":"Encoding for the concrete value. Translation/preservation uses `none` at depth zero."},"required":{"type":"boolean","description":"Whether terminal delivery must fail if the declared operation cannot complete."},"unavailable_behavior":{"type":"string","enum":["preserve","omit_parameter","dialect_sentinel","reject"],"description":"Action when the responsible actor has no value. Omission is legal only for a complete URL query-value occurrence; dialect sentinels require a cited dialect rule."}},"required":["declaration_id","token","dialect","dialect_semantic","mapping_status","operation","location","encoding","required","unavailable_behavior"],"additionalProperties":false,"allOf":[{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast","vendor"]}},"required":["dialect"]},"then":{"required":["dialect_namespace","dialect_revision"]}},{"if":{"properties":{"dialect":{"enum":["adcp","unknown"]}},"required":["dialect"]},"then":{"not":{"anyOf":[{"required":["dialect_namespace"]},{"required":["dialect_revision"]}]}}},{"if":{"properties":{"mapping_status":{"const":"verified_universal"}},"required":["mapping_status"]},"then":{"required":["universal_semantic"]},"else":{"not":{"required":["universal_semantic"]}}},{"if":{"properties":{"dialect":{"const":"adcp"}},"required":["dialect"]},"then":{"required":["universal_semantic"],"properties":{"dialect_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},"mapping_status":{"const":"verified_universal"}}}},{"if":{"properties":{"dialect":{"const":"unknown"}},"required":["dialect"]},"then":{"properties":{"mapping_status":{"const":"unresolved"},"operation":{"const":"preserve"},"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}},"required":{"const":false},"unavailable_behavior":{"const":"preserve"}},"not":{"anyOf":[{"required":["performed_by"]},{"required":["translation_target"]},{"required":["universal_semantic"]}]}}},{"if":{"properties":{"operation":{"const":"translate_to_native"}},"required":["operation"]},"then":{"required":["performed_by","translation_target"],"properties":{"mapping_status":{"enum":["verified_universal","dialect_defined"]},"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}}}}},{"if":{"properties":{"operation":{"const":"resolve_value"}},"required":["operation"]},"then":{"required":["performed_by"],"properties":{"mapping_status":{"enum":["verified_universal","dialect_defined"]}},"not":{"required":["translation_target"]}}},{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast"]},"operation":{"const":"resolve_value"}},"required":["dialect","operation"]},"then":{"properties":{"performed_by":{"const":"request_executor"}}}},{"if":{"properties":{"operation":{"const":"preserve"}},"required":["operation"]},"then":{"properties":{"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}},"required":{"const":false},"unavailable_behavior":{"const":"preserve"}},"not":{"anyOf":[{"required":["performed_by"]},{"required":["translation_target"]}]}}},{"if":{"properties":{"location":{"properties":{"context":{"const":"opaque"}},"required":["context"]}},"required":["location"]},"then":{"properties":{"operation":{"const":"preserve"},"encoding":{"properties":{"kind":{"const":"none"},"depth":{"const":0}}},"required":{"const":false},"unavailable_behavior":{"const":"preserve"}}}},{"if":{"properties":{"universal_semantic":{"enum":["CATALOG_ID","SKU","GTIN","OFFERING_ID","JOB_ID","HOTEL_ID","FLIGHT_ID","VEHICLE_ID","LISTING_ID","STORE_ID","PROGRAM_ID","DESTINATION_ID","ITEM_NAME","ITEM_DESCRIPTION","ITEM_TAGLINE","ITEM_PRICE","ITEM_PRICE_CURRENCY"]}},"required":["universal_semantic"]},"then":{"properties":{"operation":{"const":"resolve_value"},"performed_by":{"const":"seller"},"location":{"properties":{"context":{"enum":["url_query_value","url_path_segment"]}}},"encoding":{"properties":{"kind":{"const":"rfc3986"},"depth":{"const":1}}}}}},{"if":{"properties":{"required":{"const":true}},"required":["required"]},"then":{"properties":{"unavailable_behavior":{"const":"reject"}}}},{"if":{"properties":{"unavailable_behavior":{"const":"omit_parameter"}},"required":["unavailable_behavior"]},"then":{"properties":{"operation":{"const":"resolve_value"},"location":{"properties":{"context":{"const":"url_query_value"}}}}}},{"if":{"properties":{"unavailable_behavior":{"const":"preserve"}},"required":["unavailable_behavior"]},"then":{"properties":{"operation":{"const":"preserve"}}}},{"if":{"properties":{"unavailable_behavior":{"const":"dialect_sentinel"}},"required":["unavailable_behavior"]},"then":{"properties":{"dialect":{"const":"iab_vast"},"operation":{"const":"resolve_value"},"required":{"const":false}}}}]},"external:enums/macro-dialect.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/macro-dialect.json","title":"Macro Dialect Family","description":"Governed family for a creative macro token. `vendor` is qualified by an authority-controlled namespace and immutable revision on the declaration/capability; AdCP does not enumerate companies as dialects. `unknown` is declaration-only and always byte-preserved.","type":"string","enum":["adcp","iab_vast","iab_daast","vendor","unknown"],"enumDescriptions":{"adcp":"AdCP universal macro syntax and semantics.","iab_vast":"IAB VAST macro syntax, qualified by the referenced live-registry revision.","iab_daast":"IAB DAAST macro syntax, qualified by the referenced specification/registry revision.","vendor":"A vendor- or platform-owned macro namespace, qualified by its authoritative URI and immutable revision.","unknown":"The token namespace cannot be established. Preserve the token unchanged and never advertise it as resolvable."}},"external:enums/macro-mapping-status.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/macro-mapping-status.json","title":"Macro Mapping Status","description":"Evidence level connecting a dialect-local macro meaning to the AdCP universal vocabulary.","type":"string","enum":["verified_universal","dialect_defined","unresolved"],"enumDescriptions":{"verified_universal":"The cited dialect mapping verifies an AdCP universal semantic.","dialect_defined":"The dialect defines the token, but no AdCP universal semantic is asserted.","unresolved":"No safe meaning is established; the token remains byte-preserved."}},"external:enums/universal-macro.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/universal-macro.json","title":"Universal Macro","description":"Standardized macro placeholders for dynamic value substitution in creative tracking URLs. Macros are replaced with actual values at impression time. See docs/creative/universal-macros.mdx for detailed documentation.","type":"string","enum":["MEDIA_BUY_ID","PACKAGE_ID","CREATIVE_ID","CACHEBUSTER","TIMESTAMP","CLICK_URL","GDPR","GDPR_CONSENT","US_PRIVACY","GPP_STRING","GPP_SID","IP_ADDRESS","LIMIT_AD_TRACKING","DEVICE_TYPE","OS","OS_VERSION","DEVICE_MAKE","DEVICE_MODEL","USER_AGENT","APP_BUNDLE","APP_NAME","COUNTRY","REGION","CITY","ZIP","DMA","LAT","LONG","DEVICE_ID","DEVICE_ID_TYPE","DOMAIN","PAGE_URL","REFERRER","KEYWORDS","PLACEMENT_ID","FOLD_POSITION","AD_WIDTH","AD_HEIGHT","VIDEO_ID","VIDEO_TITLE","VIDEO_DURATION","VIDEO_CATEGORY","CONTENT_GENRE","CONTENT_RATING","PLAYER_WIDTH","PLAYER_HEIGHT","POD_POSITION","POD_SIZE","AD_BREAK_ID","STATION_ID","COLLECTION_NAME","INSTALLMENT_ID","AUDIO_DURATION","TMPX","IMPRESSION_ID","AXEM","CATALOG_ID","SKU","GTIN","OFFERING_ID","JOB_ID","HOTEL_ID","FLIGHT_ID","VEHICLE_ID","LISTING_ID","STORE_ID","PROGRAM_ID","DESTINATION_ID","CREATIVE_VARIANT_ID","APP_ITEM_ID","ITEM_NAME","ITEM_DESCRIPTION","ITEM_TAGLINE","ITEM_PRICE","ITEM_PRICE_CURRENCY"],"enumDescriptions":{"MEDIA_BUY_ID":"AdCP media buy identifier","PACKAGE_ID":"AdCP package identifier","CREATIVE_ID":"AdCP creative identifier","CACHEBUSTER":"Random number to prevent caching","TIMESTAMP":"Unix timestamp in milliseconds","CLICK_URL":"Publisher's click tracking URL (auto-inserted by sales agent)","GDPR":"GDPR applicability flag (1=applies, 0=doesn't apply)","GDPR_CONSENT":"IAB TCF 2.0 consent string","US_PRIVACY":"US Privacy (CCPA) string","GPP_STRING":"Global Privacy Platform consent string","GPP_SID":"GPP Section ID(s) indicating applicable privacy framework sections","IP_ADDRESS":"User IP address (often masked for privacy, may return empty)","LIMIT_AD_TRACKING":"Limit Ad Tracking enabled (1=limited, 0=allowed)","DEVICE_TYPE":"Device category (mobile, tablet, desktop, ctv, dooh)","OS":"Operating system (iOS, Android, tvOS, Roku, etc.)","OS_VERSION":"OS version number","DEVICE_MAKE":"Device manufacturer","DEVICE_MODEL":"Device model identifier","USER_AGENT":"Full user agent string","APP_BUNDLE":"App bundle ID (domain or numeric)","APP_NAME":"Human-readable app name","COUNTRY":"ISO 3166-1 alpha-2 country code","REGION":"State/province/region code","CITY":"City name","ZIP":"Postal code","DMA":"Nielsen DMA code (US TV markets)","LAT":"Latitude coordinate","LONG":"Longitude coordinate","DEVICE_ID":"Mobile advertising ID (IDFA/AAID)","DEVICE_ID_TYPE":"Type of device ID (idfa, aaid)","DOMAIN":"Domain where ad is shown","PAGE_URL":"Full page URL (encoded)","REFERRER":"HTTP referrer URL","KEYWORDS":"Page keywords (comma-separated)","PLACEMENT_ID":"Global Placement ID (IAB standard)","FOLD_POSITION":"Position relative to fold (above_fold, below_fold)","AD_WIDTH":"Ad slot width in pixels","AD_HEIGHT":"Ad slot height in pixels","VIDEO_ID":"Content video identifier","VIDEO_TITLE":"Content video title","VIDEO_DURATION":"Content duration in seconds","VIDEO_CATEGORY":"IAB content category","CONTENT_GENRE":"Content genre (news, sports, comedy, etc.)","CONTENT_RATING":"Content rating (G, PG, TV-14, etc.)","PLAYER_WIDTH":"Video player width in pixels","PLAYER_HEIGHT":"Video player height in pixels","POD_POSITION":"Position within ad break","POD_SIZE":"Total ads in the ad break","AD_BREAK_ID":"Unique ad break identifier","STATION_ID":"Radio station or podcast identifier","COLLECTION_NAME":"Program or collection name","INSTALLMENT_ID":"Installment identifier (podcast episode, print issue, etc.)","AUDIO_DURATION":"Audio content duration in seconds","TMPX":"TMP exposure token — HPKE-encrypted identity tokens for per-user exposure tracking. Produced by Identity Match, substituted into creative tracking URLs, received by the buyer's impression pixel.","IMPRESSION_ID":"Opaque, collision-resistant identifier for one impression opportunity. Used for impression deduplication, cross-vendor reconciliation, pixel-retry dedup, and TMP cross-identity exposure dedup. Minted by the publisher, ad-decision layer, or buyer at {TMPX} decode; required upstream for TMP context-only impressions where {TMPX} is absent.","AXEM":"AXE contextual metadata (encoded blob). Legacy — in TMP, use Offer creative_data for dynamic creative values and TMPX for exposure tracking.","CATALOG_ID":"Buyer-defined catalog identifier from the catalog's catalog_id field","SKU":"Product SKU identifier for the catalog item being rendered","GTIN":"Global Trade Item Number for the catalog item being rendered","OFFERING_ID":"AdCP offering identifier for the catalog item being rendered","JOB_ID":"Job posting identifier for the catalog item being rendered","HOTEL_ID":"Hotel property identifier for the catalog item being rendered","FLIGHT_ID":"Flight route identifier for the catalog item being rendered","VEHICLE_ID":"Vehicle listing identifier for the catalog item being rendered","LISTING_ID":"Real estate listing identifier for the catalog item being rendered","STORE_ID":"Store location identifier for the catalog item being rendered","PROGRAM_ID":"Education program identifier for the catalog item being rendered","DESTINATION_ID":"Travel destination identifier for the catalog item being rendered","CREATIVE_VARIANT_ID":"Seller-assigned creative variant identifier, passed through at serve time","APP_ITEM_ID":"Mobile app identifier for the catalog item being rendered","ITEM_NAME":"Name/title of the catalog item being rendered (catalog_field: name). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_DESCRIPTION":"Description of the catalog item being rendered (catalog_field: description). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_TAGLINE":"Short promotional tagline of the catalog item being rendered (catalog_field: tagline). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_PRICE":"Price amount of the catalog item being rendered (catalog_field: price.amount). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules.","ITEM_PRICE_CURRENCY":"ISO 4217 currency code of the catalog item being rendered (catalog_field: price.currency). Catalog content macro — scalar text value substituted under the catalog-item substitution-safety rules."}},"external:enums/macro-processing-operation.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/macro-processing-operation.json","title":"Macro Processing Operation","description":"The next authorized operation on the current source token.","type":"string","enum":["translate_to_native","resolve_value","preserve"],"enumDescriptions":{"translate_to_native":"Replace the current token with a declared downstream-native token; no concrete runtime value is inserted at this step.","resolve_value":"Insert the concrete runtime value using the declared encoding contract.","preserve":"Leave the source bytes unchanged because no safe local operation is established."}},"external:enums/macro-resolver.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/macro-resolver.json","title":"Macro Processing Actor","description":"Protocol role authorized to translate the token or bind its concrete value.","type":"string","enum":["buyer","creative_agent","seller","request_executor","source_ad_server"],"enumDescriptions":{"buyer":"The buyer agent acts before submission.","creative_agent":"The creative agent executing build_creative, preview_creative, or validate_input performs the declared build-time operation.","seller":"The AdCP seller or its execution adapter acts during trafficking or serving.","request_executor":"The component executing the governed request acts, whether a client player, publisher player, SSAI service, or another request executor.","source_ad_server":"The originating creative/ad server acts on its own native token."}},"external:core/macro-translation-target.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/macro-translation-target.json","title":"Macro Translation Target","description":"The exact downstream-native token produced by a `translate_to_native` operation. The output asset replaces the source declaration with a declaration for this token and its next operation.","type":"object","properties":{"token":{"type":"string","minLength":1},"dialect":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-dialect.json"},"dialect_namespace":{"type":"string","format":"uri"},"dialect_revision":{"type":"string","minLength":1},"dialect_semantic":{"type":"string","minLength":1},"mapping_status":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-mapping-status.json"},"universal_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},"next_operation":{"type":"string","const":"resolve_value"},"performed_by":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1macro-resolver.json"},"encoding":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-encoding.json"}},"required":["token","dialect","dialect_semantic","mapping_status","next_operation","performed_by","encoding"],"additionalProperties":false,"allOf":[{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast","vendor"]}},"required":["dialect"]},"then":{"required":["dialect_namespace","dialect_revision"]}},{"if":{"properties":{"dialect":{"enum":["adcp","unknown"]}},"required":["dialect"]},"then":{"not":{"anyOf":[{"required":["dialect_namespace"]},{"required":["dialect_revision"]}]}}},{"if":{"properties":{"dialect":{"const":"unknown"}},"required":["dialect"]},"then":false},{"if":{"properties":{"mapping_status":{"const":"verified_universal"}},"required":["mapping_status"]},"then":{"required":["universal_semantic"]},"else":{"not":{"required":["universal_semantic"]}}},{"if":{"properties":{"dialect":{"enum":["iab_vast","iab_daast"]}},"required":["dialect"]},"then":{"properties":{"performed_by":{"const":"request_executor"}}}},{"if":{"properties":{"dialect":{"const":"adcp"}},"required":["dialect"]},"then":{"required":["universal_semantic"],"properties":{"dialect_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},"mapping_status":{"const":"verified_universal"}}}},{"if":{"properties":{"universal_semantic":{"enum":["CATALOG_ID","SKU","GTIN","OFFERING_ID","JOB_ID","HOTEL_ID","FLIGHT_ID","VEHICLE_ID","LISTING_ID","STORE_ID","PROGRAM_ID","DESTINATION_ID","ITEM_NAME","ITEM_DESCRIPTION","ITEM_TAGLINE","ITEM_PRICE","ITEM_PRICE_CURRENCY"]}},"required":["universal_semantic"]},"then":{"properties":{"performed_by":{"const":"seller"},"encoding":{"properties":{"kind":{"const":"rfc3986"},"depth":{"const":1}}}}}}]},"external:core/macro-encoding.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/macro-encoding.json","title":"Macro Encoding","description":"Exact encoding profile applied to a concrete substitution value. `rfc3986` encodes UTF-8 bytes outside the RFC 3986 unreserved set once per depth. `iab_vast_uri` follows the cited IAB VAST macro registry, including its array serialization rules, and is exactly one pass.","type":"object","properties":{"kind":{"type":"string","enum":["none","rfc3986","iab_vast_uri"]},"depth":{"type":"integer","minimum":0}},"required":["kind","depth"],"additionalProperties":false,"allOf":[{"if":{"properties":{"kind":{"const":"none"}},"required":["kind"]},"then":{"properties":{"depth":{"const":0}}}},{"if":{"properties":{"kind":{"const":"rfc3986"}},"required":["kind"]},"then":{"properties":{"depth":{"minimum":1}}}},{"if":{"properties":{"kind":{"const":"iab_vast_uri"}},"required":["kind"]},"then":{"properties":{"depth":{"const":1}}}}]},"external:enums/macro-value-context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/macro-value-context.json","title":"Macro Value Context","description":"Syntactic occurrence context supported by the first macro contract. Substitution inside arbitrary JavaScript, JSON, or HTML text is intentionally not inferred; use `opaque` and preserve it unless a later governed context is added.","type":"string","enum":["url_query_value","url_path_segment","opaque"]},"external:enums/vast-tracking-event.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/vast-tracking-event.json","title":"VAST Tracking Event","description":"Tracking events for VAST video and audio ads. Includes the IAB VAST 4.2 `Tracking@event` enumeration (vast_4.2.xsd `TrackingEvents_type`, lines 112–136), plus AdCP-flattened representations of the `Impression`, `Error`, `VideoClicks`, and `ViewableImpression` elements (which live in dedicated VAST elements, not under `<TrackingEvents>` — they are surfaced here so a single declared list can cover everything a measurement vendor wants to track). Audio players execute only events applicable to and present in the audio VAST document; visual viewability, fullscreen, expand, collapse, and interactive events are not implied by `audio_vast`. `fullscreen` / `exitFullscreen` are retained for VAST 2.x / 3.x video compatibility (VAST 4.0+ replaced them with `playerExpand` / `playerCollapse`). `measurableImpression` is an AdCP extension for MRC measurability signals.","type":"string","enum":["impression","creativeView","loaded","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","playerExpand","playerCollapse","fullscreen","exitFullscreen","progress","acceptInvitation","adExpand","adCollapse","minimize","overlayViewDuration","otherAdInteraction","interactiveStart","clickTracking","customClick","close","closeLinear","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]},"external:core/macro-bearing-url.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/macro-bearing-url.json","title":"Macro-bearing URL","description":"Backward-compatible URL value that preserves the existing `uri-template` branch (including deep links, protocol-relative references, and RFC 6570 host variables) while additionally accepting absolute HTTP(S) URLs with byte-preserved macro delimiters not legal in a strict URI, including `%%...%%`, `[...]`, and `${...}`. Macro-bearing HTTP(S) URLs require a valid lexical authority and valid percent triplets; an AdCP verifier replaces each recognized token with an unreserved sentinel and validates the resulting absolute URI. Token semantics are established only by `macro_declarations`.","x-adcp-validation":{"verifier_constraints":{"macro_aware_uri":"mask recognized token lexical forms with an RFC3986 unreserved sentinel, whether declared or on the undeclared 3.x compatibility path, then require a valid absolute HTTP or HTTPS URI; masking assigns no semantics"},"spec":"docs/creative/universal-macros.mdx#template-syntax"},"type":"string","anyOf":[{"format":"uri-template"},{"format":"uri","pattern":"^https?://(?:[A-Za-z0-9._~!$&'()*+,;=:%-]+@)?(?:[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?|\\[[0-9A-Fa-f:.]+\\])(?::[0-9]{1,5})?(?:[/?#]|$)"},{"pattern":"^https?://(?:[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?|\\[[0-9A-Fa-f:.]+\\])(?::[0-9]{1,5})?(?:[/?#](?:[^%\\s\\u0000-\\u001F\\u007F\"<>`\\\\]|%[0-9A-Fa-f]{2}|%%[A-Za-z0-9_.:-]+%%)*)?$"}]},"external:core/assets/display-tag-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/display-tag-asset.json","title":"Display Tag Asset","description":"One atomic third-party display delivery representation. `delivery_type` distinguishes a single ad-request URL, byte-preserved inline markup, and a paired redirect whose ad-request and click-through URLs MUST travel together. This is not an HTML5 bundle: seller-hosted HTML5 zip files use `asset_type: \"zip\"` under `format_kind: \"html5\"`.","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag","description":"Discriminator identifying an atomic third-party display-tag representation."},"macro_declarations":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},"minItems":1,"description":"Exact macro tokens present anywhere in this representation. Tokens remain byte-preserved until the resolver named by each declaration substitutes them."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overriding manifest-level provenance."}},"required":["asset_type"],"discriminator":{"propertyName":"delivery_type"},"oneOf":[{"title":"Tag URL","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag"},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json"},"delivery_type":{"type":"string","const":"tag_url"},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Ad-request URL invoked at impression time. It is equivalent to the backward-compatible `url` asset with `url_type: \"ad_request\"`."}},"required":["asset_type","delivery_type","url"],"not":{"anyOf":[{"required":["markup"]},{"required":["ad_request_url"]},{"required":["clickthrough_url"]}]}},{"title":"Inline markup","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag"},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"markup"}}}}}]},"minItems":1},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json"},"delivery_type":{"type":"string","const":"inline_markup"},"markup_type":{"type":"string","enum":["iframe_javascript","javascript","standard"],"description":"How the destination traffics the byte-preserved markup."},"markup":{"type":"string","minLength":1,"maxLength":1048576,"description":"Exact third-party tag markup. Receivers MUST preserve its bytes and MUST NOT reinterpret it as a seller-hosted HTML5 bundle."}},"required":["asset_type","delivery_type","markup_type","markup"],"not":{"anyOf":[{"required":["url"]},{"required":["ad_request_url"]},{"required":["clickthrough_url"]}]}},{"title":"Paired redirect","type":"object","properties":{"asset_type":{"type":"string","const":"display_tag"},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"enum":["ad_request_url","clickthrough_url"]}}}}}]},"minItems":1},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json"},"delivery_type":{"type":"string","const":"paired_redirect"},"ad_request_url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Image or ad-request URL entered into the destination ad server. This field deliberately accepts byte-preserved vendor tokens that are not RFC 6570 URI templates."},"clickthrough_url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Click-through URL paired with `ad_request_url`. This field deliberately accepts byte-preserved vendor tokens that are not RFC 6570 URI templates. The pair MUST NOT be split, mixed, or revised independently."}},"required":["asset_type","delivery_type","ad_request_url","clickthrough_url"],"not":{"anyOf":[{"required":["url"]},{"required":["markup"]}]}}],"additionalProperties":true},"external:core/assets/text-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/text-asset.json","title":"Text Asset","description":"Text content asset","type":"object","properties":{"asset_type":{"type":"string","const":"text","description":"Discriminator identifying this as a text asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"Text content"},"language":{"type":"string","description":"Optional language claim for this text. In a materialized creative localization variant, localized-creative-asset.json requires this value to use /schemas/core/locale-tag.json and conformance requires exact equality with the enclosing variant locale. General non-localized assets retain the legacy unconstrained string for compatibility."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:core/assets/url-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/url-asset.json","title":"URL Asset","$comment":"Fallback table is also rendered in docs/creative/asset-types.mdx (URL Asset section). Keep the two in sync — schema description is the normative source for conformance tools; mdx is the human-readable copy.","description":"URL reference asset. `url_type` declares the mechanism a receiver uses to invoke the URL (`clickthrough`, display `ad_request`, `tracker_pixel`, or `tracker_script`) and is distinct from the URL's purpose, which the format declares in `url-asset-requirements.role`. Senders SHOULD include `url_type` on every URL asset. When `url_type` is absent, receivers SHOULD fall back to the format's role: clickthrough/landing_page → `clickthrough`; impression_tracker/click_tracker → `tracker_pixel`; viewability_tracker → `tracker_script`; third_party_tracker and display ad requests have no safe fallback. When neither `url_type` nor a format-side role is available, receivers MUST NOT silently pick a mechanism. VAST/DAAST tag URLs are not URL assets — use `asset_type: \"vast\"` or `asset_type: \"daast\"`.","type":"object","properties":{"asset_type":{"type":"string","const":"url","description":"Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"URL reference carrying plain, AdCP, IAB, or declared vendor macro syntax. Buyers preserve token delimiters; the authoritative declaration determines the processing operation and encoding."},"url_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1url-asset-type.json","description":"Mechanism a receiver uses to invoke this URL: `clickthrough` for a user destination, `ad_request` for a third-party display creative request, `tracker_pixel` for an event HTTP request, or `tracker_script` for a script include. SHOULD be present on every URL asset."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"One declaration per token occurrence in `url`; declaration_id values MUST be unique and every location MUST identify an existing occurrence. Absence retains legacy opaque transport behavior."},"description":{"type":"string","description":"Description of what this URL points to"},"state_id":{"type":"string","description":"Binding used only when this URL populates a `seller_rendered_stateful_display` `state_click_urls` slot. It MUST match one declared `states[].state_id` (semantic validators resolve it); at most one entry per state. Omit for ordinary URL slots."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url"],"additionalProperties":true},"external:enums/url-asset-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/url-asset-type.json","title":"URL Asset Type","description":"Invocation mechanisms for URL assets. `ad_request` invokes a third-party display ad endpoint at impression time; it is not a tracker or click destination.","type":"string","enum":["clickthrough","ad_request","tracker_pixel","tracker_script"]},"external:core/assets/html-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/html-asset.json","title":"HTML Asset","description":"Inline HTML content asset. For seller-hosted HTML5 banner bundles, use the zip asset type. For third-party display markup or paired redirects, use the display_tag asset so the trafficking representation remains explicit.","type":"object","properties":{"asset_type":{"type":"string","const":"html","description":"Discriminator identifying this as an HTML asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"HTML content"},"version":{"type":"string","description":"HTML version (e.g., 'HTML5')"},"accessibility":{"type":"object","description":"Self-declared accessibility properties for this opaque creative","x-accessibility":true,"properties":{"alt_text":{"type":"string","description":"Text alternative describing the creative content"},"keyboard_navigable":{"type":"boolean","description":"Whether the creative can be fully operated via keyboard"},"motion_control":{"type":"boolean","description":"Whether the creative respects prefers-reduced-motion or provides pause/stop controls"},"screen_reader_tested":{"type":"boolean","description":"Whether the creative has been tested with screen readers"}}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:core/assets/javascript-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/javascript-asset.json","title":"JavaScript Asset","description":"Inline JavaScript content asset. For third-party display ad markup, use the display_tag asset with delivery_type `inline_markup`; for measurement scripts use a typed tracker; for seller-hosted HTML5 bundles use zip.","type":"object","properties":{"asset_type":{"type":"string","const":"javascript","description":"Discriminator identifying this as a JavaScript asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"JavaScript content"},"module_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1javascript-module-type.json","description":"JavaScript module type"},"accessibility":{"type":"object","description":"Self-declared accessibility properties for this opaque creative","x-accessibility":true,"properties":{"alt_text":{"type":"string","description":"Text alternative describing the creative content"},"keyboard_navigable":{"type":"boolean","description":"Whether the creative can be fully operated via keyboard"},"motion_control":{"type":"boolean","description":"Whether the creative respects prefers-reduced-motion or provides pause/stop controls"},"screen_reader_tested":{"type":"boolean","description":"Whether the creative has been tested with screen readers"}}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:enums/javascript-module-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/javascript-module-type.json","title":"JavaScript Module Type","description":"JavaScript module format types for creative assets","type":"string","enum":["esm","commonjs","script"]},"external:core/assets/zip-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/zip-asset.json","title":"Zip Asset","description":"Bundled creative asset delivered as a zip archive — typically an HTML5 banner with index.html plus supporting CSS, JS, images, and fonts. Receivers unpack the zip, validate internal structure, and serve contents from CDN. Distinct from inline HTML (html asset) and from third-party tag URLs (url asset with url_type tracker_script).","type":"object","properties":{"asset_type":{"type":"string","const":"zip","description":"Discriminator identifying this as a zip-bundled asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"URL where the zip archive is hosted. Must be HTTPS."},"max_file_size_kb":{"type":"integer","minimum":0,"description":"Maximum file size in kilobytes. Receivers should reject zips exceeding this."},"entry_point":{"type":"string","description":"Relative path to the entry file within the zip (typically 'index.html'). Receivers default to 'index.html' if absent."},"allowed_inner_extensions":{"type":"array","items":{"type":"string"},"description":"File extensions permitted inside the zip (e.g., ['html', 'css', 'js', 'png', 'jpg', 'svg', 'webp', 'json', 'woff2']). Receivers may reject zips containing other extensions."},"backup_image_url":{"type":"string","format":"uri","description":"Fallback image URL for environments that cannot render the bundled creative (e.g., non-HTML5 endpoints, ad blockers). Recommended for HTML5 banners."},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Optional SHA-256 content digest of the zip archive (sha256:<hex>) for integrity verification. Lets receivers detect tampered or stale archives."},"accessibility":{"type":"object","description":"Self-declared accessibility properties for this opaque creative","x-accessibility":true,"properties":{"alt_text":{"type":"string","description":"Text alternative describing the creative content"},"keyboard_navigable":{"type":"boolean","description":"Whether the creative can be fully operated via keyboard"},"motion_control":{"type":"boolean","description":"Whether the creative respects prefers-reduced-motion or provides pause/stop controls"},"screen_reader_tested":{"type":"boolean","description":"Whether the creative has been tested with screen readers"}}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url"],"additionalProperties":true,"examples":[{"description":"HTML5 banner bundle with backup image","data":{"asset_type":"zip","url":"https://cdn.acme.example/creatives/spring-300x250-html5.zip","max_file_size_kb":200,"entry_point":"index.html","allowed_inner_extensions":["html","css","js","png","jpg","svg","json"],"backup_image_url":"https://cdn.acme.example/creatives/spring-300x250-backup.jpg","digest":"sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}}]},"external:core/assets/webhook-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/webhook-asset.json","title":"Webhook Asset","description":"Webhook for server-side dynamic content rendering (DCO)","type":"object","properties":{"asset_type":{"type":"string","const":"webhook","description":"Discriminator identifying this as a webhook asset. See /schemas/creative/asset-types for the registry."},"url":{"type":"string","format":"uri","description":"Webhook URL to call for dynamic content"},"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1http-method.json","default":"POST","description":"HTTP method"},"timeout_ms":{"type":"integer","minimum":10,"maximum":5000,"default":500,"description":"Maximum time to wait for response in milliseconds"},"supported_macros":{"type":"array","items":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},{"type":"string","description":"Custom or publisher-specific macro name"}]},"description":"Universal macros that can be passed to webhook (e.g., DEVICE_TYPE, COUNTRY). See docs/creative/universal-macros.mdx for full list."},"required_macros":{"type":"array","items":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1universal-macro.json"},{"type":"string","description":"Custom or publisher-specific macro name"}]},"description":"Universal macros that must be provided for webhook to function"},"response_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1webhook-response-type.json","description":"Expected content type of webhook response"},"security":{"type":"object","description":"Security configuration for webhook calls","properties":{"method":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1webhook-security-method.json","description":"Authentication method"},"hmac_header":{"type":"string","description":"Header name for HMAC signature (e.g., 'X-Signature')"},"api_key_header":{"type":"string","description":"Header name for API key (e.g., 'X-API-Key')"}},"required":["method"]},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","url","response_type","security"],"additionalProperties":true},"external:enums/http-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/http-method.json","title":"HTTP Method","description":"HTTP methods supported for webhook requests","type":"string","enum":["GET","POST"]},"external:enums/webhook-response-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/webhook-response-type.json","title":"Webhook Response Type","description":"Expected response content type from webhook endpoints","type":"string","enum":["html","json","xml","javascript"]},"external:enums/webhook-security-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/webhook-security-method.json","title":"Webhook Security Method","description":"Security methods for authenticating webhook requests","type":"string","enum":["hmac_sha256","api_key","none"]},"external:core/assets/css-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/css-asset.json","title":"CSS Asset","description":"CSS stylesheet asset","type":"object","properties":{"asset_type":{"type":"string","const":"css","description":"Discriminator identifying this as a CSS asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"CSS content"},"media":{"type":"string","description":"CSS media query context (e.g., 'screen', 'print')"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"}},"required":["asset_type","content"],"additionalProperties":true},"external:core/assets/daast-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/daast-asset.json","title":"DAAST Asset","description":"DAAST (Digital Audio Ad Serving Template) tag for third-party audio ad serving","type":"object","properties":{"asset_type":{"type":"string","const":"daast","description":"Discriminator identifying this as a DAAST asset. See /schemas/creative/asset-types for the registry."},"daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-version.json","description":"DAAST specification version"},"duration_ms":{"type":"integer","description":"Expected audio duration in milliseconds (if known)","minimum":0},"tracking_events":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-tracking-event.json"},"description":"Tracking events supported by this DAAST tag"},"companion_ads":{"type":"boolean","description":"Whether companion display ads are included"},"transcript_url":{"type":"string","format":"uri","description":"URL to text transcript of the audio content","x-accessibility":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance"},"macro_declarations":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},"minItems":1,"description":"One declaration per occurrence in a field carried by this asset. URL-delivered assets declare only locator-URL occurrences; receivers do not infer declarations for tokens discovered later in a fetched document."}},"required":["asset_type"],"oneOf":[{"properties":{"delivery_type":{"type":"string","const":"url","description":"Discriminator indicating DAAST is delivered via URL endpoint"},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"URL endpoint returning DAAST XML. Macro delimiters remain byte-preserved and are processed only under attached occurrence declarations."},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}}},"required":["delivery_type","url"]},{"properties":{"delivery_type":{"type":"string","const":"inline","description":"Discriminator indicating DAAST is delivered as inline XML content"},"content":{"type":"string","description":"Inline DAAST XML content"},"macro_declarations":{"items":{"properties":{"location":{"properties":{"field":{"const":"content"}}}}}}},"required":["delivery_type","content"]}],"discriminator":{"propertyName":"delivery_type"},"additionalProperties":true},"external:enums/daast-tracking-event.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/daast-tracking-event.json","title":"DAAST Tracking Event","description":"Tracking events for audio ads. Aligned to the IAB DAAST 1.1 `Tracking@event` enumeration from §3.2.1.7 of the spec (creativeView, start, firstQuartile, midpoint, thirdQuartile, complete, mute, unmute, pause, rewind, resume, skip, progress) — plus `close` (referenced descriptively in DAAST 1.1 §3.2.4.2 contrasting it with `skip`), and AdCP-flattened representations of the `Impression`, `Error`, and click elements (`<Impression>`, `<Error>`, and the click children of `<AdInteractions>`) so a single declared list can cover everything a measurement vendor wants to track. `viewable` / `notViewable` / `viewUndetermined` and `measurableImpression` / `viewableImpression` are AdCP extensions for OM-SDK Audio measurability signals (DAAST 1.1 itself does not define a `<ViewableImpression>` element). DAAST 1.1 audio-incompatible video events are deliberately omitted: no `loaded`, `playerExpand` / `playerCollapse`, `fullscreen` / `exitFullscreen`, `acceptInvitation`, `adExpand` / `adCollapse`, `minimize`, `overlayViewDuration`, or `interactiveStart`.","type":"string","enum":["impression","creativeView","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","progress","clickTracking","customClick","close","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]},"external:core/assets/markdown-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/markdown-asset.json","title":"Markdown Asset","description":"Markdown-formatted text content following CommonMark specification","type":"object","properties":{"asset_type":{"type":"string","const":"markdown","description":"Discriminator identifying this as a markdown asset. See /schemas/creative/asset-types for the registry."},"content":{"type":"string","description":"Markdown content following CommonMark spec with optional GitHub Flavored Markdown extensions"},"language":{"type":"string","description":"Optional language claim for this markdown. In a materialized creative localization variant, localized-creative-asset.json requires this value to use /schemas/core/locale-tag.json and conformance requires exact equality with the enclosing variant locale. General non-localized assets retain the legacy unconstrained string for compatibility."},"markdown_flavor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1markdown-flavor.json","default":"commonmark","description":"Markdown flavor used. CommonMark for strict compatibility, GFM for tables/task lists/strikethrough."},"allow_raw_html":{"type":"boolean","default":false,"description":"Whether raw HTML blocks are allowed in the markdown. False recommended for security."}},"required":["asset_type","content"],"additionalProperties":true},"external:enums/markdown-flavor.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/markdown-flavor.json","title":"Markdown Flavor","description":"Markdown specification flavors supported for text assets","type":"string","enum":["commonmark","gfm"]},"external:core/assets/brief-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/brief-asset.json","title":"Brief Asset","description":"Campaign-level creative context as an asset. Carries the creative brief through the manifest so it travels with the creative through regeneration, resizing, and auditing.","type":"object","properties":{"asset_type":{"type":"string","const":"brief","description":"Discriminator identifying this as a brief asset. See /schemas/creative/asset-types for the registry."}},"required":["asset_type"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1creative-brief.json"}]},"external:core/creative-brief.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-brief.json","title":"Creative Brief","description":"Campaign-level creative context for AI-powered creative generation. Provides the layer between brand identity (stable across campaigns) and individual creative execution (per-request). A brand has one identity (defined in brand.json) but different creative briefs for each campaign or flight.","type":"object","properties":{"name":{"type":"string","description":"Campaign or flight name for identification"},"objective":{"type":"string","enum":["awareness","consideration","conversion","retention","engagement"],"description":"Campaign objective that guides creative tone and call-to-action strategy"},"tone":{"type":"string","description":"Desired tone for this campaign, modulating the brand's base tone (e.g., 'playful and festive', 'premium and aspirational')"},"audience":{"type":"string","description":"Target audience description for this campaign"},"territory":{"type":"string","description":"Creative territory or positioning the campaign should occupy"},"messaging":{"type":"object","description":"Messaging framework for the campaign","properties":{"headline":{"type":"string","description":"Primary headline"},"tagline":{"type":"string","description":"Supporting tagline or sub-headline"},"cta":{"type":"string","description":"Call-to-action text"},"key_messages":{"type":"array","description":"Key messages to communicate in priority order","items":{"type":"string"}}},"additionalProperties":true},"reference_assets":{"type":"array","description":"Visual and strategic reference materials such as mood boards, product shots, example creatives, and strategy documents","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1reference-asset.json"}},"compliance":{"type":"object","description":"Regulatory and legal compliance requirements for this campaign. Campaign-specific, regional, and product-based — distinct from brand-level disclaimers in brand.json.","properties":{"required_disclosures":{"type":"array","description":"Disclosures that must appear in creatives for this campaign. Each disclosure specifies the text, where it should appear, and which jurisdictions require it.","items":{"type":"object","properties":{"text":{"type":"string","description":"The disclosure text that must appear in the creative"},"position":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-position.json","description":"Where the disclosure should appear within the creative. prominent: clearly visible in the main creative area; footer: at the bottom of visual creatives; audio: spoken in audio/video creatives; subtitle: displayed in the subtitle or closed-caption track; overlay: superimposed on video content; end_card: displayed on video end card; pre_roll: spoken or displayed before main content; companion: in companion ad unit alongside primary creative"},"jurisdictions":{"type":"array","description":"Jurisdictions where this disclosure is required. ISO 3166-1 alpha-2 country codes or ISO 3166-2 subdivision codes (e.g., 'US', 'GB', 'US-NJ', 'CA-QC'). If omitted, the disclosure applies to all jurisdictions in the campaign.","items":{"type":"string","pattern":"^[A-Z]{2}(-[A-Z0-9]{1,3})?$"},"minItems":1},"regulation":{"type":"string","description":"The regulation or legal authority requiring this disclosure (e.g., 'SEC Rule 156', 'FCA COBS 4.5', 'FDA 21 CFR 202')"},"min_duration_ms":{"type":"integer","minimum":1,"description":"Minimum display duration in milliseconds. For video/audio disclosures, how long the disclosure must be visible or audible. For static formats, how long the disclosure must remain on screen before any auto-advance."},"language":{"type":"string","description":"Language of the disclosure text as a BCP 47 language tag (e.g., 'en', 'fr-CA', 'es'). When omitted, the disclosure is assumed to match the creative's language."},"persistence":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1disclosure-persistence.json","description":"How long the disclosure must persist during content playback or display. When omitted, the creative agent should use the most restrictive persistence mode supported by the target format."}},"required":["text"],"additionalProperties":true},"minItems":1},"prohibited_claims":{"type":"array","description":"Claims that must not appear in creatives for this campaign. Creative agents should ensure generated content avoids these claims.","items":{"type":"string"},"minItems":1}},"additionalProperties":true}},"required":["name"],"additionalProperties":true},"external:core/reference-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/reference-asset.json","title":"Reference Asset","description":"A reference asset that provides creative context. Carries visual materials (mood boards, product shots, example creatives) with semantic roles that tell creative agents how to use them.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"URL to the reference asset (image, video, or document)"},"role":{"type":"string","enum":["style_reference","product_shot","mood_board","example_creative","logo","strategy_doc","storyboard"],"description":"How the creative agent should use this asset. style_reference: match the visual style; product_shot: include this product; mood_board: overall look and feel; example_creative: example of a similar execution; logo: logo to use; strategy_doc: strategy or planning document for context; storyboard: sequential visual direction for video or multi-scene creative"},"description":{"type":"string","description":"Human-readable description of the asset and how it should inform creative generation"}},"required":["url","role"],"additionalProperties":true},"external:core/assets/catalog-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/catalog-asset.json","title":"Catalog Asset","description":"A typed data feed as a creative asset. Carries catalog context (products, stores, jobs, etc.) within the manifest's assets map.","type":"object","properties":{"asset_type":{"type":"string","const":"catalog","description":"Discriminator identifying this as a catalog asset. See /schemas/creative/asset-types for the registry."}},"required":["asset_type"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1catalog.json"}]},"external:core/assets/published-post-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/published-post-asset.json","title":"Published Post Asset","description":"Reference to an already-published post on a publisher, creator, or social platform. The buyer supplies a reference to the existing post; the seller resolves, authorizes, reviews, and serves the referenced post according to the target product's format declaration. This asset is for post references, not uploaded bytes and not catalog rows.","type":"object","properties":{"asset_type":{"type":"string","const":"published_post","description":"Discriminator identifying this as a published-post reference asset. See /schemas/creative/asset-types for the registry."},"post_url":{"type":"string","format":"uri","description":"Canonical URL for the published post. Preferred when the platform exposes a stable public or authenticated URL."},"platform":{"type":"string","description":"Optional platform or publisher namespace for the referenced post. Informational unless the seller's product declaration or platform extension narrows the accepted values."},"platform_post_id":{"type":"string","description":"Optional platform-native post identifier when a URL alone is not stable or not available. Buyers SHOULD include `platform` when using `platform_post_id` without `post_url`, unless the product or format declaration already narrows the platform. Platform-specific identifier semantics belong in platform_extensions; this field is only an opaque reference."},"identity_ref":{"type":"object","description":"Optional identity hint for the authoring handle/page/channel that owns the post. Sellers MUST verify authorization from platform state; buyers MUST NOT use this object as proof of authorization.","properties":{"handle":{"type":"string","description":"Human-readable handle or username when available."},"profile_url":{"type":"string","format":"uri","description":"URL for the authoring profile, page, or channel."},"platform_identity_id":{"type":"string","description":"Opaque platform-native identity identifier."}},"additionalProperties":true},"published_at":{"type":"string","format":"date-time","description":"When the referenced post was originally published, if known."},"reference_authorization":{"type":"object","readOnly":true,"description":"Server-emitted, seller-observed authorization state for the referenced post or identity. Sellers MAY return this object on read surfaces. On write requests, sellers MUST ignore buyer-supplied `reference_authorization.status` and other authorization-state claims unless a platform extension explicitly defines a signed proof shape and the seller verifies that proof.","properties":{"status":{"type":"string","enum":["authorized","pending","expired","revoked","not_required","unknown"],"description":"Current seller-observed authorization state. `authorized`: seller can serve the referenced post. `pending`: additional creator/account action is required. `expired` or `revoked`: authorization previously existed but no longer permits serving. `not_required`: the seller can legally and technically serve without a separate identity authorization. `unknown`: seller has not checked or cannot disclose the state."},"checked_at":{"type":"string","format":"date-time","description":"When the seller last checked the authorization state."},"expires_at":{"type":"string","format":"date-time","description":"When the authorization expires, if the platform exposes an expiry."},"authorization_url":{"type":"string","format":"uri","description":"Optional URL the buyer or creator can use to complete authorization."},"authorization_instructions":{"type":"string","description":"Human-readable instructions for completing or restoring authorization."}},"required":["status"],"additionalProperties":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this reference asset, overrides manifest-level provenance."}},"required":["asset_type"],"anyOf":[{"required":["post_url"]},{"required":["platform_post_id"]}],"additionalProperties":true},"external:core/assets/card-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/card-asset.json","title":"Card Asset","description":"A single card in a multi-card creative (image_carousel, future composed carousels). Carries: `media` (an image OR video asset), optional `headline` (short text), optional `description` (longer text), optional `cta` (call-to-action label), optional `landing_page_url` (url asset with `url_type: \"clickthrough\"`).\n\nCovers the multi-card patterns across Meta carousel, Pinterest sponsored pin, Snap Collection, TikTok carousel, and AI-surface result cards. The two-field text shape (`headline` + `description`) reflects how almost every adopter splits short labels from longer copy; Pinterest pin description and Meta per-card description both go in `description`.\n\nUsed as the array element type for the `cards` slot on image_carousel canonicals. Adopters MUST NOT invent per-card key conventions like `card_0_headline` / `cards.0.headline` — the manifest's `assets.cards` value is an array of card-asset objects, period. Per-card platform extensions (e.g., Meta-specific carousel attributes, Pinterest rich-pin metadata, Snap Collection price tags) attach via the `platform_extensions` field, never via inline non-canonical keys.","type":"object","required":["asset_type","media"],"properties":{"asset_type":{"type":"string","const":"card","description":"Discriminator identifying this as a card asset. See /schemas/creative/asset-types for the registry."},"media":{"description":"The card's primary visual asset. Either an `image` or `video` asset, matching the parent format's `allowed_card_media_asset_types` parameter.","oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1video-asset.json"}],"discriminator":{"propertyName":"asset_type"}},"headline":{"type":"string","description":"Optional per-card short text label (typically 25-40 chars). Length governed by `card_headline_max_chars` on the format declaration. Meta carousel headline, Pinterest pin title, Snap Collection sticker text, TikTok caption-short."},"description":{"type":"string","description":"Optional per-card longer text (typically 100-500 chars). Distinct from `headline`: `description` is body copy, `headline` is the label. Length governed by `card_description_max_chars` on the format declaration. Meta carousel description, Pinterest pin description, AI-surface result body text, TikTok long caption."},"cta":{"type":"string","description":"Optional per-card call-to-action label (e.g., 'SHOP_NOW', 'LEARN_MORE'). When the parent format declares `cta_values` (allowed CTA labels), the per-card `cta` MUST be one of those values. Lets a Meta or TikTok carousel show different CTAs per card."},"landing_page_url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1url-asset.json","description":"Optional per-card click-through URL. URL asset with `url_type: \"clickthrough\"`."},"platform_extensions":{"type":"array","description":"Per-card platform-specific extensions (URI+digest references). Same hosting model as format-level platform_extensions. Use this for Meta carousel-card attributes, Pinterest pin overrides, etc. — NEVER inline non-canonical keys on the card object directly.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1platform-extension-ref.json"}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this card, overrides manifest-level provenance."}},"additionalProperties":true},"external:core/platform-extension-ref.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/platform-extension-ref.json","title":"Platform Extension Reference","description":"Reference to a platform extension definition. The agent that owns the URI is authoritative for the extension's schema. Buyers fetch the definition once per content digest and cache it. Platform extensions are typically bundled in `get_products` responses under an `extensions` map keyed by `uri@digest`, eliminating the need for a separate fetch.\n\n**Within a single response**, multiple references to the same `uri` MUST carry the same `digest` — divergent digests in one response indicate producer-side error (e.g., concurrent extension revision mid-render). Buyers encountering divergent digests for the same URI MUST fail closed: treat all references to that URI as unresolved and surface a validation error rather than picking one branch silently. **Across responses**, digest divergence is normal — extension authors revise their schemas, the new digest differs, the cache key changes, and the buyer refetches. Cache by `uri@digest`, not by `uri` alone.","type":"object","required":["uri","digest"],"properties":{"uri":{"type":"string","format":"uri","pattern":"^https://","description":"HTTPS URL identifying the extension. `https://` is mandatory — `http://`, `file://`, `data:`, and other schemes are rejected at the schema layer (defense-in-depth on top of the fetch-contract normative rules). The URI base is the owning agent's URL; the path identifies the extension within that agent. Example: 'https://creative.adcontextprotocol.org/translated/meta/extensions/meta_pixel'. The full fetch contract — SSRF allowlist, response-size cap, $ref sandbox, schema-compile bounds — is documented on `product-format-declaration.json#format_schema` and applies to ALL fetches of this reference shape regardless of whether the field is named `format_schema` (load-bearing for validation) or `platform_extensions` (informational); the *transport* rules are identical, only the *consumption* semantics differ."},"digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"SHA-256 content digest of the extension definition (sha256:<hex>). Used to detect drift — if the agent revises the extension, the digest changes and cached definitions become invalid."}},"additionalProperties":true,"examples":[{"uri":"https://creative.adcontextprotocol.org/translated/meta/extensions/meta_pixel","digest":"sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"}]},"external:core/assets/pixel-tracker-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/pixel-tracker-asset.json","title":"Pixel Tracker Asset","description":"A single renderer-fired HTTP tracker URL — image pixel or JavaScript include — bound to a measurement event (impression, viewability, click, custom). Generic web-pixel tracker primitive applicable to any web-rendered canonical format (image, html5, image_carousel, responsive_creative, sponsored_placement, native_*, plus the non-VAST/DAAST events of video_hosted and audio_hosted). The buyer's measurement vendor declares the tracker URL; the seller's renderer fires it at serve time without buyer-side involvement.\n\nThe discriminated-union shape and event/method enums are formalized in IAB OpenRTB Native 1.2 (`imptrackers[]` / `jstracker` / `eventtrackers[]` / `link.clicktrackers[]`); the same shape applies cleanly to image banners, html5, carousels, and any other format whose renderer fires HTTP pixels for measurement. The name `pixel_tracker` mirrors the industry's existing 'tracker pixel' terminology (already used in `url_type: \"tracker_pixel\"`) and applies equally to `method: img` and `method: js` (a JS include is still a measurement-pixel hop in vendor parlance).\n\n**Scope boundary (normative).** `pixel_tracker` covers RENDERER-FIRED trackers — measurement events that the ad's serving template invokes when the user sees, views, or clicks the creative. Conversion pixels that fire on the advertiser's site after the click (Meta Pixel, GA4 server-side, custom postbacks) MUST be modeled via `sync_event_sources` / `event_log` — they are campaign-scoped, not creative-asset-scoped. See `docs/creative/canonical-formats.mdx#what-format_kind-is-not-for`.\n\n**Format-specific tracker primitives.** Formats whose wire shape embeds tracker URLs in a format-specific structure use dedicated asset types instead:\n- `video_vast` / `audio_vast` → `vast_tracker` (VAST `<TrackingEvents>`: start, quartiles, complete, pause, mute)\n- `audio_daast` → `daast_tracker` (DAAST `<TrackingEvents>` parity)\n- `display_tag` → opaque (third-party server fires its own trackers)\n\nAll other web-rendered canonicals use `pixel_tracker`.\n\nMaps to IAB OpenRTB Native 1.2 / Dynamic Native Ads API tracker objects:\n- `imptrackers[]` → one `pixel_tracker` per entry with `event: impression`, `method: img`\n- `jstracker` → one `pixel_tracker` with `event: impression`, `method: js`\n- `eventtrackers[]` → one `pixel_tracker` per entry, `event` mapped from the IAB event enum\n- `link.clicktrackers[]` → one `pixel_tracker` per entry with `event: click`, `method: img` (click destinations live on `landing_page_url` slot)\n\n**Bidirectional v1↔v2 mapping (normative for SDK auto-negotiation).** A 3.1 buyer SDK talking to a 3.0.x seller MUST downgrade `pixel_tracker` to the v1 `{asset_type: url, url_type: tracker_pixel}` shape. The URL still emits on the wire; what's lost depends on the original event/method. A 3.1 SDK reading a v1 manifest MUST upgrade `{asset_type: url, url_type: tracker_pixel}` to `pixel_tracker` by inferring event/method from the v1 `asset_id`. Both directions are lossy-with-advisory; SDKs MUST emit the appropriate error code so consumers can see what was inferred or dropped.\n\n**v2 → v1 downgrade table:**\n| pixel_tracker source | v1 emit | Lost fields | Error code |\n|---|---|---|---|\n| `{event: impression, method: img, url}` | `{url_type: tracker_pixel, asset_id: impression_tracker, url}` | none | (no advisory) |\n| `{event: viewable_mrc_50, method: img, url}` | `{url_type: tracker_pixel, asset_id: viewability_tracker, url}` | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: viewable_mrc_100, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: viewable_video_50, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: audible_video_complete, method: img, url}` | same shape | event variant | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{event: click, method: img, url}` | `{url_type: tracker_pixel, asset_id: click_tracker, url}` | none meaningful | (no advisory) |\n| `{event: custom, custom_event_name: X, ...}` | `{url_type: tracker_pixel, asset_id: impression_tracker, url}` (defaults to impression timing) | custom event timing | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n| `{method: js, any event, url}` | same shape with `url_type: tracker_pixel` | JS execution context — URL is hit via GET (counter increments), but JS body doesn't execute (OMID-style verification, viewability observers, cross-domain cookie setters won't fire) | `PIXEL_TRACKER_LOSSY_DOWNGRADE` |\n\n**v1 → v2 upgrade table (inferred — SDK has no explicit event/method):**\n| v1 source (asset_id) | Inferred pixel_tracker | Inference basis |\n|---|---|---|\n| `impression_tracker` | `{event: impression, method: img}` | asset_id convention |\n| `viewability_tracker` | `{event: viewable_mrc_50, method: img}` | asset_id convention + most-common default (50% is the dominant variant in v1 catalogs) |\n| `click_tracker` | `{event: click, method: img}` | asset_id convention |\n| `<other asset_id>` | `{event: custom, custom_event_name: <original asset_id>, method: img}` | fallback — preserves the original asset_id as the custom name |\n\nAll v1→v2 upgrades surface `PIXEL_TRACKER_UPGRADE_INFERRED` so consumers can see that event/method were inferred rather than explicitly declared.","type":"object","properties":{"asset_type":{"type":"string","const":"pixel_tracker","description":"Discriminator identifying this as a renderer-fired pixel tracker asset. See /schemas/creative/asset-types for the registry."},"event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1pixel-tracking-event.json","description":"Which event this tracker fires on. The event enum maps its first four measurement values to IAB OpenRTB Native 1.2 event types 1-4 and adds explicit AdCP events for renderer behavior that Native does not assign a standard event type:\n- `impression` (IAB type 1) — fires when the ad is served. Covers both `imptrackers[]` and `jstracker` from the IAB shape, distinguished by `method`.\n- `viewable_mrc_50` (IAB type 2) — IAB MRC viewable, 50% pixels for ≥1 second.\n- `viewable_mrc_100` (IAB type 3) — IAB MRC viewable, 100% pixels for ≥1 second.\n- `viewable_video_50` (IAB type 4) — video-specific viewable, 50% pixels for ≥2 seconds. Native type 4 does not require audio. On video_hosted; ignored on image/html5.\n- `audible_video_complete` (AdCP-defined) — video reached 100% completion with audio on. Native reserves event types 500+ for exchange-specific use and does not assign this event a standard numeric type. Meaningful on non-VAST video formats where audible-complete is measured but VAST `<TrackingEvents>` is not the wire format; VAST formats use `vast_tracker` with `vast_event: complete` plus a separate audible tracker instead.\n- `click` — fires when the user clicks the creative (`link.clicktrackers[]`).\n- `custom` — adopter-defined event for anything not in the standardized enum. MUST also set `custom_event_name`; it can represent Native's exchange-specific 500+ range or another qualified vendor event without assigning an IAB numeric identity."},"method":{"type":"string","enum":["img","js"],"default":"img","description":"How the tracker URL is invoked at serve time:\n- `img` — fired as an image pixel (HTTP GET with `<img>`-like semantics; no JS execution)\n- `js` — fired as a script include (renderer evaluates the URL's response as JavaScript)\n\nMatches IAB OpenRTB Native 1.2 method enum (1=img, 2=js). `js` MUST only be used by sellers whose renderer supports JavaScript trackers; sellers without JS-tracker support MUST reject `method: js` declarations at sync_creatives time with `CREATIVE_REJECTED` carrying the reason."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Tracker URL fired when `event` occurs. Macro processing and encoding follow an attached occurrence declaration; absent declarations retain the legacy universal-macro path."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"One declaration per token occurrence in `url`; declaration_id values MUST be unique and locations MUST resolve. When omitted, legacy behavior applies."},"custom_event_name":{"type":"string","description":"REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. When tracker execution is undeclared, an unknown custom event is a forward-compatible probe and the seller silently no-ops instead of rejecting the creative. An effective tracker_execution_contract overrides that legacy fallback: with complete:true an unlisted custom selector is unsupported and rejects compatibility with tracker_contract_mismatch; a listed custom selector is an affirmative accept-and-initiate commitment."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance."}},"required":["asset_type","event","url"],"allOf":[{"if":{"properties":{"event":{"const":"custom"}},"required":["event"]},"then":{"required":["custom_event_name"]},"else":{"not":{"required":["custom_event_name"]}}}],"additionalProperties":true,"examples":[{"asset_type":"pixel_tracker","event":"impression","method":"img","url":"https://measurement.example.com/imp?cb={CACHEBUSTER}&cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"impression","method":"js","url":"https://measurement.example.com/jstracker.js?cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"viewable_mrc_50","method":"img","url":"https://measurement.example.com/mrc50?cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"click","method":"img","url":"https://measurement.example.com/click?cid={CREATIVE_ID}&cb={CACHEBUSTER}"},{"asset_type":"pixel_tracker","event":"audible_video_complete","method":"img","url":"https://measurement.example.com/audible_complete?cid={CREATIVE_ID}"},{"asset_type":"pixel_tracker","event":"custom","custom_event_name":"engagement_3s","method":"img","url":"https://measurement.example.com/engagement?cid={CREATIVE_ID}&duration=3s"}]},"external:enums/pixel-tracking-event.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/pixel-tracking-event.json","title":"Pixel Tracking Event","description":"Closed AdCP event vocabulary for renderer-fired pixel trackers. Impression and viewability values through `viewable_video_50` map to IAB OpenRTB Native event tracker types 1-4. `audible_video_complete` is an AdCP-defined first-class event, not an assigned IAB Native event type; Native reserves 500+ for exchange-specific use. `click` represents Native click trackers and `custom` is the explicit adopter-defined extension point.","type":"string","enum":["impression","viewable_mrc_50","viewable_mrc_100","viewable_video_50","audible_video_complete","click","custom"]},"external:core/assets/vast-tracker-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/vast-tracker-asset.json","title":"VAST Tracker Asset","description":"A single tracker URL bound to a VAST `TrackingEvents` event. Emitted by the creative agent as a decomposed VAST-event URL; the sales agent assembles these into the VAST `TrackingEvents` block at serve time. IMPORTANT: this asset type is for `TrackingEvents` URLs only (start, quartiles, complete, pause, mute, etc.). The `Impression` URL MUST be modeled as a `url` asset with `url_type: \"tracker_pixel\"`, not as a vast_tracker with `vast_event: \"impression\"`. Decomposed trackers let format requirements bind specific measurement events (e.g., MRC viewable) without forcing the buyer to construct a full VAST tag.","type":"object","properties":{"asset_type":{"type":"string","const":"vast_tracker","description":"Discriminator identifying this as a VAST tracker asset. See /schemas/creative/asset-types for the registry."},"vast_event":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1vast-tracking-event.json"},{"not":{"enum":["impression","clickTracking","customClick","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]}}],"description":"The VAST tracking event this URL fires on. Maps 1:1 to the VAST `Tracking event=\"...\"` attribute inside `TrackingEvents`. MUST NOT be `impression` (belongs in the VAST `Impression` element — model as a `url` asset with `url_type: \"tracker_pixel\"`), `clickTracking` / `customClick` (belong in `VideoClicks`), `error` (VAST `Error` element), or any of `viewable` / `notViewable` / `viewUndetermined` / `measurableImpression` / `viewableImpression` (children of the VAST `ViewableImpression` element, not `TrackingEvents`)."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Tracker URL fired for the VAST event. Attached declarations identify each macro occurrence, registry revision, processing actor, and exact encoding profile."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"Exact tokens in `url` and their resolver/encoding contracts."},"offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$","description":"VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise for compatibility with existing 3.x manifests. Format matches the VAST 4.2 XSD `Tracking@offset` pattern: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted — the VAST 4.2 XSD pattern does not allow a leading minus."},"target":{"type":"string","enum":["linear","non_linear","companion"],"default":"linear","description":"Which VAST creative element this tracker scopes to — `linear` for `<Linear>/<TrackingEvents>`, `non_linear` for `<NonLinearAds>/<TrackingEvents>`, `companion` for `<CompanionAds>/<Companion>/<TrackingEvents>`. Defaults to `linear`. Existing 3.x assets remain structurally permissive; a tracker execution contract applies the standards-valid event/target matrix when matching a creative to a product."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance."}},"required":["asset_type","vast_event","url"],"allOf":[{"if":{"properties":{"vast_event":{"const":"progress"}},"required":["vast_event"]},"then":{"required":["offset"]}}],"additionalProperties":true},"external:core/assets/daast-tracker-asset.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/assets/daast-tracker-asset.json","title":"DAAST Tracker Asset","description":"A single tracker URL bound to a DAAST `TrackingEvents` event. Audio-side analogue of vast-tracker-asset. The `Impression` URL MUST be modeled as a `url` asset with `url_type: \"tracker_pixel\"`, not as a daast_tracker with `daast_event: \"impression\"`.","type":"object","properties":{"asset_type":{"type":"string","const":"daast_tracker","description":"Discriminator identifying this as a DAAST tracker asset. See /schemas/creative/asset-types for the registry."},"daast_event":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1daast-tracking-event.json"},{"not":{"enum":["impression","clickTracking","customClick","error","viewable","notViewable","viewUndetermined","measurableImpression","viewableImpression"]}}],"description":"The DAAST tracking event this URL fires on. MUST NOT be `impression` (model as `url` asset with `url_type: \"tracker_pixel\"`), `clickTracking` / `customClick` (click-tracking trackers go on their own URL asset), `error`, or any of the `ViewableImpression`-element children (`viewable`, `notViewable`, `viewUndetermined`, `measurableImpression`, `viewableImpression`)."},"url":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-bearing-url.json","description":"Tracker URL fired for the DAAST event. Attached declarations identify each macro occurrence, processing actor, and exact encoding profile."},"macro_declarations":{"type":"array","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1macro-declaration.json"},{"properties":{"location":{"properties":{"field":{"const":"url"}}}}}]},"minItems":1,"description":"Exact tokens in `url` and their resolver/encoding contracts."},"offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$","description":"DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise for compatibility with existing 3.x manifests. Same format as VAST 4.2 `Tracking@offset`: `HH:MM:SS` or `HH:MM:SS.mmm` for absolute time (two-digit hours, minutes 00–59, seconds 00–59), or an integer percentage 0–100 suffixed with `%`. Negative offsets are NOT permitted."},"target":{"type":"string","enum":["linear","companion"],"default":"linear","description":"Which DAAST creative element this tracker scopes to — `linear` for `<Linear>/<TrackingEvents>` (DAAST 1.1 §3.2.1.7), `companion` for `<CompanionAds>/<Companion>/<TrackingEvents>` (DAAST 1.1 §3.2.2.7). DAAST has no `<NonLinearAds>` element. Defaults to `linear`. Existing 3.x assets remain structurally permissive; a tracker execution contract applies the standards-valid event/target matrix when matching a creative to a product."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this asset, overrides manifest-level provenance."}},"required":["asset_type","daast_event","url"],"allOf":[{"if":{"properties":{"daast_event":{"const":"progress"}},"required":["daast_event"]},"then":{"required":["offset"]}}],"additionalProperties":true},"external:core/creative-assets.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-assets.json","title":"Creative Assets","description":"Map of canonical asset-group or legacy asset identifiers to supplied creative assets. Values are either a single discriminated asset or a non-empty repeatable asset array.","type":"object","patternProperties":{"^[a-z0-9_]+$":{"anyOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":true},"external:enums/creative-status.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/creative-status.json","title":"Creative Status","description":"Lifecycle status of a creative asset in a creative library. See the Creative Protocol specification for transition rules.","type":"string","enum":["processing","pending_review","approved","suspended","rejected","archived"],"enumDescriptions":{"processing":"Creative is being ingested, transcoded, or validated. Automatically transitions to pending_review when processing completes, or to rejected if processing fails (e.g., corrupt file, unsupported codec).","pending_review":"Creative has passed processing and is awaiting platform content policy review. Transitions to approved or rejected after review.","approved":"Creative has been approved and is eligible for delivery. May be archived by the buyer, or transitioned by the seller to 'pending_review' (re-review), 'suspended' (recoverable dependency/authorization loss), or 'rejected' (post-approval revocation) when policy enforcement, takedown requests, or content drift require it. Sellers MUST surface a corresponding impairment on any active media buy that references this creative when transitioning 'approved' → 'suspended' or 'approved' → 'rejected'.","suspended":"Creative was approved but is temporarily ineligible for delivery due to a recoverable dependency state, such as an expired/revoked authorization for a `published_post` reference or a source post becoming private. Sellers MAY transition `suspended` back to `approved` after the dependency is restored and any required re-review passes, or to `rejected` when the seller determines the dependency cannot be restored for this creative and replacement/resubmission is required. Sellers MUST surface a corresponding impairment on any active media buy that references this creative while it is suspended.","rejected":"Creative was rejected due to content policy, technical issues, or terminal dependency/authorization loss. Reached from 'pending_review' (initial review failure), from 'approved' (post-approval revocation by the seller — policy change, takedown request, content drift), or from 'suspended' when a previously recoverable dependency is determined unrecoverable for this creative. Not terminal — the buyer may fix the issue and resubmit via sync_creatives, which returns the creative to processing.","archived":"Creative has been archived and is excluded from default queries. Archive MAY be buyer-initiated (explicit cleanup) or seller-initiated (inactivity, post-flight expiry, storage policy, account suspension) — seller-initiated archive is only valid when no active package assignments reference the creative. Archived creatives retain their data and may be unarchived back to approved by the buyer. Buyer-initiated archive is acknowledged on the `sync_creatives` response path. Seller-initiated archive (`approved → archived`) fires `creative.status_changed` against the account's `notification_configs[]` subscribers (see `notification-type.json` and `sync_accounts`); buyers MUST observe the new status on the next `list_creatives` read regardless of whether the webhook was delivered. Destruction is a distinct event (`creative.purged`); purged creatives do not appear in default `list_creatives` results and MAY surface as tombstones when `include_purged: true` is supplied — see `list_creatives` for the tombstone shape."}},"external:core/industry-identifier.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/industry-identifier.json","title":"Industry Identifier","description":"An industry-standard or market-specific identifier for an advertising creative (e.g., Ad-ID, ISCI, Clearcast clock number, IDcrea). These identifiers are managed by external registries or clearance bodies and used across the supply chain to track and reference specific creative assets. Add a PR to extend creative-identifier-type when another shared identifier scheme needs first-class support.","type":"object","properties":{"type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1creative-identifier-type.json"},"value":{"type":"string","maxLength":64,"description":"The identifier value (e.g., 'ABCD1234000H' for Ad-ID). Preserve the value exactly as the traffic or clearance system expects it."}},"required":["type","value"],"additionalProperties":true},"external:enums/creative-identifier-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/creative-identifier-type.json","title":"Creative Identifier Type","description":"Industry-standard or market-specific identifier types for advertising creatives. These identifiers are managed by external registries or clearance bodies and are used across the supply chain to track and reference specific creative assets. This enum is intentionally closed: add a PR for additional shared identifier schemes rather than using an escape hatch.","type":"string","enum":["ad_id","isci","clearcast_clock","idcrea"],"enumDescriptions":{"ad_id":"Ad-ID registry code. Common for US television workflows and accepted by some radio/audio workflows. Often 12-character alphanumeric (4-character company prefix + 8-character unique identifier, e.g., ABCD1234000H). Managed by the Ad-ID registry (ad-id.org). Ties creative assets to rotation instructions and traffic systems.","isci":"Industry Standard Coding Identification. Longstanding creative identifier still used by broadcast radio and legacy traffic systems, sometimes interchangeably with Ad-ID in audio workflows.","clearcast_clock":"Clearcast clock number. UK broadcast creative identifier assigned during the Clearcast clearance process and used from clearance through transmission and reporting.","idcrea":"IDcrea identifier. French ARPP.PUB creative identifier for current ARPP.PUB workflows; historical PubID values remain valid for older creatives."},"examples":["ad_id","isci","clearcast_clock","idcrea"]},"external:core/rights-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/rights-constraint.json","title":"Rights Constraint","description":"Rights metadata attached to a creative. Each entry represents constraints from a single rights holder. Buyer-carried fields are a presentation, not authorization. In AdCP 3.2, a serving party treats a constraint as machine-verified only after one attestation_refs entry evaluates to verified under its own adcp.attestations policy and matches the complete digest-pinned grant.","type":"object","properties":{"rights_id":{"type":"string","description":"Rights grant identifier from the acquire_rights response"},"rights_agent":{"type":"object","description":"The agent that granted these rights","properties":{"url":{"type":"string","format":"uri","description":"MCP endpoint URL of the rights agent"},"id":{"type":"string","description":"Agent identifier"}},"required":["url","id"]},"rights_holder":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json","description":"Canonical BrandRef for the rights holder that issued the grant through an authorized rights agent. Required whenever attestation_refs is present. Evaluators first match this exact BrandRef against local issuer policy, then resolve the authoritative brand.json and bind the credential verification key to exactly one matching agents[] entry with type rights. Sibling-brand agents are never authority. Legacy unattested constraints may omit this field but remain machine-unverified."},"valid_from":{"type":"string","format":"date-time","description":"Start of the rights validity period"},"valid_until":{"type":"string","format":"date-time","description":"End of the rights validity period. Creative should not be served after this time."},"uses":{"type":"array","description":"Rights uses covered by this constraint","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1right-use.json"},"minItems":1},"countries":{"type":"array","description":"Countries where this creative may be served under these rights (ISO 3166-1 alpha-2). If omitted, no country restriction. When both countries and excluded_countries are present, the effective set is countries minus excluded_countries.","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"excluded_countries":{"type":"array","description":"Countries excluded from rights availability (ISO 3166-1 alpha-2). Use when the grant is worldwide except specific markets.","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"impression_cap":{"type":"integer","minimum":1,"description":"Maximum total impressions allowed for the full validity period (valid_from to valid_until). This is the absolute cap across all creatives using this rights grant, not a per-creative or per-period limit."},"right_type":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1right-type.json","description":"Type of rights (talent, music, etc.). Helps identify constraints when a creative combines multiple rights types."},"approval_status":{"type":"string","enum":["pending","approved","rejected"],"description":"Approval status from the rights holder at manifest creation time (snapshot, not a live value)"},"grant_status":{"type":"string","enum":["active","paused","revoked"],"description":"Authoritative lifecycle state bound into the grant digest and credential status evidence. Only active can evaluate to verified. paused and revoked credentials are ineligible for serving; resumption issues a fresh active credential and reference."},"restrictions":{"type":"array","description":"Normalized enforceable content and usage restrictions issued with the grant. When present these values are part of content_digest and cannot be omitted or changed without invalidating the attestation.","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"disclosure":{"type":"object","description":"Disclosure obligation issued with the grant and bound by content_digest.","properties":{"required":{"type":"boolean"},"text":{"type":"string","minLength":1}},"required":["required"],"allOf":[{"if":{"properties":{"required":{"const":true}},"required":["required"]},"then":{"required":["text"]}}],"additionalProperties":false},"creative_approval_required":{"type":"boolean","description":"Whether each creative produced under this grant requires holder approval before distribution. This enforceable term is bound by content_digest."},"verification_url":{"type":"string","format":"uri","deprecated":true,"description":"DEPRECATED legacy informational locator. It is not proof of grant status, a revocation source, a credential locator, or permission to make a network request. Receivers MUST NOT fetch it during rights evaluation, and HTTP status codes have no AdCP authorization meaning. Rights authorization uses attestation_refs and a verifier-of-record evaluation under evaluator-owned policy."},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"SHA-256 of UTF8(JCS(rights_constraint minus content_digest, attestation_refs, and verification_url)), formatted as sha256:<lowercase hex>. This binds all serving-relevant grant fields, including future extension fields, while deliberately excluding the legacy non-authoritative URL."},"attestation_refs":{"type":"array","description":"Alternative portable presentations of a holder-issued rights-grant credential signed by its authorized rights agent. The buyer carries references only; the serving party remains verifier-of-record. At least one reference must evaluate to verified and match rights_holder, rights_id, rights_agent, content_digest, validity, revocation state, and local policy before this constraint can contribute to serving eligibility.","items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-reference.json"},{"type":"object","properties":{"issuer":{"type":"object","properties":{"type":{"type":"string","const":"brand"},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"}},"required":["type","brand"]},"claim_type":{"type":"string","const":"https://adcontextprotocol.org/claims/rights/grant"},"subject":{"type":"object","properties":{"type":{"type":"string","const":"resource"},"resource_type":{"type":"string","const":"https://adcontextprotocol.org/claims/subjects/rights-grant"}},"required":["type","resource_type","namespace","id","content_digest"]}}}]},"minItems":1,"maxItems":4,"uniqueItems":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["rights_id","rights_agent","uses"],"allOf":[{"if":{"required":["attestation_refs"]},"then":{"required":["rights_holder","grant_status","content_digest"]}}],"x-adcp-validation":{"rights_attestation_profile":{"claim_type":"https://adcontextprotocol.org/claims/rights/grant","subject_resource_type":"https://adcontextprotocol.org/claims/subjects/rights-grant","cross_field_equality":["attestation_ref.issuer.brand == rights_holder (exact BrandRef)","attestation_ref.subject.namespace == rights_agent.url (canonical URL)","attestation_ref.subject.id == rights_id","attestation_ref.subject.content_digest == content_digest"],"digest_excludes":["content_digest","attestation_refs","verification_url"],"resolution_limits":{"pre_network_checks":["accepted issuer","accepted claim","accepted proof format","accepted delivery method","accepted resolver or origin"],"maximum_references":4,"deduplicate_equivalent_references":true,"apply_account_and_evaluator_rate_limits":true}}},"additionalProperties":true},"external:enums/right-use.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/right-use.json","title":"Right Use","description":"Types of rights usage that can be licensed through the brand protocol. Aligned with DDEX UseType direction for interoperability with music and media rights systems.","x-status":"experimental","type":"string","enum":["likeness","voice","name","endorsement","motion_capture","signature","catchphrase","sync","background_music","editorial","commercial","ai_generated_image"],"enumDescriptions":{"likeness":"Visual representation of a person's appearance, including AI-generated imagery","voice":"Audio reproduction of a person's voice, including AI-generated speech","name":"Use of a person's name in advertising or promotional materials","endorsement":"Implied or explicit endorsement of a product or service by a person","motion_capture":"Use of a person's movement patterns for animation or video","signature":"Use of a person's signature or autograph","catchphrase":"Use of a person's well-known phrases or sayings","sync":"Synchronization of music with visual media (ads, video)","background_music":"Use of music as background audio in advertising","editorial":"Use in editorial or informational contexts","commercial":"Use in commercial advertising and promotional contexts","ai_generated_image":"License to produce AI-generated still imagery derived from the rights holder's IP (brand assets, character designs, talent likeness). Distinct from likeness/voice by output modality — a get_rights query filtered on ai_generated_image returns rights whose pricing options cover image generation, regardless of the underlying IP category."}},"external:enums/right-type.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/right-type.json","title":"Right Type","description":"Categories of intellectual property rights that can be licensed through the brand protocol.","x-status":"experimental","type":"string","enum":["talent","character","brand_ip","music","stock_media"],"enumDescriptions":{"talent":"Rights to a real person's likeness, voice, name, or endorsement (athletes, celebrities, influencers)","character":"Rights to fictional characters for advertising or co-branding","brand_ip":"Rights to brand intellectual property (logos, trademarks, trade dress)","music":"Rights to musical compositions or recordings (sync, background music)","stock_media":"Rights to stock photography, video, or audio collections"}},"external:core/attestation-reference.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/attestation-reference.json","title":"Attestation Reference","description":"Portable, reference-first presentation of an independently issued claim. It identifies the claimed issuer, claim vocabulary, subject, and either a stable credential locator or an embedded credential. A presentation is a locator and claim hint, not proof or a trust decision. The evaluator remains verifier-of-record and MUST resolve or inspect the credential only under its published attestation capabilities and local trust policy.","type":"object","properties":{"issuer":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-issuer.json"},"claim_type":{"type":"string","format":"uri","description":"Open, absolute URI identifying the claim vocabulary. The URI is an identifier and need not be dereferenceable. AdCP does not maintain an enum of approved claims."},"subject":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1attestation-subject.json"},"locator":{"description":"Stable locator for resolving the credential. Credential URLs are permitted only when their canonical origin is allowlisted for the matched issuer. Issuer-scoped IDs name a resolver_id already published by the evaluator; the presentation cannot introduce a resolver URL.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationCredentialUriLocator","type":"object","properties":{"type":{"type":"string","const":"credential_uri"},"credential_uri":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"HTTPS URI of the credential. Before any fetch, evaluators MUST match its canonical origin to credential_origins on the accepted issuer capability and then apply the attestation fetch contract."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","credential_uri"],"additionalProperties":false},{"title":"AttestationIssuerCredentialIdLocator","type":"object","properties":{"type":{"type":"string","const":"issuer_credential_id"},"credential_id":{"type":"string","minLength":1,"maxLength":1024,"description":"Stable credential identifier in the issuer's namespace. It is meaningful only together with issuer and resolver_id.","x-entity":"attestation_credential"},"resolver_id":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9._:-]+$","description":"Identifier of a resolver already published in the matched accepted_issuers[].resolvers[] capability. A presenter cannot supply or override its URL."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","credential_id","resolver_id"],"additionalProperties":false}]},"embedded_credential":{"type":"object","description":"Optional inline credential for private, authenticated, or offline delivery. It may accompany locator or be the only delivery path. Its format must be supported by the evaluator, and the evaluator MUST verify the credential exactly as it would a resolved credential.","properties":{"format":{"type":"string","format":"uri","description":"Open, absolute URI identifying the credential/proof format. AdCP does not impose a universal issuer payload schema."},"value":{"description":"Credential encoded as a JSON object or a compact string, according to format.","type":["object","string"],"minLength":1},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["format","value"],"additionalProperties":false},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Optional SHA-256 digest pin for the exact credential bytes, formatted as sha256:<lowercase hex>. The credential format defines its canonical byte representation. A mismatch is invalid and MUST NOT fall back to the unpinned credential. REQUIRED when both locator and embedded_credential are present; both byte representations MUST match this digest."},"credential_version":{"type":"string","minLength":1,"maxLength":255,"description":"Optional issuer-defined credential version hint. It is advisory; the resolved credential is authoritative."},"validity_hint":{"type":"object","description":"Optional planning-time validity hint copied from issuer metadata. Evaluators MUST use the resolved or embedded credential's signed validity and revocation state as authoritative.","properties":{"not_before":{"type":"string","format":"date-time"},"expires_at":{"type":"string","format":"date-time"}},"additionalProperties":false,"minProperties":1},"verify_agent":{"type":"object","description":"Optional presenter nomination of a verifier already published by the evaluator. This is a representation, not routing authority: agent_url MUST match an accepted_verifiers[] entry after canonicalization, and the evaluator may choose another accepted verifier or verify locally.","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$"}},"required":["agent_url"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["issuer","claim_type","subject"],"anyOf":[{"required":["locator"]},{"required":["embedded_credential"]}],"allOf":[{"if":{"required":["locator","embedded_credential"]},"then":{"required":["content_digest"]}}],"additionalProperties":false,"examples":[{"issuer":{"type":"origin","origin":"https://credentials.example"},"claim_type":"https://claims.example/audience/methodology-reviewed","subject":{"type":"resource","resource_type":"https://adcontextprotocol.org/claims/subjects/signal","namespace":"https://signals.meridian.example/adcp","id":"signal_urban_commuters"},"locator":{"type":"issuer_credential_id","credential_id":"cred_01JATT7Y","resolver_id":"primary"},"content_digest":"sha256:5b6e8f7a4c3d2e1f00112233445566778899aabbccddeeff0011223344556677"}]},"external:core/attestation-subject.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/attestation-subject.json","title":"Attestation Subject","description":"Typed identity of the entity or object an attestation credential is about. Brand and agent subjects reuse canonical AdCP identities. Other resources use an open, URI-namespaced resource_type plus an identifier whose namespace is explicit. Evaluators MUST compare the resolved credential subject to this complete typed identity, not to id alone.","discriminator":{"propertyName":"type"},"oneOf":[{"title":"AttestationBrandSubject","type":"object","properties":{"type":{"type":"string","const":"brand"},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","brand"],"additionalProperties":false},{"title":"AttestationAgentSubject","type":"object","properties":{"type":{"type":"string","const":"agent"},"agent_url":{"type":"string","format":"uri","pattern":"^https://[^/?#@]+(?:/[^?#]*)?(?:\\?[^#]*)?$","description":"Canonical HTTPS endpoint of the agent the claim concerns."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","agent_url"],"additionalProperties":false},{"title":"AttestationResourceSubject","type":"object","properties":{"type":{"type":"string","const":"resource"},"resource_type":{"type":"string","format":"uri","description":"Open, absolute URI naming the subject vocabulary, such as https://adcontextprotocol.org/claims/subjects/signal. AdCP does not maintain an exhaustive enum."},"namespace":{"type":"string","format":"uri","description":"Absolute URI identifying the namespace in which id is unique. This may be an AdCP agent endpoint, a catalog origin, or a domain-specific namespace URI."},"id":{"type":"string","minLength":1,"maxLength":1024,"description":"Stable identifier for the subject within namespace. It MUST NOT be compared without resource_type and namespace."},"content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"Optional SHA-256 pin for the exact content or immutable snapshot identified by this resource subject. This is part of the complete typed subject identity and is distinct from AttestationReference.content_digest, which pins credential bytes."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["type","resource_type","namespace","id"],"additionalProperties":false}],"examples":[{"type":"brand","brand":{"domain":"nova-brands.example","brand_id":"nova_motors"}},{"type":"resource","resource_type":"https://adcontextprotocol.org/claims/subjects/signal","namespace":"https://signals.meridian.example/adcp","id":"signal_urban_commuters"}]},"external:core/context.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/context.json","title":"Context Object","description":"Opaque correlation data that is echoed unchanged in responses. Used for internal tracking, UI session IDs, trace IDs, and other caller-specific identifiers that don't affect protocol behavior. Context data is never parsed by AdCP agents - it's simply preserved and returned.","type":"object","additionalProperties":true},"external:enums/advertiser-industry.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/advertiser-industry.json","title":"Advertiser Industry","description":"Standardized advertiser industry classification. Top-level categories classify the advertiser's primary business. Dot-notation subcategories (e.g., 'media_entertainment.podcasts') provide platform-specific precision where needed. Sellers map these to platform-native codes (Spotify ADV categories, LinkedIn industry IDs, IAB Content Taxonomy, etc.). Sellers MUST accept unknown values gracefully — treat unrecognized values as the parent category (strip the subcategory) or as uncategorized. This ensures forward compatibility as the taxonomy evolves.","type":"string","x-extensible":true,"x-pattern":"^[a-z][a-z0-9_]+(\\.[a-z][a-z0-9_]+)?$","enum":["automotive","automotive.electric_vehicles","automotive.parts_accessories","automotive.luxury","beauty_cosmetics","beauty_cosmetics.skincare","beauty_cosmetics.fragrance","beauty_cosmetics.haircare","cannabis","cpg","cpg.personal_care","cpg.household","dating","education","education.higher_education","education.online_learning","education.k12","energy_utilities","energy_utilities.renewable","fashion_apparel","fashion_apparel.luxury","fashion_apparel.sportswear","finance","finance.banking","finance.insurance","finance.investment","finance.cryptocurrency","food_beverage","food_beverage.alcohol","food_beverage.restaurants","food_beverage.packaged_goods","gambling_betting","gambling_betting.sports_betting","gambling_betting.casino","gaming","gaming.mobile","gaming.console_pc","gaming.esports","government_nonprofit","government_nonprofit.political","government_nonprofit.charity","healthcare","healthcare.pharmaceutical","healthcare.medical_devices","healthcare.wellness","home_garden","home_garden.furniture","home_garden.home_improvement","media_entertainment","media_entertainment.podcasts","media_entertainment.music","media_entertainment.film_tv","media_entertainment.publishing","media_entertainment.live_events","pets","professional_services","professional_services.legal","professional_services.consulting","real_estate","real_estate.residential","real_estate.commercial","recruitment_hr","retail","retail.ecommerce","retail.department_stores","sports_fitness","sports_fitness.equipment","sports_fitness.teams_leagues","technology","technology.software","technology.hardware","technology.ai_ml","telecom","telecom.mobile_carriers","telecom.internet_providers","transportation_logistics","travel_hospitality","travel_hospitality.airlines","travel_hospitality.hotels","travel_hospitality.cruise","travel_hospitality.tourism"],"enumDescriptions":{"automotive":"Automotive manufacturers, dealerships, and auto industry","automotive.electric_vehicles":"Electric vehicle manufacturers and charging infrastructure","automotive.parts_accessories":"Auto parts, accessories, and aftermarket products","automotive.luxury":"Luxury and premium automotive brands","beauty_cosmetics":"Beauty, cosmetics, and prestige skincare brands. Distinct from cpg.personal_care — use beauty_cosmetics for brands whose identity is rooted in beauty (L'Oreal Paris, Estee Lauder, Sephora) and cpg.personal_care for mass-market personal hygiene (Dove, Colgate)","beauty_cosmetics.skincare":"Skincare brands and dermatological products","beauty_cosmetics.fragrance":"Perfume and fragrance brands","beauty_cosmetics.haircare":"Professional and prestige haircare brands","cannabis":"Cannabis products and dispensaries. Subject to heavy platform restrictions — most platforms require explicit category declaration for ad acceptance","cpg":"Consumer packaged goods — mass-market products sold through retail. For food and beverage manufacturers, use food_beverage. For prestige beauty, use beauty_cosmetics","cpg.personal_care":"Mass-market personal care and hygiene products (deodorant, toothpaste, soap). For prestige beauty brands, use beauty_cosmetics","cpg.household":"Household cleaning and maintenance products","dating":"Dating apps and matchmaking services. Subject to platform restrictions similar to gambling_betting","education":"Educational institutions and learning services","education.higher_education":"Universities, colleges, and graduate programs","education.online_learning":"Online courses, MOOCs, and digital education platforms","education.k12":"Primary and secondary education","energy_utilities":"Energy companies and utilities","energy_utilities.renewable":"Renewable energy, solar, wind, and clean technology","fashion_apparel":"Clothing, footwear, and fashion accessories","fashion_apparel.luxury":"Luxury fashion and designer brands","fashion_apparel.sportswear":"Athletic and sportswear brands","finance":"Financial services, banking, and insurance","finance.banking":"Retail and commercial banking","finance.insurance":"Insurance products and services","finance.investment":"Investment, wealth management, and brokerage","finance.cryptocurrency":"Cryptocurrency exchanges and blockchain financial products","food_beverage":"Food and beverage companies — manufacturers (Coca-Cola, Nestle), restaurants, and alcohol brands. For non-food packaged goods, use cpg","food_beverage.alcohol":"Alcoholic beverages (beer, wine, spirits). Subject to platform age-gating and regional restrictions","food_beverage.restaurants":"Restaurants, fast food, and food delivery","food_beverage.packaged_goods":"Packaged food and non-alcoholic beverages","gambling_betting":"Gambling, sports betting, and wagering. Subject to heavy platform restrictions — most platforms require explicit category declaration","gambling_betting.sports_betting":"Sports betting and daily fantasy sports","gambling_betting.casino":"Online casinos and traditional gambling","gaming":"Video games and interactive entertainment","gaming.mobile":"Mobile gaming","gaming.console_pc":"Console and PC gaming","gaming.esports":"Esports teams, tournaments, and streaming","government_nonprofit":"Government agencies and nonprofit organizations","government_nonprofit.political":"Political advertising and advocacy. Subject to platform transparency and disclosure requirements","government_nonprofit.charity":"Charitable organizations and fundraising","healthcare":"Healthcare, pharmaceuticals, and medical","healthcare.pharmaceutical":"Pharmaceutical and biotech companies. Subject to platform restrictions on drug advertising","healthcare.medical_devices":"Medical devices and health technology","healthcare.wellness":"Wellness, supplements, and alternative health","home_garden":"Home furnishing, improvement, and garden","home_garden.furniture":"Furniture and home decor","home_garden.home_improvement":"Home improvement, tools, and renovation","media_entertainment":"Media, entertainment, and content","media_entertainment.podcasts":"Podcast networks and podcast-first brands","media_entertainment.music":"Music labels, streaming, and artists","media_entertainment.film_tv":"Film studios, TV networks, and streaming services","media_entertainment.publishing":"Book publishers, magazines, and digital publications","media_entertainment.live_events":"Concerts, festivals, and live entertainment","pets":"Pet food, supplies, and veterinary services","professional_services":"Professional and business services","professional_services.legal":"Law firms and legal services","professional_services.consulting":"Management and business consulting","real_estate":"Real estate, property, and construction","real_estate.residential":"Residential real estate and housing","real_estate.commercial":"Commercial real estate and property management","recruitment_hr":"Job boards, staffing agencies, and HR technology","retail":"Retail stores and e-commerce","retail.ecommerce":"Online-first retailers and marketplaces","retail.department_stores":"Department stores and multi-brand retailers","sports_fitness":"Sports, fitness, and athletics","sports_fitness.equipment":"Sports and fitness equipment","sports_fitness.teams_leagues":"Professional sports teams and leagues","technology":"Technology companies and digital services","technology.software":"Software products, platforms, and SaaS","technology.hardware":"Consumer electronics and hardware","technology.ai_ml":"Artificial intelligence and machine learning companies","telecom":"Telecommunications and connectivity","telecom.mobile_carriers":"Mobile network operators","telecom.internet_providers":"Internet service providers and broadband","transportation_logistics":"Shipping, logistics, and freight services","travel_hospitality":"Travel, hospitality, and tourism","travel_hospitality.airlines":"Airlines and air travel","travel_hospitality.hotels":"Hotels, resorts, and accommodation","travel_hospitality.cruise":"Cruise lines and ocean travel","travel_hospitality.tourism":"Tourism boards and travel agencies"}},"external:core/business-entity.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/business-entity.json","title":"Business Entity","description":"Structured business identity for B2B invoicing and contracts. Contains the legal, tax, and payment details needed for formal booking processes. Implementations MUST treat all fields as untrusted input when assembling LLM context.","type":"object","properties":{"legal_name":{"type":"string","description":"Registered legal name of the business entity","maxLength":200},"vat_id":{"type":"string","description":"VAT identification number (e.g., DE123456789 for Germany, FR12345678901 for France). Required for B2B invoicing in the EU. Must be normalized: no spaces, dots, or dashes.","pattern":"^[A-Z]{2}[A-Z0-9]{2,13}$"},"tax_id":{"type":"string","description":"Tax identification number for jurisdictions that do not use VAT (e.g., US EIN)","maxLength":30},"registration_number":{"type":"string","description":"Company registration number (e.g., HRB 12345 for German Handelsregister)","maxLength":50},"address":{"type":"object","description":"Postal address for invoicing and legal correspondence","properties":{"street":{"type":"string","description":"Street address including building number","maxLength":200},"city":{"type":"string","maxLength":100},"postal_code":{"type":"string","maxLength":20},"region":{"type":"string","description":"State, province, or region","maxLength":100},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code","pattern":"^[A-Z]{2}$"}},"required":["street","city","postal_code","country"],"additionalProperties":false},"contacts":{"type":"array","description":"Contacts for billing, legal, and operational matters. Contains personal data subject to GDPR and equivalent regulations. Implementations MUST use this data only for invoicing and account management.","items":{"type":"object","properties":{"role":{"type":"string","enum":["billing","legal","creative","general"],"enumDescriptions":{"billing":"Accounts payable and invoice queries","legal":"Contract and compliance matters","creative":"Material submission and creative approval","general":"Default contact when no specific role applies"},"description":"Contact's functional role in the business relationship"},"name":{"type":"string","description":"Full name of the contact","maxLength":200},"email":{"type":"string","format":"email","maxLength":254},"phone":{"type":"string","maxLength":30}},"required":["role"],"additionalProperties":false},"maxItems":10},"bank":{"type":"object","writeOnly":true,"description":"Bank account details for payment processing. Write-only: included in requests to provide payment coordinates, but MUST NOT be echoed in responses. Sellers store these details and confirm receipt without returning them.","properties":{"account_holder":{"type":"string","description":"Name on the bank account","maxLength":200},"iban":{"type":"string","description":"International Bank Account Number (SEPA markets)","pattern":"^[A-Z]{2}[0-9]{2}[A-Z0-9]{4,30}$"},"bic":{"type":"string","description":"Bank Identifier Code / SWIFT code (SEPA markets)","pattern":"^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"},"routing_number":{"type":"string","description":"Bank routing number for non-SEPA markets (e.g., US ABA routing number, Canadian transit/institution number)","maxLength":30},"account_number":{"type":"string","description":"Bank account number for non-SEPA markets","maxLength":30}},"required":["account_holder"],"additionalProperties":false},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:core~1ext.json"}},"required":["legal_name"],"additionalProperties":false,"examples":[{"description":"German agency with full B2B details","data":{"legal_name":"Pinnacle Media GmbH","vat_id":"DE123456789","registration_number":"HRB 12345","address":{"street":"Friedrichstrasse 100","city":"Berlin","postal_code":"10117","country":"DE"},"contacts":[{"role":"billing","name":"Sam Adeyemi","email":"billing@pinnacle-media.com","phone":"+49 30 12345678"}],"bank":{"account_holder":"Pinnacle Media GmbH","iban":"DE89370400440532013000","bic":"COBADEFFXXX"}}},{"description":"US advertiser with EIN and domestic bank details","data":{"legal_name":"Acme Corporation","tax_id":"12-3456789","address":{"street":"123 Main St","city":"New York","postal_code":"10001","region":"NY","country":"US"},"contacts":[{"role":"billing","name":"AP Department","email":"ap@acme-corp.com"}],"bank":{"account_holder":"Acme Corporation","routing_number":"021000021","account_number":"123456789"}}}]},"external:core/start-timing.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/start-timing.json","title":"Start Timing","description":"Campaign start timing: 'asap' or ISO 8601 date-time","oneOf":[{"type":"string","const":"asap","description":"Start campaign as soon as possible"},{"type":"string","format":"date-time","description":"Scheduled start date/time in ISO 8601 format"}]},"external:core/push-notification-config.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/push-notification-config.json","title":"Push Notification Config","description":"Webhook configuration for asynchronous task notifications. Uses A2A-compatible PushNotificationConfig structure. By default, webhooks are signed with the AdCP RFC 9421 profile (see docs/building/by-layer/L1/security.mdx#webhook-callbacks) — the seller signs outbound with a key published at the jwks_uri on its own brand.json `agents[]` entry and the buyer verifies against that JWKS, so no shared secret crosses the wire. The optional `authentication` block selects the legacy Bearer or HMAC-SHA256 fallback for compatibility with receivers that have not yet adopted the 9421 profile; this fallback is deprecated and will be removed in AdCP 4.0. Note: the `idempotency_key` that receivers dedup on lives inside the webhook **payload** body (see docs/building/by-layer/L3/webhooks.mdx#reliability and the mcp-webhook-payload schema), not in this configuration object — this schema only describes the receiver-side transport config sent to the seller. This schema is designed for composition via allOf - consuming schemas should define their own additionalProperties constraints.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for task status notifications. The wire contract is unconstrained beyond `format: \"uri\"` — in particular, publishers SHOULD NOT enforce a destination-port allowlist by default, since buyers legitimately host receivers on non-standard TLS ports (`:9443`, `:4443`, path-routed multi-tenant gateways). The SSRF guard the protocol relies on is the IP-range check + DNS-rebinding-resistant connect pin defined in [Webhook URL validation (SSRF)](/docs/building/by-layer/L1/security#webhook-url-validation-ssrf), not port filtering. Operators who want a hardened destination-port allowlist as defense-in-depth (e.g., locked-down enterprise egress) opt in explicitly — see [Destination port: permissive by default](/docs/building/by-layer/L1/security#destination-port-permissive-by-default)."},"operation_id":{"type":"string","description":"Buyer-supplied correlation identifier for the operation that will produce webhooks against this registration. The seller MUST echo this value verbatim into every webhook payload's `operation_id` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) and [Webhooks — Operation IDs](/docs/building/by-layer/L3/webhooks#operation-ids-and-url-templates)). Buyers SHOULD generate a unique value per task invocation (UUID recommended). This field is the canonical registration channel for `operation_id`; buyers MAY additionally embed routing values in the URL path or query as an aid for their own HTTP server, but the URL is opaque to the seller and the wire-level source of truth is this field. Sellers MUST NOT parse the URL to recover `operation_id`. For 3.x schema compatibility the member remains optional, but a seller MUST reject a task that registers an AdCP webhook without it using `INVALID_REQUEST`; otherwise the required webhook envelope cannot be emitted.","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9_.:-]{1,255}$"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. The seller MUST echo this value verbatim in every webhook payload's `token` field (see [`mcp-webhook-payload.json`](/schemas/core/mcp-webhook-payload.json) for the receiver-side validation obligation). Length bounds give receivers a defensive range check on the echoed value; senders SHOULD generate tokens with at least 128 bits of entropy (≥22 base64url characters). This is a complementary authenticity mechanism that can layer on top of the RFC 9421 webhook signature — unlike the `authentication` block below, it is not on the 4.0 removal track. Receivers that registered both a signing key (RFC 9421) and a `token` MUST NOT treat a valid token echo as authorization to skip signature verification; both checks remain independent obligations.","minLength":16,"maxLength":4096},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration (A2A-compatible). Opts the seller into Bearer or HMAC-SHA256 signing instead of the default RFC 9421 webhook profile. Deprecated; removed in AdCP 4.0. **Precedence is a switch, not a fallback:** presence of this block selects the legacy scheme; absence selects 9421. A seller MUST NOT sign the same webhook both ways, and a buyer MUST NOT attempt 'try 9421 first, fall back to HMAC' verification — signature mode is determined solely by whether this block was present at registration time. The seller's baseline 9421 webhook key is published at its brand.json `agents[]` `jwks_uri` using `adcp_use: \"request-signing\"` (deprecated `webhook-signing` keys remain accepted during the compatibility window); it does not override this selector and is only used when `authentication` is omitted. See docs/building/by-layer/L1/security.mdx#webhook-callbacks for the full precedence and downgrade-resistance rules (including the `webhook_mode_mismatch` rejection a buyer MUST apply when a received webhook's signing mode does not match the registered mode).","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. Supported: ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit `authentication` and use the RFC 9421 webhook profile.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false}},"required":["url"]},"external:enums/auth-scheme.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/auth-scheme.json","title":"Authentication Scheme","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication schemes for the webhook auth block. Bearer: token sent in Authorization header. HMAC-SHA256: legacy shared-secret signing. Both are deprecated; new integrations SHOULD omit the authentication block and use the RFC 9421 webhook signing profile (applicable on schemas where authentication is optional). Removed in AdCP 4.0.","type":"string","enum":["Bearer","HMAC-SHA256"]},"external:core/reporting-webhook.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/reporting-webhook.json","title":"Reporting Webhook","description":"Webhook configuration for automated reporting delivery. Configures where and how campaign performance reports are sent.","type":"object","properties":{"url":{"type":"string","format":"uri","description":"Webhook endpoint URL for reporting notifications"},"token":{"type":"string","description":"Optional client-provided token for webhook validation. Echoed back in webhook payload to validate request authenticity.","minLength":16},"authentication":{"type":"object","deprecated":true,"x-removed-in":"4.0.0","description":"Legacy authentication configuration for webhook delivery (A2A-compatible). Opts the receiver into Bearer or HMAC-SHA256 signing. Both schemes are deprecated; the preferred signing profile for new integrations is RFC 9421, where the seller signs with a key published at its brand.json agents[] entry and the buyer verifies against the seller's JWKS — no shared secret crosses the wire (see docs/building/by-layer/L1/security.mdx#webhook-callbacks). This field is required in AdCP 3.x; the requirement is removed in AdCP 4.0 when the default RFC 9421 path becomes the only path.","properties":{"schemes":{"type":"array","description":"Array of authentication schemes. ['Bearer'] for simple token auth, ['HMAC-SHA256'] for legacy shared-secret signing. Both are deprecated; new integrations SHOULD use the RFC 9421 webhook signing profile instead.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1auth-scheme.json"},"minItems":1,"maxItems":1},"credentials":{"type":"string","description":"Credentials for the legacy scheme. For Bearer: token sent in Authorization header. For HMAC-SHA256: shared secret used to generate signature. Minimum 32 characters. Exchanged out-of-band during onboarding.","minLength":32}},"required":["schemes","credentials"],"additionalProperties":false},"reporting_frequency":{"type":"string","enum":["hourly","daily","monthly"],"description":"Frequency for automated reporting delivery. Must be supported by all products in the media buy."},"requested_metrics":{"type":"array","description":"Optional list of metrics to include in webhook notifications. If omitted, all available metrics are included; an empty array has the same meaning as omission (it does not narrow to impressions and spend only). impressions and spend are always included regardless of this list. Must be a subset of the product's available_metrics. Subset evaluation and leaf resolution follow `enums/available-metric.json`: a numeric leaf may be covered by its container, while each structured distribution must be explicitly available. Requesting any nested identity selects its canonical carrier inside the payload's nested object. Same narrowing semantics as get_media_buy_delivery's requested_metrics (which additionally requires at least one entry when present).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/create-media-buy-request.json#/$defs/external:enums~1available-metric.json"},"uniqueItems":true}},"required":["url","authentication","reporting_frequency"],"additionalProperties":true}},"dependentRequired":{"proposal_id":["total_budget"]}}