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

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 (1705) 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/brand/index.d.mts +2 -0
  14. package/dist/lib/brand/index.d.ts +2 -0
  15. package/dist/lib/brand/index.js +3 -0
  16. package/dist/lib/brand/index.mjs +2 -0
  17. package/dist/lib/brand/selection.d.mts +13 -0
  18. package/dist/lib/brand/selection.d.ts +13 -0
  19. package/dist/lib/brand/selection.js +83 -0
  20. package/dist/lib/brand/selection.mjs +59 -0
  21. package/dist/lib/core/SingleAgentClient.js +3 -3
  22. package/dist/lib/core/SingleAgentClient.mjs +4 -3
  23. package/dist/lib/index.d.mts +2 -2
  24. package/dist/lib/index.d.ts +2 -2
  25. package/dist/lib/index.js +2 -0
  26. package/dist/lib/index.mjs +2 -0
  27. package/dist/lib/negotiation/commercial-terms-semantics.js +11 -0
  28. package/dist/lib/negotiation/commercial-terms-semantics.mjs +11 -0
  29. package/dist/lib/registry/types.d.mts +5 -0
  30. package/dist/lib/registry/types.d.ts +5 -0
  31. package/dist/lib/registry/types.generated.d.ts +4 -0
  32. package/dist/lib/schemas-data/3.2/a2ui/bound-value.json +1 -1
  33. package/dist/lib/schemas-data/3.2/a2ui/component.json +1 -1
  34. package/dist/lib/schemas-data/3.2/a2ui/si-catalog.json +25 -25
  35. package/dist/lib/schemas-data/3.2/a2ui/surface.json +2 -2
  36. package/dist/lib/schemas-data/3.2/a2ui/user-action.json +1 -1
  37. package/dist/lib/schemas-data/3.2/aao/agent-publishers.json +1 -1
  38. package/dist/lib/schemas-data/3.2/account/get-account-financials-request.json +6 -6
  39. package/dist/lib/schemas-data/3.2/account/get-account-financials-response.json +12 -12
  40. package/dist/lib/schemas-data/3.2/account/list-account-changes-request.json +7 -7
  41. package/dist/lib/schemas-data/3.2/account/list-account-changes-response.json +7 -7
  42. package/dist/lib/schemas-data/3.2/account/list-accounts-request.json +6 -6
  43. package/dist/lib/schemas-data/3.2/account/list-accounts-response.json +8 -8
  44. package/dist/lib/schemas-data/3.2/account/report-usage-request.json +6 -6
  45. package/dist/lib/schemas-data/3.2/account/report-usage-response.json +6 -6
  46. package/dist/lib/schemas-data/3.2/account/sync-accounts-request.json +16 -16
  47. package/dist/lib/schemas-data/3.2/account/sync-accounts-response.json +21 -21
  48. package/dist/lib/schemas-data/3.2/account/sync-governance-request.json +5 -5
  49. package/dist/lib/schemas-data/3.2/account/sync-governance-response.json +10 -10
  50. package/dist/lib/schemas-data/3.2/adagents.json +30 -30
  51. package/dist/lib/schemas-data/3.2/brand/acquire-rights-request.json +12 -12
  52. package/dist/lib/schemas-data/3.2/brand/acquire-rights-response.json +16 -16
  53. package/dist/lib/schemas-data/3.2/brand/creative-approval-request.json +5 -5
  54. package/dist/lib/schemas-data/3.2/brand/creative-approval-response.json +12 -12
  55. package/dist/lib/schemas-data/3.2/brand/get-brand-identity-request.json +4 -4
  56. package/dist/lib/schemas-data/3.2/brand/get-brand-identity-response.json +10 -10
  57. package/dist/lib/schemas-data/3.2/brand/get-rights-request.json +8 -8
  58. package/dist/lib/schemas-data/3.2/brand/get-rights-response.json +11 -11
  59. package/dist/lib/schemas-data/3.2/brand/revocation-notification.json +4 -4
  60. package/dist/lib/schemas-data/3.2/brand/rights-pricing-option.json +5 -5
  61. package/dist/lib/schemas-data/3.2/brand/rights-terms.json +3 -3
  62. package/dist/lib/schemas-data/3.2/brand/search-brands-request.json +6 -6
  63. package/dist/lib/schemas-data/3.2/brand/search-brands-response.json +11 -11
  64. package/dist/lib/schemas-data/3.2/brand/update-rights-request.json +6 -6
  65. package/dist/lib/schemas-data/3.2/brand/update-rights-response.json +11 -11
  66. package/dist/lib/schemas-data/3.2/brand/verification-status.json +1 -1
  67. package/dist/lib/schemas-data/3.2/brand/verify-brand-claim-request.json +3 -3
  68. package/dist/lib/schemas-data/3.2/brand/verify-brand-claim-response.json +13 -13
  69. package/dist/lib/schemas-data/3.2/brand/verify-brand-claims-request.json +3 -3
  70. package/dist/lib/schemas-data/3.2/brand/verify-brand-claims-response.json +13 -13
  71. package/dist/lib/schemas-data/3.2/brand.json +23 -23
  72. package/dist/lib/schemas-data/3.2/bundled.schemas.br +0 -0
  73. package/dist/lib/schemas-data/3.2/collection/base-collection-source.json +3 -3
  74. package/dist/lib/schemas-data/3.2/collection/collection-list-changed-webhook.json +2 -2
  75. package/dist/lib/schemas-data/3.2/collection/collection-list-filters.json +7 -7
  76. package/dist/lib/schemas-data/3.2/collection/collection-list.json +5 -5
  77. package/dist/lib/schemas-data/3.2/collection/create-collection-list-request.json +8 -8
  78. package/dist/lib/schemas-data/3.2/collection/create-collection-list-response.json +6 -6
  79. package/dist/lib/schemas-data/3.2/collection/delete-collection-list-request.json +5 -5
  80. package/dist/lib/schemas-data/3.2/collection/delete-collection-list-response.json +5 -5
  81. package/dist/lib/schemas-data/3.2/collection/get-collection-list-request.json +5 -5
  82. package/dist/lib/schemas-data/3.2/collection/get-collection-list-response.json +12 -12
  83. package/dist/lib/schemas-data/3.2/collection/list-collection-lists-request.json +6 -6
  84. package/dist/lib/schemas-data/3.2/collection/list-collection-lists-response.json +7 -7
  85. package/dist/lib/schemas-data/3.2/collection/update-collection-list-request.json +8 -8
  86. package/dist/lib/schemas-data/3.2/collection/update-collection-list-response.json +6 -6
  87. package/dist/lib/schemas-data/3.2/content-standards/artifact-webhook-payload.json +3 -3
  88. package/dist/lib/schemas-data/3.2/content-standards/artifact.json +8 -8
  89. package/dist/lib/schemas-data/3.2/content-standards/calibrate-content-request.json +5 -5
  90. package/dist/lib/schemas-data/3.2/content-standards/calibrate-content-response.json +10 -10
  91. package/dist/lib/schemas-data/3.2/content-standards/content-standards.json +7 -7
  92. package/dist/lib/schemas-data/3.2/content-standards/create-content-standards-request.json +8 -8
  93. package/dist/lib/schemas-data/3.2/content-standards/create-content-standards-response.json +8 -8
  94. package/dist/lib/schemas-data/3.2/content-standards/get-content-standards-request.json +4 -4
  95. package/dist/lib/schemas-data/3.2/content-standards/get-content-standards-response.json +9 -9
  96. package/dist/lib/schemas-data/3.2/content-standards/get-media-buy-artifacts-request.json +5 -5
  97. package/dist/lib/schemas-data/3.2/content-standards/get-media-buy-artifacts-response.json +10 -10
  98. package/dist/lib/schemas-data/3.2/content-standards/list-content-standards-request.json +6 -6
  99. package/dist/lib/schemas-data/3.2/content-standards/list-content-standards-response.json +10 -10
  100. package/dist/lib/schemas-data/3.2/content-standards/update-content-standards-request.json +8 -8
  101. package/dist/lib/schemas-data/3.2/content-standards/update-content-standards-response.json +8 -8
  102. package/dist/lib/schemas-data/3.2/content-standards/validate-content-delivery-request.json +5 -5
  103. package/dist/lib/schemas-data/3.2/content-standards/validate-content-delivery-response.json +10 -10
  104. package/dist/lib/schemas-data/3.2/core/acceptance-policy-profile-ids.json +1 -1
  105. package/dist/lib/schemas-data/3.2/core/account-authorization.json +1 -1
  106. package/dist/lib/schemas-data/3.2/core/account-change-recorded-webhook.json +2 -2
  107. package/dist/lib/schemas-data/3.2/core/account-change.json +2 -2
  108. package/dist/lib/schemas-data/3.2/core/account-identity-change-preview.json +4 -4
  109. package/dist/lib/schemas-data/3.2/core/account-identity-change.json +3 -3
  110. package/dist/lib/schemas-data/3.2/core/account-ref.json +3 -3
  111. package/dist/lib/schemas-data/3.2/core/account-status-changed-webhook.json +4 -4
  112. package/dist/lib/schemas-data/3.2/core/account-timezone-capability.json +1 -1
  113. package/dist/lib/schemas-data/3.2/core/account-with-authorization.json +3 -3
  114. package/dist/lib/schemas-data/3.2/core/account.json +14 -14
  115. package/dist/lib/schemas-data/3.2/core/activation-key.json +1 -1
  116. package/dist/lib/schemas-data/3.2/core/ad-inventory-config.json +1 -1
  117. package/dist/lib/schemas-data/3.2/core/agent-encryption-key.json +1 -1
  118. package/dist/lib/schemas-data/3.2/core/agent-notification-config-state.json +4 -4
  119. package/dist/lib/schemas-data/3.2/core/agent-notification-config.json +4 -4
  120. package/dist/lib/schemas-data/3.2/core/agent-reporting-destination-state.json +4 -4
  121. package/dist/lib/schemas-data/3.2/core/agent-reporting-destination.json +8 -8
  122. package/dist/lib/schemas-data/3.2/core/agent-signing-key.json +1 -1
  123. package/dist/lib/schemas-data/3.2/core/agent-webhook-challenge.json +1 -1
  124. package/dist/lib/schemas-data/3.2/core/app-item.json +4 -4
  125. package/dist/lib/schemas-data/3.2/core/applicable-package-id.json +1 -1
  126. package/dist/lib/schemas-data/3.2/core/asset-group-vocabulary.json +1 -1
  127. package/dist/lib/schemas-data/3.2/core/assets/asset-union.json +22 -22
  128. package/dist/lib/schemas-data/3.2/core/assets/audio-asset.json +3 -3
  129. package/dist/lib/schemas-data/3.2/core/assets/brief-asset.json +2 -2
  130. package/dist/lib/schemas-data/3.2/core/assets/card-asset.json +6 -6
  131. package/dist/lib/schemas-data/3.2/core/assets/catalog-asset.json +2 -2
  132. package/dist/lib/schemas-data/3.2/core/assets/css-asset.json +2 -2
  133. package/dist/lib/schemas-data/3.2/core/assets/daast-asset.json +6 -6
  134. package/dist/lib/schemas-data/3.2/core/assets/daast-tracker-asset.json +5 -5
  135. package/dist/lib/schemas-data/3.2/core/assets/display-tag-asset.json +12 -12
  136. package/dist/lib/schemas-data/3.2/core/assets/html-asset.json +2 -2
  137. package/dist/lib/schemas-data/3.2/core/assets/image-asset.json +2 -2
  138. package/dist/lib/schemas-data/3.2/core/assets/javascript-asset.json +3 -3
  139. package/dist/lib/schemas-data/3.2/core/assets/markdown-asset.json +2 -2
  140. package/dist/lib/schemas-data/3.2/core/assets/pixel-tracker-asset.json +5 -5
  141. package/dist/lib/schemas-data/3.2/core/assets/published-post-asset.json +2 -2
  142. package/dist/lib/schemas-data/3.2/core/assets/text-asset.json +2 -2
  143. package/dist/lib/schemas-data/3.2/core/assets/url-asset.json +5 -5
  144. package/dist/lib/schemas-data/3.2/core/assets/vast-asset.json +6 -6
  145. package/dist/lib/schemas-data/3.2/core/assets/vast-tracker-asset.json +5 -5
  146. package/dist/lib/schemas-data/3.2/core/assets/video-asset.json +7 -7
  147. package/dist/lib/schemas-data/3.2/core/assets/webhook-asset.json +7 -7
  148. package/dist/lib/schemas-data/3.2/core/assets/zip-asset.json +2 -2
  149. package/dist/lib/schemas-data/3.2/core/async-response-data.json +43 -43
  150. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/get-creative-features-async-response-submitted.json +3 -3
  151. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-input-required.json +3 -3
  152. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-submitted.json +4 -4
  153. package/dist/lib/schemas-data/3.2/core/async-response-refs/creative/sync-creatives-async-response-working.json +3 -3
  154. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-input-required.json +2 -2
  155. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-submitted.json +2 -2
  156. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/accept-proposal-async-response-working.json +2 -2
  157. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-input-required.json +4 -4
  158. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-submitted.json +4 -4
  159. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/build-creative-async-response-working.json +3 -3
  160. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-input-required.json +2 -2
  161. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-submitted.json +2 -2
  162. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/buy-products-async-response-working.json +2 -2
  163. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-input-required.json +2 -2
  164. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-submitted.json +2 -2
  165. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/control-media-buy-async-response-working.json +2 -2
  166. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-input-required.json +4 -4
  167. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-submitted.json +4 -4
  168. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/create-media-buy-async-response-working.json +3 -3
  169. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-input-required.json +2 -2
  170. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-submitted.json +2 -2
  171. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/decline-proposals-async-response-working.json +2 -2
  172. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-input-required.json +4 -4
  173. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-submitted.json +4 -4
  174. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/get-products-async-response-working.json +3 -3
  175. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-input-required.json +2 -2
  176. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-submitted.json +2 -2
  177. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/refine-proposals-async-response-working.json +2 -2
  178. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-input-required.json +2 -2
  179. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-submitted.json +2 -2
  180. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/request-proposals-async-response-working.json +2 -2
  181. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-input-required.json +3 -3
  182. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-submitted.json +4 -4
  183. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/sync-catalogs-async-response-working.json +3 -3
  184. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-input-required.json +3 -3
  185. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-submitted.json +4 -4
  186. package/dist/lib/schemas-data/3.2/core/async-response-refs/media-buy/update-media-buy-async-response-working.json +3 -3
  187. package/dist/lib/schemas-data/3.2/core/async-response-refs/signals/get-signals-async-response-submitted.json +4 -4
  188. package/dist/lib/schemas-data/3.2/core/async-response-refs/signals/get-signals-async-response-working.json +3 -3
  189. package/dist/lib/schemas-data/3.2/core/attestation-capabilities.json +5 -5
  190. package/dist/lib/schemas-data/3.2/core/attestation-evaluation.json +2 -2
  191. package/dist/lib/schemas-data/3.2/core/attestation-issuer.json +5 -5
  192. package/dist/lib/schemas-data/3.2/core/attestation-reference.json +7 -7
  193. package/dist/lib/schemas-data/3.2/core/attestation-subject.json +5 -5
  194. package/dist/lib/schemas-data/3.2/core/attribution-window.json +4 -4
  195. package/dist/lib/schemas-data/3.2/core/audience-activation-method.json +6 -6
  196. package/dist/lib/schemas-data/3.2/core/audience-characteristic.json +1 -1
  197. package/dist/lib/schemas-data/3.2/core/audience-evidence-pin.json +2 -2
  198. package/dist/lib/schemas-data/3.2/core/audience-evidence-requirements.json +10 -10
  199. package/dist/lib/schemas-data/3.2/core/audience-evidence-selection.json +5 -5
  200. package/dist/lib/schemas-data/3.2/core/audience-evidence.json +10 -10
  201. package/dist/lib/schemas-data/3.2/core/audience-member.json +3 -3
  202. package/dist/lib/schemas-data/3.2/core/audience-selector.json +7 -7
  203. package/dist/lib/schemas-data/3.2/core/audience-source.json +3 -3
  204. package/dist/lib/schemas-data/3.2/core/authorized-agent-base.json +3 -3
  205. package/dist/lib/schemas-data/3.2/core/bidding-policy-capability.json +1 -1
  206. package/dist/lib/schemas-data/3.2/core/bidding-policy.json +1 -1
  207. package/dist/lib/schemas-data/3.2/core/brand-id.json +1 -1
  208. package/dist/lib/schemas-data/3.2/core/brand-key.json +2 -2
  209. package/dist/lib/schemas-data/3.2/core/brand-ref.json +3 -3
  210. package/dist/lib/schemas-data/3.2/core/brand-response-authorization-result.json +1 -1
  211. package/dist/lib/schemas-data/3.2/core/budget-allocation.json +2 -2
  212. package/dist/lib/schemas-data/3.2/core/budget-range.json +1 -1
  213. package/dist/lib/schemas-data/3.2/core/business-entity.json +2 -2
  214. package/dist/lib/schemas-data/3.2/core/cancellation-policy.json +2 -2
  215. package/dist/lib/schemas-data/3.2/core/canonical-account-ref.json +3 -3
  216. package/dist/lib/schemas-data/3.2/core/canonical-audience-evidence-selection.json +3 -3
  217. package/dist/lib/schemas-data/3.2/core/canonical-audience-evidence.json +8 -8
  218. package/dist/lib/schemas-data/3.2/core/canonical-budget-allocation.json +2 -2
  219. package/dist/lib/schemas-data/3.2/core/canonical-delivery-forecast.json +7 -7
  220. package/dist/lib/schemas-data/3.2/core/canonical-forecast-point.json +12 -12
  221. package/dist/lib/schemas-data/3.2/core/canonical-forecast-vendor-metric-value.json +5 -5
  222. package/dist/lib/schemas-data/3.2/core/canonical-format-kind.json +1 -1
  223. package/dist/lib/schemas-data/3.2/core/canonical-format-option.json +6 -6
  224. package/dist/lib/schemas-data/3.2/core/canonical-measurement-terms.json +3 -3
  225. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-action-fields.json +6 -6
  226. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-action.json +4 -4
  227. package/dist/lib/schemas-data/3.2/core/canonical-media-buy-features.json +2 -2
  228. package/dist/lib/schemas-data/3.2/core/canonical-metric-qualifier.json +6 -6
  229. package/dist/lib/schemas-data/3.2/core/canonical-optimization-goal.json +9 -9
  230. package/dist/lib/schemas-data/3.2/core/canonical-performance-standard.json +4 -4
  231. package/dist/lib/schemas-data/3.2/core/canonical-placement.json +9 -9
  232. package/dist/lib/schemas-data/3.2/core/canonical-pricing-option.json +5 -5
  233. package/dist/lib/schemas-data/3.2/core/canonical-product-action.json +6 -6
  234. package/dist/lib/schemas-data/3.2/core/canonical-product.json +141 -32
  235. package/dist/lib/schemas-data/3.2/core/canonical-projection-ref.json +3 -3
  236. package/dist/lib/schemas-data/3.2/core/canonical-projection-slot-override.json +1 -1
  237. package/dist/lib/schemas-data/3.2/core/canonical-proposal.json +6 -6
  238. package/dist/lib/schemas-data/3.2/core/canonical-reporting-capabilities.json +11 -11
  239. package/dist/lib/schemas-data/3.2/core/canonical-reporting-commitment.json +6 -6
  240. package/dist/lib/schemas-data/3.2/core/canvas-constraint.json +1 -1
  241. package/dist/lib/schemas-data/3.2/core/capabilities-changed-webhook.json +2 -2
  242. package/dist/lib/schemas-data/3.2/core/catalog-field-mapping.json +2 -2
  243. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-error.json +3 -3
  244. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-ref.json +1 -1
  245. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-state.json +4 -4
  246. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-update-result.json +4 -4
  247. package/dist/lib/schemas-data/3.2/core/catalog-item-availability-update.json +2 -2
  248. package/dist/lib/schemas-data/3.2/core/catalog-item-delivery-metrics.json +3 -3
  249. package/dist/lib/schemas-data/3.2/core/catalog-item-reference-not-found-error.json +1 -1
  250. package/dist/lib/schemas-data/3.2/core/catalog-selection.json +7 -7
  251. package/dist/lib/schemas-data/3.2/core/catalog.json +7 -7
  252. package/dist/lib/schemas-data/3.2/core/catchment.json +5 -5
  253. package/dist/lib/schemas-data/3.2/core/collection-delivery-metrics.json +3 -3
  254. package/dist/lib/schemas-data/3.2/core/collection-distribution.json +3 -3
  255. package/dist/lib/schemas-data/3.2/core/collection-list-ref.json +1 -1
  256. package/dist/lib/schemas-data/3.2/core/collection-property-delivery-metrics.json +5 -5
  257. package/dist/lib/schemas-data/3.2/core/collection-ref.json +1 -1
  258. package/dist/lib/schemas-data/3.2/core/collection-selection.json +4 -4
  259. package/dist/lib/schemas-data/3.2/core/collection-selector.json +1 -1
  260. package/dist/lib/schemas-data/3.2/core/collection.json +13 -13
  261. package/dist/lib/schemas-data/3.2/core/committed-metric.json +14 -14
  262. package/dist/lib/schemas-data/3.2/core/compact-task-input-required.json +4 -4
  263. package/dist/lib/schemas-data/3.2/core/compact-task-submitted.json +6 -6
  264. package/dist/lib/schemas-data/3.2/core/compact-task-working.json +3 -3
  265. package/dist/lib/schemas-data/3.2/core/content-rating.json +2 -2
  266. package/dist/lib/schemas-data/3.2/core/context.json +1 -1
  267. package/dist/lib/schemas-data/3.2/core/creative-approval-scope.json +3 -3
  268. package/dist/lib/schemas-data/3.2/core/creative-asset.json +13 -13
  269. package/dist/lib/schemas-data/3.2/core/creative-assets.json +3 -3
  270. package/dist/lib/schemas-data/3.2/core/creative-assignment.json +2 -2
  271. package/dist/lib/schemas-data/3.2/core/creative-brief.json +4 -4
  272. package/dist/lib/schemas-data/3.2/core/creative-consumption.json +1 -1
  273. package/dist/lib/schemas-data/3.2/core/creative-delivery-metrics.json +2 -2
  274. package/dist/lib/schemas-data/3.2/core/creative-filters.json +8 -8
  275. package/dist/lib/schemas-data/3.2/core/creative-item.json +1 -1
  276. package/dist/lib/schemas-data/3.2/core/creative-locale-policy.json +2 -2
  277. package/dist/lib/schemas-data/3.2/core/creative-localization-readback.json +6 -6
  278. package/dist/lib/schemas-data/3.2/core/creative-localization.json +6 -6
  279. package/dist/lib/schemas-data/3.2/core/creative-manifest.json +13 -13
  280. package/dist/lib/schemas-data/3.2/core/creative-operation-format-declaration.json +7 -7
  281. package/dist/lib/schemas-data/3.2/core/creative-policy.json +3 -3
  282. package/dist/lib/schemas-data/3.2/core/creative-representation-set.json +4 -4
  283. package/dist/lib/schemas-data/3.2/core/creative-representation.json +2 -2
  284. package/dist/lib/schemas-data/3.2/core/creative-revision-id.json +1 -1
  285. package/dist/lib/schemas-data/3.2/core/creative-variable.json +1 -1
  286. package/dist/lib/schemas-data/3.2/core/creative-variant.json +6 -6
  287. package/dist/lib/schemas-data/3.2/core/daast-tracker-constraints.json +2 -2
  288. package/dist/lib/schemas-data/3.2/core/data-provider-signal-selector.json +1 -1
  289. package/dist/lib/schemas-data/3.2/core/date-range.json +1 -1
  290. package/dist/lib/schemas-data/3.2/core/datetime-range.json +1 -1
  291. package/dist/lib/schemas-data/3.2/core/daypart-target.json +3 -3
  292. package/dist/lib/schemas-data/3.2/core/deadline-policy.json +1 -1
  293. package/dist/lib/schemas-data/3.2/core/delivery-breakdown-controls.json +3 -3
  294. package/dist/lib/schemas-data/3.2/core/delivery-forecast.json +7 -7
  295. package/dist/lib/schemas-data/3.2/core/delivery-metric-aggregate.json +14 -14
  296. package/dist/lib/schemas-data/3.2/core/delivery-metrics.json +11 -11
  297. package/dist/lib/schemas-data/3.2/core/delivery-provider.json +1 -1
  298. package/dist/lib/schemas-data/3.2/core/delivery-recipient.json +2 -2
  299. package/dist/lib/schemas-data/3.2/core/demographic-age-range.json +1 -1
  300. package/dist/lib/schemas-data/3.2/core/demographic-predicate.json +2 -2
  301. package/dist/lib/schemas-data/3.2/core/demographic-reporting-capability.json +4 -4
  302. package/dist/lib/schemas-data/3.2/core/demographic-targeting-capability.json +4 -4
  303. package/dist/lib/schemas-data/3.2/core/demographic-targeting-intent.json +4 -4
  304. package/dist/lib/schemas-data/3.2/core/demographic-targeting-resolution.json +10 -10
  305. package/dist/lib/schemas-data/3.2/core/deployment.json +3 -3
  306. package/dist/lib/schemas-data/3.2/core/destination-item.json +4 -4
  307. package/dist/lib/schemas-data/3.2/core/destination.json +1 -1
  308. package/dist/lib/schemas-data/3.2/core/diagnostic-issue.json +1 -1
  309. package/dist/lib/schemas-data/3.2/core/downstream-connection-requirement.json +1 -1
  310. package/dist/lib/schemas-data/3.2/core/duration.json +1 -1
  311. package/dist/lib/schemas-data/3.2/core/education-item.json +4 -4
  312. package/dist/lib/schemas-data/3.2/core/error.json +1 -1
  313. package/dist/lib/schemas-data/3.2/core/evaluator-spec.json +5 -5
  314. package/dist/lib/schemas-data/3.2/core/event-custom-data.json +2 -2
  315. package/dist/lib/schemas-data/3.2/core/event-source-health.json +3 -3
  316. package/dist/lib/schemas-data/3.2/core/event-surface.json +2 -2
  317. package/dist/lib/schemas-data/3.2/core/event.json +8 -8
  318. package/dist/lib/schemas-data/3.2/core/experimental-feature-id.json +1 -1
  319. package/dist/lib/schemas-data/3.2/core/ext.json +1 -1
  320. package/dist/lib/schemas-data/3.2/core/feature-requirement.json +1 -1
  321. package/dist/lib/schemas-data/3.2/core/flight-item.json +4 -4
  322. package/dist/lib/schemas-data/3.2/core/forecast-dimension-audience.json +2 -2
  323. package/dist/lib/schemas-data/3.2/core/forecast-dimension-device-platform.json +2 -2
  324. package/dist/lib/schemas-data/3.2/core/forecast-dimension-device-type.json +2 -2
  325. package/dist/lib/schemas-data/3.2/core/forecast-dimension-geo.json +5 -5
  326. package/dist/lib/schemas-data/3.2/core/forecast-dimension-placement.json +2 -2
  327. package/dist/lib/schemas-data/3.2/core/forecast-dimension-signal.json +2 -2
  328. package/dist/lib/schemas-data/3.2/core/forecast-dimension-time.json +1 -1
  329. package/dist/lib/schemas-data/3.2/core/forecast-point-dimensions.json +8 -8
  330. package/dist/lib/schemas-data/3.2/core/forecast-point.json +28 -28
  331. package/dist/lib/schemas-data/3.2/core/forecast-range.json +1 -1
  332. package/dist/lib/schemas-data/3.2/core/forecast-rate-range.json +2 -2
  333. package/dist/lib/schemas-data/3.2/core/forecast-vendor-metric-value.json +7 -7
  334. package/dist/lib/schemas-data/3.2/core/format-id.json +1 -1
  335. package/dist/lib/schemas-data/3.2/core/format-option-ref.json +1 -1
  336. package/dist/lib/schemas-data/3.2/core/format-shape-vocabulary.json +1 -1
  337. package/dist/lib/schemas-data/3.2/core/format.json +45 -45
  338. package/dist/lib/schemas-data/3.2/core/frequency-cap-constraints.json +8 -8
  339. package/dist/lib/schemas-data/3.2/core/frequency-cap-duration-unit.json +1 -1
  340. package/dist/lib/schemas-data/3.2/core/frequency-cap-impression-constraints.json +2 -2
  341. package/dist/lib/schemas-data/3.2/core/frequency-cap-interval-constraints.json +3 -3
  342. package/dist/lib/schemas-data/3.2/core/frequency-cap-requirements.json +6 -6
  343. package/dist/lib/schemas-data/3.2/core/frequency-cap.json +4 -4
  344. package/dist/lib/schemas-data/3.2/core/generation-credential.json +3 -3
  345. package/dist/lib/schemas-data/3.2/core/geo-breakdown-support.json +3 -3
  346. package/dist/lib/schemas-data/3.2/core/geo-delivery-metrics.json +6 -6
  347. package/dist/lib/schemas-data/3.2/core/geo-metro.json +2 -2
  348. package/dist/lib/schemas-data/3.2/core/geo-place-area.json +4 -4
  349. package/dist/lib/schemas-data/3.2/core/geo-place-catalog-capability.json +2 -2
  350. package/dist/lib/schemas-data/3.2/core/geo-place-catalog-entry.json +3 -3
  351. package/dist/lib/schemas-data/3.2/core/geo-place-requirement.json +3 -3
  352. package/dist/lib/schemas-data/3.2/core/geo-place-resolver.json +1 -1
  353. package/dist/lib/schemas-data/3.2/core/geo-place-support.json +3 -3
  354. package/dist/lib/schemas-data/3.2/core/geo-place-system.json +1 -1
  355. package/dist/lib/schemas-data/3.2/core/geo-place-type.json +1 -1
  356. package/dist/lib/schemas-data/3.2/core/geo-region-requirement.json +1 -1
  357. package/dist/lib/schemas-data/3.2/core/geo-region-support.json +2 -2
  358. package/dist/lib/schemas-data/3.2/core/get-geo-place-resolution-request.json +3 -3
  359. package/dist/lib/schemas-data/3.2/core/get-geo-place-resolution-response.json +4 -4
  360. package/dist/lib/schemas-data/3.2/core/hotel-item.json +4 -4
  361. package/dist/lib/schemas-data/3.2/core/iana-timezone.json +1 -1
  362. package/dist/lib/schemas-data/3.2/core/identifier.json +2 -2
  363. package/dist/lib/schemas-data/3.2/core/impairment.json +3 -3
  364. package/dist/lib/schemas-data/3.2/core/indicator-bearing.json +4 -4
  365. package/dist/lib/schemas-data/3.2/core/indicator-scope.json +1 -1
  366. package/dist/lib/schemas-data/3.2/core/indicator.json +4 -4
  367. package/dist/lib/schemas-data/3.2/core/indicators-changed-webhook.json +3 -3
  368. package/dist/lib/schemas-data/3.2/core/industry-identifier.json +2 -2
  369. package/dist/lib/schemas-data/3.2/core/insertion-order.json +1 -1
  370. package/dist/lib/schemas-data/3.2/core/installment-deadlines.json +2 -2
  371. package/dist/lib/schemas-data/3.2/core/installment-delivery-metrics.json +3 -3
  372. package/dist/lib/schemas-data/3.2/core/installment-property-delivery-metrics.json +5 -5
  373. package/dist/lib/schemas-data/3.2/core/installment-ref.json +2 -2
  374. package/dist/lib/schemas-data/3.2/core/installment.json +10 -10
  375. package/dist/lib/schemas-data/3.2/core/inventory-list-application.json +1 -1
  376. package/dist/lib/schemas-data/3.2/core/job-item.json +3 -3
  377. package/dist/lib/schemas-data/3.2/core/keyword-delivery-metrics.json +3 -3
  378. package/dist/lib/schemas-data/3.2/core/keyword-target.json +2 -2
  379. package/dist/lib/schemas-data/3.2/core/limited-series.json +1 -1
  380. package/dist/lib/schemas-data/3.2/core/locale-tag.json +1 -1
  381. package/dist/lib/schemas-data/3.2/core/localized-creative-asset.json +3 -3
  382. package/dist/lib/schemas-data/3.2/core/macro-bearing-url.json +1 -1
  383. package/dist/lib/schemas-data/3.2/core/macro-declaration.json +10 -10
  384. package/dist/lib/schemas-data/3.2/core/macro-encoding.json +1 -1
  385. package/dist/lib/schemas-data/3.2/core/macro-resolution-capability.json +8 -8
  386. package/dist/lib/schemas-data/3.2/core/macro-resolution-result.json +10 -10
  387. package/dist/lib/schemas-data/3.2/core/macro-translation-target.json +7 -7
  388. package/dist/lib/schemas-data/3.2/core/material-deadline.json +1 -1
  389. package/dist/lib/schemas-data/3.2/core/mcp-webhook-payload.json +6 -6
  390. package/dist/lib/schemas-data/3.2/core/measurement-readiness.json +5 -5
  391. package/dist/lib/schemas-data/3.2/core/measurement-terms.json +3 -3
  392. package/dist/lib/schemas-data/3.2/core/measurement-window.json +1 -1
  393. package/dist/lib/schemas-data/3.2/core/media-buy-available-action-id.json +2 -2
  394. package/dist/lib/schemas-data/3.2/core/media-buy-available-action.json +7 -7
  395. package/dist/lib/schemas-data/3.2/core/media-buy-change-term-id.json +1 -1
  396. package/dist/lib/schemas-data/3.2/core/media-buy-features.json +2 -2
  397. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-capability.json +3 -3
  398. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-requirement.json +3 -3
  399. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap-support.json +3 -3
  400. package/dist/lib/schemas-data/3.2/core/media-buy-frequency-cap.json +2 -2
  401. package/dist/lib/schemas-data/3.2/core/media-buy-legacy-terms-ref.json +1 -1
  402. package/dist/lib/schemas-data/3.2/core/media-buy-support-requirements.json +2 -2
  403. package/dist/lib/schemas-data/3.2/core/media-buy-support.json +3 -3
  404. package/dist/lib/schemas-data/3.2/core/media-buy.json +14 -14
  405. package/dist/lib/schemas-data/3.2/core/missing-metric.json +14 -14
  406. package/dist/lib/schemas-data/3.2/core/negative-keyword.json +2 -2
  407. package/dist/lib/schemas-data/3.2/core/notification-config.json +3 -3
  408. package/dist/lib/schemas-data/3.2/core/offering-asset-group.json +16 -16
  409. package/dist/lib/schemas-data/3.2/core/offering.json +5 -5
  410. package/dist/lib/schemas-data/3.2/core/operator-identity.json +2 -2
  411. package/dist/lib/schemas-data/3.2/core/operator-unit.json +1 -1
  412. package/dist/lib/schemas-data/3.2/core/opportunity-context.json +3 -3
  413. package/dist/lib/schemas-data/3.2/core/optimization-goal.json +9 -9
  414. package/dist/lib/schemas-data/3.2/core/outcome-measurement.json +2 -2
  415. package/dist/lib/schemas-data/3.2/core/outcome-target-cost-per.json +2 -2
  416. package/dist/lib/schemas-data/3.2/core/overlay.json +1 -1
  417. package/dist/lib/schemas-data/3.2/core/package-delivery-metric-value.json +2 -2
  418. package/dist/lib/schemas-data/3.2/core/package-format-snapshot.json +5 -5
  419. package/dist/lib/schemas-data/3.2/core/package-signal-targeting-group.json +2 -2
  420. package/dist/lib/schemas-data/3.2/core/package-signal-targeting-groups.json +2 -2
  421. package/dist/lib/schemas-data/3.2/core/package-signal-targeting.json +3 -3
  422. package/dist/lib/schemas-data/3.2/core/package-targeting-resolution.json +3 -3
  423. package/dist/lib/schemas-data/3.2/core/package.json +23 -23
  424. package/dist/lib/schemas-data/3.2/core/pagination-request.json +1 -1
  425. package/dist/lib/schemas-data/3.2/core/pagination-response.json +1 -1
  426. package/dist/lib/schemas-data/3.2/core/performance-feedback-assertion.json +8 -8
  427. package/dist/lib/schemas-data/3.2/core/performance-feedback-metric.json +14 -14
  428. package/dist/lib/schemas-data/3.2/core/performance-feedback.json +17 -17
  429. package/dist/lib/schemas-data/3.2/core/performance-standard.json +4 -4
  430. package/dist/lib/schemas-data/3.2/core/placement-definition.json +15 -15
  431. package/dist/lib/schemas-data/3.2/core/placement-delivery-metrics.json +3 -3
  432. package/dist/lib/schemas-data/3.2/core/placement-evidence.json +1 -1
  433. package/dist/lib/schemas-data/3.2/core/placement-identity.json +2 -2
  434. package/dist/lib/schemas-data/3.2/core/placement-presentation.json +1 -1
  435. package/dist/lib/schemas-data/3.2/core/placement-property-delivery-metrics.json +5 -5
  436. package/dist/lib/schemas-data/3.2/core/placement-ref.json +1 -1
  437. package/dist/lib/schemas-data/3.2/core/placement-selection.json +5 -5
  438. package/dist/lib/schemas-data/3.2/core/placement.json +10 -10
  439. package/dist/lib/schemas-data/3.2/core/planned-delivery.json +8 -8
  440. package/dist/lib/schemas-data/3.2/core/platform-extension-ref.json +1 -1
  441. package/dist/lib/schemas-data/3.2/core/positive-postal-area-support.json +2 -2
  442. package/dist/lib/schemas-data/3.2/core/postal-area-support.json +2 -2
  443. package/dist/lib/schemas-data/3.2/core/postal-area.json +4 -4
  444. package/dist/lib/schemas-data/3.2/core/postal-country-system.json +2 -2
  445. package/dist/lib/schemas-data/3.2/core/presentation-ref.json +1 -1
  446. package/dist/lib/schemas-data/3.2/core/preview-provider.json +1 -1
  447. package/dist/lib/schemas-data/3.2/core/preview-renderer-metadata.json +1 -1
  448. package/dist/lib/schemas-data/3.2/core/price.json +1 -1
  449. package/dist/lib/schemas-data/3.2/core/pricing-option.json +11 -11
  450. package/dist/lib/schemas-data/3.2/core/principal-changed-webhook.json +2 -2
  451. package/dist/lib/schemas-data/3.2/core/principal-declarations-state.json +3 -3
  452. package/dist/lib/schemas-data/3.2/core/principal-declarations.json +2 -2
  453. package/dist/lib/schemas-data/3.2/core/principal-state.json +4 -4
  454. package/dist/lib/schemas-data/3.2/core/product-allocation.json +5 -5
  455. package/dist/lib/schemas-data/3.2/core/product-allowed-action.json +6 -6
  456. package/dist/lib/schemas-data/3.2/core/product-audience-evidence-requirements.json +13 -13
  457. package/dist/lib/schemas-data/3.2/core/product-card-reference-asset.json +5 -5
  458. package/dist/lib/schemas-data/3.2/core/product-change-map.json +1 -1
  459. package/dist/lib/schemas-data/3.2/core/product-execution-requirement.json +7 -7
  460. package/dist/lib/schemas-data/3.2/core/product-filters.json +36 -36
  461. package/dist/lib/schemas-data/3.2/core/product-format-declaration.json +22 -22
  462. package/dist/lib/schemas-data/3.2/core/product-identity.json +1 -1
  463. package/dist/lib/schemas-data/3.2/core/product-offer-filters.json +26 -26
  464. package/dist/lib/schemas-data/3.2/core/product-signal-targeting-option.json +3 -3
  465. package/dist/lib/schemas-data/3.2/core/product-targeting-resolution.json +3 -3
  466. package/dist/lib/schemas-data/3.2/core/product.json +54 -54
  467. package/dist/lib/schemas-data/3.2/core/property-delivery-metrics.json +4 -4
  468. package/dist/lib/schemas-data/3.2/core/property-id.json +1 -1
  469. package/dist/lib/schemas-data/3.2/core/property-list-ref.json +1 -1
  470. package/dist/lib/schemas-data/3.2/core/property-ref.json +2 -2
  471. package/dist/lib/schemas-data/3.2/core/property-tag.json +1 -1
  472. package/dist/lib/schemas-data/3.2/core/property.json +6 -6
  473. package/dist/lib/schemas-data/3.2/core/proposal.json +9 -9
  474. package/dist/lib/schemas-data/3.2/core/protocol-envelope.json +5 -5
  475. package/dist/lib/schemas-data/3.2/core/provenance.json +9 -9
  476. package/dist/lib/schemas-data/3.2/core/publisher-property-selector.json +3 -3
  477. package/dist/lib/schemas-data/3.2/core/push-notification-config.json +2 -2
  478. package/dist/lib/schemas-data/3.2/core/real-estate-item.json +4 -4
  479. package/dist/lib/schemas-data/3.2/core/reference-asset.json +1 -1
  480. package/dist/lib/schemas-data/3.2/core/reference-renderer.json +1 -1
  481. package/dist/lib/schemas-data/3.2/core/registry-event.json +15 -15
  482. package/dist/lib/schemas-data/3.2/core/registry-feed-response.json +2 -2
  483. package/dist/lib/schemas-data/3.2/core/reporting-adjustment-receipt.json +1 -1
  484. package/dist/lib/schemas-data/3.2/core/reporting-adjustment.json +2 -2
  485. package/dist/lib/schemas-data/3.2/core/reporting-canonical-content-digest.json +1 -1
  486. package/dist/lib/schemas-data/3.2/core/reporting-canonicalization-contract.json +1 -1
  487. package/dist/lib/schemas-data/3.2/core/reporting-capabilities.json +12 -12
  488. package/dist/lib/schemas-data/3.2/core/reporting-consumer-status.json +1 -1
  489. package/dist/lib/schemas-data/3.2/core/reporting-control-total.json +1 -1
  490. package/dist/lib/schemas-data/3.2/core/reporting-coverage.json +1 -1
  491. package/dist/lib/schemas-data/3.2/core/reporting-dataset-share-destination.json +1 -1
  492. package/dist/lib/schemas-data/3.2/core/reporting-delivery-capabilities.json +3 -3
  493. package/dist/lib/schemas-data/3.2/core/reporting-delivery-config-state.json +4 -4
  494. package/dist/lib/schemas-data/3.2/core/reporting-delivery-config.json +7 -7
  495. package/dist/lib/schemas-data/3.2/core/reporting-delivery-method.json +4 -4
  496. package/dist/lib/schemas-data/3.2/core/reporting-delivery-offering-id.json +1 -1
  497. package/dist/lib/schemas-data/3.2/core/reporting-delivery-offering.json +8 -8
  498. package/dist/lib/schemas-data/3.2/core/reporting-delivery-ready-webhook.json +3 -3
  499. package/dist/lib/schemas-data/3.2/core/reporting-file-compression.json +1 -1
  500. package/dist/lib/schemas-data/3.2/core/reporting-file-entry.json +3 -3
  501. package/dist/lib/schemas-data/3.2/core/reporting-file-manifest.json +4 -4
  502. package/dist/lib/schemas-data/3.2/core/reporting-file-object-ref.json +1 -1
  503. package/dist/lib/schemas-data/3.2/core/reporting-ledger-changed-webhook.json +3 -3
  504. package/dist/lib/schemas-data/3.2/core/reporting-materialization.json +4 -4
  505. package/dist/lib/schemas-data/3.2/core/reporting-native-version-ref.json +1 -1
  506. package/dist/lib/schemas-data/3.2/core/reporting-obligation.json +9 -9
  507. package/dist/lib/schemas-data/3.2/core/reporting-receipt.json +5 -5
  508. package/dist/lib/schemas-data/3.2/core/reporting-reconciliation-mode.json +1 -1
  509. package/dist/lib/schemas-data/3.2/core/reporting-reliability-statistics.json +1 -1
  510. package/dist/lib/schemas-data/3.2/core/reporting-report-definition.json +1 -1
  511. package/dist/lib/schemas-data/3.2/core/reporting-resource.json +2 -2
  512. package/dist/lib/schemas-data/3.2/core/reporting-revision.json +6 -6
  513. package/dist/lib/schemas-data/3.2/core/reporting-schedule-offering.json +2 -2
  514. package/dist/lib/schemas-data/3.2/core/reporting-schedule.json +1 -1
  515. package/dist/lib/schemas-data/3.2/core/reporting-status-changed-webhook.json +5 -5
  516. package/dist/lib/schemas-data/3.2/core/reporting-status-issue.json +4 -4
  517. package/dist/lib/schemas-data/3.2/core/reporting-verification-profile-set.json +1 -1
  518. package/dist/lib/schemas-data/3.2/core/reporting-verification-profile.json +1 -1
  519. package/dist/lib/schemas-data/3.2/core/reporting-verification.json +7 -7
  520. package/dist/lib/schemas-data/3.2/core/reporting-webhook.json +3 -3
  521. package/dist/lib/schemas-data/3.2/core/reporting-write-destination.json +1 -1
  522. package/dist/lib/schemas-data/3.2/core/representation-destination.json +5 -5
  523. package/dist/lib/schemas-data/3.2/core/representation-rejection.json +1 -1
  524. package/dist/lib/schemas-data/3.2/core/representation-selection.json +5 -5
  525. package/dist/lib/schemas-data/3.2/core/requirements/asset-requirements.json +13 -13
  526. package/dist/lib/schemas-data/3.2/core/requirements/audio-asset-requirements.json +1 -1
  527. package/dist/lib/schemas-data/3.2/core/requirements/catalog-field-binding.json +4 -4
  528. package/dist/lib/schemas-data/3.2/core/requirements/catalog-requirements.json +5 -5
  529. package/dist/lib/schemas-data/3.2/core/requirements/css-asset-requirements.json +1 -1
  530. package/dist/lib/schemas-data/3.2/core/requirements/daast-asset-requirements.json +3 -3
  531. package/dist/lib/schemas-data/3.2/core/requirements/html-asset-requirements.json +1 -1
  532. package/dist/lib/schemas-data/3.2/core/requirements/image-asset-requirements.json +2 -2
  533. package/dist/lib/schemas-data/3.2/core/requirements/javascript-asset-requirements.json +1 -1
  534. package/dist/lib/schemas-data/3.2/core/requirements/markdown-asset-requirements.json +1 -1
  535. package/dist/lib/schemas-data/3.2/core/requirements/offering-asset-constraint.json +4 -4
  536. package/dist/lib/schemas-data/3.2/core/requirements/text-asset-requirements.json +1 -1
  537. package/dist/lib/schemas-data/3.2/core/requirements/url-asset-requirements.json +1 -1
  538. package/dist/lib/schemas-data/3.2/core/requirements/vast-asset-requirements.json +4 -4
  539. package/dist/lib/schemas-data/3.2/core/requirements/video-asset-requirements.json +6 -6
  540. package/dist/lib/schemas-data/3.2/core/requirements/webhook-asset-requirements.json +1 -1
  541. package/dist/lib/schemas-data/3.2/core/response-payload-jws-envelope.json +1 -1
  542. package/dist/lib/schemas-data/3.2/core/response.json +1 -1
  543. package/dist/lib/schemas-data/3.2/core/rights-attestation-evaluation.json +5 -5
  544. package/dist/lib/schemas-data/3.2/core/rights-constraint.json +7 -7
  545. package/dist/lib/schemas-data/3.2/core/seller-agent-ref.json +1 -1
  546. package/dist/lib/schemas-data/3.2/core/signal-coverage-forecast.json +5 -5
  547. package/dist/lib/schemas-data/3.2/core/signal-definition-enrichment.json +5 -5
  548. package/dist/lib/schemas-data/3.2/core/signal-definition.json +8 -8
  549. package/dist/lib/schemas-data/3.2/core/signal-filters.json +3 -3
  550. package/dist/lib/schemas-data/3.2/core/signal-id.json +1 -1
  551. package/dist/lib/schemas-data/3.2/core/signal-listing.json +6 -6
  552. package/dist/lib/schemas-data/3.2/core/signal-modeling-disclosure.json +1 -1
  553. package/dist/lib/schemas-data/3.2/core/signal-pricing-option.json +2 -2
  554. package/dist/lib/schemas-data/3.2/core/signal-pricing.json +6 -6
  555. package/dist/lib/schemas-data/3.2/core/signal-ref.json +1 -1
  556. package/dist/lib/schemas-data/3.2/core/signal-selection-group-rule.json +1 -1
  557. package/dist/lib/schemas-data/3.2/core/signal-targeting-expression.json +4 -4
  558. package/dist/lib/schemas-data/3.2/core/signal-targeting-rules.json +2 -2
  559. package/dist/lib/schemas-data/3.2/core/signal-targeting.json +7 -7
  560. package/dist/lib/schemas-data/3.2/core/sla-window.json +1 -1
  561. package/dist/lib/schemas-data/3.2/core/special.json +2 -2
  562. package/dist/lib/schemas-data/3.2/core/spot-reporting-capability.json +2 -2
  563. package/dist/lib/schemas-data/3.2/core/start-timing.json +1 -1
  564. package/dist/lib/schemas-data/3.2/core/store-item.json +3 -3
  565. package/dist/lib/schemas-data/3.2/core/talent.json +2 -2
  566. package/dist/lib/schemas-data/3.2/core/targeting-input.json +40 -40
  567. package/dist/lib/schemas-data/3.2/core/targeting-modification.json +3 -3
  568. package/dist/lib/schemas-data/3.2/core/targeting-overlay-requirements.json +15 -15
  569. package/dist/lib/schemas-data/3.2/core/targeting-overlay-support.json +25 -25
  570. package/dist/lib/schemas-data/3.2/core/targeting-unknown-age-eligibility-constraint.json +1 -1
  571. package/dist/lib/schemas-data/3.2/core/targeting-verified-age-basis-constraint.json +1 -1
  572. package/dist/lib/schemas-data/3.2/core/targeting.json +34 -34
  573. package/dist/lib/schemas-data/3.2/core/tasks-get-request.json +5 -5
  574. package/dist/lib/schemas-data/3.2/core/tasks-get-response.json +10 -10
  575. package/dist/lib/schemas-data/3.2/core/tasks-list-request.json +13 -13
  576. package/dist/lib/schemas-data/3.2/core/tasks-list-response.json +8 -8
  577. package/dist/lib/schemas-data/3.2/core/tracker-execution-contract.json +2 -2
  578. package/dist/lib/schemas-data/3.2/core/tracker-execution-selector.json +18 -18
  579. package/dist/lib/schemas-data/3.2/core/transformer-param.json +1 -1
  580. package/dist/lib/schemas-data/3.2/core/transformer.json +6 -6
  581. package/dist/lib/schemas-data/3.2/core/truncation-sentinel.json +1 -1
  582. package/dist/lib/schemas-data/3.2/core/user-match.json +3 -3
  583. package/dist/lib/schemas-data/3.2/core/vast-media-file-requirements.json +2 -2
  584. package/dist/lib/schemas-data/3.2/core/vast-tracker-constraints.json +2 -2
  585. package/dist/lib/schemas-data/3.2/core/vehicle-item.json +4 -4
  586. package/dist/lib/schemas-data/3.2/core/vendor-metric-id.json +1 -1
  587. package/dist/lib/schemas-data/3.2/core/vendor-metric-optimization-supported-metric.json +3 -3
  588. package/dist/lib/schemas-data/3.2/core/vendor-metric-optimization.json +2 -2
  589. package/dist/lib/schemas-data/3.2/core/vendor-metric-value.json +9 -9
  590. package/dist/lib/schemas-data/3.2/core/vendor-pricing-option.json +3 -3
  591. package/dist/lib/schemas-data/3.2/core/verification-token-claims.json +1 -1
  592. package/dist/lib/schemas-data/3.2/core/version-envelope.json +1 -1
  593. package/dist/lib/schemas-data/3.2/core/warning-resource.json +1 -1
  594. package/dist/lib/schemas-data/3.2/core/warning.json +4 -4
  595. package/dist/lib/schemas-data/3.2/core/webhook-activity-record.json +3 -3
  596. package/dist/lib/schemas-data/3.2/core/webhook-challenge-response.json +1 -1
  597. package/dist/lib/schemas-data/3.2/core/webhook-challenge.json +2 -2
  598. package/dist/lib/schemas-data/3.2/core/wholesale-feed-event.json +20 -20
  599. package/dist/lib/schemas-data/3.2/core/wholesale-feed-webhook.json +3 -3
  600. package/dist/lib/schemas-data/3.2/core/x-entity-types.json +1 -1
  601. package/dist/lib/schemas-data/3.2/creative/asset-types/index.json +6 -6
  602. package/dist/lib/schemas-data/3.2/creative/audit-observation.json +2 -2
  603. package/dist/lib/schemas-data/3.2/creative/creative-assignment-changed-webhook.json +2 -2
  604. package/dist/lib/schemas-data/3.2/creative/creative-feature-result.json +2 -2
  605. package/dist/lib/schemas-data/3.2/creative/creative-purged-webhook.json +3 -3
  606. package/dist/lib/schemas-data/3.2/creative/creative-status-changed-webhook.json +5 -5
  607. package/dist/lib/schemas-data/3.2/creative/get-creative-delivery-request.json +6 -6
  608. package/dist/lib/schemas-data/3.2/creative/get-creative-delivery-response.json +11 -11
  609. package/dist/lib/schemas-data/3.2/creative/get-creative-features-async-response-submitted.json +3 -3
  610. package/dist/lib/schemas-data/3.2/creative/get-creative-features-request.json +7 -7
  611. package/dist/lib/schemas-data/3.2/creative/get-creative-features-response.json +9 -9
  612. package/dist/lib/schemas-data/3.2/creative/get-creative-features-terminal-success.json +6 -6
  613. package/dist/lib/schemas-data/3.2/creative/list-creative-formats-request.json +13 -13
  614. package/dist/lib/schemas-data/3.2/creative/list-creative-formats-response.json +9 -9
  615. package/dist/lib/schemas-data/3.2/creative/list-creatives-request.json +9 -9
  616. package/dist/lib/schemas-data/3.2/creative/list-creatives-response.json +34 -34
  617. package/dist/lib/schemas-data/3.2/creative/list-transformers-request.json +9 -9
  618. package/dist/lib/schemas-data/3.2/creative/list-transformers-response.json +8 -8
  619. package/dist/lib/schemas-data/3.2/creative/preview-creative-request.json +13 -13
  620. package/dist/lib/schemas-data/3.2/creative/preview-creative-response.json +18 -18
  621. package/dist/lib/schemas-data/3.2/creative/preview-render.json +4 -4
  622. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-input-required.json +3 -3
  623. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-submitted.json +4 -4
  624. package/dist/lib/schemas-data/3.2/creative/sync-creatives-async-response-working.json +3 -3
  625. package/dist/lib/schemas-data/3.2/creative/sync-creatives-request.json +10 -10
  626. package/dist/lib/schemas-data/3.2/creative/sync-creatives-response.json +18 -18
  627. package/dist/lib/schemas-data/3.2/creative/validate-input-request.json +4 -4
  628. package/dist/lib/schemas-data/3.2/creative/validate-input-response.json +4 -4
  629. package/dist/lib/schemas-data/3.2/creative/validate-input-result.json +2 -2
  630. package/dist/lib/schemas-data/3.2/creative/video-brief.json +1 -1
  631. package/dist/lib/schemas-data/3.2/enums/account-currency-mode.json +1 -1
  632. package/dist/lib/schemas-data/3.2/enums/account-scope.json +1 -1
  633. package/dist/lib/schemas-data/3.2/enums/account-status.json +1 -1
  634. package/dist/lib/schemas-data/3.2/enums/action-not-allowed-reason.json +1 -1
  635. package/dist/lib/schemas-data/3.2/enums/action-source.json +1 -1
  636. package/dist/lib/schemas-data/3.2/enums/activation-method.json +1 -1
  637. package/dist/lib/schemas-data/3.2/enums/adcp-protocol.json +1 -1
  638. package/dist/lib/schemas-data/3.2/enums/adjustment-kind.json +1 -1
  639. package/dist/lib/schemas-data/3.2/enums/advertiser-industry.json +1 -1
  640. package/dist/lib/schemas-data/3.2/enums/age-determination-basis.json +1 -1
  641. package/dist/lib/schemas-data/3.2/enums/age-verification-method.json +1 -1
  642. package/dist/lib/schemas-data/3.2/enums/assessment-status.json +1 -1
  643. package/dist/lib/schemas-data/3.2/enums/asset-content-type.json +1 -1
  644. package/dist/lib/schemas-data/3.2/enums/attestation-claim.json +1 -1
  645. package/dist/lib/schemas-data/3.2/enums/attribution-methodology.json +1 -1
  646. package/dist/lib/schemas-data/3.2/enums/attribution-model.json +1 -1
  647. package/dist/lib/schemas-data/3.2/enums/audience-evidence-methodology.json +1 -1
  648. package/dist/lib/schemas-data/3.2/enums/audience-resolution-method.json +1 -1
  649. package/dist/lib/schemas-data/3.2/enums/audience-source.json +1 -1
  650. package/dist/lib/schemas-data/3.2/enums/audience-status.json +1 -1
  651. package/dist/lib/schemas-data/3.2/enums/audience-subject-type.json +1 -1
  652. package/dist/lib/schemas-data/3.2/enums/audio-channel-layout.json +1 -1
  653. package/dist/lib/schemas-data/3.2/enums/audio-distribution-type.json +1 -1
  654. package/dist/lib/schemas-data/3.2/enums/auth-scheme.json +1 -1
  655. package/dist/lib/schemas-data/3.2/enums/availability-status.json +1 -1
  656. package/dist/lib/schemas-data/3.2/enums/available-metric.json +1 -1
  657. package/dist/lib/schemas-data/3.2/enums/billing-party.json +1 -1
  658. package/dist/lib/schemas-data/3.2/enums/binary-verdict.json +1 -1
  659. package/dist/lib/schemas-data/3.2/enums/brand-agent-type.json +1 -1
  660. package/dist/lib/schemas-data/3.2/enums/browser-family.json +1 -1
  661. package/dist/lib/schemas-data/3.2/enums/c2pa-watermark-action.json +1 -1
  662. package/dist/lib/schemas-data/3.2/enums/canceled-by.json +1 -1
  663. package/dist/lib/schemas-data/3.2/enums/canonical-media-buy-action-mode.json +1 -1
  664. package/dist/lib/schemas-data/3.2/enums/canonical-media-buy-action.json +1 -1
  665. package/dist/lib/schemas-data/3.2/enums/catalog-action.json +1 -1
  666. package/dist/lib/schemas-data/3.2/enums/catalog-item-status.json +1 -1
  667. package/dist/lib/schemas-data/3.2/enums/catalog-type.json +1 -1
  668. package/dist/lib/schemas-data/3.2/enums/channels.json +1 -1
  669. package/dist/lib/schemas-data/3.2/enums/cloud-storage-protocol.json +1 -1
  670. package/dist/lib/schemas-data/3.2/enums/co-branding-requirement.json +1 -1
  671. package/dist/lib/schemas-data/3.2/enums/collection-cadence.json +1 -1
  672. package/dist/lib/schemas-data/3.2/enums/collection-kind.json +1 -1
  673. package/dist/lib/schemas-data/3.2/enums/collection-relationship.json +1 -1
  674. package/dist/lib/schemas-data/3.2/enums/collection-status.json +1 -1
  675. package/dist/lib/schemas-data/3.2/enums/completion-source.json +1 -1
  676. package/dist/lib/schemas-data/3.2/enums/consent-basis.json +1 -1
  677. package/dist/lib/schemas-data/3.2/enums/content-id-type.json +1 -1
  678. package/dist/lib/schemas-data/3.2/enums/content-rating-system.json +1 -1
  679. package/dist/lib/schemas-data/3.2/enums/creative-action.json +1 -1
  680. package/dist/lib/schemas-data/3.2/enums/creative-agent-capability.json +1 -1
  681. package/dist/lib/schemas-data/3.2/enums/creative-approval-status.json +1 -1
  682. package/dist/lib/schemas-data/3.2/enums/creative-event-reason-code.json +1 -1
  683. package/dist/lib/schemas-data/3.2/enums/creative-identifier-type.json +1 -1
  684. package/dist/lib/schemas-data/3.2/enums/creative-quality.json +1 -1
  685. package/dist/lib/schemas-data/3.2/enums/creative-selection-strategy.json +1 -1
  686. package/dist/lib/schemas-data/3.2/enums/creative-sort-field.json +1 -1
  687. package/dist/lib/schemas-data/3.2/enums/creative-status.json +1 -1
  688. package/dist/lib/schemas-data/3.2/enums/ctv-ad-experience.json +1 -1
  689. package/dist/lib/schemas-data/3.2/enums/daast-tracking-event.json +1 -1
  690. package/dist/lib/schemas-data/3.2/enums/daast-version.json +1 -1
  691. package/dist/lib/schemas-data/3.2/enums/day-of-week.json +1 -1
  692. package/dist/lib/schemas-data/3.2/enums/daypart-timezone-mode.json +1 -1
  693. package/dist/lib/schemas-data/3.2/enums/delegation-authority.json +1 -1
  694. package/dist/lib/schemas-data/3.2/enums/delivery-recipient-cloud.json +1 -1
  695. package/dist/lib/schemas-data/3.2/enums/delivery-status.json +1 -1
  696. package/dist/lib/schemas-data/3.2/enums/delivery-type.json +1 -1
  697. package/dist/lib/schemas-data/3.2/enums/demographic-system.json +1 -1
  698. package/dist/lib/schemas-data/3.2/enums/derivative-type.json +1 -1
  699. package/dist/lib/schemas-data/3.2/enums/device-platform.json +1 -1
  700. package/dist/lib/schemas-data/3.2/enums/device-type.json +1 -1
  701. package/dist/lib/schemas-data/3.2/enums/digital-source-type.json +1 -1
  702. package/dist/lib/schemas-data/3.2/enums/dimension-unit.json +1 -1
  703. package/dist/lib/schemas-data/3.2/enums/disclosure-persistence.json +1 -1
  704. package/dist/lib/schemas-data/3.2/enums/disclosure-position.json +1 -1
  705. package/dist/lib/schemas-data/3.2/enums/distance-unit.json +1 -1
  706. package/dist/lib/schemas-data/3.2/enums/distribution-identifier-type.json +1 -1
  707. package/dist/lib/schemas-data/3.2/enums/dooh-motion-type.json +1 -1
  708. package/dist/lib/schemas-data/3.2/enums/embedded-provenance-method.json +1 -1
  709. package/dist/lib/schemas-data/3.2/enums/error-code.json +1 -1
  710. package/dist/lib/schemas-data/3.2/enums/error-scope.json +1 -1
  711. package/dist/lib/schemas-data/3.2/enums/escalation-severity.json +1 -1
  712. package/dist/lib/schemas-data/3.2/enums/event-type.json +1 -1
  713. package/dist/lib/schemas-data/3.2/enums/exclusivity.json +1 -1
  714. package/dist/lib/schemas-data/3.2/enums/feature-check-status.json +1 -1
  715. package/dist/lib/schemas-data/3.2/enums/feed-format.json +1 -1
  716. package/dist/lib/schemas-data/3.2/enums/feedback-source.json +1 -1
  717. package/dist/lib/schemas-data/3.2/enums/forecast-method.json +1 -1
  718. package/dist/lib/schemas-data/3.2/enums/forecast-range-unit.json +1 -1
  719. package/dist/lib/schemas-data/3.2/enums/forecastable-metric.json +1 -1
  720. package/dist/lib/schemas-data/3.2/enums/format-id-parameter.json +1 -1
  721. package/dist/lib/schemas-data/3.2/enums/frame-rate-type.json +1 -1
  722. package/dist/lib/schemas-data/3.2/enums/frequency-cap-control-mode.json +1 -1
  723. package/dist/lib/schemas-data/3.2/enums/frequency-cap-mutable-field.json +1 -1
  724. package/dist/lib/schemas-data/3.2/enums/frequency-cap-scope.json +1 -1
  725. package/dist/lib/schemas-data/3.2/enums/genre-taxonomy.json +1 -1
  726. package/dist/lib/schemas-data/3.2/enums/geo-level.json +1 -1
  727. package/dist/lib/schemas-data/3.2/enums/gop-type.json +1 -1
  728. package/dist/lib/schemas-data/3.2/enums/governance-decision.json +1 -1
  729. package/dist/lib/schemas-data/3.2/enums/governance-domain.json +1 -1
  730. package/dist/lib/schemas-data/3.2/enums/governance-mode.json +1 -1
  731. package/dist/lib/schemas-data/3.2/enums/governance-phase.json +1 -1
  732. package/dist/lib/schemas-data/3.2/enums/history-entry-type.json +1 -1
  733. package/dist/lib/schemas-data/3.2/enums/http-method.json +1 -1
  734. package/dist/lib/schemas-data/3.2/enums/identifier-types.json +1 -1
  735. package/dist/lib/schemas-data/3.2/enums/impairment-offline-state.json +1 -1
  736. package/dist/lib/schemas-data/3.2/enums/impairment-reason-code.json +1 -1
  737. package/dist/lib/schemas-data/3.2/enums/indicator-type.json +1 -1
  738. package/dist/lib/schemas-data/3.2/enums/installment-status.json +1 -1
  739. package/dist/lib/schemas-data/3.2/enums/javascript-module-type.json +1 -1
  740. package/dist/lib/schemas-data/3.2/enums/landing-page-requirement.json +1 -1
  741. package/dist/lib/schemas-data/3.2/enums/legacy-postal-system.json +1 -1
  742. package/dist/lib/schemas-data/3.2/enums/lift-dimension.json +1 -1
  743. package/dist/lib/schemas-data/3.2/enums/logo-slot.json +1 -1
  744. package/dist/lib/schemas-data/3.2/enums/macro-dialect.json +1 -1
  745. package/dist/lib/schemas-data/3.2/enums/macro-mapping-status.json +1 -1
  746. package/dist/lib/schemas-data/3.2/enums/macro-processing-operation.json +1 -1
  747. package/dist/lib/schemas-data/3.2/enums/macro-resolution-reason.json +1 -1
  748. package/dist/lib/schemas-data/3.2/enums/macro-resolver.json +1 -1
  749. package/dist/lib/schemas-data/3.2/enums/macro-value-context.json +1 -1
  750. package/dist/lib/schemas-data/3.2/enums/makegood-remedy.json +1 -1
  751. package/dist/lib/schemas-data/3.2/enums/markdown-flavor.json +1 -1
  752. package/dist/lib/schemas-data/3.2/enums/match-id-type.json +1 -1
  753. package/dist/lib/schemas-data/3.2/enums/match-type.json +1 -1
  754. package/dist/lib/schemas-data/3.2/enums/media-buy-action-mode.json +1 -1
  755. package/dist/lib/schemas-data/3.2/enums/media-buy-frequency-cap-control-mode.json +1 -1
  756. package/dist/lib/schemas-data/3.2/enums/media-buy-health.json +1 -1
  757. package/dist/lib/schemas-data/3.2/enums/media-buy-status.json +1 -1
  758. package/dist/lib/schemas-data/3.2/enums/media-buy-valid-action.json +1 -1
  759. package/dist/lib/schemas-data/3.2/enums/metric-scope.json +1 -1
  760. package/dist/lib/schemas-data/3.2/enums/metric-type.json +1 -1
  761. package/dist/lib/schemas-data/3.2/enums/metro-system.json +1 -1
  762. package/dist/lib/schemas-data/3.2/enums/moov-atom-position.json +1 -1
  763. package/dist/lib/schemas-data/3.2/enums/motion-level.json +1 -1
  764. package/dist/lib/schemas-data/3.2/enums/notification-type.json +1 -1
  765. package/dist/lib/schemas-data/3.2/enums/offering-availability-status.json +1 -1
  766. package/dist/lib/schemas-data/3.2/enums/outcome-target-cost-strength.json +1 -1
  767. package/dist/lib/schemas-data/3.2/enums/outcome-type.json +1 -1
  768. package/dist/lib/schemas-data/3.2/enums/pacing.json +1 -1
  769. package/dist/lib/schemas-data/3.2/enums/payment-terms.json +1 -1
  770. package/dist/lib/schemas-data/3.2/enums/performance-baseline.json +1 -1
  771. package/dist/lib/schemas-data/3.2/enums/performance-standard-metric.json +1 -1
  772. package/dist/lib/schemas-data/3.2/enums/pixel-tracking-event.json +1 -1
  773. package/dist/lib/schemas-data/3.2/enums/policy-category.json +1 -1
  774. package/dist/lib/schemas-data/3.2/enums/policy-enforcement.json +1 -1
  775. package/dist/lib/schemas-data/3.2/enums/postal-system.json +1 -1
  776. package/dist/lib/schemas-data/3.2/enums/preview-output-format.json +1 -1
  777. package/dist/lib/schemas-data/3.2/enums/pricing-model.json +1 -1
  778. package/dist/lib/schemas-data/3.2/enums/pricing-structure.json +1 -1
  779. package/dist/lib/schemas-data/3.2/enums/principal-kind.json +1 -1
  780. package/dist/lib/schemas-data/3.2/enums/production-quality.json +1 -1
  781. package/dist/lib/schemas-data/3.2/enums/property-type.json +1 -1
  782. package/dist/lib/schemas-data/3.2/enums/proposal-decline-reason.json +1 -1
  783. package/dist/lib/schemas-data/3.2/enums/proposal-refinement-reason.json +1 -1
  784. package/dist/lib/schemas-data/3.2/enums/proposal-status.json +1 -1
  785. package/dist/lib/schemas-data/3.2/enums/publisher-identifier-types.json +1 -1
  786. package/dist/lib/schemas-data/3.2/enums/purchase-type.json +1 -1
  787. package/dist/lib/schemas-data/3.2/enums/reach-aggregation.json +1 -1
  788. package/dist/lib/schemas-data/3.2/enums/reach-unit.json +1 -1
  789. package/dist/lib/schemas-data/3.2/enums/reporting-destination-setup-state.json +1 -1
  790. package/dist/lib/schemas-data/3.2/enums/reporting-finality.json +1 -1
  791. package/dist/lib/schemas-data/3.2/enums/reporting-frequency.json +1 -1
  792. package/dist/lib/schemas-data/3.2/enums/reporting-health.json +1 -1
  793. package/dist/lib/schemas-data/3.2/enums/representation-selection-strategy.json +1 -1
  794. package/dist/lib/schemas-data/3.2/enums/request-signing-error-code.json +1 -1
  795. package/dist/lib/schemas-data/3.2/enums/response-type.json +1 -1
  796. package/dist/lib/schemas-data/3.2/enums/restricted-attribute.json +1 -1
  797. package/dist/lib/schemas-data/3.2/enums/right-type.json +1 -1
  798. package/dist/lib/schemas-data/3.2/enums/right-use.json +1 -1
  799. package/dist/lib/schemas-data/3.2/enums/rights-billing-period.json +1 -1
  800. package/dist/lib/schemas-data/3.2/enums/scan-type.json +1 -1
  801. package/dist/lib/schemas-data/3.2/enums/seller-policy-decline-reason.json +1 -1
  802. package/dist/lib/schemas-data/3.2/enums/si-session-status.json +1 -1
  803. package/dist/lib/schemas-data/3.2/enums/signal-catalog-type.json +1 -1
  804. package/dist/lib/schemas-data/3.2/enums/signal-source.json +1 -1
  805. package/dist/lib/schemas-data/3.2/enums/signal-value-type.json +1 -1
  806. package/dist/lib/schemas-data/3.2/enums/snapshot-unavailable-reason.json +1 -1
  807. package/dist/lib/schemas-data/3.2/enums/social-placement-surface.json +1 -1
  808. package/dist/lib/schemas-data/3.2/enums/sort-direction.json +1 -1
  809. package/dist/lib/schemas-data/3.2/enums/sort-metric.json +1 -1
  810. package/dist/lib/schemas-data/3.2/enums/special-category.json +1 -1
  811. package/dist/lib/schemas-data/3.2/enums/specialism.json +1 -1
  812. package/dist/lib/schemas-data/3.2/enums/sponsored-placement-type.json +1 -1
  813. package/dist/lib/schemas-data/3.2/enums/talent-role.json +1 -1
  814. package/dist/lib/schemas-data/3.2/enums/task-status.json +1 -1
  815. package/dist/lib/schemas-data/3.2/enums/task-type.json +1 -1
  816. package/dist/lib/schemas-data/3.2/enums/tracker-execution-actor.json +1 -1
  817. package/dist/lib/schemas-data/3.2/enums/tracker-firing-path.json +1 -1
  818. package/dist/lib/schemas-data/3.2/enums/transport-mode.json +1 -1
  819. package/dist/lib/schemas-data/3.2/enums/travel-time-unit.json +1 -1
  820. package/dist/lib/schemas-data/3.2/enums/uid-type.json +1 -1
  821. package/dist/lib/schemas-data/3.2/enums/universal-macro.json +1 -1
  822. package/dist/lib/schemas-data/3.2/enums/update-frequency.json +1 -1
  823. package/dist/lib/schemas-data/3.2/enums/url-asset-type.json +1 -1
  824. package/dist/lib/schemas-data/3.2/enums/validation-mode.json +1 -1
  825. package/dist/lib/schemas-data/3.2/enums/vast-media-delivery-method.json +1 -1
  826. package/dist/lib/schemas-data/3.2/enums/vast-tracking-event.json +1 -1
  827. package/dist/lib/schemas-data/3.2/enums/vast-version.json +1 -1
  828. package/dist/lib/schemas-data/3.2/enums/vendor-relationship.json +1 -1
  829. package/dist/lib/schemas-data/3.2/enums/video-placement-type.json +1 -1
  830. package/dist/lib/schemas-data/3.2/enums/view-threshold-basis.json +1 -1
  831. package/dist/lib/schemas-data/3.2/enums/viewability-standard.json +1 -1
  832. package/dist/lib/schemas-data/3.2/enums/warning-code.json +1 -1
  833. package/dist/lib/schemas-data/3.2/enums/watermark-media-type.json +1 -1
  834. package/dist/lib/schemas-data/3.2/enums/wcag-level.json +1 -1
  835. package/dist/lib/schemas-data/3.2/enums/webhook-response-type.json +1 -1
  836. package/dist/lib/schemas-data/3.2/enums/webhook-security-method.json +1 -1
  837. package/dist/lib/schemas-data/3.2/error-details/accessibility-violation.json +1 -1
  838. package/dist/lib/schemas-data/3.2/error-details/account-moved.json +2 -2
  839. package/dist/lib/schemas-data/3.2/error-details/account-setup-required.json +1 -1
  840. package/dist/lib/schemas-data/3.2/error-details/action-not-allowed.json +5 -5
  841. package/dist/lib/schemas-data/3.2/error-details/agent-permission-denied.json +1 -1
  842. package/dist/lib/schemas-data/3.2/error-details/audience-too-small.json +1 -1
  843. package/dist/lib/schemas-data/3.2/error-details/authorization-required.json +3 -3
  844. package/dist/lib/schemas-data/3.2/error-details/billing-not-permitted-for-agent.json +3 -3
  845. package/dist/lib/schemas-data/3.2/error-details/billing-not-supported.json +2 -2
  846. package/dist/lib/schemas-data/3.2/error-details/budget-too-low.json +1 -1
  847. package/dist/lib/schemas-data/3.2/error-details/conflict.json +1 -1
  848. package/dist/lib/schemas-data/3.2/error-details/creative-rejected.json +1 -1
  849. package/dist/lib/schemas-data/3.2/error-details/creative-representation-unresolved.json +2 -2
  850. package/dist/lib/schemas-data/3.2/error-details/creative-revision-content-mismatch.json +2 -2
  851. package/dist/lib/schemas-data/3.2/error-details/execution-requirement-unmet.json +2 -2
  852. package/dist/lib/schemas-data/3.2/error-details/governance-agent-not-accepted.json +2 -2
  853. package/dist/lib/schemas-data/3.2/error-details/macro-resolution-failed.json +2 -2
  854. package/dist/lib/schemas-data/3.2/error-details/policy-violation.json +1 -1
  855. package/dist/lib/schemas-data/3.2/error-details/rate-limited.json +1 -1
  856. package/dist/lib/schemas-data/3.2/error-details/requote-required.json +3 -3
  857. package/dist/lib/schemas-data/3.2/error-details/stale-response.json +1 -1
  858. package/dist/lib/schemas-data/3.2/error-details/unsupported-refinement-dimension.json +1 -1
  859. package/dist/lib/schemas-data/3.2/error-details/vast-version-mismatch.json +6 -6
  860. package/dist/lib/schemas-data/3.2/error-details/vendor-error-codes.json +1 -1
  861. package/dist/lib/schemas-data/3.2/error-details/version-unsupported.json +2 -2
  862. package/dist/lib/schemas-data/3.2/extensions/extension-meta.json +1 -1
  863. package/dist/lib/schemas-data/3.2/extensions/index.json +2 -2
  864. package/dist/lib/schemas-data/3.2/formats/canonical/_base.json +5 -5
  865. package/dist/lib/schemas-data/3.2/formats/canonical/agent_placement.json +2 -2
  866. package/dist/lib/schemas-data/3.2/formats/canonical/audio_daast.json +4 -4
  867. package/dist/lib/schemas-data/3.2/formats/canonical/audio_hosted.json +2 -2
  868. package/dist/lib/schemas-data/3.2/formats/canonical/audio_vast.json +5 -5
  869. package/dist/lib/schemas-data/3.2/formats/canonical/coordinated_placements.json +18 -18
  870. package/dist/lib/schemas-data/3.2/formats/canonical/display_tag.json +2 -2
  871. package/dist/lib/schemas-data/3.2/formats/canonical/html5.json +2 -2
  872. package/dist/lib/schemas-data/3.2/formats/canonical/image.json +5 -5
  873. package/dist/lib/schemas-data/3.2/formats/canonical/image_carousel.json +2 -2
  874. package/dist/lib/schemas-data/3.2/formats/canonical/native_in_feed.json +5 -5
  875. package/dist/lib/schemas-data/3.2/formats/canonical/responsive_creative.json +2 -2
  876. package/dist/lib/schemas-data/3.2/formats/canonical/seller_rendered_stateful_display.json +3 -3
  877. package/dist/lib/schemas-data/3.2/formats/canonical/sponsored_placement.json +4 -4
  878. package/dist/lib/schemas-data/3.2/formats/canonical/video_hosted.json +3 -3
  879. package/dist/lib/schemas-data/3.2/formats/canonical/video_vast.json +8 -8
  880. package/dist/lib/schemas-data/3.2/governance/accepted-governance-agents.json +1 -1
  881. package/dist/lib/schemas-data/3.2/governance/attribute-definition.json +1 -1
  882. package/dist/lib/schemas-data/3.2/governance/audience-constraints.json +3 -3
  883. package/dist/lib/schemas-data/3.2/governance/check-governance-request.json +10 -10
  884. package/dist/lib/schemas-data/3.2/governance/check-governance-response.json +8 -8
  885. package/dist/lib/schemas-data/3.2/governance/get-plan-audit-logs-request.json +5 -5
  886. package/dist/lib/schemas-data/3.2/governance/get-plan-audit-logs-response.json +14 -14
  887. package/dist/lib/schemas-data/3.2/governance/policy-category-definition.json +2 -2
  888. package/dist/lib/schemas-data/3.2/governance/policy-entry.json +7 -7
  889. package/dist/lib/schemas-data/3.2/governance/policy-ref.json +1 -1
  890. package/dist/lib/schemas-data/3.2/governance/report-plan-adjustment-request.json +4 -4
  891. package/dist/lib/schemas-data/3.2/governance/report-plan-adjustment-response.json +4 -4
  892. package/dist/lib/schemas-data/3.2/governance/report-plan-outcome-request.json +8 -8
  893. package/dist/lib/schemas-data/3.2/governance/report-plan-outcome-response.json +5 -5
  894. package/dist/lib/schemas-data/3.2/governance/reported-outcome-error.json +1 -1
  895. package/dist/lib/schemas-data/3.2/governance/sync-plans-request.json +14 -14
  896. package/dist/lib/schemas-data/3.2/governance/sync-plans-response.json +6 -6
  897. package/dist/lib/schemas-data/3.2/index.json +639 -639
  898. package/dist/lib/schemas-data/3.2/manifest.json +3 -3
  899. package/dist/lib/schemas-data/3.2/manifest.schema.json +1 -1
  900. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/get-account-financials-request.json +1 -1
  901. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/list-account-changes-request.json +1 -1
  902. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/list-accounts-request.json +1 -1
  903. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/report-usage-request.json +1 -1
  904. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/sync-accounts-request.json +1 -1
  905. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/account/sync-governance-request.json +1 -1
  906. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/acquire-rights-request.json +1 -1
  907. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/get-brand-identity-request.json +1 -1
  908. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/get-rights-request.json +1 -1
  909. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/search-brands-request.json +1 -1
  910. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/update-rights-request.json +1 -1
  911. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/verify-brand-claim-request.json +1 -1
  912. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/brand/verify-brand-claims-request.json +1 -1
  913. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/create-collection-list-request.json +1 -1
  914. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/delete-collection-list-request.json +1 -1
  915. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/get-collection-list-request.json +1 -1
  916. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/list-collection-lists-request.json +1 -1
  917. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/collection/update-collection-list-request.json +1 -1
  918. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/compliance/comply-test-controller-request.json +1 -1
  919. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/calibrate-content-request.json +1 -1
  920. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/create-content-standards-request.json +1 -1
  921. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/get-content-standards-request.json +1 -1
  922. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/get-media-buy-artifacts-request.json +1 -1
  923. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/list-content-standards-request.json +1 -1
  924. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/update-content-standards-request.json +1 -1
  925. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/content-standards/validate-content-delivery-request.json +1 -1
  926. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/get-creative-delivery-request.json +1 -1
  927. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/get-creative-features-request.json +1 -1
  928. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/list-creatives-request.json +1 -1
  929. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/list-transformers-request.json +1 -1
  930. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/preview-creative-request.json +1 -1
  931. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/sync-creatives-request.json +1 -1
  932. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/creative/validate-input-request.json +1 -1
  933. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/check-governance-request.json +1 -1
  934. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/get-plan-audit-logs-request.json +1 -1
  935. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/report-plan-adjustment-request.json +1 -1
  936. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/report-plan-outcome-request.json +1 -1
  937. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/governance/sync-plans-request.json +1 -1
  938. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/accept-proposal-request.json +1 -1
  939. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/build-creative-request.json +1 -1
  940. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/buy-products-request.json +1 -1
  941. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/control-media-buy-request.json +1 -1
  942. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/create-media-buy-request.json +1 -1
  943. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/decline-proposals-request.json +1 -1
  944. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-media-buy-delivery-request.json +1 -1
  945. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-media-buys-request.json +1 -1
  946. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-products-request.json +1 -1
  947. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/get-reporting-status-request.json +1 -1
  948. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/list-creative-formats-request.json +1 -1
  949. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/list-products-request.json +1 -1
  950. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/log-event-request.json +1 -1
  951. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/provide-performance-feedback-request.json +1 -1
  952. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/refine-proposals-request.json +1 -1
  953. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/request-proposals-request.json +1 -1
  954. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-audiences-request.json +1 -1
  955. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-catalogs-request.json +1 -1
  956. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-event-sources-request.json +1 -1
  957. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-reporting-receipts-request.json +1 -1
  958. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/sync-reporting-status-request.json +1 -1
  959. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/media-buy/update-media-buy-request.json +1 -1
  960. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/get-account-financials-request.json +1 -1
  961. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/list-accounts-request.json +1 -1
  962. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/report-usage-request.json +1 -1
  963. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/sync-accounts-request.json +1 -1
  964. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/account/sync-governance-request.json +1 -1
  965. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/creative/list-creatives-request.json +1 -1
  966. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/creative/sync-creatives-request.json +1 -1
  967. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/manifest.json +1 -1
  968. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/accept-proposal-request.json +1 -1
  969. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/buy-products-request.json +1 -1
  970. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/control-media-buy-request.json +1 -1
  971. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/decline-proposals-request.json +1 -1
  972. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-media-buy-delivery-request.json +1 -1
  973. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-media-buys-request.json +1 -1
  974. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/get-reporting-status-request.json +1 -1
  975. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/list-products-request.json +1 -1
  976. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/log-event-request.json +1 -1
  977. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/provide-performance-feedback-request.json +1 -1
  978. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/refine-proposals-request.json +1 -1
  979. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/request-proposals-request.json +1 -1
  980. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-audiences-request.json +1 -1
  981. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-catalogs-request.json +1 -1
  982. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-event-sources-request.json +1 -1
  983. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-reporting-receipts-request.json +1 -1
  984. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/media-buy/sync-reporting-status-request.json +1 -1
  985. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-adcp-capabilities-request.json +1 -1
  986. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-principal-request.json +1 -1
  987. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/get-task-status-request.json +1 -1
  988. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/list-tasks-request.json +1 -1
  989. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/profiles/media-buy/protocol/sync-principal-request.json +1 -1
  990. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/create-property-list-request.json +1 -1
  991. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/delete-property-list-request.json +1 -1
  992. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/get-property-list-request.json +1 -1
  993. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/list-property-lists-request.json +1 -1
  994. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/update-property-list-request.json +1 -1
  995. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/property/validate-property-delivery-request.json +1 -1
  996. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-adcp-capabilities-request.json +1 -1
  997. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-principal-request.json +1 -1
  998. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/get-task-status-request.json +1 -1
  999. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/list-tasks-request.json +1 -1
  1000. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/sync-agent-notification-configs-request.json +1 -1
  1001. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/protocol/sync-principal-request.json +1 -1
  1002. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/signals/activate-signal-request.json +1 -1
  1003. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/signals/get-signals-request.json +1 -1
  1004. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-get-offering-request.json +1 -1
  1005. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-initiate-session-request.json +1 -1
  1006. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-send-message-request.json +1 -1
  1007. package/dist/lib/schemas-data/3.2/mcp/2026-07-28/sponsored-intelligence/si-terminate-session-request.json +1 -1
  1008. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-input-required.json +2 -2
  1009. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-submitted.json +2 -2
  1010. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-async-response-working.json +2 -2
  1011. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-request.json +11 -11
  1012. package/dist/lib/schemas-data/3.2/media-buy/accept-proposal-response.json +2 -2
  1013. package/dist/lib/schemas-data/3.2/media-buy/acceptance-context.json +3 -3
  1014. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-catalog.json +4 -4
  1015. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-profile-ref.json +1 -1
  1016. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-profile.json +3 -3
  1017. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-requirement.json +3 -3
  1018. package/dist/lib/schemas-data/3.2/media-buy/acceptance-policy-rule.json +3 -3
  1019. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-input-required.json +4 -4
  1020. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-submitted.json +4 -4
  1021. package/dist/lib/schemas-data/3.2/media-buy/build-creative-async-response-working.json +3 -3
  1022. package/dist/lib/schemas-data/3.2/media-buy/build-creative-request.json +19 -19
  1023. package/dist/lib/schemas-data/3.2/media-buy/build-creative-response.json +35 -35
  1024. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-input-required.json +2 -2
  1025. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-submitted.json +2 -2
  1026. package/dist/lib/schemas-data/3.2/media-buy/buy-products-async-response-working.json +2 -2
  1027. package/dist/lib/schemas-data/3.2/media-buy/buy-products-request.json +20 -20
  1028. package/dist/lib/schemas-data/3.2/media-buy/buy-products-response.json +2 -2
  1029. package/dist/lib/schemas-data/3.2/media-buy/change-term-constraints.json +4 -4
  1030. package/dist/lib/schemas-data/3.2/media-buy/change-term.json +6 -6
  1031. package/dist/lib/schemas-data/3.2/media-buy/commercial-terms.json +12 -12
  1032. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-input-required.json +2 -2
  1033. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-submitted.json +2 -2
  1034. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-async-response-working.json +2 -2
  1035. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-request.json +15 -15
  1036. package/dist/lib/schemas-data/3.2/media-buy/control-media-buy-response.json +37 -19
  1037. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-input-required.json +4 -4
  1038. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-submitted.json +4 -4
  1039. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-async-response-working.json +3 -3
  1040. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-request.json +19 -19
  1041. package/dist/lib/schemas-data/3.2/media-buy/create-media-buy-response.json +23 -23
  1042. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-input-required.json +2 -2
  1043. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-submitted.json +2 -2
  1044. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-async-response-working.json +2 -2
  1045. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-request.json +9 -9
  1046. package/dist/lib/schemas-data/3.2/media-buy/decline-proposals-response.json +6 -6
  1047. package/dist/lib/schemas-data/3.2/media-buy/get-media-buy-delivery-request.json +47 -47
  1048. package/dist/lib/schemas-data/3.2/media-buy/get-media-buy-delivery-response.json +81 -81
  1049. package/dist/lib/schemas-data/3.2/media-buy/get-media-buys-request.json +9 -9
  1050. package/dist/lib/schemas-data/3.2/media-buy/get-media-buys-response.json +52 -52
  1051. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-input-required.json +4 -4
  1052. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-submitted.json +4 -4
  1053. package/dist/lib/schemas-data/3.2/media-buy/get-products-async-response-working.json +3 -3
  1054. package/dist/lib/schemas-data/3.2/media-buy/get-products-rejected.json +5 -5
  1055. package/dist/lib/schemas-data/3.2/media-buy/get-products-request.json +19 -19
  1056. package/dist/lib/schemas-data/3.2/media-buy/get-products-response.json +13 -13
  1057. package/dist/lib/schemas-data/3.2/media-buy/get-products-targeting-resolution.json +3 -3
  1058. package/dist/lib/schemas-data/3.2/media-buy/get-reporting-status-request.json +10 -10
  1059. package/dist/lib/schemas-data/3.2/media-buy/get-reporting-status-response.json +27 -27
  1060. package/dist/lib/schemas-data/3.2/media-buy/legacy-purchase-continuation-input.json +2 -2
  1061. package/dist/lib/schemas-data/3.2/media-buy/list-creative-formats-request.json +14 -14
  1062. package/dist/lib/schemas-data/3.2/media-buy/list-creative-formats-response.json +9 -9
  1063. package/dist/lib/schemas-data/3.2/media-buy/list-products-request.json +11 -11
  1064. package/dist/lib/schemas-data/3.2/media-buy/list-products-response.json +6 -6
  1065. package/dist/lib/schemas-data/3.2/media-buy/log-event-request.json +5 -5
  1066. package/dist/lib/schemas-data/3.2/media-buy/log-event-response.json +8 -8
  1067. package/dist/lib/schemas-data/3.2/media-buy/media-buy-commitment-response.json +38 -20
  1068. package/dist/lib/schemas-data/3.2/media-buy/media-buy-delivery-webhook-result.json +11 -11
  1069. package/dist/lib/schemas-data/3.2/media-buy/outcome-target.json +4 -4
  1070. package/dist/lib/schemas-data/3.2/media-buy/package-control.json +10 -10
  1071. package/dist/lib/schemas-data/3.2/media-buy/package-request.json +31 -31
  1072. package/dist/lib/schemas-data/3.2/media-buy/package-update.json +14 -14
  1073. package/dist/lib/schemas-data/3.2/media-buy/product-discovery-criteria.json +10 -10
  1074. package/dist/lib/schemas-data/3.2/media-buy/product-fields.json +1 -1
  1075. package/dist/lib/schemas-data/3.2/media-buy/product-purchase-input.json +22 -22
  1076. package/dist/lib/schemas-data/3.2/media-buy/product-purchase.json +13 -13
  1077. package/dist/lib/schemas-data/3.2/media-buy/product-refinement.json +1 -1
  1078. package/dist/lib/schemas-data/3.2/media-buy/proposal-budget-constraint.json +1 -1
  1079. package/dist/lib/schemas-data/3.2/media-buy/proposal-decline.json +2 -2
  1080. package/dist/lib/schemas-data/3.2/media-buy/proposal-refinement.json +5 -5
  1081. package/dist/lib/schemas-data/3.2/media-buy/provide-performance-feedback-request.json +5 -5
  1082. package/dist/lib/schemas-data/3.2/media-buy/provide-performance-feedback-response.json +8 -8
  1083. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-input-required.json +2 -2
  1084. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-submitted.json +2 -2
  1085. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-async-response-working.json +2 -2
  1086. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-request.json +8 -8
  1087. package/dist/lib/schemas-data/3.2/media-buy/refine-proposals-response.json +14 -14
  1088. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-input-required.json +2 -2
  1089. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-submitted.json +2 -2
  1090. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-async-response-working.json +2 -2
  1091. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-request.json +11 -11
  1092. package/dist/lib/schemas-data/3.2/media-buy/request-proposals-response.json +21 -11
  1093. package/dist/lib/schemas-data/3.2/media-buy/sync-audiences-request.json +9 -9
  1094. package/dist/lib/schemas-data/3.2/media-buy/sync-audiences-response.json +15 -15
  1095. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-input-required.json +3 -3
  1096. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-submitted.json +4 -4
  1097. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-async-response-working.json +3 -3
  1098. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-request.json +10 -10
  1099. package/dist/lib/schemas-data/3.2/media-buy/sync-catalogs-response.json +20 -20
  1100. package/dist/lib/schemas-data/3.2/media-buy/sync-event-sources-request.json +8 -8
  1101. package/dist/lib/schemas-data/3.2/media-buy/sync-event-sources-response.json +14 -14
  1102. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-receipts-request.json +9 -9
  1103. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-receipts-response.json +10 -10
  1104. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-status-request.json +8 -8
  1105. package/dist/lib/schemas-data/3.2/media-buy/sync-reporting-status-response.json +8 -8
  1106. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-input-required.json +3 -3
  1107. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-submitted.json +4 -4
  1108. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-async-response-working.json +3 -3
  1109. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-request.json +15 -15
  1110. package/dist/lib/schemas-data/3.2/media-buy/update-media-buy-response.json +21 -21
  1111. package/dist/lib/schemas-data/3.2/pricing-options/cpa-option.json +4 -4
  1112. package/dist/lib/schemas-data/3.2/pricing-options/cpc-option.json +4 -4
  1113. package/dist/lib/schemas-data/3.2/pricing-options/cpcv-option.json +4 -4
  1114. package/dist/lib/schemas-data/3.2/pricing-options/cpm-option.json +4 -4
  1115. package/dist/lib/schemas-data/3.2/pricing-options/cpp-option.json +5 -5
  1116. package/dist/lib/schemas-data/3.2/pricing-options/cpv-option.json +4 -4
  1117. package/dist/lib/schemas-data/3.2/pricing-options/flat-rate-option.json +4 -4
  1118. package/dist/lib/schemas-data/3.2/pricing-options/price-breakdown.json +2 -2
  1119. package/dist/lib/schemas-data/3.2/pricing-options/price-guidance.json +1 -1
  1120. package/dist/lib/schemas-data/3.2/pricing-options/revenue-share-option.json +2 -2
  1121. package/dist/lib/schemas-data/3.2/pricing-options/time-option.json +4 -4
  1122. package/dist/lib/schemas-data/3.2/pricing-options/vcpm-option.json +4 -4
  1123. package/dist/lib/schemas-data/3.2/property/authorization-result.json +1 -1
  1124. package/dist/lib/schemas-data/3.2/property/base-property-source.json +4 -4
  1125. package/dist/lib/schemas-data/3.2/property/create-property-list-request.json +8 -8
  1126. package/dist/lib/schemas-data/3.2/property/create-property-list-response.json +6 -6
  1127. package/dist/lib/schemas-data/3.2/property/delete-property-list-request.json +5 -5
  1128. package/dist/lib/schemas-data/3.2/property/delete-property-list-response.json +5 -5
  1129. package/dist/lib/schemas-data/3.2/property/delivery-record.json +3 -3
  1130. package/dist/lib/schemas-data/3.2/property/get-property-list-request.json +5 -5
  1131. package/dist/lib/schemas-data/3.2/property/get-property-list-response.json +9 -9
  1132. package/dist/lib/schemas-data/3.2/property/list-property-lists-request.json +6 -6
  1133. package/dist/lib/schemas-data/3.2/property/list-property-lists-response.json +7 -7
  1134. package/dist/lib/schemas-data/3.2/property/property-error.json +2 -2
  1135. package/dist/lib/schemas-data/3.2/property/property-feature-definition.json +2 -2
  1136. package/dist/lib/schemas-data/3.2/property/property-feature-result.json +4 -4
  1137. package/dist/lib/schemas-data/3.2/property/property-feature-value.json +2 -2
  1138. package/dist/lib/schemas-data/3.2/property/property-feature.json +1 -1
  1139. package/dist/lib/schemas-data/3.2/property/property-list-changed-webhook.json +2 -2
  1140. package/dist/lib/schemas-data/3.2/property/property-list-filters.json +5 -5
  1141. package/dist/lib/schemas-data/3.2/property/property-list.json +6 -6
  1142. package/dist/lib/schemas-data/3.2/property/update-property-list-request.json +8 -8
  1143. package/dist/lib/schemas-data/3.2/property/update-property-list-response.json +6 -6
  1144. package/dist/lib/schemas-data/3.2/property/validate-property-delivery-request.json +6 -6
  1145. package/dist/lib/schemas-data/3.2/property/validate-property-delivery-response.json +6 -6
  1146. package/dist/lib/schemas-data/3.2/property/validation-result.json +5 -5
  1147. package/dist/lib/schemas-data/3.2/protocol/get-adcp-capabilities-request.json +4 -4
  1148. package/dist/lib/schemas-data/3.2/protocol/get-adcp-capabilities-response.json +53 -53
  1149. package/dist/lib/schemas-data/3.2/protocol/get-principal-request.json +4 -4
  1150. package/dist/lib/schemas-data/3.2/protocol/get-principal-response.json +9 -9
  1151. package/dist/lib/schemas-data/3.2/protocol/get-task-status-request.json +5 -5
  1152. package/dist/lib/schemas-data/3.2/protocol/get-task-status-response.json +10 -10
  1153. package/dist/lib/schemas-data/3.2/protocol/list-tasks-request.json +13 -13
  1154. package/dist/lib/schemas-data/3.2/protocol/list-tasks-response.json +8 -8
  1155. package/dist/lib/schemas-data/3.2/protocol/sync-agent-notification-configs-request.json +5 -5
  1156. package/dist/lib/schemas-data/3.2/protocol/sync-agent-notification-configs-response.json +7 -7
  1157. package/dist/lib/schemas-data/3.2/protocol/sync-principal-request.json +8 -8
  1158. package/dist/lib/schemas-data/3.2/protocol/sync-principal-response.json +10 -10
  1159. package/dist/lib/schemas-data/3.2/registries/v1-canonical-mapping.json +2 -2
  1160. package/dist/lib/schemas-data/3.2/signals/activate-signal-request.json +6 -6
  1161. package/dist/lib/schemas-data/3.2/signals/activate-signal-response.json +9 -9
  1162. package/dist/lib/schemas-data/3.2/signals/get-signals-async-response-submitted.json +4 -4
  1163. package/dist/lib/schemas-data/3.2/signals/get-signals-async-response-working.json +3 -3
  1164. package/dist/lib/schemas-data/3.2/signals/get-signals-request.json +11 -11
  1165. package/dist/lib/schemas-data/3.2/signals/get-signals-response.json +17 -17
  1166. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-capabilities.json +1 -1
  1167. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-context-use.json +1 -1
  1168. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-get-offering-request.json +4 -4
  1169. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-get-offering-response.json +9 -9
  1170. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-identity.json +1 -1
  1171. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-initiate-session-request.json +7 -7
  1172. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-initiate-session-response.json +10 -10
  1173. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-send-message-request.json +5 -5
  1174. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-send-message-response.json +10 -10
  1175. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-sponsored-context-receipt.json +4 -4
  1176. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-sponsored-context.json +4 -4
  1177. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-terminate-session-request.json +4 -4
  1178. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-terminate-session-response.json +7 -7
  1179. package/dist/lib/schemas-data/3.2/sponsored-intelligence/si-ui-element.json +1 -1
  1180. package/dist/lib/schemas-data/3.2/trusted-match/available-package.json +5 -5
  1181. package/dist/lib/schemas-data/3.2/trusted-match/context-match-request.json +5 -5
  1182. package/dist/lib/schemas-data/3.2/trusted-match/context-match-response.json +4 -4
  1183. package/dist/lib/schemas-data/3.2/trusted-match/error.json +1 -1
  1184. package/dist/lib/schemas-data/3.2/trusted-match/identity-match-request.json +4 -4
  1185. package/dist/lib/schemas-data/3.2/trusted-match/identity-match-response.json +4 -4
  1186. package/dist/lib/schemas-data/3.2/trusted-match/offer-price.json +1 -1
  1187. package/dist/lib/schemas-data/3.2/trusted-match/offer.json +5 -5
  1188. package/dist/lib/schemas-data/3.2/trusted-match/provider-context-match-response.json +4 -4
  1189. package/dist/lib/schemas-data/3.2/trusted-match/provider-identity-match-response.json +4 -4
  1190. package/dist/lib/schemas-data/3.2/trusted-match/provider-registration.json +2 -2
  1191. package/dist/lib/schemas-data/3.2/trusted-match/publisher-targeting-kv-config.json +1 -1
  1192. package/dist/lib/schemas-data/3.2/trusted-match/publisher-tmpx-config.json +1 -1
  1193. package/dist/lib/schemas-data/3.2/trusted-match/tmpx-chunk.json +1 -1
  1194. package/dist/lib/server/create-adcp-server.js +1 -1
  1195. package/dist/lib/server/create-adcp-server.mjs +2 -1
  1196. package/dist/lib/server/decisioning/runtime/from-platform.js +12 -2
  1197. package/dist/lib/server/decisioning/runtime/from-platform.mjs +12 -2
  1198. package/dist/lib/server/responses.js +50 -3
  1199. package/dist/lib/server/responses.mjs +49 -3
  1200. package/dist/lib/server/test-controller.d.mts +9 -35
  1201. package/dist/lib/server/test-controller.d.ts +9 -35
  1202. package/dist/lib/server/test-controller.js +4 -0
  1203. package/dist/lib/server/test-controller.mjs +4 -0
  1204. package/dist/lib/testing/comply-controller.d.mts +7 -10
  1205. package/dist/lib/testing/comply-controller.d.ts +7 -10
  1206. package/dist/lib/testing/reporting/doctor.js +2 -1
  1207. package/dist/lib/testing/reporting/doctor.mjs +2 -1
  1208. package/dist/lib/testing/storyboard/account-policy.d.mts +42 -0
  1209. package/dist/lib/testing/storyboard/account-policy.d.ts +42 -0
  1210. package/dist/lib/testing/storyboard/account-policy.js +41 -2
  1211. package/dist/lib/testing/storyboard/account-policy.mjs +38 -1
  1212. package/dist/lib/testing/storyboard/path.d.mts +6 -0
  1213. package/dist/lib/testing/storyboard/path.d.ts +6 -0
  1214. package/dist/lib/testing/storyboard/path.js +22 -0
  1215. package/dist/lib/testing/storyboard/path.mjs +21 -0
  1216. package/dist/lib/testing/storyboard/request-builder.js +1 -1
  1217. package/dist/lib/testing/storyboard/request-builder.mjs +1 -1
  1218. package/dist/lib/testing/storyboard/runner.d.mts +1 -42
  1219. package/dist/lib/testing/storyboard/runner.d.ts +1 -42
  1220. package/dist/lib/testing/storyboard/runner.js +8 -38
  1221. package/dist/lib/testing/storyboard/runner.mjs +5 -35
  1222. package/dist/lib/testing/storyboard/seeding.js +152 -2
  1223. package/dist/lib/testing/storyboard/seeding.mjs +152 -2
  1224. package/dist/lib/testing/storyboard/types.d.mts +4 -2
  1225. package/dist/lib/testing/storyboard/types.d.ts +4 -2
  1226. package/dist/lib/testing/storyboard/types.js +1 -0
  1227. package/dist/lib/testing/storyboard/types.mjs +1 -0
  1228. package/dist/lib/testing/storyboard/validations.d.mts +1 -1
  1229. package/dist/lib/testing/storyboard/validations.d.ts +1 -1
  1230. package/dist/lib/testing/storyboard/validations.js +60 -1
  1231. package/dist/lib/testing/storyboard/validations.mjs +61 -1
  1232. package/dist/lib/v2/projection/creative-delivery.js +93 -48
  1233. package/dist/lib/v2/projection/creative-delivery.mjs +91 -47
  1234. package/dist/lib/version.d.mts +5 -5
  1235. package/dist/lib/version.d.ts +5 -5
  1236. package/dist/lib/version.js +4 -3
  1237. package/dist/lib/version.mjs +4 -3
  1238. package/docs/CLI.md +1 -1
  1239. package/docs/TYPE-SUMMARY.md +2 -2
  1240. package/docs/guides/BRAND-ENTRY-SELECTION.md +56 -0
  1241. package/docs/guides/CREATIVE-DELIVERY.md +15 -2
  1242. package/docs/guides/CREATIVE-PACKAGE-FIT.md +1 -1
  1243. package/docs/guides/REPORTING-LEDGER.md +148 -12
  1244. package/docs/guides/REPORTING-OPERATIONS.md +80 -10
  1245. package/docs/guides/VALIDATE-YOUR-AGENT.md +44 -0
  1246. package/docs/llms.txt +2 -2
  1247. package/docs/migration-14.x-rc-worksheet.md +5 -5
  1248. package/docs/migration-16-to-17.md +3 -3
  1249. package/docs/migration-account-change-feed.md +1 -1
  1250. package/docs/migration-reporting-row-storage-alignment.md +4 -2
  1251. package/docs/migration-reporting-storage-package.md +21 -1
  1252. package/package.json +3 -3
  1253. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/index.yaml +0 -0
  1254. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/distributed_brand_resolution.yaml +0 -0
  1255. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/signed_response_envelope_vectors.yaml +0 -0
  1256. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/brand/scenarios/single_side_trust_extension.yaml +0 -0
  1257. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/index.yaml +0 -0
  1258. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/asset_type_filtering.yaml +0 -0
  1259. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/billing_out_of_band.yaml +0 -0
  1260. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/canonical_supported_formats.yaml +0 -0
  1261. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_features_idempotency.yaml +0 -0
  1262. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/creative_revision_identity.yaml +0 -0
  1263. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/evaluator_auth.yaml +0 -0
  1264. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/list_creatives_filter_behavior.yaml +0 -0
  1265. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/native_in_feed.yaml +0 -0
  1266. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/native_localization.yaml +0 -0
  1267. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/creative/scenarios/policy_backed_rejections.yaml +0 -0
  1268. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/index.yaml +0 -0
  1269. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/scenarios/failed_outcome_audit_persistence.yaml +0 -0
  1270. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/governance/scenarios/property_list_change_webhook_signing.yaml +0 -0
  1271. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/index.yaml +0 -0
  1272. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/acceptance_policy_discovery.yaml +0 -0
  1273. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_change_feed.yaml +0 -0
  1274. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_buyer_selected.yaml +0 -0
  1275. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_seller_assigned.yaml +0 -0
  1276. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/account_timezone_seller_fixed.yaml +0 -0
  1277. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/advanced_delivery_reporting.yaml +0 -0
  1278. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/audience_activation_discovery.yaml +0 -0
  1279. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/audience_buy_flow.yaml +0 -0
  1280. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/availability_windows.yaml +0 -0
  1281. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/available_actions.yaml +0 -0
  1282. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/bidding_cost_binding.yaml +0 -0
  1283. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/bidding_policy_placement.yaml +0 -0
  1284. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/billing_finality_delivery.yaml +0 -0
  1285. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_account.yaml +0 -0
  1286. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_fixed.yaml +0 -0
  1287. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_override.yaml +0 -0
  1288. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/budget_cap_timezone_override_rejected.yaml +0 -0
  1289. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/canonical_formats.yaml +0 -0
  1290. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/catalog_item_availability_updates.yaml +0 -0
  1291. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/change_rights_state_projection.yaml +0 -0
  1292. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/clicks_buy_flow.yaml +0 -0
  1293. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/collection_selection.yaml +0 -0
  1294. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/compact_direct_buy_lifecycle.yaml +0 -0
  1295. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/compact_product_lifecycle.yaml +0 -0
  1296. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/completed_views_buy_flow.yaml +0 -0
  1297. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/create_media_buy_async.yaml +0 -0
  1298. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/create_media_buy_async_lifecycle.yaml +0 -0
  1299. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/creative_reception.yaml +0 -0
  1300. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/cross_path_targeting_provenance.yaml +0 -0
  1301. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/declined_proposal_execution.yaml +0 -0
  1302. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/declined_proposal_refinement.yaml +0 -0
  1303. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/delivery_reporting.yaml +0 -0
  1304. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/demographic_targeting.yaml +0 -0
  1305. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/dependency_impairment_audience.yaml +0 -0
  1306. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/event_dedup_flow.yaml +0 -0
  1307. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/expired_proposal_execution.yaml +0 -0
  1308. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/external_audience_source_binding.yaml +0 -0
  1309. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/frequency_cap_capability_updates.yaml +0 -0
  1310. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/frequency_cap_enforcement.yaml +0 -0
  1311. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_place_targeting.yaml +0 -0
  1312. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_all_values_support.yaml +0 -0
  1313. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_exclusion_support.yaml +0 -0
  1314. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/geo_region_targeting.yaml +0 -0
  1315. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/get_products_async.yaml +0 -0
  1316. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/get_products_rejected.yaml +0 -0
  1317. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_agent_binding_acceptance.yaml +0 -0
  1318. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_approved.yaml +0 -0
  1319. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_conditions.yaml +0 -0
  1320. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_denied.yaml +0 -0
  1321. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/governance_denied_recovery.yaml +0 -0
  1322. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inline_creatives_without_sync.yaml +0 -0
  1323. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inventory_list_no_match.yaml +0 -0
  1324. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/inventory_list_targeting.yaml +0 -0
  1325. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_accountability.yaml +0 -0
  1326. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/measurement_terms_accepted.yaml +0 -0
  1327. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/media_buy_frequency_cap_readback.yaml +0 -0
  1328. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/media_buy_frequency_cap_updates.yaml +0 -0
  1329. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/metric_container_subsumption.yaml +0 -0
  1330. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/outcome_target.yaml +0 -0
  1331. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/outcome_target_list_products_inert.yaml +0 -0
  1332. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/owner_sold_channel_carriage.yaml +0 -0
  1333. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/package_automatic_bidding.yaml +0 -0
  1334. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/package_correlation_legacy_fallback.yaml +0 -0
  1335. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/pending_creatives_to_start.yaml +0 -0
  1336. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/per_creative_conversion_attribution.yaml +0 -0
  1337. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/performance_buy_flow.yaml +0 -0
  1338. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/performance_buy_flow_roas.yaml +0 -0
  1339. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/portfolio_routing_scope.yaml +0 -0
  1340. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/pricing_currency_filter.yaml +0 -0
  1341. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_coverage_filters.yaml +0 -0
  1342. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_filter_behavior.yaml +0 -0
  1343. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/product_signal_targeting.yaml +0 -0
  1344. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_finalize.yaml +0 -0
  1345. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_finalize_asap_timing.yaml +0 -0
  1346. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/proposal_not_found_errors.yaml +0 -0
  1347. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_audit_observation.yaml +0 -0
  1348. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_enforcement.yaml +0 -0
  1349. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/provenance_truth_of_claim.yaml +0 -0
  1350. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/reach_buy_flow.yaml +0 -0
  1351. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/read_filter_behavior.yaml +0 -0
  1352. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_finalize_exclusivity.yaml +0 -0
  1353. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_frequency_cap_negotiation.yaml +0 -0
  1354. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/refine_products.yaml +0 -0
  1355. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/revenue_share_pricing.yaml +0 -0
  1356. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_budget.yaml +0 -0
  1357. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_min_spend_target_exceeds_package_cap.yaml +0 -0
  1358. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/seller_optimized_proposal_package_pacing.yaml +0 -0
  1359. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/targeting_aware_discovery.yaml +0 -0
  1360. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/total_budget_redistribution.yaml +0 -0
  1361. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/typed_proposal_negotiation.yaml +0 -0
  1362. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_accountability.yaml +0 -0
  1363. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_catalog_precondition.yaml +0 -0
  1364. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/scenarios/vendor_metric_optimization_flow.yaml +0 -0
  1365. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/media-buy/state-machine.yaml +0 -0
  1366. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/signals/index.yaml +0 -0
  1367. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/signals/scenarios/get_signals_async.yaml +0 -0
  1368. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/sponsored-intelligence/index.yaml +0 -0
  1369. /package/compliance/cache/{3.2.7 → 3.2.8}/protocols/sponsored-intelligence/sponsored-context-accountability.yaml +0 -0
  1370. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/audience-sync/index.yaml +0 -0
  1371. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/index.yaml +0 -0
  1372. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/governance_approved.yaml +0 -0
  1373. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/governance_denied.yaml +0 -0
  1374. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/brand-rights/scenarios/update_rights_lifecycle.yaml +0 -0
  1375. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-activation/index.yaml +0 -0
  1376. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-discovery/index.yaml +0 -0
  1377. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-monitoring/index.yaml +0 -0
  1378. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-negotiation/index.yaml +0 -0
  1379. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/buyer-recovery/index.yaml +0 -0
  1380. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/collection-lists/index.yaml +0 -0
  1381. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/content-standards/index.yaml +0 -0
  1382. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-ad-server/index.yaml +0 -0
  1383. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-generative/generative-seller.yaml +0 -0
  1384. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-generative/index.yaml +0 -0
  1385. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-template/index.yaml +0 -0
  1386. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/index.yaml +0 -0
  1387. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/scenarios/governance_approved.yaml +0 -0
  1388. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/creative-transformers/scenarios/governance_denied.yaml +0 -0
  1389. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-aware-seller/index.yaml +0 -0
  1390. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-aware-seller/scenarios/governance_multi_agent_rejected.yaml +0 -0
  1391. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-delivery-monitor/index.yaml +0 -0
  1392. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-spend-authority/denied.yaml +0 -0
  1393. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/governance-spend-authority/index.yaml +0 -0
  1394. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/orchestrator-multi-agent/index.yaml +0 -0
  1395. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/property-lists/index.yaml +0 -0
  1396. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-catalog-driven/index.yaml +0 -0
  1397. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-dooh/index.yaml +0 -0
  1398. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-exchange/index.yaml +0 -0
  1399. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-guaranteed/index.yaml +0 -0
  1400. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-non-guaranteed/index.yaml +0 -0
  1401. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-proposal-mode/index.yaml +0 -0
  1402. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-retail-media/index.yaml +0 -0
  1403. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-social/index.yaml +0 -0
  1404. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sales-streaming-tv/index.yaml +0 -0
  1405. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/index.yaml +0 -0
  1406. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/scenarios/governance_approved.yaml +0 -0
  1407. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-marketplace/scenarios/governance_denied.yaml +0 -0
  1408. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/signal-owned/index.yaml +0 -0
  1409. /package/compliance/cache/{3.2.7 → 3.2.8}/specialisms/sponsored-intelligence/index.yaml +0 -0
  1410. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/acme-outdoor-live.yaml +0 -0
  1411. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/acme-outdoor.yaml +0 -0
  1412. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/billing-gate-runner.yaml +0 -0
  1413. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/bistro-oranje.yaml +0 -0
  1414. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/creative-build-probe-runner.yaml +0 -0
  1415. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/distributed-brand-runner.yaml +0 -0
  1416. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/hosted-grader.yaml +0 -0
  1417. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/nova-motors.yaml +0 -0
  1418. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/oauth-setup-runner.yaml +0 -0
  1419. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/osei-natural.yaml +0 -0
  1420. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/parallel-dispatch-runner.yaml +0 -0
  1421. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/rate-limit-trip-runner.yaml +0 -0
  1422. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/signed-requests-runner.yaml +0 -0
  1423. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/signed-responses-runner.yaml +0 -0
  1424. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/single-side-trust-runner.yaml +0 -0
  1425. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/substitution-observer-runner.yaml +0 -0
  1426. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/summit-foods.yaml +0 -0
  1427. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/trusted-match-router-runner.yaml +0 -0
  1428. /package/compliance/cache/{3.2.7 → 3.2.8}/test-kits/webhook-receiver-runner.yaml +0 -0
  1429. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/attestations/README.md +0 -0
  1430. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/attestations/vectors.json +0 -0
  1431. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/audience-evidence/README.md +0 -0
  1432. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/audience-evidence/vectors.json +0 -0
  1433. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/brand-response-signing/brand-authorization-cross-check.json +0 -0
  1434. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/catalog-macro-substitution.json +0 -0
  1435. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/creative-representation-resolution.json +0 -0
  1436. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/creative-representation-resolution.schema.json +0 -0
  1437. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/error-recovery/README.md +0 -0
  1438. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/error-recovery/vectors.json +0 -0
  1439. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-authorization.json +0 -0
  1440. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-runtime-attestations/README.md +0 -0
  1441. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/governance-runtime-attestations/vectors.json +0 -0
  1442. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/macro-processing.json +0 -0
  1443. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/macro-processing.schema.json +0 -0
  1444. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/oauth-setup/vectors.json +0 -0
  1445. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/001-minimal-plan.json +0 -0
  1446. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/002-full-plan.json +0 -0
  1447. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/003-bookkeeping-stripped.json +0 -0
  1448. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/004a-human-review-omitted.json +0 -0
  1449. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/004b-human-review-explicit-null.json +0 -0
  1450. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/005a-policy-categories-order-1.json +0 -0
  1451. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/005b-policy-categories-order-2.json +0 -0
  1452. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/006a-ext-trace-v1.json +0 -0
  1453. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/006b-ext-trace-v2.json +0 -0
  1454. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/007-unicode-objectives.json +0 -0
  1455. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/plan-hash/008-numeric-canonicalization.json +0 -0
  1456. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/products-only-brief-compatibility/README.md +0 -0
  1457. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/products-only-brief-compatibility/vectors.json +0 -0
  1458. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/relationship-scoped-indicators.json +0 -0
  1459. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/README.md +0 -0
  1460. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/adjustment.json +0 -0
  1461. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/canonicalization.json +0 -0
  1462. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/coverage-aggregation.json +0 -0
  1463. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/manifest.json +0 -0
  1464. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/materialization.json +0 -0
  1465. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/obligation.json +0 -0
  1466. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-recorded-response.json +0 -0
  1467. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-request.json +0 -0
  1468. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/accepted-unchanged-response.json +0 -0
  1469. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/adjustment-accepted-recorded-response.json +0 -0
  1470. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/adjustment-accepted-request.json +0 -0
  1471. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/rejected-recorded-response.json +0 -0
  1472. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/receipts/rejected-request.json +0 -0
  1473. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/report-definition.json +0 -0
  1474. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/revision.json +0 -0
  1475. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/row-schema.json +0 -0
  1476. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/rows.jsonl +0 -0
  1477. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/scenario-index.json +0 -0
  1478. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-reconciliation/scenario-index.schema.json +0 -0
  1479. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/reporting-summary/complete-summary.json +0 -0
  1480. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/README.md +0 -0
  1481. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/001-unsigned-sendmessage-required.json +0 -0
  1482. /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
  1483. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/003-unsigned-sendstreamingmessage-required.json +0 -0
  1484. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/004-duplicate-invocation-datapart.json +0 -0
  1485. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/005-signed-duplicate-invocation-datapart.json +0 -0
  1486. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/006-missing-skill.json +0 -0
  1487. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/007-protocol-method-required-covers-sendmessage.json +0 -0
  1488. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/008-no-extension-header.json +0 -0
  1489. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/009-extra-non-invocation-datapart.json +0 -0
  1490. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/010-filepart-present.json +0 -0
  1491. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/011-part-with-text-and-data.json +0 -0
  1492. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/012-non-object-data.json +0 -0
  1493. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/013-v0-3-kind-mismatch.json +0 -0
  1494. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/014-duplicate-skill-key.json +0 -0
  1495. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/015-non-string-skill.json +0 -0
  1496. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/016-text-only-message.json +0 -0
  1497. /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
  1498. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/018-unresolvable-with-lone-signature-header.json +0 -0
  1499. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/019-raw-part-present.json +0 -0
  1500. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/020-case-variant-member-name.json +0 -0
  1501. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/021-escaped-duplicate-skill-key.json +0 -0
  1502. /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
  1503. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/023-batch-body.json +0 -0
  1504. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/024-duplicate-method-key.json +0 -0
  1505. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/025-missing-method.json +0 -0
  1506. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/negative/026-empty-skill.json +0 -0
  1507. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/001-signed-sendmessage-create-media-buy.json +0 -0
  1508. /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
  1509. /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
  1510. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/004-unsigned-decoy-text-and-metadata.json +0 -0
  1511. /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
  1512. /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
  1513. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/a2a/positive/007-unsigned-method-case-variant.json +0 -0
  1514. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/body-integrity-policy.json +0 -0
  1515. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/canonicalization.json +0 -0
  1516. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/keys.json +0 -0
  1517. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/001-no-signature-header.json +0 -0
  1518. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/002-wrong-tag.json +0 -0
  1519. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/003-expired-signature.json +0 -0
  1520. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/004-window-too-long.json +0 -0
  1521. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/005-alg-not-allowed.json +0 -0
  1522. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/006-missing-covered-component.json +0 -0
  1523. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/007-missing-content-digest.json +0 -0
  1524. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/008-unknown-keyid.json +0 -0
  1525. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/009-key-ops-missing-verify.json +0 -0
  1526. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/010-content-digest-mismatch.json +0 -0
  1527. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/011-malformed-header.json +0 -0
  1528. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/012-missing-expires-param.json +0 -0
  1529. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/013-expires-le-created.json +0 -0
  1530. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/014-missing-nonce-param.json +0 -0
  1531. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/015-signature-invalid.json +0 -0
  1532. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/016-replayed-nonce.json +0 -0
  1533. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/017-key-revoked.json +0 -0
  1534. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/018-digest-covered-when-forbidden.json +0 -0
  1535. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/019-signature-without-signature-input.json +0 -0
  1536. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/020-rate-abuse.json +0 -0
  1537. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/021-duplicate-signature-input-label.json +0 -0
  1538. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/022-multi-valued-content-type.json +0 -0
  1539. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/023-multi-valued-content-digest.json +0 -0
  1540. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/024-unquoted-string-param.json +0 -0
  1541. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/025-jwk-alg-crv-mismatch.json +0 -0
  1542. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/026-non-ascii-host.json +0 -0
  1543. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/027-webhook-registration-authentication-unsigned.json +0 -0
  1544. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/028-unsigned-protocol-method-required.json +0 -0
  1545. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/029-duplicate-signature-label.json +0 -0
  1546. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/030-content-digest-key-case.json +0 -0
  1547. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/negative/031-malformed-host-authority.json +0 -0
  1548. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/001-basic-post.json +0 -0
  1549. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/002-post-with-content-digest.json +0 -0
  1550. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/003-es256-post.json +0 -0
  1551. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/004-multiple-signature-labels.json +0 -0
  1552. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/005-default-port-stripped.json +0 -0
  1553. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/006-dot-segment-path.json +0 -0
  1554. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/007-query-byte-preserved.json +0 -0
  1555. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/008-percent-encoded-path.json +0 -0
  1556. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/009-percent-encoded-unreserved-decoded.json +0 -0
  1557. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/010-percent-encoded-slash-preserved.json +0 -0
  1558. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/011-ipv6-authority.json +0 -0
  1559. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/012-ipv6-authority-default-port-stripped.json +0 -0
  1560. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/013-two-signature-labels-distinct.json +0 -0
  1561. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/014-content-digest-two-algorithms.json +0 -0
  1562. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/positive/015-bracketed-ipv6-host-with-port.json +0 -0
  1563. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/001-base64url-sf-binary.json +0 -0
  1564. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/001-no-signature-header.json +0 -0
  1565. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/002-multiple-trailing-dots.json +0 -0
  1566. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/002-wrong-tag.json +0 -0
  1567. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/003-expired-signature.json +0 -0
  1568. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/004-window-too-long.json +0 -0
  1569. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/005-alg-not-allowed.json +0 -0
  1570. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/006-missing-covered-component.json +0 -0
  1571. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/007-missing-content-digest.json +0 -0
  1572. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/008-unknown-keyid.json +0 -0
  1573. /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
  1574. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/010-content-digest-mismatch.json +0 -0
  1575. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/011-malformed-header.json +0 -0
  1576. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/012-missing-expires-param.json +0 -0
  1577. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/013-expires-le-created.json +0 -0
  1578. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/014-missing-nonce-param.json +0 -0
  1579. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/015-signature-invalid.json +0 -0
  1580. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/016-replayed-nonce.json +0 -0
  1581. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/017-key-revoked.json +0 -0
  1582. /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
  1583. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/020-rate-abuse.json +0 -0
  1584. /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
  1585. /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
  1586. /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
  1587. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/024-unquoted-string-param.json +0 -0
  1588. /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
  1589. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/026-non-ascii-host.json +0 -0
  1590. /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
  1591. /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
  1592. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/029-duplicate-signature-label.json +0 -0
  1593. /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
  1594. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/negative/031-malformed-host-authority.json +0 -0
  1595. /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
  1596. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/003-es256-post.json +0 -0
  1597. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/004-multiple-signature-labels.json +0 -0
  1598. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/005-default-port-stripped.json +0 -0
  1599. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/006-dot-segment-path.json +0 -0
  1600. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/007-query-byte-preserved.json +0 -0
  1601. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/008-percent-encoded-path.json +0 -0
  1602. /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
  1603. /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
  1604. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/profile-3.2/positive/011-ipv6-authority.json +0 -0
  1605. /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
  1606. /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
  1607. /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
  1608. /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
  1609. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/request-signing/protocol-method-names.json +0 -0
  1610. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/rights-attestations/README.md +0 -0
  1611. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/rights-attestations/vectors.json +0 -0
  1612. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/supply-path/README.md +0 -0
  1613. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/supply-path/vectors.json +0 -0
  1614. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/tracker-execution-contracts.json +0 -0
  1615. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/tracker-execution-contracts.schema.json +0 -0
  1616. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/trusted-match-context-merge/README.md +0 -0
  1617. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/trusted-match-context-merge/vectors.json +0 -0
  1618. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/universal-macro-translation.json +0 -0
  1619. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/universal-macro-translation.schema.json +0 -0
  1620. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-receiver-envelope.json +0 -0
  1621. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/README.md +0 -0
  1622. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/keys.json +0 -0
  1623. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/001-wrong-tag.json +0 -0
  1624. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/002-expired-signature.json +0 -0
  1625. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/003-window-too-long.json +0 -0
  1626. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/004-alg-not-allowed.json +0 -0
  1627. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/005-missing-authority-component.json +0 -0
  1628. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/006-missing-content-digest.json +0 -0
  1629. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/007-unknown-keyid.json +0 -0
  1630. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/008-wrong-adcp-use.json +0 -0
  1631. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/009-content-digest-mismatch.json +0 -0
  1632. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/010-malformed-signature-input.json +0 -0
  1633. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/011-signature-without-input.json +0 -0
  1634. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/012-missing-expires-param.json +0 -0
  1635. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/013-expires-le-created.json +0 -0
  1636. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/014-missing-nonce-param.json +0 -0
  1637. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/015-signature-invalid.json +0 -0
  1638. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/016-replayed-nonce.json +0 -0
  1639. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/017-key-revoked.json +0 -0
  1640. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/018-rate-abuse.json +0 -0
  1641. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/019-revocation-stale.json +0 -0
  1642. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/020-key-ops-missing-verify.json +0 -0
  1643. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/negative/021-base64-alphabet-mixing.json +0 -0
  1644. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/001-basic-post.json +0 -0
  1645. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/002-es256-post.json +0 -0
  1646. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/003-multiple-signature-labels.json +0 -0
  1647. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/004-default-port-stripped.json +0 -0
  1648. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/005-percent-encoded-path.json +0 -0
  1649. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/006-query-byte-preserved.json +0 -0
  1650. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/007-body-without-idempotency-key.json +0 -0
  1651. /package/compliance/cache/{3.2.7 → 3.2.8}/test-vectors/webhook-signing/positive/008-request-signing-key-reuse.json +0 -0
  1652. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/account-identity-reconciliation.yaml +0 -0
  1653. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/agent-notification-configs.yaml +0 -0
  1654. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/billing-gate-dispatch.yaml +0 -0
  1655. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/buyer-fixture-publisher.yaml +0 -0
  1656. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/buyer-orchestrator-track.yaml +0 -0
  1657. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/canonical-format-validate-input.yaml +0 -0
  1658. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/capability-discovery.yaml +0 -0
  1659. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/collection-lists-pagination-integrity.yaml +0 -0
  1660. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/comply-controller-mode-gate.yaml +0 -0
  1661. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/content-standards-pagination-integrity.yaml +0 -0
  1662. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/ctv-experience-validate-input.yaml +0 -0
  1663. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/deterministic-testing.yaml +0 -0
  1664. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/error-compliance-signals.yaml +0 -0
  1665. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/error-compliance.yaml +0 -0
  1666. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/fictional-entities.yaml +0 -0
  1667. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-media-buys-pagination-integrity.yaml +0 -0
  1668. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-products-pagination-integrity.yaml +0 -0
  1669. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/get-signals-pagination-integrity.yaml +0 -0
  1670. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/governance.yaml +0 -0
  1671. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/idempotency.yaml +0 -0
  1672. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-event-scope.yaml +0 -0
  1673. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-lifecycle.yaml +0 -0
  1674. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/notification-config-rejections.yaml +0 -0
  1675. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/oauth-setup.yaml +0 -0
  1676. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity-creative-formats.yaml +0 -0
  1677. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity-list-accounts.yaml +0 -0
  1678. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/pagination-integrity.yaml +0 -0
  1679. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/premium-display-canonical-validation.yaml +0 -0
  1680. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/principal.yaml +0 -0
  1681. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/property-lists-pagination-integrity.yaml +0 -0
  1682. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/read-tool-idempotency.yaml +0 -0
  1683. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reliable-reporting-managed-delivery.yaml +0 -0
  1684. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reliable-reporting-reconciled-billing.yaml +0 -0
  1685. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-consumer-status.yaml +0 -0
  1686. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-core-declaration.yaml +0 -0
  1687. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/reporting-core.yaml +0 -0
  1688. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/runner-output-contract.yaml +0 -0
  1689. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/schema-validation-signals.yaml +0 -0
  1690. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/schema-validation.yaml +0 -0
  1691. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/security.yaml +0 -0
  1692. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/signed-requests.yaml +0 -0
  1693. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/trusted-match-publisher-authentication.yaml +0 -0
  1694. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/v3-envelope-integrity.yaml +0 -0
  1695. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/v4-compatibility.yaml +0 -0
  1696. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/version-negotiation.yaml +0 -0
  1697. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/webhook-emission.yaml +0 -0
  1698. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/webhook-receiver-envelope.yaml +0 -0
  1699. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-bulk-webhooks.yaml +0 -0
  1700. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-product-webhooks.yaml +0 -0
  1701. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-products-scope-isolation.yaml +0 -0
  1702. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-products.yaml +0 -0
  1703. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signal-webhooks.yaml +0 -0
  1704. /package/compliance/cache/{3.2.7 → 3.2.8}/universal/wholesale-feed-signals-scope-isolation.yaml +0 -0
  1705. /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/build-creative-request.json","title":"Build Creative Request","description":"Request to transform, generate, resolve, refine, or retrieve a creative manifest. Supports five modes: (1) generation from a brief or seed assets, (2) transformation of an existing manifest, (3) deterministic seller-bound selection from a pre-binding CreativeRepresentationSet, (4) refinement of a prior produced variant via refine_from_build_variant_id, and (5) retrieval from a creative library by creative_id. Produces target manifest(s) through canonical capabilities advertised in `get_adcp_capabilities.creative.supported_formats[]`. CreativeRepresentationSet input is a non-generative, single-output mode available only on the destination sales agent and additionally requires `creative.representation_resolution.supported: true`. In 3.2, provide `target_capability_id` for one output or `target_capability_ids` for multiple outputs. Legacy named-format selectors remain accepted during the 3.x compatibility window but are deprecated.","x-tool-summary":"Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities.","type":"object","x-mutates-state":true,"x-governed-commitment":{"scope":"conditional","triggers":["incurs_vendor_cost"],"exemptions":["estimate","zero_cost_retrieval"],"precedence":"trigger_overrides_exemption"},"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 when this creative execution incurs vendor cost.","minLength":1,"maxLength":4096,"pattern":"^[\\x20-\\x7E]+$"},"message":{"type":"string","description":"Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes."},"creative_manifest":{"$ref":"#/$defs/external:core~1creative-manifest.json","description":"Creative manifest to transform or generate from. On the canonical 3.2 path it carries `format_kind`, optional `format_option_ref`, and the required input assets. For transformation (for example resizing or reformatting), this is the complete creative to adapt. When creative_id is provided, the agent resolves the creative from its library and this field is ignored."},"creative_representation_set":{"$ref":"#/$defs/external:core~1creative-representation-set.json","description":"Complete creative revision containing equivalent trafficking representations, of which exactly one is selected for this seller-bound output. This mode is accepted only by the destination sales agent and requires representation_destination plus representation_selection_strategy. The target capability selects the seller's build route; representation_destination supplies the binding inventory contract. The resolver verifies revision_content_digest against the complete set, retains every representation unchanged, selects exactly one compatible representation, and returns a manifest carrying representation_selection. If macro_values is present, selection happens first and binding affects only the derived output; the retained representation set and its revision binding never change. When none is compatible, the request fails with CREATIVE_REPRESENTATION_UNRESOLVED and one representation_rejections entry per candidate."},"representation_destination":{"$ref":"#/$defs/external:core~1representation-destination.json","description":"Seller-owned product and effective format context for representation resolution. Required only with creative_representation_set and meaningful only when this endpoint is the destination sales agent."},"representation_selection_strategy":{"$ref":"#/$defs/external:enums~1representation-selection-strategy.json","description":"Deterministic strategy to apply after compatibility filtering. Required with creative_representation_set and MUST be advertised by creative.representation_resolution.strategies."},"creative_id":{"type":"string","description":"Reference to a creative in the agent's library. The creative agent resolves this to a manifest from its library. Use this instead of creative_manifest when retrieving an existing creative for tag generation or format adaptation.","x-entity":"creative"},"concept_id":{"type":"string","description":"Creative concept containing the creative. Creative agents SHOULD assign globally unique creative_id values; when they cannot guarantee uniqueness, concept_id is REQUIRED to disambiguate."},"media_buy_id":{"type":"string","description":"Media buy identifier for tag generation context. When the creative agent is also the ad server, this provides the trafficking context needed to generate placement-specific tags (e.g., CM360 placement ID). Not needed when tags are generated at the creative level (most creative platforms).","x-entity":"media_buy"},"package_id":{"type":"string","description":"Package identifier within the media buy. Used with media_buy_id when the creative agent needs line-item-level context for tag generation. Omit to get a tag not scoped to a specific package.","x-entity":"package"},"target_format_id":{"$ref":"#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format selector. Use `target_capability_id` with a value advertised in `get_adcp_capabilities.creative.supported_formats[].capability_id`."},"target_format_ids":{"type":"array","items":{"$ref":"#/$defs/external:core~1format-id.json"},"minItems":1,"maxItems":50,"deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format selectors. Use `target_capability_ids` with values advertised in `get_adcp_capabilities.creative.supported_formats[].capability_id`."},"target_capability_id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Canonical 3.2 single-output selector. Matches exactly one `get_adcp_capabilities.creative.supported_formats[].capability_id` advertised by this creative agent. The matched entry supplies the canonical `format` declaration used to validate inputs and the returned manifest. Mutually exclusive with `target_capability_ids` and the deprecated target_format_id fields."},"target_capability_ids":{"type":"array","items":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$"},"minItems":1,"maxItems":50,"uniqueItems":true,"description":"Canonical 3.2 multi-output selector. Each value matches a `get_adcp_capabilities.creative.supported_formats[].capability_id`. The creative agent produces one canonical manifest per capability in request order. Mutually exclusive with `target_capability_id` and the deprecated target_format_id fields."},"transformer_id":{"type":"string","x-entity":"transformer","description":"Selects an account-scoped transformer (discovered via list_transformers) to perform the build. One transformer per call. When present, the build uses this transformer and target_capability_id/target_capability_ids select which of its outputs to produce — they MUST be a subset of the transformer's output_capability_ids. Deprecated target_format_id fields use the legacy output_format_ids compatibility path. Render configuration goes in `config`."},"config":{"type":"object","description":"Typed render configuration for the selected transformer, keyed by each param's `field` (from the transformer's params[] in list_transformers). Example: { \"voice\": \"isaac\", \"speaking_rate\": 1.1, \"mastering_preset\": \"podcast\" }. The agent MUST validate `config` against the transformer's live params for this account and reject unrecognized keys and out-of-range / non-enumerated values with a field-attributed error (e.g. `config.voice`) rather than silently ignoring them — config drives a paid render. Genuinely vendor-specific or experimental knobs not declared as params belong in `ext`, not here. (The schema leaves this object open because legal keys are dynamic per transformer; strict validation is a normative agent obligation.) When `refine_from_build_variant_id` is set, `config` is applied as a DELTA over the parent leaf's config.","additionalProperties":true},"refine_from_build_variant_id":{"type":"string","x-entity":"build_variant","description":"Refine a previously produced variant and return new lineage-linked variants. The transformer and target capability are inherited from the parent leaf. A refinement request MUST omit transformer_id, target_capability_id(s), and deprecated target_format_id(s); changing transformer or output format is a new transformation build, not refinement. Requires creative.supports_refinement."},"mode":{"type":"string","enum":["execute","estimate"],"default":"execute","description":"`execute` (default) produces and bills the creative(s). `estimate` is a DRY RUN: the agent produces nothing and bills nothing, and returns a BuildCreativeEstimate with a projected cost band (cost_low/cost_high) computed against THIS request's actual inputs (script length, brief, catalog size, max_creatives × max_variants) — the band the buyer cannot derive itself, since per_unit gives the rate but not the unit count. Requires the agent to advertise `creative.supports_spend_controls`; otherwise rejected with `UNSUPPORTED_FEATURE`."},"max_spend":{"type":"object","description":"Hard per-call spend ceiling. The agent produces leaves until the NEXT leaf would push the run's aggregate vendor_cost over `amount`, then STOPS and returns the partial BuildCreativeVariantSuccess produced so far with `budget_status: \"capped\"` (every returned leaf is real, trafficable, and billed — nothing produced is discarded; the leaf shortfall is `leaves_returned` < `leaves_total`). If even the first leaf would exceed the cap, the call fails with BUDGET_CAP_REACHED. `currency` MUST match the rate card's currency (the agent does not FX-convert) or the request is rejected with INVALID_REQUEST (error.field `max_spend.currency`). Requires `creative.supports_spend_controls`. Caps a SINGLE call — to bound a refinement loop, track aggregate vendor_cost across calls and stop issuing them (buyer responsibility in this revision). max_spend bounds only build-time vendor_cost: CPM-priced builds (estimate basis `cpm_deferred`) have build-time vendor_cost 0 and accrue at serve time, so max_spend never engages for them — bound a CPM fan-out with max_creatives instead.","properties":{"amount":{"type":"number","minimum":0,"description":"Maximum aggregate vendor_cost to incur on this call, in `currency`."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency; MUST match the rate card."}},"required":["amount","currency"],"additionalProperties":true},"max_creatives":{"type":"integer","minimum":1,"description":"Caps how many DISTINCT creatives to produce along the catalog/item fan-out axis — one creative per catalog item. Use it to sample a large catalog (e.g. send 150 job openings, set max_creatives: 5 to preview five). Distinct from item_limit, which caps how many catalog items a SINGLE creative consumes (DCO-style). Omitted with a catalog input means one creative per item up to the catalog/format bound; omitted without a catalog collapses to a single creative. Large fan-outs may return asynchronously. Mutually exclusive with `refine_from_build_variant_id` (refinement targets one prior creative, not a catalog fan-out). Supported only when the agent advertises `creative.multiplicity.supports_catalog_fanout`; values above `max_creatives_limit` are clamped. Pair with `max_spend` to bound the bill of a large fan-out."},"signal_conditions":{"type":"array","x-status":"experimental","minItems":1,"items":{"allOf":[{"$ref":"#/$defs/external:core~1signal-targeting.json"},{"properties":{"signal_agent_segment_id":{"type":"string","x-entity":"signal_activation_id","description":"Optional opaque resolved-segment handle for this fan-out condition — the RESOLVED condition identity, distinct from signal_ref's DEFINITION identity. When get_signals or a product signal_targeting_options entry exposed a signal_agent_segment_id for the targeted signal, echo it here verbatim so the produced creative's signal_condition carries the resolved-segment identity that the trafficking-compatibility check (SIGNAL_TARGETING_INCOMPATIBLE) matches on exactly. Providers MAY namespace it (e.g. provider_a:weather:rain_realtime vs provider_b:precip:high) so cross-provider conditions stay distinct without a shared taxonomy registry; treat as opaque, do not parse the namespace for business logic. Prefer it over reconstructing condition identity from categorical values — categorical {signal_ref,value} identity is the weaker fallback, appropriate only for inherently-categorical signals with no resolved handle, and never a cross-provider equivalence claim."}}}]},"x-entity":"signal","description":"Advisory keep-all PRODUCTION axis: produce one distinct creative group per signal condition, each kept and trafficked with its own signal targeting (e.g. a rain creative AND a sun creative). Sibling to max_creatives (catalog axis), NOT a variant_axis value (which is choose-among). Each item reuses SignalTargeting (value_type-discriminated binary/categorical/numeric over signal_ref) so the produced group's signal_condition resolves condition identity through the SAME schema the sales-side package targeting uses, plus an optional signal_agent_segment_id carrying the RESOLVED-segment identity (vs signal_ref's definition identity) — echo a provider-exposed handle verbatim; it is the primary trafficking-compatibility key, with categorical signal_ref+value as the weaker fallback. Per #5280 this is an ADVISORY context pointer — it informs production and MUST NOT hard-block at the build_creative layer; trafficking-compatibility (a sun creative MUST NOT serve into rain-targeted packages) is enforced reject-at-trafficking on the sales side (SIGNAL_TARGETING_INCOMPATIBLE), not here. Triggers the BuildCreativeVariantSuccess shape. Supported only when the agent advertises creative.multiplicity.supports_signal_fanout; condition counts above max_signal_conditions_limit are CLAMPED (not rejected), consistent with max_creatives. Composes with max_creatives (catalog × conditions cross-product) and max_variants (variants per group)."},"max_variants":{"type":"integer","minimum":1,"default":1,"description":"Caps how many ALTERNATIVES to produce per creative (different voices, themes, best-of-N, etc.). Default 1 preserves single-output behavior. Each variant is a real, independently-billed build (you pay for all produced); the buyer keeps one or many. When variant_axis.values[] is provided, its length is authoritative over max_variants. Resolutions/quality tiers are NOT variants — request them as additional target formats."},"variant_axis":{"type":"object","description":"Declares the dimension along which variants differ. When `values` is provided, the agent produces exactly one variant per value (e.g. an A/B of two voices). When only `dimension` is provided, the agent chooses up to max_variants variants along that dimension (e.g. best-of-N, themes).","properties":{"dimension":{"type":"string","enum":["voice","theme","best_of_n","transformer_config","custom"],"description":"What varies across variants. `transformer_config` varies a named config param (name it in `field`); `best_of_n` lets the agent explore and rank; `custom` is agent-defined (describe in `label`)."},"field":{"type":"string","description":"The transformer `config` param `field` this axis sweeps. REQUIRED when `dimension` is `transformer_config`; `values[]` are then interpreted as values for `config[field]`. Omit for other dimensions."},"values":{"type":"array","description":"Caller-fixed set of values for the axis (e.g. [\"isaac\", \"sara\"] for dimension `voice`). When present, len(values) is the variant count and is authoritative over max_variants.","items":{},"minItems":1},"label":{"type":"string","description":"Human-readable description of the axis, especially for `custom`."}},"required":["dimension"],"additionalProperties":true},"keep_mode":{"type":"string","enum":["keep_all","keep_one","keep_some"],"default":"keep_all","description":"Advisory hint for how the buyer intends to use the variants. `keep_one` (best-of-N) and `keep_some` signal the agent to set `recommended`/`rank` on returned variants. Advisory only — it does not change what is returned or billed; every produced variant is returned and charged. Keeping is a client act of trafficking the chosen build_variant_id(s)."},"selection_strategy":{"$ref":"#/$defs/external:enums~1creative-selection-strategy.json","x-status":"experimental","description":"Governs HOW the agent samples when max_creatives < items_total (folds #5262). audience_relevance draws its ranking input from the SAME signal_ref pointers in signal_conditions / package targeting — NOT a parallel signals[] array. proximity takes a location input (geo shape TBD — WG open). inventory_priority is seller-side catalog metadata (margin/overstock/promo; no buyer input). random is the status-quo default. Per-creative selection ordering surfaces on the existing rank / recommended fields of creatives[].variants[], not a new selection_rank. Advisory; absent => agent default (random)."},"account":{"$ref":"#/$defs/external:core~1account-ref.json","description":"Account reference for pricing and billing. When present, the creative agent applies account-specific pricing from the rate card, records the build against the account for billing, and can enforce account-level quotas or entitlements. Required by creative agents that charge for their services."},"brand":{"$ref":"#/$defs/external:core~1brand-ref.json","description":"Brand reference for creative generation. Resolved to full brand identity (colors, logos, tone) at execution time."},"quality":{"$ref":"#/$defs/external:enums~1creative-quality.json","description":"Quality tier for generation. 'draft' produces fast, lower-fidelity output for iteration and review. 'production' produces full-quality output for final delivery. If omitted, the creative agent uses its own default. For non-generative transforms (e.g., format resizing), creative agents MAY ignore this field."},"evaluator":{"$ref":"#/$defs/external:core~1evaluator-spec.json","x-status":"experimental","description":"Optional advisory evaluator (buyer-attached pointer, #5280) declaring how produced variants should be evaluated and ranked — the rank-side of the get_creative_features feature oracle. Experimental (x-status: experimental): the whole evaluator surface is new and unfrozen, and requires creative.supports_evaluator, which sellers MUST pair with `creative.evaluator` in experimental_features. Drives the producing agent's gate-then-rank pipeline over its best_of_n exploration: per leaf, evaluate (the chosen form) → optionally GATE (`evaluator.feature_requirement[]`, drop fails — internal pruning of which leaves the agent recommends, never an AdCP-layer block of an already-produced billable leaf) → RANK survivors (`evaluator.rank_by`, an explicit {feature_id, direction} ordering). Feature discovery uses get_adcp_capabilities governance.creative_features for rank_by, feature_requirement, and eval.features[]; evaluator_id is a pre-provisioned/account-arranged preset, not an ID discovered from that catalog. Populates a per-leaf `eval` block of creative-feature values (creative-feature-result[]) when supports_evaluator. When the evaluator names an external agent (`evaluator.feature_agent.agent_url` or the agent-form `agent_url`), that agent MUST appear in the seller's `creative_policy.accepted_verifiers[]` (the same allowlist #5280 established for provenance verify_agent); an off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED`. The outbound evaluator call authenticates on the transport (request signing/JWKS, mTLS, or a pre-provisioned static credential); credentials and caller-supplied trust material MUST NOT appear in evaluator, context, ext, or creative payload fields, and credential- or trust-material keys should be rejected with `CREDENTIAL_IN_ARGS`. With no `feature_requirement`, evaluation is advisory only and does not change what is produced or billed; an unreachable/unknown on-list agent degrades to seller-default ranking (advisory errors[] note), not a failure. Requires creative.supports_evaluator; otherwise ignored."},"item_limit":{"type":"integer","minimum":1,"description":"Maximum number of catalog items a SINGLE creative consumes when generating (DCO-style — e.g. how many items fill one carousel/feed creative). When a catalog asset contains more items than this limit, the creative agent selects the top items based on relevance or catalog ordering. When item_limit exceeds the format's max_items, the creative agent SHOULD use the lesser of the two. Ignored when the manifest contains no catalog assets. Distinct from `max_creatives`, which fans OUT across catalog items to produce one distinct creative per item."},"include_preview":{"type":"boolean","description":"When true, requests the creative agent to include preview renders in the response alongside the manifest. Agents that support this return a 'preview' object in the response using the same structure as preview_creative. Agents that do not support inline preview simply omit the field. This avoids a separate preview_creative round trip for platforms that generate previews as a byproduct of building."},"preview_inputs":{"type":"array","description":"Input sets for preview generation when include_preview is true. Supported with a single target_capability_id; multi-capability requests generate one default preview per output. Deprecated target-format selectors retain equivalent compatibility behavior.","items":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable name for this input set (e.g., 'Sunny morning on mobile', 'Evening podcast ad')"},"macros":{"type":"object","description":"Macro values to use for this preview variant","additionalProperties":{"type":"string"}},"context_description":{"type":"string","description":"Natural language description of the context for AI-generated content"}},"required":["name"],"additionalProperties":true},"minItems":1},"preview_quality":{"$ref":"#/$defs/external:enums~1creative-quality.json","description":"Render quality for inline preview when include_preview is true. 'draft' produces fast, lower-fidelity renderings. 'production' produces full-quality renderings. Independent of the build quality parameter — you can build at draft quality and preview at production quality, or vice versa. If omitted, the creative agent uses its own default. Ignored when include_preview is false or omitted."},"preview_output_format":{"$ref":"#/$defs/external:enums~1preview-output-format.json","default":"url","description":"Output format for preview renders when include_preview is true. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML). Ignored when include_preview is false or omitted."},"macro_values":{"type":"object","description":"Raw concrete values offered for build-time binding, keyed by AdCP universal semantic (for example CLICK_URL or CACHEBUSTER). With declarations, a value binds only a verified-universal `resolve_value` occurrence performed_by `creative_agent`, using that declaration's exact context and encoding; callers MUST NOT pre-encode it. The selected `creative.supported_formats[]` route's macro_resolution_capabilities is the binding build/preview capability set; seller-wide and product sets apply only on the sales execution path. Values never short-circuit `translate_to_native`: translation emits its target declaration and the complete target capability chain remains required. For creative_representation_set, selection happens before binding and the complete representation set remains byte-identical. Without declarations, the 3.x legacy path remains: creative agents may translate recognized AdCP tokens using the existing `translateUniversalMacros` contract, preserve omitted placeholders for the sales agent, and ignore unknown keys. Existing unmapped/frozen-consent diagnostics remain required.","additionalProperties":{"type":"string"}},"idempotency_key":{"type":"string","description":"Client-generated unique key for this request. Prevents duplicate creative generation on retries. 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}$"},"push_notification_config":{"$ref":"#/$defs/external:core~1push-notification-config.json","description":"Optional webhook configuration for async terminal completion/failure notifications on build_creative. Meaningful only when the request enters the async lifecycle and returns a Submitted envelope. Submitted envelopes with `task_id` remain pollable through `get_task_status` (legacy `tasks/get`) whether or not this field is present. If a request includes this field and the agent returns a Submitted envelope, the agent MUST deliver at least the terminal completion/failure notification to the configured URL; intermediate progress notifications are MAY. If the agent cannot honor the webhook channel, it MUST reject the request with a structured error instead of silently accepting. This field does not change response timing semantics: agents MUST NOT route a request through the async/Submitted arm or emit async delivery solely because `push_notification_config` is present; requests that can be completed inline still return the synchronous success shape."},"context":{"$ref":"#/$defs/external:core~1context.json"},"ext":{"$ref":"#/$defs/external:core~1ext.json"}},"required":["idempotency_key"],"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/creative-manifest.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-manifest.json","title":"Creative Manifest","description":"Complete specification of a creative: format identification + assets. In 3.2 a manifest uses `format_kind` (the canonical format name it targets), paired with optional `format_option_ref` when a product has multiple declarations sharing that kind. The deprecated `format_id` named-format branch remains only for 3.x wire compatibility. Ordinary and shared assets live in `assets`; a `coordinated_placements` additionally namespaces each component's canonical slots under `component_assets.<component_id>`.","type":"object","properties":{"format_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format path retained for 3.x compatibility. New manifests use canonical `format_kind` and, when product routing requires it, `format_option_ref`. Mutually exclusive with format_kind."},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Canonical 3.2 path. The canonical format name this manifest targets (e.g., `image`, `video_hosted`, `audio_vast`, `seller_rendered_stateful_display`, `coordinated_placements`). Selects the contract against which the seller validates the manifest's assets. Mutually exclusive with deprecated `format_id`."},"format_option_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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 carries multiple `format_options` entries sharing the same `format_kind`; optional when `format_kind` alone routes the manifest 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/build-creative-request.json#/$defs/external:core~1representation-selection.json","description":"Present when this seller-bound manifest was selected from a CreativeRepresentationSet. Preserves creative, complete revision digest, and selected representation lineage through sync and reporting."},"assets":{"type":"object","description":"Map of slot keys to actual asset content. Legacy named-format path: each key matches an `asset_id` from the format's `assets` array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). 3.1+ canonical-format path: each key matches an `asset_group_id` from the format's `slots` declaration drawn from the canonical vocabulary registry (e.g., 'images_landscape', 'video', 'published_post', 'landing_page_url', 'vast_tag', 'script', 'creative_brief'). Either path produces the same envelope shape; only the slot-key vocabulary differs.\n\nEach slot value is **either** a single asset object (most slots — image, video, published_post, vast_tag, landing_page_url, etc.) **or** an array of asset objects (slots with `min`/`max` counts on the format declaration — `cards` on `image_carousel`, `headlines` / `descriptions` / `images_landscape` on `responsive_creative`, etc.). Single-vs-array shape is governed by the format's `slots[].min` and `slots[].max` parameters: when `max > 1` (or when the slot is conceptually a pool), the value MUST be an array; when the slot is single-valued, the value MUST be a single object. Each asset value (single or array element) carries an `asset_type` discriminator (image, video, audio, vast, daast, text, markdown, url, html, css, webhook, javascript, brief, catalog, published_post, zip, card) that selects the matching asset schema. Validators with OpenAPI-style discriminator support use `asset_type` to report errors against only the selected branch instead of all branches.","patternProperties":{"^[a-z0-9_]+$":{"oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":true},"component_assets":{"type":"object","description":"Component-addressed asset maps for `coordinated_placements`. Each key MUST match one `params.components[].component_id`; its value supplies that component's canonical slots. Shared assets remain in top-level `assets` and are injected only into components named by `shared_slots[].consumed_by`. This namespace allows two components to use the same canonical slot name, such as `image_main`, without collision. It MUST be absent for non-`coordinated_placements` manifests.","patternProperties":{"^[a-z][a-z0-9_]*$":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-assets.json"}},"additionalProperties":false},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1brand-ref.json","description":"Brand identity reference (BrandRef — `domain` plus optional `brand_id` for house-of-brands; plus optional inline `brand_kit_override` for per-creative tweaks where brand.json is missing/stale). When present, the seller pulls master brand identity (logo, palette, fonts, voice, and visual guidelines) from the brand's brand.json automatically; supported fields present in `brand_kit_override` take precedence, and all other master identity fields continue to come from brand.json. Catalogs supply product or item payload. Catalog item asset groups — including an item-level `logo` for a property or franchise — are item identity selected through format field bindings; they do not override brand.json's master logo or other brand identity fields. v2 formats no longer redeclare brand_logo / brand_colors / brand_voice as explicit slots — brand identity is implicit context."},"rights":{"type":"array","description":"Rights constraints attached to this creative. Buyer-carried fields are informational until a serving party evaluates an issuer-bound attestation reference under its own policy. Only a verified, unexpired, unrevoked, digest-matched evaluation can support serving authorization; verification_url is never authority.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1rights-constraint.json"}},"industry_identifiers":{"type":"array","description":"Industry-standard or market-specific identifiers for this specific manifest (e.g., Ad-ID, ISCI, Clearcast clock number, IDcrea). When present, overrides creative-level identifiers. Use when different format versions of the same source creative have distinct traffic identifiers (e.g., the :15 and :30 cuts, or separate TV and radio versions). 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/build-creative-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/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this creative manifest. Serves as the default provenance for all assets in this manifest. An asset with its own provenance replaces this object entirely (no field-level merging)."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1ext.json"}},"required":["assets"],"not":{"anyOf":[{"required":["capability_id"]},{"required":["capability_ref"]}]},"oneOf":[{"title":"Named-format manifest","deprecated":true,"description":"Deprecated 3.x compatibility branch. Manifest references a named format via the structured format_id object. New 3.2 manifests use format_kind.","required":["format_id"],"not":{"required":["format_kind"]}},{"title":"Canonical-format manifest","description":"Manifest declares which canonical format it targets via `format_kind` (e.g., `image`). This 3.1+ canonical-format path was introduced by RFC #3305.","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"]}}},{"$comment":"audio_vast is new in 3.2, so its VAST assets require an exact version without changing the additive compatibility of existing video_vast or named-format manifests.","if":{"properties":{"format_kind":{"const":"audio_vast"}},"required":["format_kind"]},"then":{"properties":{"assets":{"patternProperties":{".*":{"allOf":[{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}},{"if":{"type":"array"},"then":{"items":{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}}}}]}}}}}}],"additionalProperties":true},"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/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: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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1video-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1audio-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1vast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1display-tag-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1text-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1url-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1html-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1javascript-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1zip-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1webhook-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1css-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1daast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1markdown-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1brief-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1catalog-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1published-post-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1card-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1pixel-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1vast-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1daast-tracker-asset.json"}],"discriminator":{"propertyName":"asset_type"}},"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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:enums~1macro-resolver.json"},"encoding":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1catalog.json"}]},"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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/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: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/build-creative-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/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/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1platform-extension-ref.json"}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":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/build-creative-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/build-creative-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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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-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/build-creative-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/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/build-creative-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/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/build-creative-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/creative-representation-set.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-representation-set.json","title":"Creative Representation Set","description":"A complete buyer-authored revision containing one or more equivalent trafficking representations before seller binding. Exactly one compatible representation is selected for each seller-bound manifest. Representations are not rotation, A/B content, build variants, locale variants, or served variants.","x-adcp-validation":{"verifier_constraints":{"revision_identity":{"scope":["creative_id","revision_id"],"complete_preimage":"the complete CreativeRepresentationSet, never only the selected representation","canonical_content":"RFC 8785 JCS after removing exactly the top-level $schema, creative_id, revision_id, revision_content_digest, and name properties","unknown_fields":"included","array_order":"significant","duplicate_json_members":"reject before canonicalization","digest":"revision_content_digest MUST equal lowercase-hex SHA-256 of the canonical content","immutability":"reusing creative_id plus revision_id with a different digest or canonical content MUST fail with CREATIVE_REVISION_CONTENT_MISMATCH","equivalence_assertion":"the buyer asserts that all representations are equivalent; the digest proves set integrity, not semantic or rendered equivalence"}},"spec":"docs/creative/representation-sets.mdx#revision-identity"},"type":"object","properties":{"creative_id":{"type":"string","minLength":1,"x-entity":"creative","description":"Stable logical creative identifier across all representations and later seller-bound manifests."},"revision_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-revision-id.json","description":"Buyer-assigned immutable revision identity for this complete representation set. Changing any revision-bearing part of the set requires a new revision_id; selection does not."},"revision_content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"SHA-256 of the RFC 8785 JCS canonical revision content defined by this schema. The producer computes it over the complete representation set after removing exactly the top-level $schema, creative_id, revision_id, revision_content_digest, and name properties. `$schema` is transport/schema-location metadata and never mints creative content identity. Resolvers MUST recompute and reject a mismatch; selection readback carries the verified digest so downstream sellers bind the revision to the complete source set rather than only the selected manifest."},"name":{"type":"string","minLength":1},"representations":{"type":"array","minItems":1,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-representation.json"},"x-adcp-validation":{"unique_item_properties":["representation_id"]},"description":"Complete ordered set of equivalent representations. `representation_id` values MUST be unique within this array. Unsupported entries remain byte-for-byte unchanged; neither filtering nor selection changes this revision's canonical content."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Default provenance for every retained representation and for the selected seller-bound output unless a representation supplies a narrower provenance object."}},"required":["creative_id","revision_id","revision_content_digest","name","representations"],"additionalProperties":true},"external:core/creative-representation.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-representation.json","title":"Creative Representation","description":"One equivalent trafficking representation retained within a CreativeRepresentationSet before seller binding. `representation_id` is stable within its parent revision and identifies a representation, not rotation, A/B content, build output, locale, or a seller's served execution variant.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-manifest.json"},{"required":["format_kind"],"not":{"anyOf":[{"required":["format_id"]},{"required":["format_option_ref"]},{"required":["representation_selection"]}]}},{"$comment":"The opt-in late-bound VAST representation path requires one exact asset version. Existing video_vast and named-format CreativeManifest/CreativeAsset payloads retain additive 3.x compatibility; audio_vast is new in 3.2 and already requires the exact version in the base manifest.","if":{"properties":{"format_kind":{"enum":["video_vast","audio_vast"]}},"required":["format_kind"]},"then":{"properties":{"assets":{"patternProperties":{".*":{"allOf":[{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}},{"if":{"type":"array"},"then":{"items":{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}}}}]}}}}}}],"type":"object","properties":{"representation_id":{"type":"string","minLength":1,"pattern":"^[a-zA-Z0-9_-]+$","x-entity":"creative_representation","description":"Stable representation identifier, unique within the enclosing CreativeRepresentationSet revision."},"source":{"type":"object","properties":{"system":{"type":"string","minLength":1,"description":"Source system namespace."},"source_representation":{"type":"string","minLength":1,"description":"Source system's human-readable name for this representation."},"source_id":{"type":"string","description":"Optional immutable source-system identifier for this representation."}},"required":["system","source_representation"],"additionalProperties":true}},"required":["representation_id","source","format_kind"],"additionalProperties":true},"external:core/representation-destination.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/representation-destination.json","title":"Representation Destination","description":"Seller-owned inventory context against which a CreativeRepresentationSet is resolved. This object is valid only when build_creative is invoked on the destination sales agent. The seller resolves product_id to its current product, verifies that format_option is an exact current effective declaration for the requested placements, and intersects it with its own current seller-wide execution capabilities. A standalone creative agent cannot use this object to claim seller deliverability.","x-adcp-validation":{"verifier_constraints":{"seller_authority":"the build_creative endpoint MUST be the sales agent that owns product_id","current_product_match":"format_option MUST exactly match one effective current format option for product_id after every applicable placement and publisher narrowing","placement_scope":"when placement_refs is omitted, the representation must satisfy the common effective contract for every placement where the product may deliver","execution_intersection":"resolution additionally intersects the seller's current media_buy.execution.creative_specs VAST and macro ceilings; the request does not override those capabilities","tracker_execution_version":"when a candidate contains first-class vast_tracker or daast_tracker assets and no sibling VAST/DAAST delivery document supplies one exact version, the matching execution_*_version is required, MUST belong to the destination acceptance set, and MUST be preserved in representation_selection; the seller MUST NOT guess or defer it to a later package"},"spec":"docs/creative/representation-sets.mdx#seller-bound-resolution"},"type":"object","properties":{"product_id":{"type":"string","minLength":1,"x-entity":"product","description":"Product owned by the destination seller."},"format_option":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1product-format-declaration.json","description":"Exact effective destination declaration. The full declaration is carried so an option without format_option_id remains addressable. The destination seller verifies it against the current product and applicable placement/publisher narrowings."},"placement_refs":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1placement-ref.json"},"description":"Optional placements the derived manifest must satisfy. Omission means every placement in the intended product route, not an unconstrained destination."},"execution_vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json","description":"Exact VAST execution version selected for seller-assembled first-class VAST trackers when no sibling exact-version VAST document supplies it. Must be accepted by format_option and is preserved in selection lineage."},"execution_daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1daast-version.json","description":"Exact DAAST execution version selected for seller-assembled first-class DAAST trackers when no sibling exact-version DAAST document supplies it. Must be accepted by format_option and is preserved in selection lineage."}},"required":["product_id","format_option"],"additionalProperties":false},"external:core/product-format-declaration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/product-format-declaration.json","title":"Product Format Declaration","description":"Inline format declaration on a product. The `format_kind` discriminator names which canonical format the product narrows; `params` carries only the canonical creative-shape parameters (slots, dimensions, durations, codecs, character limits, platform_extensions, etc.). Processing metadata such as `macro_resolution_capabilities` belongs at this declaration's top level rather than inside `params`. Optional `format_option_id` (stable identifier for routing when a product's `format_options` contains multiple declarations sharing the same `format_kind`), optional `publisher_domain` (namespace for the format option when it comes from a publisher adagents.json catalog), `display_name` (seller-controlled human-readable label for dashboard and catalog UIs), and `applies_to_channels` (subset of the product's declared channels this declaration applies to — lets a multi-channel product carry distinct format_options per channel). Discriminated-union shape generates clean tagged unions in TypeScript and Pydantic codegen. Replaces v1's named-format pattern (where products referenced a separately-defined format file via compound `format_id`). Canonical product-bound declarations are the AdCP 3.2 authoring path; v1 named formats remain only as deprecated 3.x compatibility projections.\n\n**Closed-set semantics (normative).** `format_options[]` is the closed set of accepted formats for this product. Sellers MUST reject `create_media_buy` requests targeting any `format_kind` (or format option reference) not present in this list — typically with `UNSUPPORTED_FEATURE` or a seller-specific code; the rejection is structural, not negotiable. `seller_preference` modulates *within* the accepted set (a soft ranking hint between equally-acceptable options), it is NOT an enforcement axis. A product wanting to say 'this format is the only one that works' lists exactly that one entry in `format_options[]`; everything else falls outside the set and is rejected by the closed-set rule.\n\n**Format matching vs satisfaction (normative).** Legacy named formats MUST be normalized to canonical declarations before comparison; do not exact-match raw `(agent_url, id)` pairs once a `format_id` has been projected through `canonical`, `v1_format_ref`, or the canonical mapping registry. Equivalence matching can treat a legacy fixed-size display ID and `format_kind: \"image\"` with matching `width`/`height` as the same underlying shape. Product satisfaction is stricter and directional: when this declaration specifies fixed constraints such as `width`, `height`, `duration_ms_exact`, or `duration_ms_range`, a buyer request or creative manifest MUST declare and satisfy those constraints. A broad request with no dimensions or duration does not satisfy a fixed-size or fixed-duration product; a broad product MAY accept a more specific creative unless another product constraint excludes it. Duration precedence is `duration_ms_exact` > `duration_ms_range`. Range constraints use containment: a range-based request satisfies this declaration only when every value it permits falls within this declaration's accepted range; overlap alone is insufficient. An exact value satisfies a range when the exact value falls inside the accepted interval. For hosted audio/video, a null range endpoint is unbounded: [null, 60000] means up to 60s, and [15000, null] means at least 15s; [null, null] is invalid because at least one endpoint must be bounded.\n\n**Custom format_kind** (`format_kind: \"custom\"`): for adopter-defined shapes that don't fit the 15 canonicals (branded content, cross-screen sponsorship, sponsorship lockup, newsletter sponsorship, AR lens, playable, live event sponsorship). When `format_kind` is `custom`, the declaration MUST carry `format_shape` (recognized global pattern from the [format-shape vocabulary registry](/schemas/core/format-shape-vocabulary.json)) AND `format_schema` (URI+digest reference to a fetchable schema describing the actual `params` and `slots`). Buyer agents fetch the schema, validate manifests structurally, and reason about manifests without per-seller integration code. See [adcp#3666](https://github.com/adcontextprotocol/adcp/issues/3666) for the canonical promotion queue.","type":"object","required":["format_kind","params"],"discriminator":{"propertyName":"format_kind"},"properties":{"format_option_id":{"type":"string","description":"Stable identifier for this declaration within its namespace. REQUIRED when a product contains multiple declarations with the same format_kind and SHOULD be set on every entry. Publisher-backed options pair it with publisher_domain; product-local options omit publisher_domain. When a single declaration has a unique format_kind and no ID, buyers author canonically with format_kind plus params; they MUST NOT fall back to deprecated format_ids merely because this optional ID is absent. Examples: 'display_image_300x250', 'responsive_search', 'daily_pulse_homepage_image'."},"publisher_domain":{"type":"string","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","description":"Namespace for `format_option_id` when this declaration references or narrows a publisher-declared format option from that publisher's adagents.json top-level `formats[]`. Product-local options omit this field and are selected by `format_option_id` within the target product."},"tracker_execution_contract":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1tracker-execution-contract.json","description":"Seller- or publisher-authored commitment describing which first-class manifest trackers the selected format option accepts and initiates in production. The seller-returned Product declaration is binding; publisher and placement declarations are upstream inputs that the seller resolves into that effective contract. Presence requires a stable format_option_id. Creative-agent capability projections, transformer inputs, and deprecated canonical_parameters MUST reject this seller-authority field rather than copying it."},"macro_resolution_capabilities":{"type":"array","minItems":1,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1macro-resolution-capability.json"},"description":"Binding format-option processing capabilities for exact macro dialect identities, semantics, operations, actors, contexts, and encodings. Absence means undeclared, not supported on the opt-in declared-token path. Seller-wide capabilities are only a ceiling. This field does not claim that a buyer tracker asset is honored or fired.","x-adcp-validation":{"verifier_constraints":{"translation_chain_closure":"every translate_to_native entry must have an exact matching resolve_value entry for its translation_target in this same array"}}},"technical_requirements_complete":{"type":"boolean","description":"Completeness assertion for technical creative acceptance constraints in this declaration. When true, the declaring party asserts that every technical constraint within its authority is expressed by this declaration (including fetched custom-format and platform-extension schemas), and every omitted technical field means no constraint at that layer. A creative that satisfies the complete effective technical contract MUST NOT later be rejected for an undisclosed technical constraint. When false or absent, omitted technical constraints are undeclared: consumers MUST NOT interpret omission as support, no constraint, or a prose/default value. The effective product/placement contract is complete only when every applicable product, publisher, and placement declaration asserts true. This assertion is limited to technical acceptance; it does not waive policy, legal, security, malware, transport/fetch, corrupted-content, or materially misdeclared-asset checks. Creative size fields ending in `_kb` use exactly 1,000 bytes per KB and fields ending in `_mb` use exactly 1,000,000 bytes per MB."},"display_name":{"type":"string","description":"Optional seller-controlled human-readable label for this format declaration. Used by buyer dashboards, catalog UIs, and reporting surfaces to show a seller's own naming ('Homepage Takeover', 'Branded Canvas', 'Reels Premium Video') rather than the raw `format_kind` or `format_option_id`. Has no machine semantics — buyer agents route on `format_kind` and `format_option_id`; `display_name` is purely for human presentation. Freeform; no enumeration. Sellers SHOULD keep it stable once published to avoid dashboard churn."},"sample_render_url":{"type":"string","format":"uri","pattern":"^https://","description":"Optional public HTTPS page where a human can inspect a sample render of this declaration using assets chosen by the party publishing the enclosing declaration. Consumers MUST identify that source correctly: publisher or community mirror for `adagents.json` `formats[]`, seller for product or inline-placement declarations, and creative agent for `creative.supported_formats`. Informational only: this is not a renderer endpoint, buyer-asset preview, validation result, creative approval, proof of publisher acceptance, or guarantee of live delivery. Declaring parties SHOULD keep the URL stable while the declaration is active."},"applies_to_channels":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1channels.json"},"uniqueItems":true,"description":"Optional subset of the parent product's `channels` to which this declaration applies. When omitted, the declaration applies to ALL channels declared on the product. Lets a multi-channel product (e.g., `channels: ['display', 'video']`) carry distinct format_options per channel — `format_options: [{format_kind: 'image', applies_to_channels: ['display']}, {format_kind: 'video_hosted', applies_to_channels: ['video']}]`. Buyers ship channel-appropriate manifests per `applies_to_channels`."},"seller_preference":{"type":"string","enum":["preferred","accepted","discouraged"],"description":"Optional soft routing hint *within* a product's accepted set of formats — NOT an enforcement axis. `preferred` — seller actively recommends this format (often because of measurement, viewability, or render-quality differences); `accepted` — supported on equal footing with other format_options (default when omitted); `discouraged` — supported but suboptimal (e.g., legacy 3p-tag where the seller would prefer html5 for OM-SDK coverage). Buyer agents picking between format_options SHOULD respect seller preferences when their own constraints don't override.\n\n**Not an enforcement axis (normative).** `seller_preference` does NOT carry the meaning of 'this format won't work / required-only'. That case is structural: `format_options[]` IS the closed set of accepted formats; anything outside the list is rejected at `create_media_buy` regardless of preference. A seller that accepts only one format lists exactly that one entry — the structural fact does the enforcement work, no enum value needed. There is intentionally no `required` value; preference is bounded to *ranking within the already-accepted set*, not gating into it."},"locale_policy":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-locale-policy.json","description":"Optional seller-enforced creative-locale constraint for this format option. This is product/placement eligibility, not a new format kind or synthetic locale-specific format ID. Because legacy format_ids cannot preserve this constraint, declarations carrying locale_policy MUST set canonical_formats_only to true and MUST NOT carry v1_format_ref."},"canonical_formats_only":{"type":"boolean","default":false,"description":"When true, this format declaration has no clean v1 projection and SDKs MUST NOT synthesize a v1 `format_id` for it. Buyers reading the product on the v1 wire path see this declaration absent from `format_ids`; only v2-aware buyers (reading `format_options`) discover it. Set explicitly for `format_kind: \"custom\"` declarations (no canonical exists in v1 to project onto) and for declarations whose canonical/parameter shape cannot round-trip through a v1 named format without semantic loss. The protocol does NOT mint synthetic v1 format_ids for unmappable declarations — the alternative (an `aao-synth/*` namespace populated automatically) was considered and rejected because adopters would index on synthetic IDs that have no stable identity. Producers SHOULD set `canonical_formats_only: true` rather than omit the declaration from `format_options` — explicit v2-only is more useful than silent absence."},"experimental":{"type":"boolean","default":false,"description":"When true, this seller's specific canonical declaration may not work as declared even if the underlying canonical is stable. Buyers SHOULD preflight it with validate_input or in a sandbox before routing production budget and SHOULD filter it from default views unless the caller opts in. Experimental status never makes the deprecated named-format path preferable. This field is independent of the canonical's own experimental flag and replaces the earlier runtime_status enum."},"format_shape":{"type":"string","description":"REQUIRED when `format_kind: \"custom\"`; otherwise MUST be absent. Recognized global pattern this custom shape is an instance of, drawn from the [format-shape vocabulary registry](/schemas/core/format-shape-vocabulary.json) (`branded_content`, `cross_screen_sponsorship`, `sponsorship_lockup`, `newsletter_sponsorship`, `ar_lens`, `playable`, `live_event_sponsorship`, …). Non-canonical values are valid (validators MAY soft-warn) — adopters CAN ship a shape that isn't yet in the registry. Adding entries is a vocabulary PR. Once a `format_shape` entry sees 2+ adopters with substantively similar `format_schema` content for 90+ days, the working group may promote it to a first-class canonical. Retired vocabulary entries `multi_state_display` and `multi_placement_takeover` remain temporarily recognizable for migration; new declarations MUST use their promoted canonicals and validators SHOULD emit `FORMAT_SHAPE_PROMOTED`. `roadblock` remains an inventory/exclusivity classifier and is not a promoted creative format."},"v1_format_ref":{"type":"array","minItems":1,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-id.json"},"description":"Authoritative v2 → v1 link, expressed as an array of one or more v1 `format_id` ({agent_url, id}) values. Each entry asserts that this canonical-formats declaration IS the same underlying format as the referenced v1 named format. Always an array (single-ref is `[{...}]`) so the multi-size case below has a clean wire shape — adopters surveyed in the SDK implementor review pushed for this over the lossy single-ref form.\n\nThe v2 declaration's `params` MUST narrow (be compatible with) each referenced v1 format's `requirements` — see the 'Narrows — formal definition' section in canonical-formats.mdx. SDKs comparing dual-emitted shapes (`Product.format_ids[]` ⊇ entries from `v1_format_ref` AND `Product.format_options[]` carrying this declaration) treat the link as the authoritative pairing and run the narrowing check between this declaration and EACH referenced v1 format file's `requirements`.\n\n**Multi-size fan-out (normative).** When the declaration carries `params.sizes: [{w,h}, ...]` (multi-size flexible slot), sellers SHOULD carry one `v1_format_ref[]` entry per size, each pointing at the per-size v1 named format in the AAO catalog. Example: a multi-size image declaration with `sizes: [300x250, 728x90, 970x250]` SHOULD carry `v1_format_ref: [{aao, display_300x250_image}, {aao, display_728x90_image}, {aao, display_970x250_image}]`. v1-only buyers then see the product on all three sizes via the `format_ids[]` dual-emission. When `v1_format_ref[]` count < `sizes[]` count, SDKs MUST emit `FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE` on the response `errors[]` (advisory, alongside the partial-coverage v1 emit — NOT in place of it). SDKs MAY (non-normative) fan out automatically by catalog lookup when `v1_format_ref[]` has length 1 and `sizes[]` has length N — opt-in, requires catalog access; sellers asserting refs is the source of truth.\n\nMutually exclusive with `canonical_formats_only: true` — a declaration can EITHER assert no v1 projection (`canonical_formats_only: true`) OR link to v1 named formats (`v1_format_ref[]`), never both. When neither is present, SDKs fall back to the resolution order in `v1-canonical-mapping.json` (seller's explicit `canonical` field on the v1 file → registry glob → structural match → fail-closed).\n\nThis is the v2-side authoritative replacement for the v1-side `canonical_parameters` field on `format.json` (which is deprecated for 3.1, removed at 4.0). Sellers SHOULD prefer authoring v2 declarations with `v1_format_ref[]` over mirroring the v2 shape onto v1 files via `canonical_parameters`; the directional link (v2 declaration → v1 identifiers) is the same fact without the parallel-shape drift surface.\n\n**AAO-hosted convention (normative).** For IAB-standard formats (image dimensions, VAST/DAAST tags, standard third-party tags, HTML5 banner bundles), sellers SHOULD point each `v1_format_ref[].agent_url` at the AAO-hosted canonical agent URL `https://creative.adcontextprotocol.org` and use the registry-published id (e.g., `display_300x250_image`, `video_vast_30s`, `audio_standard_30s`, `display_300x250_html`, `display_js`). This converges the v1-wire namespace: every seller's IAB MREC points at the same `{agent_url, id}` pair, so v1-only buyers' allowlists work uniformly. Without this convention, every publisher's 300x250 ships with a different `v1_format_ref` (theirs vs nytimes.example vs cnn.example vs …) and the v1 wire fragments into per-publisher namespaces — exactly what canonical-formats was designed to eliminate.\n\nFor platform-specific formats (Meta Reels, TikTok Spark, Snap Spotlight, etc.), each `v1_format_ref[].agent_url` SHOULD point at the platform's own agent_url when the platform has adopted AdCP and publishes its own `adagents.json` with `formats[]`. When the platform has NOT adopted AdCP, sellers SHOULD point at the AAO community-registry mirror — `https://creative.adcontextprotocol.org/translated/<platform>` + `id: <platform-format-name>` (e.g., `https://creative.adcontextprotocol.org/translated/meta` + `id: meta_reels`). This keeps the v1 namespace converged across all sellers selling that platform's inventory until the platform owns its own adagents.json.\n\n**Platform-adoption cutover (normative).** When a platform adopts AdCP and publishes its own adagents.json, sellers MUST update `v1_format_ref[].agent_url` to the platform's adopted agent_url in the same minor release as the AAO mirror entry's `superseded_by` field goes live (see `static/schemas/source/adagents.json#superseded_by`). The AAO mirror entry SHOULD continue serving for ≥1 minor release after `superseded_by` is set, returning an advisory 'superseded' marker so v1 buyer allowlists keyed on the mirror URL get an explicit signal rather than a silent break. **Identity-confusion note**: the mirror URL is *format-shape namespace*, NOT seller identity. Inventory authorization always flows from `authorized_agents[]` + publisher signing keys; a buyer matching `v1_format_ref[].agent_url` against an allowlist is matching format-shape provenance, not seller identity.\n\n**Mirror domain migration (3.1).** Earlier drafts used `https://mirror.adcontextprotocol.org/translated/<platform>`. As of this release, the convention is `https://creative.adcontextprotocol.org/translated/<platform>` — sibling content under the AAO catalog domain we already host. Adopters who hardcoded the earlier mirror URL MUST migrate to the new path; the canonical-formats.mdx migration section documents the move. No transitional redirect is currently published (the earlier subdomain was never provisioned).\n\nFor seller-bespoke formats (a publisher's `acme_homepage_takeover` that doesn't fit IAB conventions), each `v1_format_ref[].agent_url` is the seller's own agent_url and the id is seller-namespaced. These won't appear in `v1-canonical-mapping.json`'s registry; they're seller-asserted only."},"format_schema":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1platform-extension-ref.json","description":"REQUIRED when `format_kind: \"custom\"`; otherwise MUST be absent. URI+digest reference to a fetchable schema describing this custom shape's actual `params` and `slots`. Same hosting model as `platform_extensions`: open-ecosystem publishers host the artifact at the canonical URI on their subdomain; closed-platform / walled-garden shapes resolve through the AAO mirror at `https://creative.adcontextprotocol.org/translated/...`. Buyer agents fetch by `uri@digest` (immutable per digest, aggressive caching, `Cache-Control: public, max-age=31536000, immutable`), validate `params` and `slots` against the fetched schema, and reason about manifests structurally — same mechanic as platform_extensions but at the format-structure level. Without `format_schema`, custom shapes would be opaque to buyer agents and the protocol would regress to per-seller integration code; that's why the schema is required, not optional.\n\n**Fetch contract (normative)** — `format_schema` is load-bearing for validation (unlike `platform_extensions`, which is informational on the *consumption* side). The *transport* rules below apply identically to BOTH fields — any SDK fetching a `platform-extension-ref.json` URI MUST apply this contract regardless of whether the field name is `format_schema` or `platform_extensions`. A shared SDK fetch path that drops to the weakest bar undermines `format_schema`'s hardening. The consumption distinction (load-bearing vs informational) is about *what the body means*; the transport distinction is `https`-and-allowlisted regardless.\n\n- **Transport**: `https` only. Buyers MUST reject `http://`, `file://`, `data:`, and any non-`https` scheme. The URI MUST resolve to a JSON document that is itself a valid JSON Schema (Draft 07 or 2020-12; producers MUST declare `$schema`).\n- **SSRF protection**: buyers MUST resolve the URI hostname and reject if any resolved address is in RFC 1918 private space (`10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`), loopback (`127.0.0.0/8`, `::1`), link-local (`169.254.0.0/16`, `fe80::/10`), CGNAT (`100.64.0.0/10`), or any RFC 6761 special-use name (`.local`, `.localhost`, `.internal`, `.test`, `.example`, `.invalid`). Cloud metadata endpoints (`169.254.169.254`, `metadata.google.internal`, `kubernetes.default.svc`) are explicitly forbidden — these are credential-leak primitives. Buyers MUST pin the connection to the resolved IP (or re-resolve and re-validate the allowlist per request) to defeat DNS rebinding.\n- **HTTP redirects**: MUST be disabled. If a follow is implemented at all, the redirect target MUST pass the same scheme + SSRF + allowlist checks; otherwise the fetch hard-fails. Open redirects on same-origin paths are otherwise a free SSRF primitive.\n- **Response size cap**: response body MUST be capped at 1 MiB. Enforce during streaming, not after full buffering. Over-cap hard-fails identically to digest mismatch.\n- **Timeout**: SDKs SHOULD apply a fetch timeout ≤5 seconds. Timeout SHOULD be treated identically to an HTTP 5xx response (transient — retry policy at the SDK's discretion; on persistent failure surface as unresolved and skip the declaration for this session).\n- **Digest verification**: SHA-256 of the response body MUST equal `digest`. **Digest mismatch is a hard fail** — the buyer MUST treat the format declaration as unresolvable and MUST NOT validate manifests against the mismatched body. A divergent digest is either a malicious substitution or producer error; either way, falling back to the un-verified body breaks the trust model. Digest format: `sha256:` prefix + 64 lowercase hex characters. Cache key is `uri@digest`; digest mismatch MUST NOT be cached as a negative result keyed on `uri` alone (defeats CDN-flap recovery), and MUST be distinguishable in telemetry from network 5xx / 404 (sustained mismatch is a substitution-attack signal, not a flap).\n- **Sandboxing of `$ref`**: fetched schemas MAY use `$ref`. Buyers MUST resolve `$ref` only to URIs that are (a) same-origin as the parent `format_schema.uri` after RFC 3986 §6 normalization (lowercase scheme + host, strip default port, normalize path dot-segments, no userinfo component), OR (b) hosted under the AAO catalog domain (`https://creative.adcontextprotocol.org/...`), OR (c) intra-document JSON Pointer refs (`#/...`) bounded to the parent document's parsed tree. Cross-origin `$ref` to arbitrary URIs MUST be rejected. `$ref: file://...` MUST be rejected unconditionally. Transitive `$ref` chains MUST be bounded at depth ≤8 AND `$ref` count ≤256 across the resolved tree (depth 8 with breadth 100 per level is 10^16 nodes — depth alone is not enough). Publishers SHOULD inline rather than $ref where possible.\n- **Schema-compile bounds (DoS protection)**: validators MUST bound CPU/memory on fetched schemas. Recommended: compiled-schema keyword count ≤10 000, `pattern` regexes evaluated with a non-backtracking engine (re2) OR under a per-pattern timeout, per-manifest validation budget ≤250 ms (exceeded budget → treat manifest as invalid, surface telemetry signal). Without these, a 'valid' schema with catastrophic regex backtracking or exponential `allOf`/`anyOf` expansion pins a CPU forever.\n- **Cache**: buyers cache fetched schemas by `uri@digest` and treat them as immutable (the same hosting contract as `platform_extensions`). On `404`, network partition, or persistent fetch failure, buyers SHOULD degrade gracefully (treat the declaration as unresolved, skip it for the current `get_products` response, surface via `errors[]` with the relevant code) rather than failing the entire session.\n- **Schema-not-valid handling**: if the fetched body parses as JSON but is not a valid JSON Schema, the buyer MUST treat the declaration as unresolvable (same as digest mismatch) and surface via `errors[]`. Validators MUST NOT attempt partial validation against an invalid schema.\n- **AAO catalog trust**: `https://creative.adcontextprotocol.org/*` is a single trust anchor in the same-origin allowlist; compromise of the catalog domain or its CA compromises every buyer agent. Catalog-served bodies MUST be digest-pinned identically to origin fetches (the digest is on the *parent* `format_schema.uri@digest`, not on the catalog response). Future hardening (signed bodies, transparency log) is tracked separately."}},"allOf":[{"$comment":"A production tracker commitment must be durably addressable; ID-less unique-kind declarations cannot carry seller execution authority.","if":{"required":["tracker_execution_contract"]},"then":{"required":["format_option_id"],"properties":{"format_option_id":{"minLength":1}}}},{"$comment":"Publisher-scoped canonical declarations are addressable only by the complete {publisher_domain, format_option_id} identity pair.","if":{"required":["publisher_domain"]},"then":{"required":["format_option_id"]}},{"if":{"properties":{"format_kind":{"const":"custom"}},"required":["format_kind"]},"then":{"required":["format_shape","format_schema"],"anyOf":[{"properties":{"canonical_formats_only":{"const":true}},"required":["canonical_formats_only"]},{"required":["v1_format_ref"]}]},"else":{"not":{"anyOf":[{"required":["format_shape"]},{"required":["format_schema"]}]}}},{"$comment":"canonical_formats_only:true and v1_format_ref are mutually exclusive — a declaration EITHER asserts no v1 projection OR links to a v1 named format, never both.","not":{"allOf":[{"properties":{"canonical_formats_only":{"const":true}},"required":["canonical_formats_only"]},{"required":["v1_format_ref"]}]}},{"$comment":"Canonical-format product declarations use format_option_id; capability_id belongs only to creative-agent build capabilities.","not":{"required":["capability_id"]}},{"$comment":"Locale policy is a v2-only hard constraint. Legacy format_ids cannot preserve it without allowing non-executable buys.","if":{"required":["locale_policy"]},"then":{"properties":{"canonical_formats_only":{"const":true}},"required":["canonical_formats_only"]}}],"oneOf":[{"title":"Image Format Declaration","properties":{"format_kind":{"type":"string","const":"image"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image.json"}},"required":["format_kind","params"]},{"title":"HTML5 Format Declaration","properties":{"format_kind":{"type":"string","const":"html5"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1html5.json"}},"required":["format_kind","params"]},{"title":"Display Tag Format Declaration","properties":{"format_kind":{"type":"string","const":"display_tag"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1display_tag.json"}},"required":["format_kind","params"]},{"title":"Image Carousel Format Declaration","properties":{"format_kind":{"type":"string","const":"image_carousel"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image_carousel.json"}},"required":["format_kind","params"]},{"title":"Hosted Video Format Declaration","properties":{"format_kind":{"type":"string","const":"video_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_hosted.json"}},"required":["format_kind","params"]},{"title":"VAST Video Format Declaration","properties":{"format_kind":{"type":"string","const":"video_vast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_vast.json"}},"required":["format_kind","params"]},{"title":"Hosted Audio Format Declaration","properties":{"format_kind":{"type":"string","const":"audio_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_hosted.json"}},"required":["format_kind","params"]},{"title":"VAST Audio Format Declaration","properties":{"format_kind":{"type":"string","const":"audio_vast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_vast.json"}},"required":["format_kind","params"]},{"title":"DAAST Audio Format Declaration","properties":{"format_kind":{"type":"string","const":"audio_daast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_daast.json"}},"required":["format_kind","params"]},{"title":"Sponsored Placement Format Declaration","properties":{"format_kind":{"type":"string","const":"sponsored_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1sponsored_placement.json"}},"required":["format_kind","params"]},{"title":"Native In-Feed Format Declaration","properties":{"format_kind":{"type":"string","const":"native_in_feed"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1native_in_feed.json"}},"required":["format_kind","params"]},{"title":"Responsive Creative Format Declaration","properties":{"format_kind":{"type":"string","const":"responsive_creative"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1responsive_creative.json"}},"required":["format_kind","params"]},{"title":"Agent Placement Format Declaration","properties":{"format_kind":{"type":"string","const":"agent_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1agent_placement.json"}},"required":["format_kind","params"]},{"title":"Seller-Rendered Stateful Display Format Declaration","properties":{"format_kind":{"type":"string","const":"seller_rendered_stateful_display"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1seller_rendered_stateful_display.json"}},"required":["format_kind","params"]},{"title":"Coordinated Placements Format Declaration","properties":{"format_kind":{"type":"string","const":"coordinated_placements"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1coordinated_placements.json"}},"required":["format_kind","params"]},{"title":"Custom Format Declaration","description":"Adopter-defined shape that doesn't fit the 15 canonicals. Requires `format_shape` (vocabulary-registered global pattern) and `format_schema` (URI+digest reference to a fetchable schema describing the actual params/slots). `params` shape is governed by the fetched schema rather than baked into AdCP — kept as `type: object` here with `additionalProperties: true` because the canonical schema validates dynamically post-fetch.","properties":{"format_kind":{"type":"string","const":"custom"},"params":{"type":"object","additionalProperties":true,"description":"Custom shape's params. Validated against the schema fetched from `format_schema.uri` at the cached `format_schema.digest`."}},"required":["format_kind","params"]}],"examples":[{"description":"Meta Reels — narrows video_hosted (vertical orientation)","data":{"format_kind":"video_hosted","params":{"orientation":"vertical","aspect_ratio":"9:16","duration_ms_range":[3000,90000],"min_width":1080,"min_height":1920,"max_file_size_mb":200,"video_codecs":["h264"],"audio_codecs":["aac"],"headline_max_chars":25,"primary_text_max_chars":72,"captions":"recommended","cta_values":["LEARN_MORE","SHOP_NOW","DOWNLOAD","SIGN_UP"],"composition_model":"deterministic","platform_extensions":[{"uri":"https://creative.adcontextprotocol.org/translated/meta/extensions/meta_pixel","digest":"sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"}]}}},{"description":"IAB Medium Rectangle (300x250) — narrows image","data":{"format_kind":"image","params":{"width":300,"height":250,"max_file_size_kb":200,"image_formats":["jpg","png","gif"],"ssl_required":true,"composition_model":"deterministic","cta_values":["LEARN_MORE","SHOP_NOW","GET_OFFER"]}}},{"description":"Québec French-only display image — same image shape with a seller-enforced creative locale constraint","data":{"format_kind":"image","format_option_id":"quebec_display_image","display_name":"Québec display image — French creative","canonical_formats_only":true,"locale_policy":{"accepted_language_ranges":["fr"]},"params":{"width":300,"height":250,"max_file_size_kb":200,"image_formats":["jpg","png"]}}},{"description":"Podcast 30s host-read — narrows audio_hosted with a `script` slot the seller's host reads verbatim. No separate `inputs` map; the script lives in the manifest's `assets` like any other text asset.","data":{"format_kind":"audio_hosted","params":{"duration_ms_exact":30000,"audio_codecs":["mp3","aac"],"audio_sample_rates":[44100,48000],"audio_channels":["stereo"],"loudness_lufs":-16,"asset_source":"publisher_host_recorded","buyer_asset_acceptance":"rejected","composition_model":"deterministic","slots":[{"asset_group_id":"script","required":true,"asset_type":"text","max_chars":800},{"asset_group_id":"offering_ref","required":false,"asset_type":"text"}],"production_window_business_days":7}}},{"description":"StreamHaus Branded Feature — a still-custom branded-content format with format_schema pointing at the fictional seller's hosted schema. Buyer agents fetch the schema by uri@digest (cached, immutable) and validate the manifest structurally. `canonical_formats_only: true` is required for custom declarations because no v1 named format expresses this bespoke composition.","data":{"format_kind":"custom","canonical_formats_only":true,"format_shape":"branded_content","format_schema":{"uri":"https://ads.streamhaus.example/schemas/formats/branded_feature_v1","digest":"sha256:e1d4f6a9c2b5e8d1f4a7c0b3e6d9f2a5c8b1e4d7f0a3c6b9e2d5f8a1c4b7e0a3"},"format_option_id":"streamhaus_branded_feature","display_name":"StreamHaus branded feature","applies_to_channels":["display"],"params":{"components":[{"placement_type":"feature_header","required":true},{"placement_type":"sponsored_story_card","required":true},{"placement_type":"sponsorship_lockup","required":true}],"exclusivity_window_hours":12,"ssl_required":true}}}]},"external:core/tracker-execution-contract.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/tracker-execution-contract.json","title":"Tracker Execution Contract","description":"Seller-authored production commitment for first-class buyer-supplied tracker occurrences accepted by one effective product format option. Listed selectors are affirmative commitments. When complete is true, every unlisted combination is explicitly unsupported; when false, omissions are undeclared.","type":"object","properties":{"complete":{"type":"boolean","description":"Whether honored is the complete set. complete:true with an empty honored array explicitly supports no buyer-supplied trackers."},"honored":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1tracker-execution-selector.json"},"uniqueItems":true,"description":"Exact tracker/event selectors the seller accepts and initiates once per manifest instance for each logical event occurrence. selector_id and structural selector identity are each unique within this array."}},"required":["complete","honored"],"x-adcp-validation":{"selector_id_unique":true,"structural_selector_identity_unique":true,"version_sets":"For one non-version selector identity, version sets must be identical or disjoint; overlapping unequal sets are invalid.","asset_normalization":"Before selector matching, omitted pixel_tracker.method becomes img, omitted VAST/DAAST target becomes linear, and offset on a non-progress asset is ignored and removed. Existing 3.x asset schemas remain structurally permissive; the selector schema supplies the closed event/target matrix for contract matching.","format_slot_satisfiability":"Every asset_type named by honored MUST have at least one matching first-class slot in the effective selected canonical format declaration. A contract cannot promise execution for an asset shape that the same format rejects structurally.","layer_derivation":"Publisher, placement, and seller effective-contract derivation is evaluated over atomic tuples of normalized non-version selector identity, one exact version (or null for pixel), execution_actor, and one firing_path. For a complete parent, every child tuple MUST exist in the parent, the child remains complete, and array compression MUST NOT create a version/path cross-product. An incomplete or omitted parent is not a ceiling: a child may add or omit affirmative tuples for its narrower scope, but remains incomplete until every applicable layer is complete. Omission from an incomplete child is undeclared, not an assertion that the tuple is unsupported.","cardinality":"Each accepted manifest tracker instance is initiated exactly once in total for each logical event occurrence; identical URLs are not deduplicated."},"additionalProperties":false},"external:core/tracker-execution-selector.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/tracker-execution-selector.json","title":"Tracker Execution Selector","description":"One exact first-class manifest tracker selector in a seller production execution contract. AdCP 3.2 supports pixel_tracker, vast_tracker, and daast_tracker only; URL-slot selectors are not part of this union.","oneOf":[{"type":"object","properties":{"selector_id":{"type":"string","minLength":1,"x-entity":"tracker_execution_selector","description":"Stable identifier unique within the materialized execution contract."},"asset_type":{"type":"string","const":"pixel_tracker"},"event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1pixel-tracking-event.json"},"method":{"type":"string","const":"img","description":"AdCP 3.2 execution contracts cover image-pixel initiation only; JavaScript response evaluation is outside this contract version."},"custom_event_name":{"type":"string","minLength":1,"description":"Required only when event is custom."},"execution_actor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-execution-actor.json"},"firing_paths":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-firing-path.json"},"minItems":1,"uniqueItems":true,"description":"Complete set of permitted initiation environments. Exactly one path is selected for each logical event occurrence."}},"required":["selector_id","asset_type","event","method","execution_actor","firing_paths"],"allOf":[{"if":{"properties":{"event":{"const":"custom"}},"required":["event"]},"then":{"required":["custom_event_name"]},"else":{"not":{"required":["custom_event_name"]}}}],"additionalProperties":false},{"type":"object","properties":{"selector_id":{"type":"string","minLength":1,"x-entity":"tracker_execution_selector","description":"Stable identifier unique within the materialized execution contract."},"asset_type":{"type":"string","const":"vast_tracker"},"vast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_versions"},"vast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_offset"},"execution_actor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-execution-actor.json"},"firing_paths":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-firing-path.json"},"minItems":1,"uniqueItems":true,"description":"Complete set of permitted initiation environments. Exactly one path is selected for each logical event occurrence."}},"required":["selector_id","asset_type","vast_versions","vast_event","target","execution_actor","firing_paths"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json"}],"additionalProperties":false},{"type":"object","properties":{"selector_id":{"type":"string","minLength":1,"x-entity":"tracker_execution_selector","description":"Stable identifier unique within the materialized execution contract."},"asset_type":{"type":"string","const":"daast_tracker"},"daast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_versions"},"daast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_offset"},"execution_actor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-execution-actor.json"},"firing_paths":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-firing-path.json"},"minItems":1,"uniqueItems":true,"description":"Complete set of permitted initiation environments. Exactly one path is selected for each logical event occurrence."}},"required":["selector_id","asset_type","daast_versions","daast_event","target","execution_actor","firing_paths"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json"}],"additionalProperties":false}],"discriminator":{"propertyName":"asset_type"}},"external:enums/tracker-execution-actor.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/tracker-execution-actor.json","title":"Tracker Execution Actor","description":"Actor responsible for initiating a buyer-supplied tracker under a seller-authored execution contract. This v1 vocabulary is intentionally narrower than the macro resolver actor vocabulary.","type":"string","enum":["seller","request_executor"]},"external:enums/tracker-firing-path.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/tracker-firing-path.json","title":"Tracker Firing Path","description":"Environment in which the responsible actor initiates a tracker. A selector may permit both values, but exactly one path is used for each logical event occurrence.","type":"string","enum":["client","server"]},"external:core/vast-tracker-constraints.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/vast-tracker-constraints.json","title":"VAST Tracker Constraints","description":"Shared VAST TrackingEvents constraints used by tracker assets and production execution selectors. The target/event matrix is closed, progress alone carries offset, and selector version arrays may contain only versions in which the event exists.","type":"object","properties":{"vast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_offset"},"vast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_versions"}},"allOf":[{"if":{"anyOf":[{"not":{"required":["target"]}},{"properties":{"target":{"const":"linear"}},"required":["target"]}]},"then":{"properties":{"vast_event":{"enum":["creativeView","loaded","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","playerExpand","playerCollapse","fullscreen","exitFullscreen","progress","otherAdInteraction","interactiveStart","closeLinear"]}}}},{"if":{"properties":{"target":{"const":"non_linear"}},"required":["target"]},"then":{"properties":{"vast_event":{"enum":["creativeView","acceptInvitation","adExpand","adCollapse","minimize","overlayViewDuration","otherAdInteraction","close"]}}}},{"if":{"properties":{"target":{"const":"companion"}},"required":["target"]},"then":{"properties":{"vast_event":{"const":"creativeView"}}}},{"if":{"properties":{"vast_event":{"const":"progress"}},"required":["vast_event"]},"then":{"required":["offset"]},"else":{"not":{"required":["offset"]}}},{"if":{"properties":{"vast_event":{"enum":["skip","progress"]}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["3.0","4.0","4.1","4.2","4.3"]}}}}},{"if":{"properties":{"vast_event":{"const":"fullscreen"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["2.0","3.0"]}}}}},{"if":{"properties":{"vast_event":{"const":"exitFullscreen"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"const":"3.0"}}}}},{"if":{"properties":{"vast_event":{"enum":["playerExpand","playerCollapse","adExpand","adCollapse","minimize","overlayViewDuration","otherAdInteraction"]}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["4.0","4.1","4.2","4.3"]}}}}},{"if":{"properties":{"vast_event":{"const":"loaded"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["4.1","4.2","4.3"]}}}}},{"if":{"properties":{"vast_event":{"const":"interactiveStart"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["4.2","4.3"]}}}}},{"$comment":"VAST 4.0 omitted closeLinear; VAST 4.1 restored it from VAST 3.0. The 4.0 gap is intentional.","if":{"properties":{"vast_event":{"const":"closeLinear"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["3.0","4.1","4.2","4.3"]}}}}}],"$defs":{"vast_event":{"type":"string","enum":["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","close","closeLinear"]},"vast_target":{"type":"string","enum":["linear","non_linear","companion"],"default":"linear"},"vast_offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$"},"vast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json"},"minItems":1,"uniqueItems":true}}},"external:core/daast-tracker-constraints.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/daast-tracker-constraints.json","title":"DAAST Tracker Constraints","description":"Shared DAAST tracker vocabulary and execution-selector constraints. The legacy asset vocabulary retains AdCP's historical close extension, while the closed standards selector matrix excludes it. Progress alone carries offset in selectors.","type":"object","properties":{"daast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_offset"},"daast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_versions"}},"allOf":[{"if":{"anyOf":[{"not":{"required":["target"]}},{"properties":{"target":{"const":"linear"}},"required":["target"]}]},"then":{"properties":{"daast_event":{"enum":["creativeView","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","progress"]}}}},{"if":{"properties":{"target":{"const":"companion"}},"required":["target"]},"then":{"properties":{"daast_event":{"const":"creativeView"}}}},{"if":{"properties":{"daast_event":{"const":"progress"}},"required":["daast_event"]},"then":{"required":["offset"]},"else":{"not":{"required":["offset"]}}}],"$defs":{"daast_event":{"type":"string","enum":["creativeView","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","progress","close"]},"daast_target":{"type":"string","enum":["linear","companion"],"default":"linear"},"daast_offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$"},"daast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1daast-version.json"},"minItems":1,"uniqueItems":true}}},"external:core/macro-resolution-capability.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/macro-resolution-capability.json","title":"Macro Processing Capability","description":"One exact processing capability for one governed dialect semantic, operation, actor, occurrence context, and encoding set. Entries are intentionally semantic-specific; they do not create a semantics × maximum-depth cross-product. Seller-wide capabilities are only a ceiling and the selected product format option is binding.","x-adcp-validation":{"verifier_constraints":{"adcp_semantic_identity":"when dialect is adcp, dialect_semantic must equal universal_semantic","translation_chain":"a translate_to_native entry is usable only when the same capability set contains an exact resolve_value entry for translation_target"},"spec":"docs/creative/universal-macros.mdx#capability-matching-and-validation"},"type":"object","properties":{"dialect":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-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":{"type":"string","enum":["verified_universal","dialect_defined"]},"universal_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1universal-macro.json"},"operation":{"type":"string","enum":["translate_to_native","resolve_value"]},"performed_by":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1macro-resolver.json"},"supported_contexts":{"type":"array","minItems":1,"uniqueItems":true,"items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1macro-value-context.json"},{"not":{"const":"opaque"}}]}},"supported_encodings":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1macro-encoding.json"},"description":"Exact supported encoding profiles, not a maximum depth. Required for value resolution."},"translation_target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1macro-translation-target.json"}},"required":["dialect","dialect_semantic","mapping_status","operation","performed_by","supported_contexts"],"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":{"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/build-creative-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":{"operation":{"const":"resolve_value"},"performed_by":{"const":"seller"},"supported_contexts":{"items":{"enum":["url_query_value","url_path_segment"]}},"supported_encodings":{"items":{"properties":{"kind":{"const":"rfc3986"},"depth":{"const":1}},"required":["kind","depth"]}}}}},{"if":{"properties":{"operation":{"const":"resolve_value"}},"required":["operation"]},"then":{"required":["supported_encodings"],"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":"translate_to_native"}},"required":["operation"]},"then":{"required":["translation_target"],"not":{"required":["supported_encodings"]}}}]},"external:enums/channels.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/channels.json","title":"Media Channel","description":"Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.","type":"string","enum":["display","olv","social","search","ctv","linear_tv","radio","streaming_audio","podcast","dooh","ooh","print","cinema","email","gaming","retail_media","influencer","affiliate","product_placement","sponsored_intelligence"],"enumDescriptions":{"display":"Digital display advertising (banners, native, rich media) across web and app","olv":"Online video advertising outside CTV (pre-roll, outstream, in-app video)","social":"Social media platforms (Facebook, Instagram, TikTok, LinkedIn, etc.)","search":"Search engine advertising and search networks","ctv":"Connected TV and streaming on television screens","linear_tv":"Traditional broadcast and cable television","radio":"Traditional AM/FM radio broadcast","streaming_audio":"Digital audio streaming services (Spotify, Pandora, etc.)","podcast":"Podcast advertising (host-read or dynamically inserted)","dooh":"Digital out-of-home buying context, including inventory on venue-operated screens and audio players","ooh":"Classic out-of-home (physical billboards, transit, etc.)","print":"Newspapers, magazines, and other print publications","cinema":"Movie theater advertising","email":"Email advertising and sponsored newsletter content","gaming":"In-game advertising across platforms","retail_media":"Retail media networks and commerce marketplaces (Amazon, Walmart, Instacart)","influencer":"Creator and influencer marketing partnerships","affiliate":"Affiliate networks, comparison sites, and performance-based partnerships","product_placement":"Product placement, branded content, and sponsorship integrations","sponsored_intelligence":"Sponsored Intelligence — advertising within AI assistants, AI search, and generative AI experiences via the reversed data flow"}},"external:core/creative-locale-policy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/creative-locale-policy.json","title":"Creative Locale Policy","description":"Seller-declared locale eligibility for one product or placement format declaration. Each accepted_language_ranges entry is a concrete canonical BCP 47 language range evaluated with RFC 4647 section 3.3.1 Basic Filtering: fr accepts fr, fr-CA, and fr-FR, while fr-CA accepts only fr-CA and its more-specific descendants. Ranges are ORed and wildcards are not supported. Presence is a hard assignment constraint, not a preference: at least one materialized creative locale variant must match. The seller filters the creative to eligible variants before applying buyer-declared strict Lookup, locale_fallbacks, or default behavior; buyer policy can never select a seller-ineligible variant.","type":"object","x-adcp-validation":{"verifier_constraints":{"range_matching":"rfc4647_basic_filtering","wildcards":"not_supported","assignment_eligibility":"at_least_one_materialized_variant_must_match","selection_precedence":"filter_seller_eligible_variants_before_buyer_lookup_fallback_or_default","serve_default":"when_unmatched_locale_action_is_serve_default_default_locale_variant_id_must_reference_an_eligible_variant","placement_narrowing":"product_policy_absent_allows_any_placement_policy_else_every_placement_range_must_be_contained_by_a_product_range","legacy_projection":"no_product_or_placement_format_id_may_project_to_a_locale_constrained_option","capability_gate":"seller_must_advertise_creative.localization_and_creative.has_creative_library","assignment_policy_lifecycle":"snapshot_effective_policy_at_acceptance_catalog_changes_apply_only_to_new_or_changed_assignments"},"spec":"docs/creative/canonical-formats.mdx#creative-locale-policy"},"properties":{"accepted_language_ranges":{"type":"array","description":"Concrete canonical BCP 47 language ranges accepted by this format option. RFC 4647 Basic Filtering is directional: seller range fr accepts variant fr-CA, but seller range fr-CA does not accept variant fr or fr-FR. Use zxx explicitly for language-neutral creative; und means unknown and is not a wildcard.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1,"maxItems":50,"uniqueItems":true}},"required":["accepted_language_ranges"],"additionalProperties":true},"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:formats/canonical/image.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/image.json","title":"Canonical Format: Image","description":"Static image creative format. Slots: `image_main` (image asset, file or hosted URL), optional `headline` (text), `body_text` (text), `cta` (text/enum), `landing_page_url` (url). Tracking model: impression pixel + click URL via universal_macros, with optional viewability pixel. Distinct from `html5` (interactive bundles) and `display_tag` (third-party served). AR/dimensions narrow to specific sizes via product parameters — covers IAB display sizes (300x250, 728x90, 970x250, etc.) without a separate iab_size enum.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"title":"Size-mode mutex","description":"Exactly one of: (a) fixed (`width` + `height` both set), (b) multi-size (`sizes` set), (c) responsive (any of `min_width`/`max_width`/`min_height`/`max_height` set), (d) none (no size constraint declared — accepts any dimensions). Combining modes (e.g., `width` + `sizes`) is rejected at schema layer; same rule on `html5` and `display_tag` canonicals.","oneOf":[{"title":"fixed","required":["width","height"],"not":{"anyOf":[{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"multi-size","required":["sizes"],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"responsive","anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]}]}},{"title":"none","not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}}]},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"enum":["pause","screensaver"]}}}},{"properties":{"motion_level":{"enum":["static","limited_motion"]}}}],"properties":{"slots":{"default":[{"asset_group_id":"image_main","asset_type":"image","required":true},{"asset_group_id":"headline","asset_type":"text","required":false},{"asset_group_id":"body_text","asset_type":"text","required":false},{"asset_group_id":"primary_text","asset_type":"text","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for image canonical. Buyer ships an image asset (file or hosted URL) plus optional headline, body text, primary text (long-form caption), CTA (typically constrained to an enum via `cta_values`), and clickthrough URL. Products MAY override the default — make `headline` required, narrow `cta` to a value enum, or remove slots the surface doesn't consume."},"width":{"type":"integer","minimum":1,"description":"Logical render width in pixels — use for fixed-size slots (e.g., a 300×250 IAB MREC). When `pixel_ratios` is absent, the required image asset width is the same value (1x). When `pixel_ratios` is present, an accepted asset's intrinsic width is `width × pixel_ratio`. For multi-size flexible slots, use `sizes[]`; for responsive slots, use the min/max fields. The three size modes are mutually exclusive."},"height":{"type":"integer","minimum":1,"description":"Logical render height in pixels. Intrinsic asset height is `height × pixel_ratio`, where the ratio defaults to 1 when `pixel_ratios` is absent. See `width` for size-mode mutual exclusion."},"sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"List of accepted logical (width, height) render pairs for a multi-size flexible slot. The buyer ships an asset matching one logical size multiplied by one accepted `pixel_ratios` entry (or by 1 when `pixel_ratios` is absent). SDKs MUST treat size and density as separate axes: a 600×500 intrinsic asset at 2x satisfies a logical 300×250 size; it does not create a logical 600×500 placement. Mirrors OpenRTB `banner.format[]` semantics. Mutually exclusive with `(width, height)` and with responsive ranges."},"pixel_ratios":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"number","exclusiveMinimum":0},"description":"Accepted intrinsic-pixel densities for image assets, expressed as intrinsic pixels per logical render pixel (for example `[1, 2]` accepts both standard and Retina renditions). Absence means `[1]` for backward compatibility. This is an acceptance set, not a requirement to submit every rendition: one `image_main` asset satisfying any listed ratio is sufficient unless the effective `image_main` slot declares `required_pixel_ratios`. SDKs determine the effective ratio from `asset.pixel_ratio` when supplied, otherwise infer it from intrinsic asset dimensions divided by the matched logical size. Width and height ratios MUST agree."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted width in pixels for responsive slots that adapt within a range (e.g., 'any width from 300 to 970'). Use with `max_width` (and optionally `min_height`/`max_height`). Mutually exclusive with `(width, height)` and `sizes[]`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted width in pixels for responsive slots. Pair with `min_width`. See `min_width` for size-mode mutual exclusion."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted height in pixels for responsive slots. Pair with `max_height`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted height in pixels for responsive slots. Pair with `min_height`."},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Optional aspect ratio constraint (e.g., '1.91:1', '1:1'). When provided alongside `width`/`height`, must agree. When used with `sizes[]` or responsive ranges, narrows accepted entries to those matching the aspect ratio."},"max_file_size_kb":{"type":"integer","minimum":1,"description":"Maximum file size in kilobytes."},"image_formats":{"type":"array","items":{"type":"string","enum":["jpg","jpeg","png","gif","webp","svg"]},"description":"Permitted image file formats."},"ssl_required":{"type":"boolean","description":"Whether the image and its trackers must be served over HTTPS."},"headline_max_chars":{"type":"integer","minimum":1},"body_text_max_chars":{"type":"integer","minimum":1},"cta_values":{"type":"array","items":{"type":"string"},"description":"Permitted CTA values for this product (e.g., ['LEARN_MORE', 'SHOP_NOW'])."},"asset_source":{"type":"string","enum":["buyer_uploaded","publisher_host_recorded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered asset bytes come from. Single shared enum across all canonicals (`image`, `video_hosted`, `audio_hosted` — replaces the earlier per-canonical `image_source` / `video_source` / `audio_source` fields). `buyer_uploaded` (default): buyer ships a pre-rendered asset. `publisher_host_recorded`: publisher's host records the asset (audio-specific; podcast host-read pattern). `seller_pre_rendered_from_brief`: buyer ships a brief plus structured copy; seller renders ONE asset at sync_creatives or build_creative time (generative-DSP pattern). `seller_human_designed`: seller's design team renders manually from a brief. `agent_synthesized`: AI synthesis pipeline; pair with `synthesis_nondeterministic: true` when the platform cannot guarantee in-spec output (Veo/Sora/Imagen-class). `publisher_owned_reference`: buyer references an existing post or publisher-owned object via a `published_post` slot; the seller resolves and serves the referenced content after authorization/review rather than receiving uploaded bytes.\n\nNot every value is meaningful on every canonical — `publisher_host_recorded` is audio-specific; on `image` or `video_hosted` it has no defined behavior. `publisher_owned_reference` is meaningful only when the product's `slots` declaration accepts a reference asset such as `published_post`. Adopters MUST select a value appropriate to the canonical's asset type. The `slots` declaration is the binding contract for what the buyer ships; `asset_source` is informational and lets buyers understand the production model when picking products."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded assets. When `rejected`, the buyer cannot ship pre-rendered bytes directly — they must use build_creative (or sync_creatives with brief inputs or reference assets) so the seller produces or resolves the asset. Combined with `asset_source`, lets a product declare 'I produce assets from briefs and refuse buyer uploads' (asset_source=`seller_pre_rendered_from_brief`, buyer_asset_acceptance=`rejected`) or 'I accept existing post references, not uploaded bytes' (asset_source=`publisher_owned_reference`, buyer_asset_acceptance=`rejected`)."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On `image` only `pause` and `screensaver` are valid — the image-plus-copy contract the major pause-ad sellers ingest (seller composites the frame; typical canvas 1920×1080 or a transparent-region overlay). Other experiences route per the matrix in docs/creative/ctv-experiences.mdx."},"motion_level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1motion-level.json","description":"Accepted motion class (AdCOM attrs 21-22; `full_motion` is invalid on a static image canonical)."},"activation_methods":{"type":"array","uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1activation-method.json"},"description":"Viewer activation mechanisms this option offers (e.g. `qr_code` on a pause frame). Activations are engagement events, not impressions."}},"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on image must be pause or screensaver","motion_level_static_canonical":"motion_level full_motion is rejected on image","ctv_activation_copy_slots":"push_notification activation_methods SHOULD declare an activation_message slot; text_message SHOULD declare an activation_text_message slot; email SHOULD declare activation_email_subject and activation_email_body slots. Missing copy slots emit a non-blocking validate_input warnings[] entry."},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true},"external:formats/canonical/_base.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/_base.json","title":"Canonical Format Base","description":"Shared parameter fields that apply across canonical formats. Each canonical format extends this base with format-specific parameters (dimensions, durations, codecs, slot constraints).","type":"object","properties":{"experimental":{"type":"boolean","default":false,"description":"When true, this canonical or seller narrowing may not work as declared. Adopters SHOULD preflight it with validate_input or in a sandbox and SHOULD NOT route production budget without testing; experimental status never makes the deprecated v1 path preferable. Drivers include unsettled spec shape, an adopter runtime gap, and custom shapes awaiting promotion. This replaces the earlier status plus runtime_status axes. Sellers SHOULD set experimental whenever a canonical or declaration is not production-ready."},"deprecated":{"type":"boolean","default":false,"description":"When true, this canonical (or a seller's specific narrowing of it) is going away. Existing adopters are supported through the deprecation cycle; new adoption is discouraged. Pair with `migration_target_version` to indicate when the canonical is expected to be removed. Distinct from `experimental`: an experimental canonical may stabilize and stop being experimental; a deprecated canonical is on a sunset path."},"v1_translatable":{"type":"boolean","default":true,"description":"Whether this canonical has any v1 named-format equivalent. `true` (default) — the canonical is structurally expressible as one or more v1 named formats (IAB display sizes, VAST tags, DAAST tags, etc.); v1→v2 projection via `v1-canonical-mapping.json` is meaningful. `false` — the canonical is inherently new in v2 and has no v1 form; v1's `list_creative_formats` couldn't express it because the underlying concept (algorithmic surface composition, AI-surface mentions, retail-media catalog placements, multi-card carousels) didn't exist as a v1 named-format archetype.\n\nLets SDKs distinguish two failure modes that today look identical: (a) the registry hasn't covered this canonical yet (correctable — seller adds explicit `canonical` field or files a registry entry) vs (b) no v1 path is possible (informational — buyer needs v2-aware consumption, or seller declares `canonical_formats_only: true` on the product declaration). SDKs encountering `v1_translatable: false` on a canonical SHOULD NOT emit `FORMAT_PROJECTION_FAILED` (which signals registry-coverage gap) — instead surface the inherent v1-unreachability as a different diagnostic or skip silently. The six inherently-v2 canonicals in 3.2 are `image_carousel`, `sponsored_placement`, `responsive_creative`, `agent_placement`, `seller_rendered_stateful_display`, and `coordinated_placements`."},"since_version":{"type":"string","pattern":"^[1-9]\\d*\\.(0|[1-9]\\d*)$","description":"AdCP MAJOR.MINOR version that introduced this canonical (e.g., '3.1', '3.2'). Lets adopters reason about minimum protocol version requirements when consuming a format declaration. Patch precision is intentionally rejected — canonicals are introduced at minor-version boundaries."},"migration_target_version":{"type":"string","pattern":"^[1-9]\\d*\\.(0|[1-9]\\d*)$","description":"AdCP MAJOR.MINOR version by which the working group expects this canonical to stabilize, surface a breaking revision, or (when `deprecated: true`) be removed. Patch precision is intentionally rejected — canonicals shift at minor-version boundaries. Absence signals 'no specific target' (omit the field rather than use a placeholder like 'unknown')."},"composition_model":{"type":"string","enum":["deterministic","algorithmic"],"description":"Whether the surface composes deterministically (buyer can predict per-slot rendering — sponsored_placement, image, video) or algorithmically (surface chooses combinations or phrasing — responsive_creative, agent_placement)."},"provenance_required":{"type":"boolean","description":"When true, the product rejects unsigned synthesized assets. Builders calling build_creative MUST attach a C2PA-compatible provenance manifest attributing synthesis to the creative agent."},"platform_extensions":{"type":"array","description":"Platform-specific extensions narrowing the canonical (pixel ID shapes, conversion event taxonomies, platform-specific CTAs/destinations). Each extension is a URI+digest reference resolved against the bundled `extensions` map in get_products responses or fetched directly.\n\n**Collision precedence (normative).** When two or more `platform_extensions[]` entries on the same declaration extend the same target (e.g., both extend `tracking`) with overlapping field names, **array order is authoritative — later entries override earlier ones on a per-field basis** (last-in-array-wins). SDKs MUST surface the overlap via the `errors[]` array on the `get_products` response with a structured code (`FORMAT_DECLARATION_DIVERGENT` is appropriate when the overlap appears across dual-emitted shapes; a producer-self-emitted overlap on a single declaration SHOULD use the same code with `error.details: { collision_kind: \"platform_extension_field\", target, overlapping_fields, winning_extension_uri }`). Producers SHOULD avoid the collision by emitting one extension per target or by partitioning fields across extensions; the deterministic precedence is for last-resort consistency across SDK implementations, not a sanctioned merging strategy.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1platform-extension-ref.json"}},"synthesis_nondeterministic":{"type":"boolean","description":"When true, the format's production pipeline is genuinely nondeterministic — the platform cannot guarantee that synthesis from a given input set produces in-spec output. Veo / Sora / Runway-class generative video, and other AI-synthesis flows where output dimensions, duration, or quality vary per run. Implies a different validation contract: predictive `validate_input` is impossible; the platform's own post-synthesis QA loop applies; if the QA loop exhausts without producing a valid artifact, `build_creative` returns task_failed with a synthesis_failed reason. Distinct from `composition_model` (which describes how the surface composes per-slot rendering, not whether synthesis is deterministic). When false or absent, the format's production is predictable enough that `validate_input` can predict output properties from input properties.\n\n**Compatibility with `asset_source` / `item_production_model`**: `synthesis_nondeterministic: true` MAY pair with any of `seller_pre_rendered_from_brief`, `seller_human_designed`, or `agent_synthesized` (the QA loop is concept-level, not source-specific — 'seller renders from brief but each retry differs' is just as nondeterministic as Veo). It MUST NOT pair with `buyer_uploaded` (the buyer ships pre-rendered bytes; there's no synthesis step to be nondeterministic about). It MUST NOT pair with `publisher_host_recorded` (the publisher's host produces a deterministic-from-script output even if the human voice varies). When `synthesis_nondeterministic: true` is set with an incompatible source, validators SHOULD reject with a structured error.","default":false},"slots":{"type":"array","description":"Programmatic declaration of which canonical asset_group_id slots a manifest targeting this format must (or may) populate. Lets SDK codegen and validators enumerate expected slots without parsing the format's prose description. Each entry references an asset_group_id from the canonical vocabulary registry, paired with an `asset_type` so the validator knows which asset schema to apply. Format-level narrowing parameters that apply across all slots (e.g., flat `headline_max_chars` on responsive_creative) may also live on the format declaration; per-slot constraints (a specific slot's `max_chars` or `max_size_kb`) live on the slot entry.","items":{"type":"object","required":["asset_group_id","asset_type"],"properties":{"asset_group_id":{"type":"string","description":"Canonical asset_group_id from /schemas/core/asset-group-vocabulary.json. Non-canonical IDs are valid but trigger soft warnings."},"asset_type":{"type":"string","enum":["image","video","audio","text","markdown","url","html","css","javascript","vast","daast","display_tag","webhook","brief","catalog","published_post","zip","card","object","pixel_tracker","vast_tracker","daast_tracker"],"description":"Discriminator selecting the asset schema this slot accepts. SDK codegen uses this to type the slot value. `display_tag` is the atomic third-party display representation (URL, inline markup, or paired redirect). `published_post` is an existing-post reference asset. `pixel_tracker` / `vast_tracker` / `daast_tracker` are renderer-fired tracker primitives. `object` is a last-resort fallback."},"required":{"type":"boolean","description":"Whether this slot is required for a valid manifest.","default":false},"min":{"type":"integer","minimum":0,"description":"Minimum count for repeatable / pool slots."},"max":{"type":"integer","minimum":1,"description":"Maximum count for repeatable / pool slots."},"max_chars":{"type":"integer","minimum":1,"description":"Per-slot character limit. Valid only when `asset_type` is `text`, `markdown`, or `brief`. Mutually exclusive with `max_size_kb` (which applies to binary asset types). Schema enforces via if/then so a producer can't set both on the same slot."},"max_size_kb":{"type":"integer","minimum":1,"description":"Per-slot file size limit in exact kilobytes, where 1 KB = 1,000 bytes. Valid only when `asset_type` is `image`, `video`, `audio`, or `zip`. Mutually exclusive with `max_chars` (which applies to text asset types). Schema enforces via if/then so a producer can't set both on the same slot."},"pixel_ratios":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"number","exclusiveMinimum":0},"description":"Accepted intrinsic-pixel densities for this image-bearing slot. Valid when `asset_type` is `image`, and on a `card` slot where it constrains each card's image media (video media is unaffected). This makes density available to every canonical carrying image assets (native, carousel, responsive, companion images, and image itself), not only `format_kind: image`. When the image canonical also declares top-level `params.pixel_ratios`, the effective set is the intersection; an empty intersection is invalid. One matching asset satisfies the slot unless `required_pixel_ratios` requires rendition coverage."},"required_pixel_ratios":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"number","exclusiveMinimum":0},"description":"Required density coverage for an image rendition set. Valid only when `asset_type` is `image` and `pixel_ratios` is also declared. Every value MUST appear in the effective accepted set after intersecting any top-level image `params.pixel_ratios`, and the manifest slot value MUST be an array containing exactly one matching image rendition for each required ratio. Other accepted ratios remain optional. For example, `pixel_ratios: [1, 1.5, 2]` with `required_pixel_ratios: [1, 2]` requires the 1x and 2x renditions while making 1.5x optional. SDKs enforce intersection, subset, coverage, and duplicate-ratio rules because JSON Schema draft-07 cannot express them generically."},"logo_slots":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1logo-slot.json"},"uniqueItems":true,"description":"When `asset_group_id` is `logo`, renderer-facing brand.json logo slots acceptable for this format slot. Producers selecting from brand.json SHOULD prefer `logos[]` entries whose `slots[]` intersects this list, then apply `visual_guidelines.logo_usage_rules[]`."},"required_logo_slots":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1logo-slot.json"},"uniqueItems":true,"description":"Subset of `logo_slots` for which this format expects explicit logo coverage. A manifest or brand-derived logo pool SHOULD include at least one usable logo for each required slot; if coverage is missing, builders SHOULD surface a validation warning or approval mapping instead of guessing from prose."},"description":{"type":"string","description":"Human-readable description of what the slot expects from the buyer."},"consumed_for_production":{"type":"boolean","default":false,"description":"Dispatch hint for `build_creative` and v1↔v2 wire translators: when `true`, the slot's value is consumed as INPUT to a production step (host-read script, brief copy fed to generative synthesis, catalog feed driving per-SKU rendering) and is not rendered verbatim. When `false` (default), the slot's value is rendered verbatim on the placement (image bytes, video file, display tag).\n\nMotivates the v1↔v2 dispatch table: pre-v2 buyers shipped production-consumed inputs separately in a `inputs` map on the build_creative request; v2 collapses inputs and rendered assets into a single `assets` map keyed by `asset_group_id`. SDK translators between v1 and v2 use this flag per canonical to know which assets in the v2 manifest map back to v1 `inputs` vs v1 `assets`. Without the per-slot flag the dispatch table lives in adopter code and every SDK gets it slightly different.\n\nProducers SHOULD set this explicitly on slots whose consumption pattern isn't obvious (host-read scripts on `audio_hosted`, briefs on generative `video_hosted`, catalog feeds on `sponsored_placement`). For canonicals where every slot is render-verbatim (`image`, `display_tag`, `video_vast`, `audio_vast`), the default `false` is sufficient and the flag MAY be omitted."}},"additionalProperties":true,"allOf":[{"$comment":"max_chars is valid only for text-shaped asset types; max_size_kb is valid only for binary asset types. A slot MUST NOT carry both; the type-appropriate one is enforced via if/then.","if":{"properties":{"asset_type":{"enum":["text","markdown","brief"]}},"required":["asset_type"]},"then":{"not":{"required":["max_size_kb"]}}},{"if":{"properties":{"asset_type":{"enum":["image","video","audio","zip"]}},"required":["asset_type"]},"then":{"not":{"required":["max_chars"]}}},{"$comment":"Logo slot narrowing is only meaningful on the canonical logo asset group.","if":{"not":{"properties":{"asset_group_id":{"const":"logo"}},"required":["asset_group_id"]}},"then":{"not":{"anyOf":[{"required":["logo_slots"]},{"required":["required_logo_slots"]}]}}},{"if":{"properties":{"asset_type":{"enum":["image","card"]}},"required":["asset_type"]},"else":{"not":{"anyOf":[{"required":["pixel_ratios"]},{"required":["required_pixel_ratios"]}]}}},{"$comment":"A rendition set is representable only by an array-valued image slot. Card media is singular in card-asset.json, so card slots may accept densities but cannot require multiple density renditions.","if":{"required":["required_pixel_ratios"]},"then":{"properties":{"asset_type":{"const":"image"}},"required":["pixel_ratios"]}},{"$comment":"Non-size asset types (url, catalog, published_post, html, css, javascript, webhook, daast, vast, card, object, pixel_tracker, vast_tracker, daast_tracker) reject both — there's no defined per-slot size semantics on those.","if":{"properties":{"asset_type":{"enum":["url","catalog","published_post","html","css","javascript","webhook","daast","vast","display_tag","card","object","pixel_tracker","vast_tracker","daast_tracker"]}},"required":["asset_type"]},"then":{"not":{"anyOf":[{"required":["max_chars"]},{"required":["max_size_kb"]}]}}}]}},"required_connections":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1downstream-connection-requirement.json"},"description":"Downstream platform connections or grants required to use this format declaration. These are in addition to the single AdCP caller credential. Use this when a platform product requires multiple downstream grants, such as an advertiser account connection plus a publisher identity or post authorization for published-post references."},"reference_mutability":{"type":"string","enum":["immutable_snapshot","mutable_requires_reapproval","mutable_auto_recheck"],"description":"Policy for formats whose `slots` accept a `published_post` reference. `immutable_snapshot`: seller snapshots the referenced post at approval and later source changes do not change the served creative. `mutable_requires_reapproval`: the source post may change and material changes require review before continued serving. `mutable_auto_recheck`: the source post may change and the seller continuously or periodically rechecks authorization/policy without requiring buyer resubmission. Omit when the format has no `published_post` slot."},"production_window_business_days":{"type":"integer","minimum":0,"description":"Typical production turnaround in business days when the format requires seller-side production (e.g., host-recording from a buyer-supplied script). 0 for synchronous (e.g., generative AI); >0 for human-produced (e.g., podcast host-read). Absent when no production is required (buyer uploads complete creative)."}},"not":{"required":["macro_resolution_capabilities"]},"additionalProperties":true,"x-canonical-policy-required-params-not-enforced":"Canonical format schemas intentionally do NOT mark parameter fields as required and use additionalProperties: true. The canonical describes which parameters MAY narrow a declaration; it does not supply hidden technical defaults. When a technical parameter is omitted, its meaning comes only from the enclosing declaration's technical_requirements_complete assertion: true means no constraint at that layer, while false or absence means undeclared. Consumers MUST NOT infer an omitted technical constraint from canonical prose, examples, common practice, or implementation defaults. This is intentional: structural schema validation and product-level technical-contract completeness are separate checks.","x-adcp-file-size-units":"Creative file-size fields ending in `_kb` use exactly 1,000 bytes per KB. Fields ending in `_mb` use exactly 1,000,000 bytes per MB. Fields ending in `_bytes` are exact byte counts."},"external:enums/logo-slot.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/logo-slot.json","title":"Logo Slot","description":"Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.","type":"string","enum":["logo_card_light","logo_card_dark","profile_mark","favicon","app_icon","social_profile_mark","nav_header","footer","email_header","watermark","ad_end_card","co_brand_lockup","marketplace_listing"],"enumDescriptions":{"logo_card_light":"Logo rendered in a card or framed placement on a light background.","logo_card_dark":"Logo rendered in a card or framed placement on a dark background.","profile_mark":"Small square logo mark for profile-style UI. Distinct from brand.json's top-level animated or conversational avatar object.","favicon":"Browser favicon or similarly tiny tab/bookmark icon.","app_icon":"Application icon or launcher icon.","social_profile_mark":"Social profile logo mark or feed identity mark.","nav_header":"Primary navigation header logo.","footer":"Footer logo.","email_header":"Email header logo.","watermark":"Subtle watermark or bug.","ad_end_card":"Advertising end card, especially video or CTV.","co_brand_lockup":"Co-brand, partner, sponsor, or secondary-mark lockup.","marketplace_listing":"Marketplace, catalog, directory, or store listing logo."}},"external:core/downstream-connection-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/downstream-connection-requirement.json","title":"Downstream Connection Requirement","description":"A seller/platform-side connection or grant required by a product, format, or request. This is not the AdCP caller credential: the AdCP request is still authenticated once, and the seller uses these stored downstream connections to call a platform or service on the buyer's behalf. Use this shape for platforms that require more than one downstream grant, such as an advertiser account connection plus a publisher identity or post authorization for published-post references.","type":"object","properties":{"provider":{"type":"string","description":"Stable provider or platform namespace, preferably lowercase. Examples: `social.example`, `shortvideo.example`, or a seller-defined namespace. Omit only when the requirement is provider-agnostic, or when an `authorization_url` fully routes the human to the correct provider-specific connection flow."},"connection_type":{"type":"string","enum":["advertiser_account","publisher_identity","post_authorization"],"description":"Kind of downstream connection required. `advertiser_account` is the platform account used to buy/manage ads. `publisher_identity` is the creator, page, channel, organization, or profile that owns source posts. `post_authorization` is a post-scoped grant when the platform authorizes individual posts instead of, or in addition to, the owning identity."},"required_for":{"type":"array","items":{"type":"string","minLength":1,"examples":["list_creatives","sync_creatives","create_media_buy","get_media_buy_delivery","get_creative_delivery"]},"uniqueItems":true,"description":"Concrete AdCP protocol operation names that require this downstream connection. Sellers SHOULD include this in product declarations when the requirement is known ahead of time, and in AUTHORIZATION_REQUIRED details when it explains the failed operation. Prefer specific operation names such as `list_creatives`, `sync_creatives`, `create_media_buy`, `get_media_buy_delivery`, or `get_creative_delivery` over broad category labels such as `reporting`."},"scope":{"type":"string","enum":["account","identity","post","unknown"],"description":"Granularity of the downstream grant."},"status":{"type":"string","enum":["connected","missing","pending","expired","revoked","not_required","unknown"],"description":"Current seller-observed state for this downstream connection when known. Product declarations MAY omit status or use `unknown`; AUTHORIZATION_REQUIRED details SHOULD use `missing`, `expired`, or `revoked` for the connection that blocked the call."},"connection_id":{"type":"string","description":"Seller-defined identifier for an already-created downstream connection. Omit when no connection exists yet or when exposing it would leak platform/account state."},"resource_ref":{"type":"object","description":"Optional opaque provider-native resource hint, such as a platform account id, profile URL, handle, channel id, post id, or post URL. This is a hint for routing authorization, not proof that authorization exists.","properties":{"platform_account_id":{"type":"string","description":"Provider-native advertiser or business account id, when safe to disclose."},"identity_id":{"type":"string","description":"Provider-native creator, page, channel, organization, or profile id, when safe to disclose."},"handle":{"type":"string","description":"Provider-native public handle for the owning identity, when available."},"profile_url":{"type":"string","format":"uri","description":"Public URL for the owning identity, when available."},"post_id":{"type":"string","description":"Provider-native post id, when the grant is post-scoped or the failed request referenced a specific post."},"post_url":{"type":"string","format":"uri","description":"Public URL for the referenced post, when available."}},"additionalProperties":true},"authorization_url":{"type":"string","format":"uri","description":"Seller-hosted or provider-hosted URL where a human can complete or restore this downstream connection."},"authorization_instructions":{"type":"string","description":"Human-readable instructions for completing or restoring this downstream connection."},"expires_at":{"type":"string","format":"date-time","description":"Expiration time for the downstream grant, when known."}},"required":["connection_type"],"allOf":[{"if":{"properties":{"status":{"enum":["missing","pending","expired","revoked"]}},"required":["status"]},"then":{"anyOf":[{"required":["provider"]},{"required":["authorization_url"]}]}}],"additionalProperties":true,"examples":[{"provider":"social.example","connection_type":"advertiser_account","required_for":["sync_creatives","create_media_buy"],"scope":"account","status":"connected"},{"provider":"social.example","connection_type":"publisher_identity","required_for":["list_creatives","sync_creatives","create_media_buy"],"scope":"identity","status":"missing","resource_ref":{"handle":"@acme","profile_url":"https://social.example/@acme"},"authorization_instructions":"Connect the creator or page that owns the source post."}]},"external:enums/ctv-ad-experience.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/ctv-ad-experience.json","title":"CTV Ad Experience","description":"IAB Tech Lab CTV Ad Portfolio experience for a format option. `menu` covers smart-TV home/menu surfaces (tiles and headline banners, OpenRTB Native plcmttype 1/3); `pause`, `screensaver`, `overlay`, `squeezeback`, and `in_scene` are the on-glass experiences the portfolio signals via OpenRTB Video with VAST NonLinearAds (AdCOM plcmt 5-9). One format option declares at most one experience; sellers offering several publish sibling format options. Each canonical format permits only the experiences in its documented matrix — pairings outside the matrix fail validation. Linear CTV video is ordinary video_vast/video_hosted and declares no experience.","$comment":"Vocabulary and names follow the IAB CTV Ad Format Guidelines v2.0 and the final Signaling Implementation Guidelines. The IAB signaling table (Menu -> Native, others -> NonLinear VAST) is an OpenRTB bridge mapping documented in docs/creative/ctv-experiences.mdx; AdCP creative supply follows the per-canonical experience matrix, which also admits the asset-bundle and image contracts CTV sellers ingest in practice.","type":"string","enum":["menu","pause","screensaver","overlay","squeezeback","in_scene"]},"external:enums/motion-level.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/motion-level.json","title":"Creative Motion Level","description":"Motion class of a rendered creative, mirroring AdCOM creative attributes 21 (Static Visual), 22 (Limited Motion / Cinemagraph), and 23 (Full-Motion Video). Sellers constrain the accepted level on a format option; buyers declare the level their creative carries. OpenRTB bridges map the value to `attr` on the bid and `battr` on the request.","type":"string","enum":["static","limited_motion","full_motion"]},"external:enums/activation-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/activation-method.json","title":"Creative Activation Method","description":"Viewer activation mechanism a CTV or high-impact unit offers beyond a rendered impression: `qr_code` (on-glass QR to a buyer URL), `deep_link` (app or content deep link, including app-store detail pages), `push_notification` and `email` (send-to-device follow-ups with buyer-supplied copy), `tune_in` (jump to linear/virtual channel or content), `text_message` (SMS follow-up with buyer-supplied copy). Activations are engagement events, never additional impressions. Formats offering copy-bearing activations declare normative character-limited copy slots via `slots_override`: `push_notification` → `activation_message`; `text_message` → `activation_text_message`; `email` → `activation_email_subject` + `activation_email_body`. The activation URL rides `landing_page_url` unless a dedicated slot is declared.","type":"string","enum":["qr_code","deep_link","push_notification","email","tune_in","text_message"]},"external:formats/canonical/html5.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/html5.json","title":"Canonical Format: HTML5 Banner","description":"Interactive HTML5 banner delivered as a zip archive. Slot: `html5_bundle` (zip asset). Tracking model: MRAID + IAB Open Measurement (OM-SDK) + click-tag macro substitution + backup image fallback. Receivers unpack the zip, validate internal structure, and serve from CDN. Distinct from `image` (static, non-interactive) and `display_tag` (third-party served). The zip's entry point is typically `index.html`; click handling uses `clickTag` (or `clickTAG`) macro substitution.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"title":"Size-mode mutex","description":"Exactly one of: (a) fixed (`width` + `height` both set), (b) multi-size (`sizes` set), (c) responsive (any of `min_width`/`max_width`/`min_height`/`max_height` set), (d) none (no size constraint declared — accepts any dimensions). Combining modes is rejected at schema layer.","oneOf":[{"title":"fixed","required":["width","height"],"not":{"anyOf":[{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"multi-size","required":["sizes"],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"responsive","anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]}]}},{"title":"none","not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}}]}],"properties":{"slots":{"default":[{"asset_group_id":"html5_bundle","asset_type":"zip","required":true},{"asset_group_id":"backup_image","asset_type":"image","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for html5 canonical. Buyer ships a zip bundle plus optional backup image (required when `backup_image_required: true`) and clickthrough URL. The zip's entry point is typically `index.html`; click handling uses the `clickTag` (or `clickTAG`) macro substituted by the seller at serve time."},"width":{"type":"integer","minimum":1,"description":"Required banner width in pixels — use for fixed-size slots. For multi-size flexible slots use `sizes[]`; for responsive use `min_width`/`max_width`/`min_height`/`max_height`. Exactly one of `(width, height)`, `sizes[]`, or `min/max_width` + `min/max_height` ranges MUST be set."},"height":{"type":"integer","minimum":1,"description":"Required banner height in pixels. See `width` for size-mode mutual exclusion."},"sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"List of accepted (width, height) pairs for a multi-size flexible slot (publisher banner that accepts 300×250 OR 728×90 OR 970×250). Mirrors OpenRTB `banner.format[]`. Mutually exclusive with `(width, height)` and with responsive ranges."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted width for responsive HTML5 banners that adapt within a range. Pair with `max_width`. Mutually exclusive with `(width, height)` and `sizes[]`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted width for responsive HTML5 banners. Pair with `min_width`."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted height for responsive HTML5 banners. Pair with `max_height`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted height for responsive HTML5 banners. Pair with `min_height`."},"max_initial_load_kb":{"type":"integer","minimum":1,"description":"Maximum initial-load file size (zip + above-the-fold assets) in kilobytes. IAB display standards: 200 KB for fixed sizes, 100 KB for mobile."},"max_polite_load_kb":{"type":"integer","minimum":1,"description":"Maximum polite-load file size after host-initiated subload, in kilobytes. IAB display standards: 500 KB for fixed sizes."},"host_initiated_subload":{"type":"boolean","description":"Whether the host page must initiate the polite-load phase. IAB-compliant banners require true."},"max_animation_duration_ms":{"type":"integer","minimum":0,"description":"Maximum total animation duration in milliseconds. IAB standard: 30000 (30 seconds)."},"max_cpu_load_percent":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum CPU load percentage during render."},"mraid_required":{"type":"boolean","description":"Whether MRAID compatibility is required (mobile in-app)."},"mraid_version":{"type":"string","enum":["2.0","3.0"],"description":"Required MRAID version when mraid_required is true."},"om_sdk_required":{"type":"boolean","description":"Whether IAB Open Measurement SDK integration is required."},"clicktag_macro":{"type":"string","enum":["clickTag","clickTAG"],"description":"Name of the click-tag macro the bundle must use."},"backup_image_required":{"type":"boolean","description":"Whether a backup image must accompany the zip for non-HTML5 environments."},"backup_image_max_size_kb":{"type":"integer","minimum":1,"description":"Maximum backup image file size in kilobytes."},"ssl_required":{"type":"boolean"}},"additionalProperties":true},"external:formats/canonical/display_tag.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/display_tag.json","title":"Canonical Format: Display Tag","description":"Third-party-served display creative delivered as one of three explicit representations: a single ad-request URL, byte-preserved inline markup, or an atomic paired redirect (`ad_request_url` plus `clickthrough_url`). The backward-compatible default slot remains `tag_url` (`url_type: ad_request`). Format options accepting inline or paired delivery override `slots` with a `display_tag` asset and declare `supported_delivery_types`. Tracking is opaque to the seller except for declared macro resolution. Distinct from `image` and seller-hosted `html5` zip bundles.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"title":"Size-mode mutex","description":"Exactly one of: (a) fixed (`width` + `height` both set), (b) multi-size (`sizes` set), (c) responsive (any of `min_width`/`max_width`/`min_height`/`max_height` set), (d) none (no size constraint declared — accepts any dimensions). Combining modes is rejected at schema layer.","oneOf":[{"title":"fixed","required":["width","height"],"not":{"anyOf":[{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"multi-size","required":["sizes"],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"responsive","anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]}]}},{"title":"none","not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}}]}],"properties":{"slots":{"default":[{"asset_group_id":"tag_url","asset_type":"url","required":true},{"asset_group_id":"backup_image","asset_type":"image","required":false}],"description":"Backward-compatible URL-delivery slots. `tag_url` MUST use `url_type: ad_request`. A format option accepting `inline_markup` or `paired_redirect` overrides this list with a required slot whose `asset_type` is `display_tag`; the display-tag asset keeps paired redirect URLs atomic."},"width":{"type":"integer","minimum":1,"description":"Required tag rendering width in pixels — use for fixed-size slots. For multi-size flexible slots use `sizes[]`; for responsive use `min_width`/`max_width`/`min_height`/`max_height`. Exactly one of `(width, height)`, `sizes[]`, or `min/max_width` + `min/max_height` ranges MUST be set."},"height":{"type":"integer","minimum":1,"description":"Required tag rendering height in pixels. See `width` for size-mode mutual exclusion."},"sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"List of accepted (width, height) pairs for a multi-size flexible slot. The buyer's third-party tag must render at one of the listed sizes; the seller picks which size to request at impression time. Mutually exclusive with `(width, height)` and with responsive ranges."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted width for responsive third-party tags. Pair with `max_width`. Mutually exclusive with `(width, height)` and `sizes[]`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted width for responsive third-party tags. Pair with `min_width`."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted height for responsive third-party tags. Pair with `max_height`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted height for responsive third-party tags. Pair with `min_height`."},"supported_tag_types":{"type":"array","deprecated":true,"items":{"type":"string","enum":["iframe","javascript","1x1_redirect"]},"description":"Deprecated ambiguous mechanism list. Use `supported_delivery_types`; markup subtype lives on the `display_tag` asset."},"supported_delivery_types":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["tag_url","inline_markup","paired_redirect"]},"description":"Closed set of delivery types this format option can traffic. `paired_redirect` means one atomic ad-request/click-through pair (Internal Redirect semantics), never independently matchable URL slots."},"ssl_required":{"type":"boolean","description":"Whether the tag URL must be HTTPS."},"max_redirect_depth":{"type":"integer","minimum":0,"description":"Maximum redirect chain depth permitted."},"max_response_time_ms":{"type":"integer","minimum":1,"description":"Maximum tag-server response time in milliseconds."},"backup_image_required":{"type":"boolean","description":"Whether a backup image must accompany the tag for environments that cannot render the third-party tag."},"backup_image_max_size_kb":{"type":"integer","minimum":1},"om_sdk_required":{"type":"boolean","description":"Whether the buyer's tag must integrate IAB Open Measurement SDK for viewability."}},"additionalProperties":true},"external:formats/canonical/image_carousel.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/image_carousel.json","title":"Canonical Format: Image Carousel","description":"Multi-card swipeable carousel. The buyer ships a `cards` slot whose value is an **array** of [card-asset](/schemas/core/assets/card-asset.json) objects (a single key with an array value — NOT one key per card, NOT dotted/bracketed paths). Each card-asset carries: `asset_type: \"card\"`, `media` (an image or video asset), optional `headline` (text), optional `landing_page_url` (url asset). Per-card structure is the same across all cards; mixed orientations not allowed within a single carousel. Tracking model: per-card impression and engagement pixels + carousel-level engagement (swipe, view-time). Allowed asset types for a card's `media` field: `image` and `video` (Meta-style mixed-media); platforms can narrow to image-only or video-only via `allowed_card_media_asset_types`.\n\nThe manifest's `assets.cards` value is an array of card-asset objects. Example: `\"cards\": [{\"asset_type\": \"card\", \"media\": {\"asset_type\": \"image\", \"url\": \"...\"}, \"headline\": \"Buy now\", \"landing_page_url\": {\"asset_type\": \"url\", \"url_type\": \"clickthrough\", \"url\": \"...\"}}, ...]`. Each card-asset validates against the card schema; per-card platform extensions attach via the card's `platform_extensions` field, never via inline non-canonical keys.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"v1_translatable":{"default":false,"description":"Inherently new in v2 — multi-card carousels (Meta carousel, Pinterest pin collections, Snap collection ads) weren't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural."},"slots":{"default":[{"asset_group_id":"cards","asset_type":"card","required":true,"min":2,"max":10},{"asset_group_id":"primary_text","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for image_carousel. The `cards` slot's value in the manifest is an array of [card-asset](/schemas/core/assets/card-asset.json) objects; `min` / `max` constrain card count."},"card_aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Aspect ratio shared across all cards (e.g., '1:1', '1.91:1', '4:5')."},"min_cards":{"type":"integer","minimum":2,"description":"Minimum card count (typical: 2 or 3)."},"max_cards":{"type":"integer","description":"Maximum card count (typical: 6, 10, or 35 depending on platform)."},"allowed_card_media_asset_types":{"type":"array","items":{"type":"string","enum":["image","video"]},"description":"Asset types each card's `media` field may carry. Default: ['image']. Polymorphic carousels (Meta) allow ['image', 'video']. Renamed from `allowed_card_asset_types` to disambiguate that this constrains the card's media payload, not the card-asset itself (which is always asset_type: \"card\")."},"allowed_card_asset_types":{"type":"array","deprecated":true,"items":{"type":"string","enum":["image","video"]},"description":"DEPRECATED — alias for `allowed_card_media_asset_types`. Kept for back-compat; prefer the new field name. Removed in 5.0."},"card_image_max_file_size_kb":{"type":"integer","minimum":1},"card_video_max_file_size_kb":{"type":"integer","minimum":1},"card_video_max_duration_ms":{"type":"integer","minimum":1},"primary_text_max_chars":{"type":"integer","minimum":1,"description":"Maximum length of the carousel-level primary text."},"card_headline_max_chars":{"type":"integer","minimum":1,"description":"Per-card headline character limit. Governs the `headline` field on each card-asset in the `cards` slot."},"card_description_max_chars":{"type":"integer","minimum":1,"description":"Per-card description character limit. Governs the `description` field on each card-asset in the `cards` slot. Distinct from `card_headline_max_chars`: description is longer body copy (typically 100-500 chars); headline is the short label (typically 25-40 chars)."},"ssl_required":{"type":"boolean"}},"additionalProperties":true},"external:formats/canonical/video_hosted.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/video_hosted.json","title":"Canonical Format: Hosted Video","description":"Direct video file (mp4/webm/mov) hosted by the buyer. Slot: `video_main` (video asset, file or hosted URL), optional `headline`, `brand_name`, `cta`, `companion_banner`, `landing_page_url`. Tracking model: IAB Open Measurement SDK + external impression/click/quartile pixels via universal_macros. Orientation is a parameter (vertical 9:16 / horizontal 16:9 / square 1:1); slot shape includes optional `brand_name` (typical for vertical short-form) and optional `companion_banner` (typical for horizontal instream). Distinct from `video_vast` (VAST tag, inherent VAST event tracking) — receivers fire impression and click pixels at delivery time.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"const":"screensaver"}}}}],"properties":{"slots":{"default":[{"asset_group_id":"video_main","asset_type":"video","required":true},{"asset_group_id":"headline","asset_type":"text","required":false},{"asset_group_id":"primary_text","asset_type":"text","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"brand_name","asset_type":"text","required":false},{"asset_group_id":"companion_banner","asset_type":"image","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for video_hosted canonical. Buyer ships a video asset (file or hosted URL); optional headline, primary text (long-form caption), CTA (typically constrained via `cta_values`), brand_name (typical for vertical short-form), companion_banner (typical for horizontal instream), and clickthrough URL. Products MAY override or extend the default — e.g., remove `companion_banner` for short-form vertical, narrow `cta` to a value enum, mark `landing_page_url` as required."},"orientation":{"type":"string","enum":["vertical","horizontal","square"],"description":"Video orientation. Vertical = 9:16 (Reels, Stories, Shorts). Horizontal = 16:9 (instream, CTV). Square = 1:1 (in-feed)."},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Aspect ratio. Inferred from orientation if omitted."},"min_width":{"type":"integer","minimum":1},"min_height":{"type":"integer","minimum":1},"max_width":{"type":"integer","minimum":1},"max_height":{"type":"integer","minimum":1},"duration_ms_range":{"type":"array","items":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"minItems":2,"maxItems":2,"contains":{"type":"integer","minimum":0},"description":"[min, max] duration in milliseconds. Either endpoint MAY be null to express an unbounded side: [null, 60000] means up to 60s; [15000, null] means at least 15s. [null, null] is invalid because at least one endpoint must be bounded. **Precedence**: when both `duration_ms_exact` and `duration_ms_range` ship on the same product, `duration_ms_exact` takes precedence — buyers MUST validate against the exact value and ignore the range. SDKs SHOULD lint a warning when both fields ship; producers SHOULD pick one."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship (see `duration_ms_range` description)."},"video_codecs":{"type":"array","items":{"type":"string","enum":["h264","h265","vp8","vp9","av1","prores"]}},"audio_codecs":{"type":"array","items":{"type":"string","enum":["aac","mp3","opus","pcm"]}},"containers":{"type":"array","items":{"type":"string","enum":["mp4","webm","mov"]}},"min_bitrate_kbps":{"type":"integer","minimum":1},"max_bitrate_kbps":{"type":"integer","minimum":1},"max_file_size_mb":{"type":"integer","minimum":1,"description":"Maximum file size, where 1 MB is exactly 1,000,000 bytes."},"frame_rates":{"type":"array","items":{"type":"number"}},"captions":{"type":"string","enum":["required","recommended","not_required"]},"om_sdk_required":{"type":"boolean"},"headline_max_chars":{"type":"integer","minimum":1},"primary_text_max_chars":{"type":"integer","minimum":1},"brand_name_max_chars":{"type":"integer","minimum":1},"cta_values":{"type":"array","items":{"type":"string"}},"companion_banner_widths":{"type":"array","items":{"type":"integer","minimum":1},"description":"Permitted companion banner widths (instream video)."},"companion_banner_heights":{"type":"array","items":{"type":"integer","minimum":1}},"asset_source":{"type":"string","enum":["buyer_uploaded","publisher_host_recorded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered asset bytes come from. Single shared enum across canonicals. See `image.json#asset_source` for the full semantics. `publisher_host_recorded` is audio-specific and has no defined behavior on video. `publisher_owned_reference` is valid when the product accepts an existing post reference via a `published_post` slot instead of uploaded video bytes. Adopters MUST select a value appropriate to the canonical."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded video. When `rejected`, the buyer cannot ship a video asset directly — they must use build_creative, sync_creatives with brief inputs, or sync_creatives with an accepted reference asset so the seller produces or resolves the video."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On `video_hosted` only `screensaver` is valid (ambient looping video the platform plays on idle). Other experiences route per the matrix in docs/creative/ctv-experiences.mdx; linear CTV video declares no experience."}},"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on video_hosted must be screensaver"},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true},"external:formats/canonical/video_vast.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/video_vast.json","title":"Canonical Format: VAST Video","description":"VAST-tag-delivered video creative. Slot: `vast_tag` (vast asset, URL or inline XML, VAST 2.x-4.x). Tracking model: VAST events inherent to the spec — `impression`, `firstQuartile`, `midpoint`, `thirdQuartile`, `complete`, `start`, `pause`, `resume`, `mute`, `unmute`, `expand`, `collapse`, `fullscreen`, `creativeView`, `clickTracking`, `error`. VPAID interactivity via `vpaid_enabled: true` flag. SIMID is carried by the first-class VAST 4.1+ `<InteractiveCreativeFile apiFramework=\"SIMID\">` element on Linear creatives. Orientation is a parameter (vertical / horizontal / square). Distinct from `video_hosted` (direct file with external tracking).","properties":{"slots":{"default":[{"asset_group_id":"vast_tag","asset_type":"vast","required":true},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for video_vast canonical. Buyer ships a VAST tag (URL or inline XML, VAST 2.x-4.x) plus an optional clickthrough URL (which falls back to the VAST `ClickThrough` element when omitted). Tracking events are inherent to VAST and don't require explicit slots."},"orientation":{"type":"string","enum":["vertical","horizontal","square"]},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$"},"vast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json"},"minItems":1,"uniqueItems":true,"description":"VAST versions accepted by this product format option. The asset still declares exactly one `vast_version`; compatibility requires membership in this set and the seller-wide execution set."},"vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json","deprecated":true,"description":"Deprecated one-element alias for `vast_versions`. Producers use either the singular legacy alias or the plural 3.2 field, never both."},"media_file_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-media-file-requirements.json","description":"Technical acceptance constraints for alternative VAST MediaFile renditions. Each applicable resolved InLine linear creative needs at least one MediaFile satisfying all declared constraints."},"vpaid_enabled":{"type":"boolean","description":"Whether VPAID interactivity is supported. When true, the VAST tag may carry VPAID JS/Flash payloads."},"vpaid_version":{"type":"string","enum":["1.0","2.0"]},"simid_supported":{"type":"boolean","description":"Whether the seller accepts IAB SIMID through `<InteractiveCreativeFile apiFramework=\"SIMID\">` on a Linear VAST creative. SIMID is not a generic VAST extension and cannot be serialized under NonLinearAds; every `ctv_ad_experience` profile therefore forbids `true`."},"duration_ms_range":{"type":"array","items":{"type":"integer","minimum":0},"minItems":2,"maxItems":2,"description":"[min, max] duration in milliseconds. **Precedence**: `duration_ms_exact` takes precedence when both ship. SDKs SHOULD lint a warning when both fields ship."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship."},"min_width":{"type":"integer","minimum":1,"description":"Minimum placement/player width in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum placement/player width in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"min_height":{"type":"integer","minimum":1,"description":"Minimum placement/player height in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum placement/player height in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"creative_type":{"type":"string","enum":["linear","nonlinear","either"],"description":"Required VAST creative class: `linear` (in-stream Linear), `nonlinear` (NonLinearAds overlay-class), or `either`. Supersedes `linear_required`; when both are present `creative_type` wins, and validators treat `linear_required: true` with no `creative_type` as `linear`."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option is eligible to serve. On video_vast only `pause`, `screensaver`, `overlay`, `squeezeback`, and `in_scene` are valid (`menu` routes to native_in_feed or sponsored_placement), and `creative_type` MUST be `nonlinear`. Because VAST places `<InteractiveCreativeFile>` only under Linear `<MediaFiles>`, `simid_supported` MUST NOT be true on any of these NonLinear profiles. Per-experience floors: `overlay` and `squeezeback` require a 10s minimum duration; `in_scene` requires a 3s minimum brand-exposure duration and forbids interactivity (`vpaid_enabled` MUST NOT be true); `pause` has no duration floor and ends on viewer or device action."},"motion_level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1motion-level.json","description":"Accepted motion class for the rendered creative (AdCOM attrs 21-23)."},"activation_methods":{"type":"array","uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1activation-method.json"},"description":"Viewer activation mechanisms this option offers. Activations are engagement events, not impressions."},"linear_required":{"type":"boolean","description":"Whether the VAST creative must be linear (non-skippable in-stream). Superseded by `creative_type`; retained for pre-3.2 declarations."},"skippable_after_ms":{"type":"integer","minimum":0,"description":"When skippable, the buyer-side skip threshold in milliseconds (e.g., 5000 for 5-second skippable pre-roll)."},"max_wrapper_depth":{"type":"integer","minimum":0,"description":"Maximum VAST wrapper redirect depth permitted."},"ssl_required":{"type":"boolean"}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"not":{"const":"menu"}},"creative_type":{"const":"nonlinear"},"simid_supported":{"const":false}},"required":["creative_type"]}},{"if":{"properties":{"ctv_ad_experience":{"const":"in_scene"}},"required":["ctv_ad_experience"]},"then":{"properties":{"vpaid_enabled":{"const":false}}}}],"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on video_vast must be one of pause, screensaver, overlay, squeezeback, in_scene, with creative_type nonlinear","ctv_nonlinear_no_simid":"Every video_vast CTV experience is nonlinear and forbids simid_supported true because VAST serializes InteractiveCreativeFile only under Linear MediaFiles","ctv_duration_floors":"overlay and squeezeback require duration_ms_exact or duration_ms_range minimum of at least 10000; in_scene at least 3000; pause has no floor","ctv_in_scene_no_interactivity":"in_scene additionally forbids vpaid_enabled","ctv_activation_copy_slots":"push_notification activation_methods SHOULD declare an activation_message slot; text_message SHOULD declare an activation_text_message slot; email SHOULD declare activation_email_subject and activation_email_body slots. Missing copy slots emit a non-blocking validate_input warnings[] entry.","creative_type_precedence":"creative_type wins over linear_required when both are declared; linear_required true with creative_type nonlinear or either is a contradiction and is rejected"},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true,"not":{"required":["vast_version","vast_versions"]}},"external:core/vast-media-file-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/vast-media-file-requirements.json","title":"VAST MediaFile Requirements","description":"Technical acceptance requirements for the alternative video or audio `<MediaFile>` renditions in a resolved VAST `<InLine>` linear creative. A linear creative satisfies this object when at least one of its MediaFile elements satisfies every declared field; incompatible sibling renditions do not reject the creative. Omitted fields are governed by the enclosing format declaration's `technical_requirements_complete` assertion and MUST NOT be inferred from prose or implementation defaults. When a declared constraint cannot be proven from VAST metadata or safe inspection of the referenced media bytes, compatibility is undeclared rather than assumed. Container identity MUST come from authoritative metadata or byte inspection, never only a URI filename extension. Audio VAST declarations use audio MIME types and do not set the dimension constraints below because VAST audio MediaFiles carry width and height values of 0.","type":"object","properties":{"delivery_methods":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-media-delivery-method.json"},"minItems":1,"uniqueItems":true,"description":"Accepted values of the required `MediaFile@delivery` attribute. `progressive` identifies a directly downloadable media file; `streaming` identifies a streaming media resource."},"mime_types":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]*/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]*$"},"minItems":1,"uniqueItems":true,"description":"Accepted MIME types from `MediaFile@type`, compared case-insensitively after trimming optional whitespace. Parameters are not accepted in this field. Examples: `video/mp4`, `video/webm`, `audio/mpeg`, `audio/aac`."},"containers":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9._+-]*$"},"minItems":1,"uniqueItems":true,"description":"Accepted normalized container identifiers, such as `mp4`, `webm`, or `mpeg_ts`. A receiver MUST determine the container from authoritative metadata or safe byte inspection and MUST NOT guess it only from the media URI suffix."},"codecs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true,"description":"Accepted codec identifiers for `MediaFile@codec`, using the codec syntax referenced by the applicable VAST version. A missing codec attribute does not satisfy a declared codec constraint unless safe inspection establishes the codec."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted `MediaFile@width` in pixels."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted `MediaFile@width` in pixels."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted `MediaFile@height` in pixels."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted `MediaFile@height` in pixels."},"min_bitrate_kbps":{"type":"integer","minimum":1,"description":"Minimum accepted MediaFile bitrate in kilobits per second. A fixed `MediaFile@bitrate` must be at least this value. For adaptive/streaming media, the declared `MediaFile@minBitrate` must be at least this value. Safe byte inspection may establish the value when metadata is absent."},"max_bitrate_kbps":{"type":"integer","minimum":1,"description":"Maximum accepted MediaFile bitrate in kilobits per second. A fixed `MediaFile@bitrate` must not exceed this value. For adaptive/streaming media, the declared `MediaFile@maxBitrate` must not exceed this value. Safe byte inspection may establish the value when metadata is absent."},"max_file_size_bytes":{"type":"integer","minimum":1,"description":"Maximum accepted MediaFile size in exact bytes. `MediaFile@fileSize`, when present, is expressed in bytes; a receiver MAY verify it against safely fetched media bytes and MUST use the verified byte count if the values disagree."}},"x-adcp-validation":{"verifier_constraints":{"range_order":"When both bounds are declared, min_width MUST be <= max_width, min_height MUST be <= max_height, and min_bitrate_kbps MUST be <= max_bitrate_kbps.","adaptive_bitrate_containment":"A MediaFile advertising a minBitrate/maxBitrate interval satisfies declared bitrate bounds only when its entire interval is contained within those bounds; overlap alone is insufficient.","alternative_renditions":"For each applicable resolved InLine linear creative, at least one MediaFile MUST satisfy every declared property in this object; requirements MUST NOT be satisfied by combining properties from different MediaFile elements.","missing_metadata":"If a declared property cannot be established from VAST metadata or safe inspection, compatibility is unproven and the MediaFile does not satisfy that property."}},"additionalProperties":true},"external:enums/vast-media-delivery-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/vast-media-delivery-method.json","title":"VAST Media Delivery Method","description":"Delivery method declared by the required VAST MediaFile `delivery` attribute.","type":"string","enum":["progressive","streaming"]},"external:formats/canonical/audio_hosted.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/audio_hosted.json","title":"Canonical Format: Hosted Audio","description":"Direct audio creative — buyer ships an `audio` asset (mp3/aac/wav) for asset-driven products, or ships a `script` / `creative_brief` text asset for products where the seller produces audio internally (podcast host-reads, TTS synthesis). Optional companion slots: `companion_image`, `brand_name`, `landing_page_url`. Tracking model: standard impression + completion + companion-image-click pixels via universal_macros. Distinct from `audio_daast` (DAAST tag, inherent DAAST event tracking). For host-reads and synthesized audio, the format declares `asset_source: 'publisher_host_recorded'` or `'agent_synthesized'` plus `buyer_asset_acceptance: 'rejected'`; the format's `slots` declaration enumerates which assets the buyer ships (e.g., `script` text asset for host-reads). The seller decides how to consume each asset (render verbatim vs produce audio from text) — there is no separate manifest 'inputs' map; everything the buyer ships goes in `assets`.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"slots":{"default":[{"asset_group_id":"audio_main","asset_type":"audio","required":true},{"asset_group_id":"companion_image","asset_type":"image","required":false},{"asset_group_id":"brand_name","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for buyer-uploaded audio. Host-read products override with a `script` (asset_type: text) or `creative_brief` (asset_type: brief) slot in place of `audio_main`, plus `asset_source: 'publisher_host_recorded'` and `buyer_asset_acceptance: 'rejected'`. TTS-from-script products override similarly with `asset_source: 'seller_pre_rendered_from_brief'`."},"duration_ms_range":{"type":"array","items":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"minItems":2,"maxItems":2,"contains":{"type":"integer","minimum":0},"description":"[min, max] duration in milliseconds. Either endpoint MAY be null to express an unbounded side: [null, 60000] means up to 60s; [15000, null] means at least 15s. [null, null] is invalid because at least one endpoint must be bounded. **Precedence**: when both `duration_ms_exact` and `duration_ms_range` ship on the same product, `duration_ms_exact` takes precedence — buyers MUST validate against the exact value and ignore the range. SDKs SHOULD lint a warning when both fields ship; producers SHOULD pick one."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship."},"audio_codecs":{"type":"array","items":{"type":"string","enum":["mp3","aac","wav","opus","flac"]}},"audio_sample_rates":{"type":"array","items":{"type":"integer","minimum":1}},"audio_channels":{"type":"array","items":{"type":"string","enum":["mono","stereo"]}},"min_bitrate_kbps":{"type":"integer","minimum":1},"max_bitrate_kbps":{"type":"integer","minimum":1},"max_file_size_mb":{"type":"number","exclusiveMinimum":0,"description":"Maximum hosted audio file size in decimal megabytes. Agents that proxy or cache media SHOULD advertise their effective transport ceiling here."},"loudness_lufs":{"type":"number","description":"Required integrated loudness in LUFS (typical: -16 for streaming/podcast, -23 for broadcast). Negative values."},"loudness_tolerance_db":{"type":"number","minimum":0,"description":"Permitted deviation from loudness_lufs in dB."},"true_peak_dbfs":{"type":"number","description":"Maximum true-peak level in dBFS (typical: -2)."},"asset_source":{"type":"string","enum":["buyer_uploaded","publisher_host_recorded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered audio bytes come from. Single shared enum across canonicals (see `image.json#asset_source` for the full semantics). `publisher_host_recorded`: the publisher's host records the audio (podcast host-read pattern); buyer must use the publisher's build_creative capability. `publisher_owned_reference` is valid only when the product accepts a reference asset whose publisher-owned source resolves to playable audio. `publisher_host_recorded` remains the normal audio-specific host-read value."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded audio. When `rejected`, the buyer cannot ship an audio asset directly — they must use build_creative (or sync_creatives with brief inputs) so the seller produces the audio. Combined with `asset_source`, lets a product declare 'I produce audio from briefs and refuse buyer uploads' (asset_source=`seller_pre_rendered_from_brief`, buyer_asset_acceptance=`rejected`)."},"companion_image_required":{"type":"boolean"},"companion_image_aspect_ratio":{"type":"string"},"companion_image_max_file_size_kb":{"type":"integer","minimum":1},"brand_name_max_chars":{"type":"integer","minimum":1}},"additionalProperties":true},"external:formats/canonical/audio_vast.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/audio_vast.json","title":"Canonical Format: VAST Audio","description":"VAST-tag-delivered audio creative. Standardized VAST audio support begins at 4.1; a seller may explicitly advertise older VAST versions only for legacy audio interoperability. Slot: `vast_tag` (vast asset, URL or inline XML). Tracking is inherent to VAST, including impression, start, quartiles, complete, click, error, pause/resume, and mute/unmute events. Distinct from `audio_hosted` (direct audio bytes) and `audio_daast` (legacy DAAST tag delivery).","properties":{"slots":{"default":[{"asset_group_id":"vast_tag","asset_type":"vast","required":true},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for the audio_vast canonical. The buyer supplies a VAST tag (URL or inline XML) plus an optional clickthrough URL, which falls back to the VAST ClickThrough when omitted. Tracking events and companion creatives carried by the VAST document do not require separate slots."},"vast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json"},"minItems":1,"uniqueItems":true,"description":"VAST audio versions accepted by this product format option. Standardized audio support begins at VAST 4.1; listing 2.0, 3.0, or 4.0 explicitly declares seller-supported legacy audio interoperability rather than standards-conformant VAST audio. The asset declares exactly one vast_version; compatibility requires membership in this set and the seller-wide execution set."},"vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json","deprecated":true,"description":"Deprecated one-element alias for vast_versions. Producers use either the singular legacy alias or the plural 3.2 field, never both. VAST 4.1+ is the standards-conformant audio profile; older values declare legacy audio interoperability."},"media_file_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-media-file-requirements.json","description":"Technical acceptance constraints for alternative audio MediaFile renditions in each resolved InLine linear creative. Declared MIME types must be audio/*; visual-dimension constraints are invalid because VAST represents audio MediaFiles with width and height 0."},"duration_ms_range":{"type":"array","items":{"type":"integer","minimum":0},"minItems":2,"maxItems":2,"description":"[min, max] duration in milliseconds. duration_ms_exact takes precedence when both fields are present; SDKs SHOULD warn when both are supplied."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, the resolved audio creative duration must equal this value. Takes precedence over duration_ms_range."},"skippable_after_ms":{"type":"integer","minimum":0,"description":"When skippable, the buyer-side skip threshold in milliseconds."},"max_wrapper_depth":{"type":"integer","minimum":0,"description":"Maximum VAST wrapper redirect depth permitted."},"ssl_required":{"type":"boolean"},"companion_image_required":{"type":"boolean","description":"Whether the resolved VAST audio ad must include a companion creative."}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"x-adcp-validation":{"verifier_constraints":{"audio_profile":"The resolved InLine creative MUST be Linear and supply a playable audio MediaFile; VAST 4.1+ documents MUST declare Ad adType audio. Video and hybrid ads do not satisfy audio_vast.","audio_media_files":"Every playable MediaFile used to satisfy the declaration MUST have an audio/* MIME type and the VAST-required width and height values of 0.","audio_version_compatibility":"VAST 4.1+ is the standards-conformant audio profile. A seller accepts 2.0, 3.0, or 4.0 only by listing that version explicitly as legacy audio interoperability."},"spec":"docs/creative/channels/audio.mdx"},"additionalProperties":true,"not":{"anyOf":[{"required":["vast_version","vast_versions"]},{"properties":{"media_file_requirements":{"properties":{"mime_types":{"contains":{"not":{"pattern":"^[Aa][Uu][Dd][Ii][Oo]/"}}}},"required":["mime_types"]}},"required":["media_file_requirements"]},{"properties":{"media_file_requirements":{"anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},"required":["media_file_requirements"]}]}},"external:formats/canonical/audio_daast.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/audio_daast.json","title":"Canonical Format: DAAST Audio","description":"DAAST-tag-delivered audio creative (audio analog of VAST). Slot: `daast_tag` (daast asset, URL or inline XML). Tracking model: DAAST events inherent to the spec — `impression`, `firstQuartile`, `midpoint`, `thirdQuartile`, `complete`, `start`, `pause`, `resume`, `mute`, `unmute`, `clickTracking`, `error`. Distinct from `audio_hosted` (direct file with external tracking).","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"slots":{"default":[{"asset_group_id":"daast_tag","asset_type":"daast","required":true},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for audio_daast canonical. Buyer ships a DAAST tag (URL or inline XML, 1.0 or 1.1) plus an optional clickthrough URL. Tracking events are inherent to DAAST and don't require explicit slots."},"daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1daast-version.json","deprecated":true,"description":"Deprecated one-element alias for `daast_versions`. Producers use either the singular legacy alias or the plural 3.2 field, never both."},"daast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_versions","description":"Accepted DAAST versions for this format option. A tracker execution selector's daast_versions must be a nonempty subset of this set."},"duration_ms_range":{"type":"array","items":{"type":"integer","minimum":0},"minItems":2,"maxItems":2,"description":"[min, max] duration in milliseconds. **Precedence**: `duration_ms_exact` takes precedence when both ship. SDKs SHOULD lint a warning when both fields ship."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship."},"linear_required":{"type":"boolean"},"max_wrapper_depth":{"type":"integer","minimum":0},"ssl_required":{"type":"boolean"},"companion_image_required":{"type":"boolean"}},"not":{"required":["daast_version","daast_versions"]},"additionalProperties":true},"external:formats/canonical/sponsored_placement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/sponsored_placement.json","title":"Canonical Format: Sponsored Placement (retail-media catalog-driven)","description":"Catalog-driven retail-media format. Slot: `source_catalog` (catalog asset — product/SKU/ASIN/GTIN catalog reference, REQUIRED), optional `hero_asset`, optional `landing_page_url`. Buyer supplies the catalog reference; surface composes per-item or multi-item rendering using its native placement template. **Composition is deterministic** — buyer can predict per-slot rendering from the catalog item structure. Tracking model: per-item impression + click + conversion (catalog-keyed via offering_id/sku/gtin macros). Covers Amazon Sponsored Products, Criteo Sponsored Products, CitrusAd Sponsored Products, Walmart Connect Sponsored Products, Pinterest Collection (catalog-driven mode).\n\n**Scope (normative — buyer-agent routing).** This canonical is the home for catalog-driven retail-media placements ONLY. The defining feature is the `source_catalog` slot — products under this canonical compose their creative *per catalog item* using the buyer-supplied catalog feed. Without a catalog feed there is nothing to render against. Buyer agents reading `format_kind: sponsored_placement` MUST attach a catalog reference; sellers MUST require `source_catalog` in the manifest.\n\n**Not this canonical (route elsewhere):**\n- IAB in-feed native ads, content-recommendation widgets (Taboola, Outbrain, Yahoo Native, AdMob Native, in-feed sponsored cards) — use `native_in_feed` (asset-bundle composition; no catalog).\n- Algorithmic surface that picks from a buyer-supplied asset pool (Google PMax, Meta Advantage+) — use `responsive_creative`.\n- Single-image or single-video creative — use `image` or `video_hosted`.\n\nThe earlier broader framing ('any sponsored placement') was too loose for buyer-agent routing — a buyer reading `sponsored_placement` couldn't disambiguate a catalog-driven Amazon SP from an in-feed Taboola widget. As of 3.1, the canonical is narrowed to catalog-keyed retail-media; native moves to `native_in_feed`. Distinct from `responsive_creative` (algorithmic combinator from buyer pool) and `agent_placement` (text/audio AI-surface composition).","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"enum":["menu","squeezeback","in_scene"]}}}}],"properties":{"experimental":{"default":true,"description":"Marked experimental at 3.1 GA: the canonical covers 4 meaningfully different retail-media adapter contracts (Amazon SP, Criteo SP / CitrusAd SP, Pinterest Collection, generative-per-SKU). Adopter contracts vary; buyers MUST validate per-adapter behavior before routing budget. Promotion to non-experimental gated on the #4592 adapter-contract docs work."},"v1_translatable":{"default":false,"description":"Inherently new in v2 — retail-media catalog placements weren't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural, not a registry-coverage gap."},"slots":{"default":[{"asset_group_id":"source_catalog","required":true,"asset_type":"catalog"},{"asset_group_id":"hero_asset","required":false,"asset_type":"image"},{"asset_group_id":"landing_page_url","required":false,"asset_type":"url"}]},"supported_catalog_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1catalog-type.json"},"description":"Catalog types this product accepts."},"min_items":{"type":"integer","minimum":1,"description":"Minimum catalog item count buyer must supply."},"max_items":{"type":"integer","description":"Maximum items considered for placement."},"fanout_mode":{"type":"string","enum":["per_item","multi_item_in_creative","single_item"],"description":"How items map to delivery: per_item = one ad per catalog item; multi_item_in_creative = composed multi-item ad (Pinterest Collection, Snap Collection); single_item = one ad showing one item."},"required_catalog_fields":{"type":"array","items":{"type":"string"},"description":"Catalog item fields the seller requires (e.g., ['title', 'image_url', 'price'])."},"supported_id_types":{"type":"array","items":{"type":"string","enum":["asin","sku","gtin","offering_id","store_id","hotel_id","flight_id","vehicle_id","listing_id","program_id","destination_id","app_id","job_id"]},"description":"Catalog identifier types the placement renders against."},"hero_asset_supported":{"type":"boolean","description":"Whether the buyer can supply a hero/banner asset alongside the catalog (Pinterest Collection pattern)."},"item_production_model":{"type":"string","enum":["buyer_uploaded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized"],"default":"buyer_uploaded","description":"How each per-item creative is produced. Covers the same production-source axis as `asset_source` on `image` / `video_hosted` / `audio_hosted` but with a 4-value subset — drops `publisher_host_recorded` because it's audio-specific and doesn't apply to retail-media catalog placements. SDK codegen MAY share a base enum and narrow per-canonical, or emit two distinct enums; either way the wire values overlap exactly for the 4 retained values. `buyer_uploaded` (default, current Amazon/Criteo/CitrusAd pattern): the buyer's catalog already contains rendered assets per item; the seller composes the placement using those assets. (\"Uploaded\" reads slightly off for catalog-keyed items where the buyer didn't actively upload bytes — the catalog ingestion already supplied them — but the semantic is the same: rendered bytes are buyer-supplied, not seller-produced.) `seller_pre_rendered_from_brief`: the buyer ships a brief plus the catalog reference; the seller renders one creative per catalog item from the brief at sync_creatives time. `seller_human_designed`: seller's design team produces per-item renders manually. `agent_synthesized`: AI synthesis pipeline produces per-item renders; pair with `synthesis_nondeterministic: true` for Veo/Sora-class generative video applied per item. Captures the multi-output generative pattern (1 brief × N catalog items → N rendered creatives) under the existing canonical without requiring a separate canonical. Distinct from `fanout_mode`, which describes how items map to delivery slots after rendering."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On `sponsored_placement`: `menu` (sponsored app/content tiles and rows whose assets derive from a catalog listing — Fire-TV-tile pattern), `squeezeback`, and `in_scene` (seller-composited brand integrations produced from the catalog/brief rather than a buyer wire creative). Asset-bundle menu heroes route to `native_in_feed`."}},"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on sponsored_placement must be menu, squeezeback, or in_scene"},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true},"external:formats/canonical/native_in_feed.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/native_in_feed.json","title":"Canonical Format: Native In-Feed","description":"IAB-shaped native creative for in-feed and content-recommendation surfaces. Default slots cover the primary IAB OpenRTB Native 1.2 asset types — `title` (Title Asset), `body_text` (Data Asset type 2), `main_image` (Image Asset main), `icon` (Image Asset icon), `cta` (Data Asset type 12), `advertiser_name` (Data Asset type 1), `sponsored_label` (Title-adjacent), `landing_page_url` (Link Asset), `display_url` (Data Asset type 11 — visible URL/domain, distinct from clickthrough), `rating` (Data Asset type 3 — app/product rating), `price` (Data Asset type 6 — product price), plus renderer-fired `impression_tracker` / `viewability_tracker` / `click_tracker` (`pixel_tracker`). Products MAY use `slots_override` to add other IAB Native data asset types (likes — type 4, downloads — type 5, saleprice — type 7, phone_number — type 8, address — type 9, desc2 — type 10, etc.) or to remove slots the surface doesn't render. The publisher's renderer assembles these into its own look-and-feel — feed card, content-recommendation slot, in-stream native unit. Buyer ships a single asset bundle; the surface chooses presentation.\n\n**Scope (normative — buyer-agent routing).** This canonical is the home for:\n- IAB OpenRTB Native 1.2 in-feed native ads (publisher feeds, app feeds)\n- Content-recommendation widgets (Taboola, Outbrain, Yahoo Recommendations)\n- AdMob Native / Yahoo Native publisher slots\n- In-feed sponsored placements without catalog dependency\n\n**Not this canonical:**\n- Catalog-driven retail-media (Amazon SP, Criteo SP, CitrusAd SP) — use `sponsored_placement` (requires `source_catalog`).\n- Algorithmic surface that picks from a buyer-supplied asset pool (Google PMax, Meta Advantage+) — use `responsive_creative`.\n- Multi-card carousel — use `image_carousel`.\n- Video-first native units where the asset is a hosted video file — use `video_hosted` with `applies_to_channels: [\"native\"]`. (Distinct from the CTV menu profile: a menu hero remains this canonical because the platform assembles the full asset bundle and the video rides the Native 1.2 `vasttag` video asset, playing on focus rather than being the unit itself.)\n\nDistinct from `sponsored_placement` along the catalog axis: native_in_feed is asset-bundle composition; sponsored_placement is catalog-row composition. A buyer agent reading `format_kind: native_in_feed` knows to assemble title + image + body + CTA; reading `format_kind: sponsored_placement` knows to attach a catalog feed.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"enum":["menu","overlay"]}}}},{"if":{"anyOf":[{"required":["menu_placement"]},{"required":["focus_behavior"]}]},"then":{"properties":{"ctv_ad_experience":{"const":"menu"}},"required":["ctv_ad_experience"]}}],"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on native_in_feed must be menu or overlay","menu_profile_fields":"menu_placement and focus_behavior require ctv_ad_experience menu","focus_video_pairing":"focus_behavior autoplay_muted or autoplay_sound requires the effective slots to include the video asset group","ctv_activation_copy_slots":"push_notification activation_methods SHOULD declare an activation_message slot; text_message SHOULD declare an activation_text_message slot; email SHOULD declare activation_email_subject and activation_email_body slots. Missing copy slots emit a non-blocking validate_input warnings[] entry."},"spec":"docs/creative/ctv-experiences.mdx"},"properties":{"experimental":{"default":false,"description":"Stable at 3.1 GA. Shape mirrors IAB OpenRTB Native 1.2 — the renderer contract is well-established across in-feed native and content-recommendation adopters."},"v1_translatable":{"default":true,"description":"Translates to v1 named native formats (e.g., `native_standard`, `native_content`) via the projection registry. Sellers with existing v1 named native formats SHOULD point `v1_format_ref[]` at them."},"slots":{"default":[{"asset_group_id":"title","asset_type":"text","required":true},{"asset_group_id":"body_text","asset_type":"text","required":false},{"asset_group_id":"main_image","asset_type":"image","required":false},{"asset_group_id":"icon","asset_type":"image","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"advertiser_name","asset_type":"text","required":true},{"asset_group_id":"sponsored_label","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":true},{"asset_group_id":"display_url","asset_type":"text","required":false},{"asset_group_id":"rating","asset_type":"text","required":false},{"asset_group_id":"price","asset_type":"text","required":false},{"asset_group_id":"video","asset_type":"vast","required":false},{"asset_group_id":"impression_tracker","asset_type":"pixel_tracker","required":false},{"asset_group_id":"viewability_tracker","asset_type":"pixel_tracker","required":false},{"asset_group_id":"click_tracker","asset_type":"pixel_tracker","required":false}],"description":"Default slot shape for native_in_feed. Mirrors IAB OpenRTB Native 1.2 asset types, including the Native video asset: `video` carries a VAST document (the Native 1.2 `vasttag` field) for video-bearing native units such as CTV menu heroes with focus-triggered playback. Products MAY override (`slots_override` on the projection ref) to narrow per-slot limits (`max_chars` on title/body) or remove unused slots (a content-recommendation slot that doesn't display an icon)."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On native_in_feed `menu` and `overlay` are valid. `menu`: smart-TV home/menu surfaces where the platform assembles buyer assets (background/main image, logo/icon, copy, optional focus-triggered video); `menu_placement` selects the tile vs headline-banner variant, and catalog-derived sponsored tiles route to `sponsored_placement` instead. `overlay`: seller-composited in-stream overlays supplied as an asset bundle (video, logo, imagery, copy, activation copy) — the contract overlay sellers that do not ingest VAST tags use; VAST-ingesting sellers publish a `video_vast` sibling option instead. The wire name stays `native_in_feed` for 3.x even though neither surface is literally in-feed."},"menu_placement":{"type":"string","enum":["tile","headline_banner"],"description":"Menu surface variant, mapping to OpenRTB Native `plcmttype` 1 (tile/feed) and 3 (headline banner). Valid only with `ctv_ad_experience: \"menu\"`."},"focus_behavior":{"type":"string","enum":["none","autoplay_muted","autoplay_sound"],"description":"What happens when the viewer's remote focus lands on the unit. `autoplay_*` requires a `video` asset; playback method maps to AdCOM playbackmethod on OpenRTB bridges. Valid only with `ctv_ad_experience: \"menu\"`."},"motion_level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1motion-level.json","description":"Accepted motion class for the rendered unit (AdCOM attrs 21-23)."},"activation_methods":{"type":"array","uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1activation-method.json"},"description":"Viewer activation mechanisms this option offers (QR, deep link, send-to-device). Activations are engagement events, not impressions."},"title_max_chars":{"type":"integer","minimum":1,"description":"Maximum character length for the title slot. IAB native typical: 25 (short) to 90 (long). Buyer agents SHOULD validate ship-time title length against this."},"body_text_max_chars":{"type":"integer","minimum":1,"description":"Maximum character length for the body_text slot. IAB native typical: 90 (mainline) to 140 (extended)."},"cta_max_chars":{"type":"integer","minimum":1,"description":"Maximum character length for the cta slot. Typical: 15–25."},"cta_values":{"type":"array","items":{"type":"string"},"description":"Permitted CTA values for this product (e.g., ['LEARN_MORE', 'SHOP_NOW', 'SIGN_UP', 'DOWNLOAD']). When set, narrows the cta slot to a closed enum."},"main_image_sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"Accepted logical (width, height) pairs for the main_image slot. Common IAB native sizes: 1200×627 (1.91:1), 1080×1080 (1:1), 1080×1350 (4:5). When the effective main_image slot declares `pixel_ratios`, intrinsic asset dimensions are the matched logical pair multiplied by the selected ratio; absence remains 1x."},"icon_size":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false,"description":"Required logical (width, height) for the icon slot when present (typical: 80×80 or 100×100). When the effective icon slot declares `pixel_ratios`, intrinsic dimensions are multiplied by the selected ratio; absence remains 1x."},"max_image_file_size_kb":{"type":"integer","minimum":1,"description":"Maximum file size in kilobytes for main_image and icon."},"image_formats":{"type":"array","items":{"type":"string","enum":["jpg","jpeg","png","gif","webp"]},"description":"Permitted image file formats."},"ssl_required":{"type":"boolean","description":"Whether trackers, landing pages, and image URLs must be served over HTTPS."},"asset_source":{"type":"string","enum":["buyer_uploaded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered native assets come from. `publisher_host_recorded` is omitted (audio-specific and not meaningful for native). Other values mirror the shared production-source axis used on `image` / `video_hosted`. `buyer_uploaded` (default): buyer ships pre-rendered title/image/body. `seller_pre_rendered_from_brief`: buyer ships a brief, seller renders the native bundle. `agent_synthesized`: AI synthesis pipeline produces title + image + body from a brief; pair with `synthesis_nondeterministic: true` for generative pipelines that can't guarantee in-spec output. `publisher_owned_reference`: buyer ships an existing published post reference; the seller resolves the post into the native presentation after authorization/review."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded native assets. When `rejected`, the buyer cannot ship pre-rendered title/image/body — they must use `build_creative`, `sync_creatives` with brief inputs, or an accepted `published_post` reference so the seller produces or resolves the native bundle."}},"additionalProperties":true},"external:formats/canonical/responsive_creative.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/responsive_creative.json","title":"Canonical Format: Responsive Creative","description":"Buyer supplies a pool of typed assets (multiple headlines, descriptions, images, videos, logos); the surface algorithmically composes combinations per placement. **Composition is algorithmic** — surface picks combinations and reports per-asset performance breakdowns. Covers Google Responsive Display Ads (RDA), Responsive Search Ads (RSA), Performance Max (PMax), Demand Gen, and Meta Advantage+ creative. Industry term: \"Responsive\" (Google) / \"Advantage+ creative\" (Meta) / \"Dynamic Creative\" (older Meta term). Distinct from `sponsored_placement` (catalog-driven, deterministic) and `agent_placement` (AI-surface composition). The structured `slots` field below enumerates expected canonical asset_group_id slots; per-slot count/length narrowing lives in flat parameters (`headlines_min`, `headline_max_chars`, etc.).","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Marked experimental at 3.1 GA: composition is algorithmic (the surface picks combinations and reports per-asset breakdowns), and there's no clean v1-translatable equivalent. Buyers ship asset pools rather than rendered creatives; the surface's per-impression composition cannot be predicted by `validate_input`. Adopters SHOULD validate behavior per surface (Google PMax vs Meta Advantage+ creative differ meaningfully)."},"v1_translatable":{"default":false,"description":"Inherently new in v2 — algorithmic asset-pool composition (Google PMax / Meta Advantage+ creative) wasn't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural."},"slots":{"default":[{"asset_group_id":"headlines","asset_type":"text","required":true,"min":3,"max":15},{"asset_group_id":"long_headlines","asset_type":"text","required":false,"min":1,"max":5},{"asset_group_id":"descriptions","asset_type":"text","required":true,"min":2,"max":5},{"asset_group_id":"images_landscape","asset_type":"image","required":false,"min":1,"max":20},{"asset_group_id":"images_square","asset_type":"image","required":false,"min":1,"max":20},{"asset_group_id":"images_vertical","asset_type":"image","required":false,"min":1,"max":20},{"asset_group_id":"video","asset_type":"video","required":false,"min":0,"max":5},{"asset_group_id":"logo","asset_type":"image","required":true,"min":1,"max":5,"logo_slots":["logo_card_light","logo_card_dark","marketplace_listing","ad_end_card"],"required_logo_slots":["logo_card_light","logo_card_dark"]},{"asset_group_id":"landing_page_url","asset_type":"url","required":true,"min":1,"max":1}]},"headlines_min":{"type":"integer","minimum":0},"headlines_max":{"type":"integer","minimum":0},"headline_max_chars":{"type":"integer","minimum":1},"long_headlines_min":{"type":"integer","minimum":0},"long_headlines_max":{"type":"integer","minimum":0},"long_headline_max_chars":{"type":"integer","minimum":1},"descriptions_min":{"type":"integer","minimum":0},"descriptions_max":{"type":"integer","minimum":0},"description_max_chars":{"type":"integer","minimum":1},"images_landscape_min":{"type":"integer","minimum":0},"images_landscape_max":{"type":"integer","minimum":0},"images_landscape_aspect_ratio":{"type":"string"},"images_square_min":{"type":"integer","minimum":0},"images_square_max":{"type":"integer","minimum":0},"images_vertical_min":{"type":"integer","minimum":0},"images_vertical_max":{"type":"integer","minimum":0},"videos_min":{"type":"integer","minimum":0},"videos_max":{"type":"integer","minimum":0},"video_min_duration_ms":{"type":"integer","minimum":1},"video_max_duration_ms":{"type":"integer","minimum":1},"logo_min":{"type":"integer","minimum":0},"logo_max":{"type":"integer","minimum":0},"logo_aspect_ratios":{"type":"array","items":{"type":"string"}},"business_name_max_chars":{"type":"integer","minimum":1},"asset_image_max_file_size_kb":{"type":"integer","minimum":1},"supports_catalog_input":{"type":"boolean","description":"Whether the product can additionally consume a catalog reference (e.g., PMax with product feed)."}},"additionalProperties":true},"external:formats/canonical/agent_placement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/agent_placement.json","title":"Canonical Format: Agent Placement (AI-surface sponsored placement)","description":"**3.2-track canonical.** The structural shape (algorithmic composition + brand-context input + optional offering/landing_page) is captured here so adopters can declare against it in 3.1 catalogs, but the **mention-level tracking contract is intentionally underspecified for 3.1**: no normative macro vocabulary, no postback shape, no cross-surface dedup model. Adopters claiming `agent_placement` in 3.1 ship private tracking integrations and SHOULD leave `experimental: true` on the product declaration that references this canonical; buyer agents MUST treat agent_placement attribution as adapter-defined until the 3.2 tracking-macro spec lands. The canonical promotes to a normatively-buyer-callable surface in 3.2 (or later) once the tracking contract is specified.\n\nSponsored placement integrated into an AI-surface's response to a user. Buyer supplies a `BrandRef` (resolving brand.json for context), an optional `offering_ref` to focus the mention on a specific offering, and an optional `landing_page_url` the surface MAY attach as a citation. The surface (LLM, voice assistant, sponsored-search ranker) composes a natural-language mention, sponsored card, or audio snippet within its response to a user query. **Composition is algorithmic** — the agent chooses phrasing and presentation. Output asset_type varies by surface: `text` for chat UIs and sponsored search snippets; `audio` (synthesized) for voice assistants; `card` for structured AI-surface result cards. Tracking model: mention-level impression + attribution events; per-mention id keys back to brand and offering — but see the 3.2-track note above; the wire shape of these events is not yet specified. Distinct from `si_chat` (which is the user-converses-with-brand's-agent pattern — brand owns the conversational surface) and from `sponsored_placement` (retail-media catalog-driven). Parallels `sponsored_placement` structurally: both are surface-composed placements; agent_placement is for AI/agentic surfaces, sponsored_placement is for retail media.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Marked experimental at 3.1 GA: the canonical's tracking model (mention-level impression + attribution, postback shape, cross-surface dedup) is intentionally underspecified for 3.1. Adopters claiming `agent_placement` ship private tracking integrations; buyer agents MUST treat attribution as adapter-defined until the 3.2 tracking-macro spec lands. Promotion to non-experimental gated on the 3.2 tracking-contract spec."},"v1_translatable":{"default":false,"description":"Inherently new in v2 — AI-surface sponsored mentions weren't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural."},"slots":{"default":[{"asset_group_id":"offering_ref","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"agent_placement has minimal buyer-shipped slots — the surface composes the rendered output from brand context (resolved via the manifest's top-level `brand` BrandRef) plus optional offering_ref and landing_page_url assets. None of these assets are rendered verbatim by the buyer; the agent chooses how to use them."},"output_modality":{"type":"string","enum":["text","audio","card"],"description":"How the surface presents the mention. `text` = inline text (chat, search snippet). `audio` = TTS-synthesized voice. `card` = structured card with optional image + text."},"max_mention_length_chars":{"type":"integer","minimum":1,"description":"For text output: maximum length of the surface-composed mention text."},"max_mention_duration_ms":{"type":"integer","minimum":1,"description":"For audio output: maximum duration of the spoken mention in milliseconds."},"supports_offering_reference":{"type":"boolean","description":"Whether the product accepts an offering reference (specific product/service to promote within the mention) in addition to brand context."},"supports_landing_page_url":{"type":"boolean","description":"Whether the surface attaches a landing page URL to the mention (citation, learn-more link)."},"tone_constraints":{"type":"array","items":{"type":"string"},"description":"**Advisory only.** Buyer-declared brand-voice preferences the surface SHOULD honor (e.g., ['formal', 'no_superlatives']). LLM/agentic surfaces have no protocol-level mechanism to verify enforcement — adopters that need hard guarantees should rely on brand.json voice declarations and post-mention review rather than this field. Future revisions may tie this to a structured tone vocabulary; for now treat as free-text guidance."},"disclosure_required":{"type":"boolean","description":"Whether the surface must include an explicit sponsorship disclosure label."}},"additionalProperties":true},"external:formats/canonical/seller_rendered_stateful_display.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/seller_rendered_stateful_display.json","title":"Canonical Format: Seller-Rendered Stateful Display","description":"Seller-rendered display unit whose declaration is an executable template contract: buyer-known visual states, explicit transitions, breakpoint canvases, and per-state slot bindings. The seller owns the runtime; `supply_mode` declares which end the buyer feeds. For machine-rendered `components` and `rendered_canvases` supply, sellers MUST support `preview_creative` returning every state × breakpoint from a candidate manifest. `layered_source` instead follows the asynchronous seller-production preview path after the declared production window. `composition_model: deterministic` describes serving the finished states, not instant derivation from layered source. Buyer-executable HTML/MRAID is `html5`, a buyer-delivered tag is `display_tag`, arbitrary games/hotspots/scripts remain `custom`, and per-impression algorithmic assembly is `responsive_creative`.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Experimental in AdCP 3.2 while the creative working group gathers implementation evidence across premium web and mobile/app sellers."},"v1_translatable":{"default":false,"description":"No v1 named-format equivalent can express multiple seller-rendered states and their breakpoint bindings."},"since_version":{"default":"3.2"},"composition_model":{"default":"deterministic"},"supply_mode":{"type":"string","enum":["components","rendered_canvases","layered_source"],"default":"components","description":"Which end of the template contract the buyer feeds. `components`: buyer supplies component slots; seller renders states (no `state_canvases`/`layered_source` assets allowed). `rendered_canvases`: buyer supplies exactly one `state_canvases` image per declared state × breakpoint pair. `layered_source`: buyer ships design source (+ optional `font_files`); seller production derives states (`production_window_business_days` applies) — transitional for sellers without executable templates."},"slots":{"default":[{"asset_group_id":"state_canvases","asset_type":"image","required":false,"min":1},{"asset_group_id":"logo","asset_type":"image","required":false},{"asset_group_id":"imagery","asset_type":"image","required":false,"min":0},{"asset_group_id":"headline","asset_type":"text","required":false},{"asset_group_id":"messaging","asset_type":"text","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"legal_text","asset_type":"text","required":false},{"asset_group_id":"video_main","asset_type":"video","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":true},{"asset_group_id":"state_click_urls","asset_type":"url","required":false,"min":0},{"asset_group_id":"layered_source","asset_type":"zip","required":false},{"asset_group_id":"font_files","asset_type":"zip","required":false}],"description":"Default manifest slots; which are consumed depends on `supply_mode`. `state_canvases` images MUST carry `state_id` and `breakpoint_id`, and `state_click_urls` entries MUST carry `state_id` (semantic validators resolve the bindings). Component images SHOULD carry `focal_point` for deterministic seller cropping. `landing_page_url` is the default destination (see `clickthrough`). `font_files` MUST contain only buyer-licensed fonts; publisher-proprietary fonts never travel in manifests. Only image, video, text, url, zip, and pixel_tracker slot asset types are accepted — executable types (javascript, html, css, webhook) are rejected even via `slots` overrides."},"states":{"type":"array","minItems":1,"description":"Finite visual states known at buy time; state and breakpoint IDs form the canvas-key matrix. Runtime causes live in `transitions[]`. A single-state unit (topscroll, interscroller, skin) declares one state, no transitions, and typically a `reveal` mechanic.","items":{"type":"object","properties":{"state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable identifier used by `state_canvases[].state_id` and `state_click_urls[].state_id`."},"anchoring":{"type":"string","enum":["inline","sticky_top","sticky_bottom","overlay","fullscreen_overlay","underlay"],"description":"`underlay` renders the canvas beneath page content, which scrolls over it (IAB New Ad Portfolio underlay class: skins, reveal units). Transitions into `overlay`/`fullscreen_overlay` states SHOULD be user-initiated; non-user-action entries emit LEAN policy warnings."},"slot_bindings":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^[a-z0-9_]+$"},"description":"Asset group IDs rendered in this state (components mode). Makes the template executable: given components and bindings, assembly is deterministic. Every value MUST resolve to a declared slot. Omitted means all supplied component slots may render."},"motion":{"type":"string","enum":["static","animated"],"default":"static","description":"Whether the seller-rendered layout animates within this state (attract loops, load animations). Intra-state animation is seller-rendered; buyer canvases stay static images."},"max_animation_s":{"type":"number","exclusiveMinimum":0,"description":"Upper bound on intra-state animation duration. Required when `motion` is `animated`."},"breakpoints":{"type":"array","minItems":1,"items":{"type":"object","properties":{"breakpoint_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable identifier used by `state_canvases[].breakpoint_id`."},"width":{"type":"integer","minimum":1},"width_range":{"type":"array","items":{"type":"integer","minimum":1},"minItems":2,"maxItems":2,"description":"Inclusive [minimum, maximum] accepted canvas width. The first value MUST be no greater than the second; semantic validators enforce ordering."},"width_mode":{"type":"string","enum":["full_bleed","gutter_residual"],"description":"Fluid width classes. `full_bleed`: edge-to-edge viewport width (IAB adhesion, topscroll). `gutter_residual`: the margin remaining beside the page content column (desktop skins). Fluid breakpoints cannot be targeted by `rendered_canvases` supply — semantic validation rejects that pairing."},"height":{"type":"integer","minimum":1},"height_range":{"type":"array","items":{"type":"integer","minimum":1},"minItems":2,"maxItems":2,"description":"Inclusive [minimum, maximum] accepted canvas height. The first value MUST be no greater than the second; semantic validators enforce ordering."},"viewport_height_percent":{"type":"number","exclusiveMinimum":0,"maximum":100,"description":"Height as a percentage of the viewport (topscroll 80%, mobile skin panel 15%). Fluid; cannot be targeted by `rendered_canvases` supply."},"canvas_aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Aspect ratio the rendered canvas maintains across the size range (IAB flexible units, ratio-bucket responsive). When both fixed `width` and `height` are declared, the ratio MUST be consistent with them."}},"required":["breakpoint_id"],"allOf":[{"anyOf":[{"required":["width"],"not":{"anyOf":[{"required":["width_range"]},{"required":["width_mode"]}]}},{"required":["width_range"],"not":{"anyOf":[{"required":["width"]},{"required":["width_mode"]}]}},{"required":["width_mode"],"not":{"anyOf":[{"required":["width"]},{"required":["width_range"]}]}}]},{"anyOf":[{"required":["height"],"not":{"anyOf":[{"required":["height_range"]},{"required":["viewport_height_percent"]}]}},{"required":["height_range"],"not":{"anyOf":[{"required":["height"]},{"required":["viewport_height_percent"]}]}},{"required":["viewport_height_percent"],"not":{"anyOf":[{"required":["height"]},{"required":["height_range"]}]}}]}],"additionalProperties":true}},"close_affordance":{"type":"boolean","description":"Whether this state visibly renders a seller-controlled close affordance. When true, rendering MUST follow IAB New Ad Portfolio close-button guidance (top-right, minimum 50×50 dp, available from state entry)."}},"required":["state_id","anchoring","breakpoints","close_affordance"],"additionalProperties":true}},"initial_state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"State rendered when the unit first becomes visible. MUST resolve to `states[].state_id`; for a single-state unit it MUST equal the sole state."},"reveal":{"type":"string","enum":["none","clip_window","scroll_parallax"],"default":"none","description":"How the unit enters view, distinct from state changes. `clip_window`: canvas fixed and progressively exposed through a scrolling window (interscroller, topscroll). `scroll_parallax`: canvas moves at a different rate than content. Reveal is presentation of one canvas, not a transition; do not fabricate a second state to express it."},"transitions":{"type":"array","minItems":1,"description":"Bounded seller-rendered transitions between declared visual states. Required when `states` has more than one entry; MUST be omitted for single-state units. Every non-initial state MUST be reachable from `initial_state_id`. Dismissal is terminal unit behavior declared by `user_controls.dismissible`, not a hidden visual state.","items":{"type":"object","properties":{"transition_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable transition identifier for preview and reporting."},"from_state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"to_state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"trigger":{"type":"string","enum":["timer","in_view_timer","scroll_threshold","scroll_progress","user_action","media_event"],"description":"Cause of the transition. `timer` counts from state entry; `in_view_timer` counts viewable time in the current state (industry auto-collapse is N seconds in view). `media_event` fires on `video_main` playback milestones. The outcome is expressed separately by `to_state_id`."},"input":{"type":"string","enum":["tap","hover","swipe_up","swipe_down","swipe_left","swipe_right","scroll","expand_control","collapse_control"],"description":"Input driving a user or scroll transition. `hover` expansion is disallowed by IAB NAP guidance and emits a LEAN policy warning visible to buyers."},"media_event":{"type":"string","enum":["video_start","video_complete"],"description":"Playback milestone of `video_main` driving a `media_event` transition (endframes, collapse-on-complete)."},"direction":{"type":"string","enum":["down","up"],"default":"down","description":"Scroll direction that arms a `scroll_threshold` transition; enables direction-aware expand/collapse cycles. Re-crossing in the opposite direction does not re-fire this transition."},"transition_mode":{"type":"string","enum":["instant","animated","scroll_linked"],"default":"instant","description":"`scroll_linked` continuously interpolates the seller-owned layout between the two declared endpoint states; it is valid only with trigger `scroll_progress` and does not permit buyer scripting."},"delay_ms":{"type":"integer","minimum":0,"description":"For `timer`: delay after `from_state_id` activates (re-entry restarts it). For `in_view_timer`: accumulated viewable milliseconds in `from_state_id`. Timer-class transitions in a state cycle MUST declare at least 1000 (anti-strobe floor)."},"duration_ms":{"type":"integer","minimum":0,"description":"Duration of a seller-rendered animated transition."},"scroll_threshold_percent":{"type":"number","minimum":0,"maximum":100,"description":"Viewport/page scroll threshold that starts a `scroll_threshold` transition."},"scroll_reference":{"type":"string","enum":["document_progress","containing_scroller_progress"],"description":"Reference frame for scroll percentages. Progress is `scroll_offset / max(scroll_extent - viewport_extent, 1) * 100`, measured on either the page document or the nearest seller-declared containing scroller."},"scroll_start_percent":{"type":"number","minimum":0,"maximum":100,"description":"Start of the bounded scroll interval for a `scroll_progress` transition."},"scroll_end_percent":{"type":"number","minimum":0,"maximum":100,"description":"End of the bounded scroll interval for a `scroll_progress` transition. MUST be greater than `scroll_start_percent`."},"preserve_playback":{"type":"boolean","default":false,"description":"Whether `video_main` continues without restart while the seller changes state."}},"required":["transition_id","from_state_id","to_state_id","trigger","transition_mode"],"oneOf":[{"properties":{"trigger":{"type":"string","const":"timer"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","delay_ms"],"not":{"anyOf":[{"required":["input"]},{"required":["media_event"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]}]}},{"properties":{"trigger":{"type":"string","const":"in_view_timer"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","delay_ms"],"not":{"anyOf":[{"required":["input"]},{"required":["media_event"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]}]}},{"properties":{"trigger":{"type":"string","const":"scroll_threshold"},"input":{"type":"string","const":"scroll"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","input","scroll_reference","scroll_threshold_percent"],"not":{"anyOf":[{"required":["delay_ms"]},{"required":["media_event"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]}]}},{"properties":{"trigger":{"type":"string","const":"scroll_progress"},"input":{"type":"string","const":"scroll"},"transition_mode":{"type":"string","const":"scroll_linked"}},"required":["trigger","input","scroll_reference","scroll_start_percent","scroll_end_percent"],"not":{"anyOf":[{"required":["delay_ms"]},{"required":["media_event"]},{"required":["scroll_threshold_percent"]},{"required":["direction"]}]}},{"properties":{"trigger":{"type":"string","const":"user_action"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","input"],"not":{"anyOf":[{"required":["delay_ms"]},{"required":["media_event"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]},{"required":["direction"]}]}},{"properties":{"trigger":{"type":"string","const":"media_event"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","media_event"],"not":{"anyOf":[{"required":["input"]},{"required":["delay_ms"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]},{"required":["direction"]}]}}],"additionalProperties":true}},"clickthrough":{"type":"string","enum":["required","optional","none"],"default":"required","description":"Destination policy. `required` (default): manifest MUST supply `landing_page_url`. `optional`: click-optional units (in-feed brand units) may omit it. `none`: unit is non-clickable; manifests MUST NOT supply `landing_page_url` or `state_click_urls`. Per-state overrides via `state_click_urls` entries carrying `state_id`; `landing_page_url` is the fallback for unlisted states."},"user_controls":{"type":"object","properties":{"dismissible":{"type":"boolean"},"user_collapsible":{"type":"boolean"}},"required":["dismissible","user_collapsible"],"additionalProperties":true,"description":"When any state anchors as `overlay` or `fullscreen_overlay`, either `dismissible` MUST be true or that state's `close_affordance` MUST be true (dismissibility floor; semantic validators enforce)."},"canvas_constraints":{"type":"array","description":"Rectangular areas constraining buyer artwork. Omitted state/breakpoint selectors apply the constraint to every canvas. For fluid or range-sized breakpoints, use percent-unit regions.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canvas-constraint.json"}},"duration_ms_range":{"type":"array","items":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"minItems":2,"maxItems":2,"contains":{"type":"integer","minimum":0},"description":"Accepted embedded-video duration [min, max]. `duration_ms_exact` takes precedence when both are present."},"duration_ms_exact":{"type":"integer","minimum":1},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Embedded-video aspect ratio."},"containers":{"type":"array","items":{"type":"string","enum":["mp4","webm","mov"]},"uniqueItems":true},"video_playback":{"type":"string","enum":["none","auto_muted","user_initiated"]},"max_initial_load_kb":{"type":"integer","minimum":1},"max_subload_kb":{"type":"integer","minimum":1,"description":"Ceiling on assets loaded after the window load event (IAB LEAN subload). Pairs with `max_initial_load_kb` to mirror the New Ad Portfolio initial/subload weight pair."},"polite_load":{"type":"boolean","description":"When true, non-initial assets load only after the host page's window load event (IAB LEAN subload boundary)."}},"x-adcp-validation":{"allowed_slot_asset_types":["image","video","text","url","zip","pixel_tracker"],"verifier_constraints":{"state_id_uniqueness":"states[].state_id values must be unique","initial_state_resolution":"initial_state_id must resolve to a declared state","single_state_shape":"when states has one entry, transitions must be absent or empty and initial_state_id must equal the sole state; when states has more than one entry, transitions must be present and non-empty","transition_id_uniqueness":"transitions[].transition_id values must be unique","transition_exit_determinism":"at most one transition out of a given state per cause tuple (trigger, plus input for user_action, media_event for media_event, direction for scroll_threshold); distinct causes may coexist and the seller runtime arms whichever inputs the device supports","transition_state_resolution":"transition endpoints must resolve to distinct declared states","scroll_progress_bounds":"scroll_start_percent must be less than scroll_end_percent","scroll_linked_binding":"transition_mode scroll_linked is valid only with trigger scroll_progress","state_reachability":"every non-initial state must be reachable from initial_state_id","timer_cycle_floor":"timer and in_view_timer transitions participating in a state cycle must declare delay_ms >= 1000","dismissibility_floor":"any state anchored overlay or fullscreen_overlay requires user_controls.dismissible true or that state's close_affordance true","breakpoint_id_uniqueness":"breakpoints[].breakpoint_id values must be unique within each state","width_range_order":"width_range minimum must be less than or equal to maximum","height_range_order":"height_range minimum must be less than or equal to maximum","aspect_consistency":"canvas_aspect_ratio must be consistent with fixed width and height when both are declared","duration_ms_range_order":"duration_ms_range[0] must be less than or equal to duration_ms_range[1] when both are non-null","motion_animation_bound":"max_animation_s is required when a state's motion is animated and forbidden when static","slot_binding_resolution":"states[].slot_bindings values must resolve to declared slot asset_group_ids","allowed_slot_asset_types":"declaration slots (including params.slots overrides) must not widen the canonical's allowed asset types; executable types are rejected","supply_mode_manifest":"components mode forbids state_canvases and layered_source assets; rendered_canvases mode requires full canvas coverage and forbids layered_source; layered_source mode requires a layered_source asset and forbids state_canvases","fluid_breakpoint_supply":"breakpoints using width_mode or viewport_height_percent cannot be targeted by rendered_canvases supply","state_canvas_coverage":"in rendered_canvases mode, exactly one state_canvases image per declared state and breakpoint pair","state_canvas_dimensions":"canvas width must equal declared width or fall within width_range; height must equal fixed height or fall within height_range","state_canvas_extras":"undeclared and duplicate state/breakpoint pairs are rejected","clickthrough_policy":"landing_page_url required when clickthrough is required; landing_page_url and state_click_urls forbidden when clickthrough is none","state_click_url_resolution":"state_click_urls entries must carry state_id resolving to a declared state, with at most one entry per state","lean_policy_warnings":"non-user-action transitions into overlay/fullscreen_overlay anchoring, hover-triggered expansion, and scroll transitions into overlay anchoring emit policy warnings (non-blocking)"},"spec":"docs/creative/canonical-formats.mdx#premium-display-in-32"},"required":["states","initial_state_id","user_controls"],"additionalProperties":true},"external:core/canvas-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/canvas-constraint.json","title":"Canvas Constraint","description":"Rectangular rule applied to buyer artwork. State and breakpoint selectors are optional so the same shape can constrain a coordinated-placement component or a specific stateful-display canvas.","type":"object","properties":{"constraint":{"type":"string","enum":["safe_area","reserved_region","decoration_only_edge","no_text_or_logos"]},"state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"breakpoint_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"region":{"type":"object","properties":{"x":{"type":"number","minimum":0},"y":{"type":"number","minimum":0},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0},"unit":{"type":"string","enum":["px","percent"],"default":"px"}},"required":["x","y","width","height"],"allOf":[{"if":{"properties":{"unit":{"const":"percent"}},"required":["unit"]},"then":{"properties":{"x":{"maximum":100},"y":{"maximum":100},"width":{"maximum":100},"height":{"maximum":100}}}}],"additionalProperties":true}},"required":["constraint","region"],"x-adcp-validation":{"verifier_constraints":{"selector_resolution":"state_id and breakpoint_id resolve against the containing seller_rendered_stateful_display declaration; coordinated_placements component constraints omit both selectors","region_bounds":"percent regions satisfy x + width <= 100 and y + height <= 100; pixel regions fit within every selected canvas"},"spec":"docs/creative/canonical-formats.mdx#premium-display-in-32"},"additionalProperties":true,"dependentRequired":{"breakpoint_id":["state_id"]}},"external:formats/canonical/coordinated_placements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/formats/canonical/coordinated_placements.json","title":"Canonical Format: Coordinated Placements","description":"One creative manifest atomically supplies assets for multiple declared product placements. Each component binds to a public `Product.placements[]` entry and either declares an inline non-custom canonical format or references a sibling format option on the same product. Components cannot nest coordinated placements. The manifest supplies component slots under `component_assets.<component_id>`; `shared_slots` assets are supplied once at top level. Inventory exclusivity remains `Product.exclusivity`, not a creative-format parameter. Ordinary products whose placements accept independently assigned creatives do not need this canonical.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Experimental in AdCP 3.2 while the creative working group gathers implementation evidence for atomic cross-placement composition."},"v1_translatable":{"default":false,"description":"No v1 named-format equivalent can express a coordinated multi-placement buy."},"since_version":{"default":"3.2"},"composition_model":{"default":"deterministic"},"components":{"type":"array","minItems":2,"contains":{"type":"object","properties":{"required":{"type":"boolean","const":true}},"required":["required"]},"items":{"type":"object","properties":{"component_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable coordination-local component identifier. Values MUST be unique within `components[]`."},"placement_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1placement-ref.json","description":"Public product placement this component supplies. MUST resolve against the containing product's `placements[]`."},"required":{"type":"boolean"},"sequence":{"type":"integer","minimum":1,"description":"Declared presentation order for sequential-messaging coordinated buys. Components sharing a sequence value present simultaneously; absent means unordered/simultaneous (default). Sequence declares seller-rendered ordering, not buyer-controlled timing."},"serving_policy":{"type":"string","enum":["seller_served_only","third_party_allowed"],"description":"Per-component serving/tracking policy. Some sellers restrict specific components (e.g., page skins) to first-party serving while allowing third-party tags on sibling components. Defaults to the product-level policy when absent."},"canvas_constraints":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canvas-constraint.json"},"description":"Artwork constraints applied to this component, including safe areas and seller-reserved regions."},"format_option_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-option-ref.json","description":"Reference to a sibling `format_options[]` entry on the same product. It MUST NOT resolve to `custom` or `coordinated_placements`."},"format_kind":{"type":"string"},"params":{"type":"object"}},"required":["component_id","placement_ref","required"],"anyOf":[{"required":["format_option_ref"],"not":{"anyOf":[{"required":["format_kind"]},{"required":["params"]}]}},{"required":["format_kind","params"],"not":{"required":["format_option_ref"]},"oneOf":[{"properties":{"format_kind":{"type":"string","const":"image"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"html5"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1html5.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"display_tag"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1display_tag.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"image_carousel"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image_carousel.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"video_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_hosted.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"video_vast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_vast.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"audio_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_hosted.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"audio_daast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_daast.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"sponsored_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1sponsored_placement.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"native_in_feed"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1native_in_feed.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"responsive_creative"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1responsive_creative.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"agent_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1agent_placement.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"seller_rendered_stateful_display"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1seller_rendered_stateful_display.json"}},"required":["format_kind"]}]}],"additionalProperties":true}},"shared_slots":{"type":"array","description":"Manifest slots supplied once and consumed by one or more coordinated components.","items":{"type":"object","properties":{"asset_group_id":{"type":"string","pattern":"^[a-z0-9_]+$"},"asset_type":{"type":"string","enum":["image","video","audio","text","markdown","url","html","css","javascript","vast","daast","webhook","brief","catalog","published_post","zip","card","object","pixel_tracker","vast_tracker","daast_tracker"]},"required":{"type":"boolean","default":false},"min":{"type":"integer","minimum":0},"max":{"type":"integer","minimum":1},"consumed_by":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string"},"description":"Component IDs that consume this shared asset. Every value MUST resolve to `components[].component_id`."}},"required":["asset_group_id","asset_type","consumed_by"],"additionalProperties":true}}},"x-adcp-validation":{"verifier_constraints":{"component_id_uniqueness":"components[].component_id values must be unique","required_component":"at least one component must be required","placement_ref_resolution":"components[].placement_ref values must resolve to distinct Product.placements[] entries","format_option_ref_resolution":"component references resolve only against sibling format_options entries on the same product","component_kind":"resolved and inline components cannot be custom or coordinated_placements","inline_params":"inline params validate against the schema selected by inline format_kind","component_assets":"required components have a component_assets entry satisfying their resolved canonical slots","sequence_values":"when any component declares sequence, sequence values must start at 1 and be contiguous across the declared set","referenced_option_schema":"declarations resolved via format_option_ref are schema-validated identically to inline params","shared_slot_consumers":"every shared_slots[].consumed_by value resolves to a declared component_id whose canonical slots accept the shared asset_group_id and asset_type"},"spec":"docs/creative/canonical-formats.mdx#premium-display-in-32"},"required":["components"],"additionalProperties":true},"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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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-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/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:enums/creative-selection-strategy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/creative-selection-strategy.json","title":"Creative Selection Strategy","description":"How a creative agent samples which catalog items / signal conditions to produce creatives for when max_creatives is below the eligible count (#5262). Selection ordering surfaces on the existing rank/recommended fields of build_creative's creatives[].variants[]. This is a curated set, not an open extension point — new strategies are added per the enum-membership criterion in spec-guidelines.md. Part of the experimental signal-fanout surface (x-status: experimental; feature id `creative.signal_fanout`).","x-status":"experimental","type":"string","enum":["audience_relevance","contextual_fit","performance","proximity","inventory_priority","random"],"enumDescriptions":{"audience_relevance":"Rank by relevance to the buyer's audience signal(s) — the user-side axis. Drawn from the SAME signal_ref pointers in signal_conditions / package targeting, not a parallel signals[] array.","contextual_fit":"Rank by fit to the content/context the creative renders against — the content-side counterpart to audience_relevance (user-side). Uses the same signal_ref mechanism with a context signal rather than an audience signal. Mirrors the Trusted Match Protocol Context Match / Identity Match split.","performance":"Rank by the catalog item's historical delivery performance (e.g. CTR, completion, conversion) where the agent has that signal.","proximity":"Rank by proximity to a location input. Reuse the existing geo targeting shape (see docs/media-buy/advanced-topics/targeting.mdx) rather than a parallel one; the exact geo-input binding is still being settled, which the experimental status of this surface keeps revisable.","inventory_priority":"Rank by seller-side catalog metadata (margin, overstock, promotional priority). No buyer input.","random":"Status-quo fallback: agent samples without a ranking preference. Default when selection_strategy is omitted."}},"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/build-creative-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/build-creative-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/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:enums/creative-quality.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/creative-quality.json","title":"Creative Quality","description":"Quality tier for creative generation, controlling the fidelity and cost tradeoff","type":"string","enum":["draft","production"],"enumDescriptions":{"draft":"Fast, lower-fidelity output for iteration and review","production":"Full-quality output for final delivery"}},"external:core/evaluator-spec.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/evaluator-spec.json","title":"Evaluator Spec","description":"Advisory buyer-attached pointer (#5280) declaring HOW produced build_creative variants should be evaluated and ranked. The rank-side of the get_creative_features feature oracle: the chosen form is the SOURCE of feature evaluation that yields creative-feature values for each leaf, `feature_requirement` is an optional hard GATE over those values, and `rank_by` is the RANK ordering over the survivors. Informs the agent's best_of_n recommended/rank and, when the agent advertises creative.supports_evaluator, populates a per-leaf `eval` block (creative-feature-result[]) on the response.\n\nGate-then-rank pipeline (per produced leaf in a best_of_n run): the producing agent (1) evaluates the leaf via the chosen form, obtaining creative-feature values; (2) when `feature_requirement` is present, applies those predicates and DROPS any leaf that fails (internal best_of_n pruning) — survivors only; (3) orders survivors by `rank_by`. The gate operates BEFORE return: it prunes which leaves the agent recommends/returns from its own best_of_n exploration, never an AdCP-layer block of an already-produced billable leaf — what is produced and billed is governed by max_variants/max_creatives/max_spend, not by the evaluator. With no `feature_requirement`, evaluation stays advisory: every produced leaf is returned and billed and ranking is a soft preference, so `rank_by` failures rank lower but are never dropped.\n\nWhen the chosen form is `feature_agent` (or `agent_url`), the seller calls an external get_creative_features-capable agent, so the pointer is subject to the seller's `creative_policy.accepted_verifiers[]` allowlist exactly as #5280 established for provenance verify_agent: the buyer REPRESENTS which on-list agent it used, the seller (verifier-of-record) CALLS it. An off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED` (mirrors PROVENANCE_VERIFIER_NOT_ACCEPTED) before any outbound call; an on-list agent that is unreachable or unknown degrades to seller-default ranking with an advisory errors[] note (non-terminal), NOT a failure.\n\nEvaluator credentials and caller-supplied trust material are never carried in this object, `context`, `ext`, or the creative payload. The producing creative agent authenticates its outbound call to the evaluator on the transport (RFC 9421 request signing/JWKS, mTLS, or a pre-provisioned Bearer/API-key credential). Credential- or trust-material payload keys (for example `api_key`, `client_secret`, `authorization`, `jwk`, `jwks`, or `jwks_uri`) are non-conforming and should be rejected with `CREDENTIAL_IN_ARGS`.\n\nProvide exactly one of three forms; an optional `feature_requirement` gate, an optional `rank_by` ordering, an optional `feature_agent` allowlisted pointer, and a shared optional eval_budget apply to whichever form is chosen. Feature discovery uses the existing governance.creative_features catalog on get_adcp_capabilities; evaluator outputs reuse creative-feature-result[] and do not mint a parallel verdict/result surface. `evaluator_id` is not discovered from governance.creative_features: it is a pre-provisioned, account-arranged preset whose emitted feature_ids still come from that catalog.\n\nExperimental (x-status: experimental): this whole evaluator surface — the `evaluator` input, the per-leaf `eval` response block, and `creative.supports_evaluator` — is new and not yet field-tested across parties. Sellers that implement it MUST list `creative.evaluator` in `experimental_features`. Reserved 3.x follow-ons that may reshape these fields: a separate `supports_evaluator_gate` capability and a hard MUST-enforce-gate semantic. Per docs/reference/experimental-status, it MAY change between 3.x releases with notice.","x-status":"experimental","type":"object","properties":{"feature_requirement":{"type":"array","description":"Optional hard GATE over creative-feature values — the predicates a leaf MUST satisfy for the producing agent to recommend/return it. Reuses the feature-requirement shape (min_value/max_value for quantitative features like creative_quality_score, allowed_values for binary/categorical) — the same predicate vocabulary that gates property/audience filters, which its own schema names as an intended creative-gate reuse. A leaf that fails any predicate is DROPPED from the agent's best_of_n survivors before ranking — this is internal pruning of which leaves the agent recommends, not an AdCP-layer block of an already-produced billable leaf (what is produced/billed is governed by max_variants/max_creatives/max_spend). Distinct from `rank_by`: the gate is a pass/fail predicate (drop on fail), `rank_by` is an ordering over survivors. Each predicate's `if_not_covered` (exclude|include, default exclude) is the fail-open knob when the source cannot measure that feature. A pass/warn/fail verdict is expressed as a categorical string feature value gated via `allowed_values` (e.g. [\"pass\"] or [\"pass\",\"warn\"]) — the buyer's predicate decides whether warn passes; the verdict is derived, never stored on creative-feature-result. Omit to leave evaluation advisory (no leaf is dropped).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1feature-requirement.json"},"minItems":1},"rank_by":{"type":"array","description":"Optional RANK ordering over creative-feature values — an ordered list (most significant first) the agent uses to order the gate survivors into recommended/rank. An explicit {feature_id, direction} ordering rather than the feature-requirement predicate (which has no sort direction): the gate decides pass/fail, rank_by decides better/worse. Soft preference, never a gate: leaves are not dropped by rank_by, they are only ordered. Omit to let the evaluator/seller choose the ordering.","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"Creative feature to order by (discovered via get_adcp_capabilities; the same feature_id space the chosen evaluator form returns in eval.features[])."},"direction":{"type":"string","enum":["maximize","minimize"],"default":"maximize","description":"Sort direction for this feature: `maximize` ranks higher feature values first (e.g. creative_quality_score), `minimize` ranks lower values first (e.g. predicted_cpa)."}},"required":["feature_id"],"additionalProperties":false},"minItems":1},"feature_agent":{"type":"object","description":"Optional buyer-attached pointer to a get_creative_features-capable creative-feature / governance agent the producing agent calls to evaluate each leaf (the gate's SOURCE of feature values). This is the buyer-represents → seller-calls pattern #5280 established for provenance, generalized to the evaluator gate: the buyer REPRESENTS which agent it used, but the seller is the verifier-of-record and decides which agent it actually calls. `agent_url` MUST appear (canonicalized per /docs/reference/url-canonicalization) in the seller's `creative_policy.accepted_verifiers[].agent_url`; an off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED` (mirrors PROVENANCE_VERIFIER_NOT_ACCEPTED) before any outbound call. The outbound evaluator call authenticates on the transport; this pointer MUST NOT carry API keys, bearer tokens, client secrets, authorization values, JWKs, JWKS documents, or JWKS URIs. Reuses the same allowlist mechanism — no new allowlist is introduced. Distinct from the `agent_url` oneOf form, which names the evaluator's source directly; `feature_agent` attaches the gate's measurement source alongside any of the three forms.","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the get_creative_features-capable agent the producing agent calls to obtain creative-feature values for the gate. MUST use https:// and MUST match an entry in the seller's `creative_policy.accepted_verifiers[].agent_url`; off-list → `EVALUATOR_AGENT_NOT_ACCEPTED`."},"feature_id":{"type":"string","description":"Optional canonical feature_id the producing agent SHOULD request against this agent. When present it SHOULD match the agent's `accepted_verifiers[].feature_id` or be omitted; when absent the seller selects a feature at evaluation time. Resolves selector ambiguity exactly as the provenance verify_agent.feature_id does."}},"required":["agent_url"],"additionalProperties":false},"eval_budget":{"type":"object","description":"Optional soft ceiling on evaluation effort. Advisory in v1 with no billing coupling. Well-known soft fields max_calls / max_seconds; open for evaluator-specific knobs.","properties":{"max_calls":{"type":"integer","minimum":1,"description":"Soft cap on the number of judge calls the evaluator should make."},"max_seconds":{"type":"number","minimum":0,"description":"Soft cap on wall-clock seconds the evaluation should consume."}},"additionalProperties":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1ext.json"}},"oneOf":[{"type":"object","description":"Exemplar form: inline pass/fail examples that CALIBRATE a single agent-defined prediction feature — conventionally `predicted_performance`, a number in [0,1] — that the evaluator computes per leaf and returns as one creative-feature-result entry in eval.features[]. Exemplars are calibration, not a separate ranking path (mirroring content-standards.json calibration_exemplars): the pass/fail artifacts anchor where the prediction sits between 0 (like the fail set) and 1 (like the pass set). `rank_by` then orders survivors on that one feature_id (e.g. {feature_id: predicted_performance, direction: maximize}). Artifact-based — a creative variant is content to be measured. Like all three forms, this resolves to \"produce a feature value, rank by it.\"","required":["exemplars"],"properties":{"exemplars":{"type":"object","description":"Pass/fail examples that calibrate the single prediction feature (e.g. `predicted_performance` in [0,1]) the evaluator returns in eval.features[]. Artifact-based, mirroring content-standards.json calibration_exemplars.","properties":{"pass":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json"},"description":"Artifacts exemplifying variants the buyer considers good — the high end (≈1) of the calibrated prediction feature."},"fail":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json"},"description":"Artifacts exemplifying variants the buyer considers bad — the low end (≈0) of the calibrated prediction feature."}}}},"additionalProperties":true},{"type":"object","description":"Identifier form: an account-scoped house evaluator preset that produces creative-feature values for each leaf. This is not an on-wire discovery catalog: buyers obtain evaluator_id through account provisioning or bilateral arrangement, while emitted feature_ids MUST be drawn from the agent's get_adcp_capabilities governance.creative_features catalog. The scoring path remains accountable through eval.features[] plus any pinned feature_agent.","required":["evaluator_id"],"properties":{"evaluator_id":{"type":"string","x-entity":"evaluator","description":"Account-scoped house evaluator preset selected by the buyer. This id is pre-provisioned/account-arranged, not discovered from get_adcp_capabilities governance.creative_features. That catalog only discovers the feature vocabulary the preset emits. An unknown id degrades to seller-default ranking (advisory errors[] note), not a failure."}},"additionalProperties":true},{"type":"object","description":"Agent form: an external judge agent the seller calls via the get_creative_features contract (/docs/governance/creative/get_creative_features) to produce creative-feature values for each leaf — the SAME contract and the same results[] (creative-feature-result[]) shape get_creative_features returns. One creative-feature agent contract spans gate, rank, and provenance. Subject to the same `creative_policy.accepted_verifiers[]` allowlist as `feature_agent`: an off-list agent_url is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED` before any outbound call. The producing agent authenticates the outbound evaluator call on the transport (request signing/JWKS, mTLS, or a pre-provisioned static credential); this object only names the evaluator and MUST NOT carry credentials or caller-supplied trust material. eval_budget bounds the calls; sellers SHOULD populate calls_used/seconds_used on the leaf eval block when agent_url was used and eval_budget was supplied (reuse the oracle's vendor_cost/consumption for cost).","required":["agent_url"],"properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of an external get_creative_features-capable judge agent the seller calls to score the produced leaves. MUST match an entry in the seller's `creative_policy.accepted_verifiers[].agent_url` (off-list → `EVALUATOR_AGENT_NOT_ACCEPTED`); an on-list agent that is unreachable or rejects the producing agent's transport authentication degrades to seller-default ranking (advisory errors[] note), not a failure. Authentication and trust material for this call belongs on the transport or in account provisioning, not in the evaluator payload."}},"additionalProperties":true}],"additionalProperties":true},"external:core/feature-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/core/feature-requirement.json","title":"Feature Requirement","description":"A feature-based requirement — a reusable predicate over a feature value. Used by property list filters today; designed for reuse in other surfaces (audience filters, creative gates) in future versions. Use min_value/max_value for quantitative features, allowed_values for binary/categorical features.","type":"object","properties":{"feature_id":{"type":"string","description":"Feature to evaluate (discovered via get_adcp_capabilities)"},"min_value":{"type":"number","description":"Minimum numeric value required (for quantitative features)"},"max_value":{"type":"number","description":"Maximum numeric value allowed (for quantitative features)"},"allowed_values":{"type":"array","description":"Values that pass the requirement (for binary/categorical features)","items":{},"minItems":1},"if_not_covered":{"type":"string","enum":["exclude","include"],"default":"exclude","description":"How to handle properties where this feature is not covered. 'exclude' (default): property is removed from the list. 'include': property passes this requirement (fail-open)."},"policy_id":{"type":"string","description":"Optional attribution — when this requirement encodes a specific buyer-chosen threshold authorized by a policy, policy_id references the authorizing PolicyEntry. Producers populate when the mechanism exists because of a specific policy (e.g., max_value: 15 on audience_children_composition because of uk_hfss); do NOT populate when the requirement is a general filter unrelated to any policy. Governance findings echo this policy_id when emitting denials traced to the requirement. See /docs/governance/policy-attribution.","$comment":"x-entity deliberately omitted — a PolicyEntry reference can resolve to either a governance_registry_policy or a governance_inline_policy depending on the authorizing entry's source. See issue #2685."}},"required":["feature_id"],"additionalProperties":false},"external:content-standards/artifact.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/content-standards/artifact.json","title":"Artifact","description":"Content artifact for safety and suitability evaluation. An artifact represents content adjacent to an ad placement - a news article, podcast segment, video chapter, or social post. Artifacts are collections of assets (text, images, video, audio) plus metadata and signals.","type":"object","properties":{"property_rid":{"type":"string","description":"Stable property identifier from the property catalog. Globally unique across the ecosystem."},"artifact_id":{"type":"string","description":"Identifier for this artifact within the property. The property owner defines the scheme (e.g., 'article_12345', 'episode_42_segment_3', 'post_abc123')."},"variant_id":{"type":"string","description":"Identifies a specific variant of this artifact. Use for A/B tests, translations, or temporal versions. Examples: 'en', 'es-MX', 'v2', 'headline_test_b'. The combination of artifact_id + variant_id must be unique."},"format_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format reference. Use `format_kind` for canonical artifact media classification."},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Optional canonical media/creative kind associated with this artifact."},"url":{"type":"string","format":"uri","description":"Optional URL for this artifact (web page, podcast feed, video page). Not all artifacts have URLs (e.g., Instagram content, podcast segments, TV scenes)."},"published_time":{"type":"string","format":"date-time","description":"When the artifact was published (ISO 8601 format)"},"last_update_time":{"type":"string","format":"date-time","description":"When the artifact was last modified (ISO 8601 format)"},"assets":{"type":"array","description":"Artifact assets in document flow order - text blocks, images, video, audio","maxItems":200,"items":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","description":"Text block (paragraph, heading, etc.)","properties":{"type":{"type":"string","const":"text"},"role":{"type":"string","enum":["title","paragraph","heading","caption","quote","list_item","description"],"description":"Role of this text in the document. Use 'title' for the main artifact title, 'description' for summaries."},"content":{"type":"string","description":"Text content. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.","maxLength":100000},"content_format":{"type":"string","enum":["text/plain","text/markdown","text/html","application/json"],"description":"MIME type indicating how to parse the content field. Default: text/plain.","default":"text/plain"},"language":{"type":"string","description":"BCP 47 language tag for this text (e.g., 'en', 'es-MX'). Useful when artifact contains mixed-language content."},"heading_level":{"type":"integer","minimum":1,"maximum":6,"description":"Heading level (1-6), only for role=heading"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this text block, overrides artifact-level provenance"}},"required":["type","content"]},{"type":"object","description":"Image asset","properties":{"type":{"type":"string","const":"image"},"url":{"type":"string","format":"uri","description":"Image URL"},"access":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json/$defs/asset_access","description":"Authentication for secured URLs"},"alt_text":{"type":"string","description":"Alt text or image description"},"caption":{"type":"string","description":"Image caption"},"width":{"type":"integer","description":"Image width in pixels"},"height":{"type":"integer","description":"Image height in pixels"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this image, overrides artifact-level provenance"}},"required":["type","url"]},{"type":"object","description":"Video asset","properties":{"type":{"type":"string","const":"video"},"url":{"type":"string","format":"uri","description":"Video URL"},"access":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json/$defs/asset_access","description":"Authentication for secured URLs"},"duration_ms":{"type":"integer","description":"Video duration in milliseconds"},"transcript":{"type":"string","description":"Video transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.","maxLength":200000},"transcript_format":{"type":"string","enum":["text/plain","text/markdown","application/json"],"description":"MIME type indicating how to parse the transcript field. Default: text/plain.","default":"text/plain"},"transcript_source":{"type":"string","enum":["original_script","subtitles","closed_captions","dub","generated"],"description":"How the transcript was generated"},"thumbnail_url":{"type":"string","format":"uri","description":"Video thumbnail URL"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this video, overrides artifact-level provenance"}},"required":["type","url"]},{"type":"object","description":"Audio asset","properties":{"type":{"type":"string","const":"audio"},"url":{"type":"string","format":"uri","description":"Audio URL"},"access":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json/$defs/asset_access","description":"Authentication for secured URLs"},"duration_ms":{"type":"integer","description":"Audio duration in milliseconds"},"transcript":{"type":"string","description":"Audio transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.","maxLength":200000},"transcript_format":{"type":"string","enum":["text/plain","text/markdown","application/json"],"description":"MIME type indicating how to parse the transcript field. Default: text/plain.","default":"text/plain"},"transcript_source":{"type":"string","enum":["original_script","closed_captions","generated"],"description":"How the transcript was generated"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this audio, overrides artifact-level provenance"}},"required":["type","url"]}]}},"metadata":{"type":"object","description":"Rich metadata extracted from the artifact","properties":{"canonical":{"type":"string","format":"uri","description":"Canonical URL"},"author":{"type":"string","description":"Artifact author name"},"keywords":{"type":"string","description":"Artifact keywords"},"open_graph":{"type":"object","description":"Open Graph protocol metadata","additionalProperties":true},"twitter_card":{"type":"object","description":"Twitter Card metadata","additionalProperties":true},"json_ld":{"type":"array","description":"JSON-LD structured data (schema.org)","items":{"type":"object"}}},"additionalProperties":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.7/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this artifact. Serves as the default provenance for all assets within this artifact — individual assets can override with their own provenance."},"identifiers":{"type":"object","description":"Platform-specific identifiers for this artifact","properties":{"apple_podcast_id":{"type":"string","description":"Apple Podcasts ID"},"spotify_collection_id":{"type":"string","description":"Spotify collection ID"},"podcast_guid":{"type":"string","description":"Podcast GUID (from RSS feed)"},"youtube_video_id":{"type":"string","description":"YouTube video ID"},"rss_url":{"type":"string","format":"uri","description":"RSS feed URL"}},"additionalProperties":true}},"required":["property_rid","artifact_id","assets"],"additionalProperties":true,"$defs":{"asset_access":{"type":"object","description":"Access instructions for a secured asset URL. Producers SHOULD use `signed_url` for one-off delivery unless the parties already have an identity-based access relationship. New producers MUST NOT emit `service_account.credentials`; `bearer_token` is the explicit short-lived credential path. Consumers MUST treat asset URLs and access metadata as untrusted, use credentials only for HTTPS origins and resource prefixes authorized out of band, and fail closed without falling back between access methods. The deprecated legacy field remains parseable during the 3.x compatibility window but MUST NOT be activated automatically.","discriminator":{"propertyName":"method"},"oneOf":[{"type":"object","description":"Short-lived bearer-token access for origins that cannot use signed URLs or pre-configured workload identity. The token is a live secret and must be scoped to the asset. Consumers MUST send it only to the HTTPS origin authorized for that asset and MUST NOT forward the Authorization header across redirects.","properties":{"method":{"type":"string","const":"bearer_token"},"token":{"type":"string","description":"Short-lived, asset-scoped bearer token for the Authorization header. Producers MUST NOT issue a standing or broadly scoped credential here. Consumers MUST redact the token from logs, traces, errors, metrics, analytics, model context, and durable storage. Any temporary encrypted cache MUST be bounded by the credential expiry and the consumer's configured maximum lifetime."}},"required":["method","token"]},{"type":"object","description":"Credential-free workload-identity access. The asset origin authorizes an identity already controlled by the component that performs the asset fetch, such as a GCP service account or AWS IAM role, through authenticated out-of-band onboarding. The consumer MUST use workload credentials only for the pre-authorized HTTPS origin and resource prefix; the payload's method, provider, and URL are not authorization. No provider key or access secret crosses the AdCP payload.","properties":{"method":{"type":"string","const":"service_account"},"provider":{"type":"string","enum":["gcp","aws"],"description":"Cloud provider"},"credentials":{"type":"object","deprecated":true,"description":"Deprecated in AdCP 3.2 and eligible for removal in 4.0 or later only after the deprecation-policy notice and release-cycle gates are satisfied. Presence denotes the legacy inline-credential form, not workload-identity authorization. New producers MUST omit this field. Consumers MUST NOT activate received credentials automatically; they may process them only for an explicitly allowlisted legacy peer and otherwise MUST reject or quarantine them. Consumers MUST redact the complete value from logs, traces, errors, metrics, analytics, model context, and durable storage. Use the consumer's pre-authorized workload identity or `signed_url` instead.","additionalProperties":true}},"required":["method","provider"]},{"type":"object","description":"Recommended default for one-off access. The asset `url` is a time-limited bearer capability and requires no additional authentication. Producers SHOULD scope it to one asset and the shortest practical access window under their documented maximum TTL. Consumers MUST redact the complete URL from logs, traces, errors, metrics, analytics, model context, and durable storage, and MUST NOT forward it outside the intended recipient trust boundary.","properties":{"method":{"type":"string","const":"signed_url"}},"required":["method"]}]}}},"external:enums/preview-output-format.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.7/enums/preview-output-format.json","title":"Preview Output Format","description":"Output format for creative previews","type":"string","enum":["url","html"]},"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/build-creative-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/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}}}
1
+ {"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json","title":"Build Creative Request","description":"Request to transform, generate, resolve, refine, or retrieve a creative manifest. Supports five modes: (1) generation from a brief or seed assets, (2) transformation of an existing manifest, (3) deterministic seller-bound selection from a pre-binding CreativeRepresentationSet, (4) refinement of a prior produced variant via refine_from_build_variant_id, and (5) retrieval from a creative library by creative_id. Produces target manifest(s) through canonical capabilities advertised in `get_adcp_capabilities.creative.supported_formats[]`. CreativeRepresentationSet input is a non-generative, single-output mode available only on the destination sales agent and additionally requires `creative.representation_resolution.supported: true`. In 3.2, provide `target_capability_id` for one output or `target_capability_ids` for multiple outputs. Legacy named-format selectors remain accepted during the 3.x compatibility window but are deprecated.","x-tool-summary":"Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities.","type":"object","x-mutates-state":true,"x-governed-commitment":{"scope":"conditional","triggers":["incurs_vendor_cost"],"exemptions":["estimate","zero_cost_retrieval"],"precedence":"trigger_overrides_exemption"},"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 when this creative execution incurs vendor cost.","minLength":1,"maxLength":4096,"pattern":"^[\\x20-\\x7E]+$"},"message":{"type":"string","description":"Natural language instructions for the transformation or generation. For pure generation, this is the creative brief. For transformation, this provides guidance on how to adapt the creative. For refinement, this describes the desired changes."},"creative_manifest":{"$ref":"#/$defs/external:core~1creative-manifest.json","description":"Creative manifest to transform or generate from. On the canonical 3.2 path it carries `format_kind`, optional `format_option_ref`, and the required input assets. For transformation (for example resizing or reformatting), this is the complete creative to adapt. When creative_id is provided, the agent resolves the creative from its library and this field is ignored."},"creative_representation_set":{"$ref":"#/$defs/external:core~1creative-representation-set.json","description":"Complete creative revision containing equivalent trafficking representations, of which exactly one is selected for this seller-bound output. This mode is accepted only by the destination sales agent and requires representation_destination plus representation_selection_strategy. The target capability selects the seller's build route; representation_destination supplies the binding inventory contract. The resolver verifies revision_content_digest against the complete set, retains every representation unchanged, selects exactly one compatible representation, and returns a manifest carrying representation_selection. If macro_values is present, selection happens first and binding affects only the derived output; the retained representation set and its revision binding never change. When none is compatible, the request fails with CREATIVE_REPRESENTATION_UNRESOLVED and one representation_rejections entry per candidate."},"representation_destination":{"$ref":"#/$defs/external:core~1representation-destination.json","description":"Seller-owned product and effective format context for representation resolution. Required only with creative_representation_set and meaningful only when this endpoint is the destination sales agent."},"representation_selection_strategy":{"$ref":"#/$defs/external:enums~1representation-selection-strategy.json","description":"Deterministic strategy to apply after compatibility filtering. Required with creative_representation_set and MUST be advertised by creative.representation_resolution.strategies."},"creative_id":{"type":"string","description":"Reference to a creative in the agent's library. The creative agent resolves this to a manifest from its library. Use this instead of creative_manifest when retrieving an existing creative for tag generation or format adaptation.","x-entity":"creative"},"concept_id":{"type":"string","description":"Creative concept containing the creative. Creative agents SHOULD assign globally unique creative_id values; when they cannot guarantee uniqueness, concept_id is REQUIRED to disambiguate."},"media_buy_id":{"type":"string","description":"Media buy identifier for tag generation context. When the creative agent is also the ad server, this provides the trafficking context needed to generate placement-specific tags (e.g., CM360 placement ID). Not needed when tags are generated at the creative level (most creative platforms).","x-entity":"media_buy"},"package_id":{"type":"string","description":"Package identifier within the media buy. Used with media_buy_id when the creative agent needs line-item-level context for tag generation. Omit to get a tag not scoped to a specific package.","x-entity":"package"},"target_format_id":{"$ref":"#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format selector. Use `target_capability_id` with a value advertised in `get_adcp_capabilities.creative.supported_formats[].capability_id`."},"target_format_ids":{"type":"array","items":{"$ref":"#/$defs/external:core~1format-id.json"},"minItems":1,"maxItems":50,"deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format selectors. Use `target_capability_ids` with values advertised in `get_adcp_capabilities.creative.supported_formats[].capability_id`."},"target_capability_id":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$","description":"Canonical 3.2 single-output selector. Matches exactly one `get_adcp_capabilities.creative.supported_formats[].capability_id` advertised by this creative agent. The matched entry supplies the canonical `format` declaration used to validate inputs and the returned manifest. Mutually exclusive with `target_capability_ids` and the deprecated target_format_id fields."},"target_capability_ids":{"type":"array","items":{"type":"string","pattern":"^[a-zA-Z0-9_-]+$"},"minItems":1,"maxItems":50,"uniqueItems":true,"description":"Canonical 3.2 multi-output selector. Each value matches a `get_adcp_capabilities.creative.supported_formats[].capability_id`. The creative agent produces one canonical manifest per capability in request order. Mutually exclusive with `target_capability_id` and the deprecated target_format_id fields."},"transformer_id":{"type":"string","x-entity":"transformer","description":"Selects an account-scoped transformer (discovered via list_transformers) to perform the build. One transformer per call. When present, the build uses this transformer and target_capability_id/target_capability_ids select which of its outputs to produce — they MUST be a subset of the transformer's output_capability_ids. Deprecated target_format_id fields use the legacy output_format_ids compatibility path. Render configuration goes in `config`."},"config":{"type":"object","description":"Typed render configuration for the selected transformer, keyed by each param's `field` (from the transformer's params[] in list_transformers). Example: { \"voice\": \"isaac\", \"speaking_rate\": 1.1, \"mastering_preset\": \"podcast\" }. The agent MUST validate `config` against the transformer's live params for this account and reject unrecognized keys and out-of-range / non-enumerated values with a field-attributed error (e.g. `config.voice`) rather than silently ignoring them — config drives a paid render. Genuinely vendor-specific or experimental knobs not declared as params belong in `ext`, not here. (The schema leaves this object open because legal keys are dynamic per transformer; strict validation is a normative agent obligation.) When `refine_from_build_variant_id` is set, `config` is applied as a DELTA over the parent leaf's config.","additionalProperties":true},"refine_from_build_variant_id":{"type":"string","x-entity":"build_variant","description":"Refine a previously produced variant and return new lineage-linked variants. The transformer and target capability are inherited from the parent leaf. A refinement request MUST omit transformer_id, target_capability_id(s), and deprecated target_format_id(s); changing transformer or output format is a new transformation build, not refinement. Requires creative.supports_refinement."},"mode":{"type":"string","enum":["execute","estimate"],"default":"execute","description":"`execute` (default) produces and bills the creative(s). `estimate` is a DRY RUN: the agent produces nothing and bills nothing, and returns a BuildCreativeEstimate with a projected cost band (cost_low/cost_high) computed against THIS request's actual inputs (script length, brief, catalog size, max_creatives × max_variants) — the band the buyer cannot derive itself, since per_unit gives the rate but not the unit count. Requires the agent to advertise `creative.supports_spend_controls`; otherwise rejected with `UNSUPPORTED_FEATURE`."},"max_spend":{"type":"object","description":"Hard per-call spend ceiling. The agent produces leaves until the NEXT leaf would push the run's aggregate vendor_cost over `amount`, then STOPS and returns the partial BuildCreativeVariantSuccess produced so far with `budget_status: \"capped\"` (every returned leaf is real, trafficable, and billed — nothing produced is discarded; the leaf shortfall is `leaves_returned` < `leaves_total`). If even the first leaf would exceed the cap, the call fails with BUDGET_CAP_REACHED. `currency` MUST match the rate card's currency (the agent does not FX-convert) or the request is rejected with INVALID_REQUEST (error.field `max_spend.currency`). Requires `creative.supports_spend_controls`. Caps a SINGLE call — to bound a refinement loop, track aggregate vendor_cost across calls and stop issuing them (buyer responsibility in this revision). max_spend bounds only build-time vendor_cost: CPM-priced builds (estimate basis `cpm_deferred`) have build-time vendor_cost 0 and accrue at serve time, so max_spend never engages for them — bound a CPM fan-out with max_creatives instead.","properties":{"amount":{"type":"number","minimum":0,"description":"Maximum aggregate vendor_cost to incur on this call, in `currency`."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency; MUST match the rate card."}},"required":["amount","currency"],"additionalProperties":true},"max_creatives":{"type":"integer","minimum":1,"description":"Caps how many DISTINCT creatives to produce along the catalog/item fan-out axis — one creative per catalog item. Use it to sample a large catalog (e.g. send 150 job openings, set max_creatives: 5 to preview five). Distinct from item_limit, which caps how many catalog items a SINGLE creative consumes (DCO-style). Omitted with a catalog input means one creative per item up to the catalog/format bound; omitted without a catalog collapses to a single creative. Large fan-outs may return asynchronously. Mutually exclusive with `refine_from_build_variant_id` (refinement targets one prior creative, not a catalog fan-out). Supported only when the agent advertises `creative.multiplicity.supports_catalog_fanout`; values above `max_creatives_limit` are clamped. Pair with `max_spend` to bound the bill of a large fan-out."},"signal_conditions":{"type":"array","x-status":"experimental","minItems":1,"items":{"allOf":[{"$ref":"#/$defs/external:core~1signal-targeting.json"},{"properties":{"signal_agent_segment_id":{"type":"string","x-entity":"signal_activation_id","description":"Optional opaque resolved-segment handle for this fan-out condition — the RESOLVED condition identity, distinct from signal_ref's DEFINITION identity. When get_signals or a product signal_targeting_options entry exposed a signal_agent_segment_id for the targeted signal, echo it here verbatim so the produced creative's signal_condition carries the resolved-segment identity that the trafficking-compatibility check (SIGNAL_TARGETING_INCOMPATIBLE) matches on exactly. Providers MAY namespace it (e.g. provider_a:weather:rain_realtime vs provider_b:precip:high) so cross-provider conditions stay distinct without a shared taxonomy registry; treat as opaque, do not parse the namespace for business logic. Prefer it over reconstructing condition identity from categorical values — categorical {signal_ref,value} identity is the weaker fallback, appropriate only for inherently-categorical signals with no resolved handle, and never a cross-provider equivalence claim."}}}]},"x-entity":"signal","description":"Advisory keep-all PRODUCTION axis: produce one distinct creative group per signal condition, each kept and trafficked with its own signal targeting (e.g. a rain creative AND a sun creative). Sibling to max_creatives (catalog axis), NOT a variant_axis value (which is choose-among). Each item reuses SignalTargeting (value_type-discriminated binary/categorical/numeric over signal_ref) so the produced group's signal_condition resolves condition identity through the SAME schema the sales-side package targeting uses, plus an optional signal_agent_segment_id carrying the RESOLVED-segment identity (vs signal_ref's definition identity) — echo a provider-exposed handle verbatim; it is the primary trafficking-compatibility key, with categorical signal_ref+value as the weaker fallback. Per #5280 this is an ADVISORY context pointer — it informs production and MUST NOT hard-block at the build_creative layer; trafficking-compatibility (a sun creative MUST NOT serve into rain-targeted packages) is enforced reject-at-trafficking on the sales side (SIGNAL_TARGETING_INCOMPATIBLE), not here. Triggers the BuildCreativeVariantSuccess shape. Supported only when the agent advertises creative.multiplicity.supports_signal_fanout; condition counts above max_signal_conditions_limit are CLAMPED (not rejected), consistent with max_creatives. Composes with max_creatives (catalog × conditions cross-product) and max_variants (variants per group)."},"max_variants":{"type":"integer","minimum":1,"default":1,"description":"Caps how many ALTERNATIVES to produce per creative (different voices, themes, best-of-N, etc.). Default 1 preserves single-output behavior. Each variant is a real, independently-billed build (you pay for all produced); the buyer keeps one or many. When variant_axis.values[] is provided, its length is authoritative over max_variants. Resolutions/quality tiers are NOT variants — request them as additional target formats."},"variant_axis":{"type":"object","description":"Declares the dimension along which variants differ. When `values` is provided, the agent produces exactly one variant per value (e.g. an A/B of two voices). When only `dimension` is provided, the agent chooses up to max_variants variants along that dimension (e.g. best-of-N, themes).","properties":{"dimension":{"type":"string","enum":["voice","theme","best_of_n","transformer_config","custom"],"description":"What varies across variants. `transformer_config` varies a named config param (name it in `field`); `best_of_n` lets the agent explore and rank; `custom` is agent-defined (describe in `label`)."},"field":{"type":"string","description":"The transformer `config` param `field` this axis sweeps. REQUIRED when `dimension` is `transformer_config`; `values[]` are then interpreted as values for `config[field]`. Omit for other dimensions."},"values":{"type":"array","description":"Caller-fixed set of values for the axis (e.g. [\"isaac\", \"sara\"] for dimension `voice`). When present, len(values) is the variant count and is authoritative over max_variants.","items":{},"minItems":1},"label":{"type":"string","description":"Human-readable description of the axis, especially for `custom`."}},"required":["dimension"],"additionalProperties":true},"keep_mode":{"type":"string","enum":["keep_all","keep_one","keep_some"],"default":"keep_all","description":"Advisory hint for how the buyer intends to use the variants. `keep_one` (best-of-N) and `keep_some` signal the agent to set `recommended`/`rank` on returned variants. Advisory only — it does not change what is returned or billed; every produced variant is returned and charged. Keeping is a client act of trafficking the chosen build_variant_id(s)."},"selection_strategy":{"$ref":"#/$defs/external:enums~1creative-selection-strategy.json","x-status":"experimental","description":"Governs HOW the agent samples when max_creatives < items_total (folds #5262). audience_relevance draws its ranking input from the SAME signal_ref pointers in signal_conditions / package targeting — NOT a parallel signals[] array. proximity takes a location input (geo shape TBD — WG open). inventory_priority is seller-side catalog metadata (margin/overstock/promo; no buyer input). random is the status-quo default. Per-creative selection ordering surfaces on the existing rank / recommended fields of creatives[].variants[], not a new selection_rank. Advisory; absent => agent default (random)."},"account":{"$ref":"#/$defs/external:core~1account-ref.json","description":"Account reference for pricing and billing. When present, the creative agent applies account-specific pricing from the rate card, records the build against the account for billing, and can enforce account-level quotas or entitlements. Required by creative agents that charge for their services."},"brand":{"$ref":"#/$defs/external:core~1brand-ref.json","description":"Brand reference for creative generation. Resolved to full brand identity (colors, logos, tone) at execution time."},"quality":{"$ref":"#/$defs/external:enums~1creative-quality.json","description":"Quality tier for generation. 'draft' produces fast, lower-fidelity output for iteration and review. 'production' produces full-quality output for final delivery. If omitted, the creative agent uses its own default. For non-generative transforms (e.g., format resizing), creative agents MAY ignore this field."},"evaluator":{"$ref":"#/$defs/external:core~1evaluator-spec.json","x-status":"experimental","description":"Optional advisory evaluator (buyer-attached pointer, #5280) declaring how produced variants should be evaluated and ranked — the rank-side of the get_creative_features feature oracle. Experimental (x-status: experimental): the whole evaluator surface is new and unfrozen, and requires creative.supports_evaluator, which sellers MUST pair with `creative.evaluator` in experimental_features. Drives the producing agent's gate-then-rank pipeline over its best_of_n exploration: per leaf, evaluate (the chosen form) → optionally GATE (`evaluator.feature_requirement[]`, drop fails — internal pruning of which leaves the agent recommends, never an AdCP-layer block of an already-produced billable leaf) → RANK survivors (`evaluator.rank_by`, an explicit {feature_id, direction} ordering). Feature discovery uses get_adcp_capabilities governance.creative_features for rank_by, feature_requirement, and eval.features[]; evaluator_id is a pre-provisioned/account-arranged preset, not an ID discovered from that catalog. Populates a per-leaf `eval` block of creative-feature values (creative-feature-result[]) when supports_evaluator. When the evaluator names an external agent (`evaluator.feature_agent.agent_url` or the agent-form `agent_url`), that agent MUST appear in the seller's `creative_policy.accepted_verifiers[]` (the same allowlist #5280 established for provenance verify_agent); an off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED`. The outbound evaluator call authenticates on the transport (request signing/JWKS, mTLS, or a pre-provisioned static credential); credentials and caller-supplied trust material MUST NOT appear in evaluator, context, ext, or creative payload fields, and credential- or trust-material keys should be rejected with `CREDENTIAL_IN_ARGS`. With no `feature_requirement`, evaluation is advisory only and does not change what is produced or billed; an unreachable/unknown on-list agent degrades to seller-default ranking (advisory errors[] note), not a failure. Requires creative.supports_evaluator; otherwise ignored."},"item_limit":{"type":"integer","minimum":1,"description":"Maximum number of catalog items a SINGLE creative consumes when generating (DCO-style — e.g. how many items fill one carousel/feed creative). When a catalog asset contains more items than this limit, the creative agent selects the top items based on relevance or catalog ordering. When item_limit exceeds the format's max_items, the creative agent SHOULD use the lesser of the two. Ignored when the manifest contains no catalog assets. Distinct from `max_creatives`, which fans OUT across catalog items to produce one distinct creative per item."},"include_preview":{"type":"boolean","description":"When true, requests the creative agent to include preview renders in the response alongside the manifest. Agents that support this return a 'preview' object in the response using the same structure as preview_creative. Agents that do not support inline preview simply omit the field. This avoids a separate preview_creative round trip for platforms that generate previews as a byproduct of building."},"preview_inputs":{"type":"array","description":"Input sets for preview generation when include_preview is true. Supported with a single target_capability_id; multi-capability requests generate one default preview per output. Deprecated target-format selectors retain equivalent compatibility behavior.","items":{"type":"object","properties":{"name":{"type":"string","description":"Human-readable name for this input set (e.g., 'Sunny morning on mobile', 'Evening podcast ad')"},"macros":{"type":"object","description":"Macro values to use for this preview variant","additionalProperties":{"type":"string"}},"context_description":{"type":"string","description":"Natural language description of the context for AI-generated content"}},"required":["name"],"additionalProperties":true},"minItems":1},"preview_quality":{"$ref":"#/$defs/external:enums~1creative-quality.json","description":"Render quality for inline preview when include_preview is true. 'draft' produces fast, lower-fidelity renderings. 'production' produces full-quality renderings. Independent of the build quality parameter — you can build at draft quality and preview at production quality, or vice versa. If omitted, the creative agent uses its own default. Ignored when include_preview is false or omitted."},"preview_output_format":{"$ref":"#/$defs/external:enums~1preview-output-format.json","default":"url","description":"Output format for preview renders when include_preview is true. 'url' returns preview_url (iframe-embeddable URL), 'html' returns preview_html (raw HTML). Ignored when include_preview is false or omitted."},"macro_values":{"type":"object","description":"Raw concrete values offered for build-time binding, keyed by AdCP universal semantic (for example CLICK_URL or CACHEBUSTER). With declarations, a value binds only a verified-universal `resolve_value` occurrence performed_by `creative_agent`, using that declaration's exact context and encoding; callers MUST NOT pre-encode it. The selected `creative.supported_formats[]` route's macro_resolution_capabilities is the binding build/preview capability set; seller-wide and product sets apply only on the sales execution path. Values never short-circuit `translate_to_native`: translation emits its target declaration and the complete target capability chain remains required. For creative_representation_set, selection happens before binding and the complete representation set remains byte-identical. Without declarations, the 3.x legacy path remains: creative agents may translate recognized AdCP tokens using the existing `translateUniversalMacros` contract, preserve omitted placeholders for the sales agent, and ignore unknown keys. Existing unmapped/frozen-consent diagnostics remain required.","additionalProperties":{"type":"string"}},"idempotency_key":{"type":"string","description":"Client-generated unique key for this request. Prevents duplicate creative generation on retries. 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}$"},"push_notification_config":{"$ref":"#/$defs/external:core~1push-notification-config.json","description":"Optional webhook configuration for async terminal completion/failure notifications on build_creative. Meaningful only when the request enters the async lifecycle and returns a Submitted envelope. Submitted envelopes with `task_id` remain pollable through `get_task_status` (legacy `tasks/get`) whether or not this field is present. If a request includes this field and the agent returns a Submitted envelope, the agent MUST deliver at least the terminal completion/failure notification to the configured URL; intermediate progress notifications are MAY. If the agent cannot honor the webhook channel, it MUST reject the request with a structured error instead of silently accepting. This field does not change response timing semantics: agents MUST NOT route a request through the async/Submitted arm or emit async delivery solely because `push_notification_config` is present; requests that can be completed inline still return the synchronous success shape."},"context":{"$ref":"#/$defs/external:core~1context.json"},"ext":{"$ref":"#/$defs/external:core~1ext.json"}},"required":["idempotency_key"],"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/creative-manifest.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-manifest.json","title":"Creative Manifest","description":"Complete specification of a creative: format identification + assets. In 3.2 a manifest uses `format_kind` (the canonical format name it targets), paired with optional `format_option_ref` when a product has multiple declarations sharing that kind. The deprecated `format_id` named-format branch remains only for 3.x wire compatibility. Ordinary and shared assets live in `assets`; a `coordinated_placements` additionally namespaces each component's canonical slots under `component_assets.<component_id>`.","type":"object","properties":{"format_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format path retained for 3.x compatibility. New manifests use canonical `format_kind` and, when product routing requires it, `format_option_ref`. Mutually exclusive with format_kind."},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Canonical 3.2 path. The canonical format name this manifest targets (e.g., `image`, `video_hosted`, `audio_vast`, `seller_rendered_stateful_display`, `coordinated_placements`). Selects the contract against which the seller validates the manifest's assets. Mutually exclusive with deprecated `format_id`."},"format_option_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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 carries multiple `format_options` entries sharing the same `format_kind`; optional when `format_kind` alone routes the manifest 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/build-creative-request.json#/$defs/external:core~1representation-selection.json","description":"Present when this seller-bound manifest was selected from a CreativeRepresentationSet. Preserves creative, complete revision digest, and selected representation lineage through sync and reporting."},"assets":{"type":"object","description":"Map of slot keys to actual asset content. Legacy named-format path: each key matches an `asset_id` from the format's `assets` array (e.g., 'banner_image', 'clickthrough_url', 'video_file', 'vast_tag'). 3.1+ canonical-format path: each key matches an `asset_group_id` from the format's `slots` declaration drawn from the canonical vocabulary registry (e.g., 'images_landscape', 'video', 'published_post', 'landing_page_url', 'vast_tag', 'script', 'creative_brief'). Either path produces the same envelope shape; only the slot-key vocabulary differs.\n\nEach slot value is **either** a single asset object (most slots — image, video, published_post, vast_tag, landing_page_url, etc.) **or** an array of asset objects (slots with `min`/`max` counts on the format declaration — `cards` on `image_carousel`, `headlines` / `descriptions` / `images_landscape` on `responsive_creative`, etc.). Single-vs-array shape is governed by the format's `slots[].min` and `slots[].max` parameters: when `max > 1` (or when the slot is conceptually a pool), the value MUST be an array; when the slot is single-valued, the value MUST be a single object. Each asset value (single or array element) carries an `asset_type` discriminator (image, video, audio, vast, daast, text, markdown, url, html, css, webhook, javascript, brief, catalog, published_post, zip, card) that selects the matching asset schema. Validators with OpenAPI-style discriminator support use `asset_type` to report errors against only the selected branch instead of all branches.","patternProperties":{"^[a-z0-9_]+$":{"oneOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":true},"component_assets":{"type":"object","description":"Component-addressed asset maps for `coordinated_placements`. Each key MUST match one `params.components[].component_id`; its value supplies that component's canonical slots. Shared assets remain in top-level `assets` and are injected only into components named by `shared_slots[].consumed_by`. This namespace allows two components to use the same canonical slot name, such as `image_main`, without collision. It MUST be absent for non-`coordinated_placements` manifests.","patternProperties":{"^[a-z][a-z0-9_]*$":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-assets.json"}},"additionalProperties":false},"brand":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1brand-ref.json","description":"Brand identity reference (BrandRef — `domain` plus optional `brand_id` for house-of-brands; plus optional inline `brand_kit_override` for per-creative tweaks where brand.json is missing/stale). When present, the seller pulls master brand identity (logo, palette, fonts, voice, and visual guidelines) from the brand's brand.json automatically; supported fields present in `brand_kit_override` take precedence, and all other master identity fields continue to come from brand.json. Catalogs supply product or item payload. Catalog item asset groups — including an item-level `logo` for a property or franchise — are item identity selected through format field bindings; they do not override brand.json's master logo or other brand identity fields. v2 formats no longer redeclare brand_logo / brand_colors / brand_voice as explicit slots — brand identity is implicit context."},"rights":{"type":"array","description":"Rights constraints attached to this creative. Buyer-carried fields are informational until a serving party evaluates an issuer-bound attestation reference under its own policy. Only a verified, unexpired, unrevoked, digest-matched evaluation can support serving authorization; verification_url is never authority.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1rights-constraint.json"}},"industry_identifiers":{"type":"array","description":"Industry-standard or market-specific identifiers for this specific manifest (e.g., Ad-ID, ISCI, Clearcast clock number, IDcrea). When present, overrides creative-level identifiers. Use when different format versions of the same source creative have distinct traffic identifiers (e.g., the :15 and :30 cuts, or separate TV and radio versions). 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/build-creative-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/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this creative manifest. Serves as the default provenance for all assets in this manifest. An asset with its own provenance replaces this object entirely (no field-level merging)."},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1ext.json"}},"required":["assets"],"not":{"anyOf":[{"required":["capability_id"]},{"required":["capability_ref"]}]},"oneOf":[{"title":"Named-format manifest","deprecated":true,"description":"Deprecated 3.x compatibility branch. Manifest references a named format via the structured format_id object. New 3.2 manifests use format_kind.","required":["format_id"],"not":{"required":["format_kind"]}},{"title":"Canonical-format manifest","description":"Manifest declares which canonical format it targets via `format_kind` (e.g., `image`). This 3.1+ canonical-format path was introduced by RFC #3305.","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"]}}},{"$comment":"audio_vast is new in 3.2, so its VAST assets require an exact version without changing the additive compatibility of existing video_vast or named-format manifests.","if":{"properties":{"format_kind":{"const":"audio_vast"}},"required":["format_kind"]},"then":{"properties":{"assets":{"patternProperties":{".*":{"allOf":[{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}},{"if":{"type":"array"},"then":{"items":{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}}}}]}}}}}}],"additionalProperties":true},"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/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: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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1video-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1audio-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1vast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1display-tag-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1text-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1url-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1html-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1javascript-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1zip-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1webhook-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1css-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1daast-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1markdown-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1brief-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1catalog-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1published-post-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1card-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1pixel-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1vast-tracker-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1assets~1daast-tracker-asset.json"}],"discriminator":{"propertyName":"asset_type"}},"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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:enums~1macro-resolver.json"},"encoding":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1catalog.json"}]},"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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/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: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/build-creative-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/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/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1image-asset.json"},{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1platform-extension-ref.json"}},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-request.json#/$defs/external:core~1assets~1asset-union.json"},"minItems":1}]}},"additionalProperties":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/build-creative-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/build-creative-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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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-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/build-creative-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/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/build-creative-request.json#/$defs/external:core~1brand-ref.json"},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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/build-creative-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/build-creative-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/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/build-creative-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/creative-representation-set.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-representation-set.json","title":"Creative Representation Set","description":"A complete buyer-authored revision containing one or more equivalent trafficking representations before seller binding. Exactly one compatible representation is selected for each seller-bound manifest. Representations are not rotation, A/B content, build variants, locale variants, or served variants.","x-adcp-validation":{"verifier_constraints":{"revision_identity":{"scope":["creative_id","revision_id"],"complete_preimage":"the complete CreativeRepresentationSet, never only the selected representation","canonical_content":"RFC 8785 JCS after removing exactly the top-level $schema, creative_id, revision_id, revision_content_digest, and name properties","unknown_fields":"included","array_order":"significant","duplicate_json_members":"reject before canonicalization","digest":"revision_content_digest MUST equal lowercase-hex SHA-256 of the canonical content","immutability":"reusing creative_id plus revision_id with a different digest or canonical content MUST fail with CREATIVE_REVISION_CONTENT_MISMATCH","equivalence_assertion":"the buyer asserts that all representations are equivalent; the digest proves set integrity, not semantic or rendered equivalence"}},"spec":"docs/creative/representation-sets.mdx#revision-identity"},"type":"object","properties":{"creative_id":{"type":"string","minLength":1,"x-entity":"creative","description":"Stable logical creative identifier across all representations and later seller-bound manifests."},"revision_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-revision-id.json","description":"Buyer-assigned immutable revision identity for this complete representation set. Changing any revision-bearing part of the set requires a new revision_id; selection does not."},"revision_content_digest":{"type":"string","pattern":"^sha256:[a-f0-9]{64}$","description":"SHA-256 of the RFC 8785 JCS canonical revision content defined by this schema. The producer computes it over the complete representation set after removing exactly the top-level $schema, creative_id, revision_id, revision_content_digest, and name properties. `$schema` is transport/schema-location metadata and never mints creative content identity. Resolvers MUST recompute and reject a mismatch; selection readback carries the verified digest so downstream sellers bind the revision to the complete source set rather than only the selected manifest."},"name":{"type":"string","minLength":1},"representations":{"type":"array","minItems":1,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-representation.json"},"x-adcp-validation":{"unique_item_properties":["representation_id"]},"description":"Complete ordered set of equivalent representations. `representation_id` values MUST be unique within this array. Unsupported entries remain byte-for-byte unchanged; neither filtering nor selection changes this revision's canonical content."},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Default provenance for every retained representation and for the selected seller-bound output unless a representation supplies a narrower provenance object."}},"required":["creative_id","revision_id","revision_content_digest","name","representations"],"additionalProperties":true},"external:core/creative-representation.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-representation.json","title":"Creative Representation","description":"One equivalent trafficking representation retained within a CreativeRepresentationSet before seller binding. `representation_id` is stable within its parent revision and identifies a representation, not rotation, A/B content, build output, locale, or a seller's served execution variant.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-manifest.json"},{"required":["format_kind"],"not":{"anyOf":[{"required":["format_id"]},{"required":["format_option_ref"]},{"required":["representation_selection"]}]}},{"$comment":"The opt-in late-bound VAST representation path requires one exact asset version. Existing video_vast and named-format CreativeManifest/CreativeAsset payloads retain additive 3.x compatibility; audio_vast is new in 3.2 and already requires the exact version in the base manifest.","if":{"properties":{"format_kind":{"enum":["video_vast","audio_vast"]}},"required":["format_kind"]},"then":{"properties":{"assets":{"patternProperties":{".*":{"allOf":[{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}},{"if":{"type":"array"},"then":{"items":{"if":{"type":"object","properties":{"asset_type":{"const":"vast"}},"required":["asset_type"]},"then":{"required":["vast_version"]}}}}]}}}}}}],"type":"object","properties":{"representation_id":{"type":"string","minLength":1,"pattern":"^[a-zA-Z0-9_-]+$","x-entity":"creative_representation","description":"Stable representation identifier, unique within the enclosing CreativeRepresentationSet revision."},"source":{"type":"object","properties":{"system":{"type":"string","minLength":1,"description":"Source system namespace."},"source_representation":{"type":"string","minLength":1,"description":"Source system's human-readable name for this representation."},"source_id":{"type":"string","description":"Optional immutable source-system identifier for this representation."}},"required":["system","source_representation"],"additionalProperties":true}},"required":["representation_id","source","format_kind"],"additionalProperties":true},"external:core/representation-destination.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/representation-destination.json","title":"Representation Destination","description":"Seller-owned inventory context against which a CreativeRepresentationSet is resolved. This object is valid only when build_creative is invoked on the destination sales agent. The seller resolves product_id to its current product, verifies that format_option is an exact current effective declaration for the requested placements, and intersects it with its own current seller-wide execution capabilities. A standalone creative agent cannot use this object to claim seller deliverability.","x-adcp-validation":{"verifier_constraints":{"seller_authority":"the build_creative endpoint MUST be the sales agent that owns product_id","current_product_match":"format_option MUST exactly match one effective current format option for product_id after every applicable placement and publisher narrowing","placement_scope":"when placement_refs is omitted, the representation must satisfy the common effective contract for every placement where the product may deliver","execution_intersection":"resolution additionally intersects the seller's current media_buy.execution.creative_specs VAST and macro ceilings; the request does not override those capabilities","tracker_execution_version":"when a candidate contains first-class vast_tracker or daast_tracker assets and no sibling VAST/DAAST delivery document supplies one exact version, the matching execution_*_version is required, MUST belong to the destination acceptance set, and MUST be preserved in representation_selection; the seller MUST NOT guess or defer it to a later package"},"spec":"docs/creative/representation-sets.mdx#seller-bound-resolution"},"type":"object","properties":{"product_id":{"type":"string","minLength":1,"x-entity":"product","description":"Product owned by the destination seller."},"format_option":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1product-format-declaration.json","description":"Exact effective destination declaration. The full declaration is carried so an option without format_option_id remains addressable. The destination seller verifies it against the current product and applicable placement/publisher narrowings."},"placement_refs":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1placement-ref.json"},"description":"Optional placements the derived manifest must satisfy. Omission means every placement in the intended product route, not an unconstrained destination."},"execution_vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json","description":"Exact VAST execution version selected for seller-assembled first-class VAST trackers when no sibling exact-version VAST document supplies it. Must be accepted by format_option and is preserved in selection lineage."},"execution_daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1daast-version.json","description":"Exact DAAST execution version selected for seller-assembled first-class DAAST trackers when no sibling exact-version DAAST document supplies it. Must be accepted by format_option and is preserved in selection lineage."}},"required":["product_id","format_option"],"additionalProperties":false},"external:core/product-format-declaration.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/product-format-declaration.json","title":"Product Format Declaration","description":"Inline format declaration on a product. The `format_kind` discriminator names which canonical format the product narrows; `params` carries only the canonical creative-shape parameters (slots, dimensions, durations, codecs, character limits, platform_extensions, etc.). Processing metadata such as `macro_resolution_capabilities` belongs at this declaration's top level rather than inside `params`. Optional `format_option_id` (stable identifier for routing when a product's `format_options` contains multiple declarations sharing the same `format_kind`), optional `publisher_domain` (namespace for the format option when it comes from a publisher adagents.json catalog), `display_name` (seller-controlled human-readable label for dashboard and catalog UIs), and `applies_to_channels` (subset of the product's declared channels this declaration applies to — lets a multi-channel product carry distinct format_options per channel). Discriminated-union shape generates clean tagged unions in TypeScript and Pydantic codegen. Replaces v1's named-format pattern (where products referenced a separately-defined format file via compound `format_id`). Canonical product-bound declarations are the AdCP 3.2 authoring path; v1 named formats remain only as deprecated 3.x compatibility projections.\n\n**Closed-set semantics (normative).** `format_options[]` is the closed set of accepted formats for this product. Sellers MUST reject `create_media_buy` requests targeting any `format_kind` (or format option reference) not present in this list — typically with `UNSUPPORTED_FEATURE` or a seller-specific code; the rejection is structural, not negotiable. `seller_preference` modulates *within* the accepted set (a soft ranking hint between equally-acceptable options), it is NOT an enforcement axis. A product wanting to say 'this format is the only one that works' lists exactly that one entry in `format_options[]`; everything else falls outside the set and is rejected by the closed-set rule.\n\n**Format matching vs satisfaction (normative).** Legacy named formats MUST be normalized to canonical declarations before comparison; do not exact-match raw `(agent_url, id)` pairs once a `format_id` has been projected through `canonical`, `v1_format_ref`, or the canonical mapping registry. Equivalence matching can treat a legacy fixed-size display ID and `format_kind: \"image\"` with matching `width`/`height` as the same underlying shape. Product satisfaction is stricter and directional: when this declaration specifies fixed constraints such as `width`, `height`, `duration_ms_exact`, or `duration_ms_range`, a buyer request or creative manifest MUST declare and satisfy those constraints. A broad request with no dimensions or duration does not satisfy a fixed-size or fixed-duration product; a broad product MAY accept a more specific creative unless another product constraint excludes it. Duration precedence is `duration_ms_exact` > `duration_ms_range`. Range constraints use containment: a range-based request satisfies this declaration only when every value it permits falls within this declaration's accepted range; overlap alone is insufficient. An exact value satisfies a range when the exact value falls inside the accepted interval. For hosted audio/video, a null range endpoint is unbounded: [null, 60000] means up to 60s, and [15000, null] means at least 15s; [null, null] is invalid because at least one endpoint must be bounded.\n\n**Custom format_kind** (`format_kind: \"custom\"`): for adopter-defined shapes that don't fit the 15 canonicals (branded content, cross-screen sponsorship, sponsorship lockup, newsletter sponsorship, AR lens, playable, live event sponsorship). When `format_kind` is `custom`, the declaration MUST carry `format_shape` (recognized global pattern from the [format-shape vocabulary registry](/schemas/core/format-shape-vocabulary.json)) AND `format_schema` (URI+digest reference to a fetchable schema describing the actual `params` and `slots`). Buyer agents fetch the schema, validate manifests structurally, and reason about manifests without per-seller integration code. See [adcp#3666](https://github.com/adcontextprotocol/adcp/issues/3666) for the canonical promotion queue.","type":"object","required":["format_kind","params"],"discriminator":{"propertyName":"format_kind"},"properties":{"format_option_id":{"type":"string","description":"Stable identifier for this declaration within its namespace. REQUIRED when a product contains multiple declarations with the same format_kind and SHOULD be set on every entry. Publisher-backed options pair it with publisher_domain; product-local options omit publisher_domain. When a single declaration has a unique format_kind and no ID, buyers author canonically with format_kind plus params; they MUST NOT fall back to deprecated format_ids merely because this optional ID is absent. Examples: 'display_image_300x250', 'responsive_search', 'daily_pulse_homepage_image'."},"publisher_domain":{"type":"string","pattern":"^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$","description":"Namespace for `format_option_id` when this declaration references or narrows a publisher-declared format option from that publisher's adagents.json top-level `formats[]`. Product-local options omit this field and are selected by `format_option_id` within the target product."},"tracker_execution_contract":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1tracker-execution-contract.json","description":"Seller- or publisher-authored commitment describing which first-class manifest trackers the selected format option accepts and initiates in production. The seller-returned Product declaration is binding; publisher and placement declarations are upstream inputs that the seller resolves into that effective contract. Presence requires a stable format_option_id. Creative-agent capability projections, transformer inputs, and deprecated canonical_parameters MUST reject this seller-authority field rather than copying it."},"macro_resolution_capabilities":{"type":"array","minItems":1,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1macro-resolution-capability.json"},"description":"Binding format-option processing capabilities for exact macro dialect identities, semantics, operations, actors, contexts, and encodings. Absence means undeclared, not supported on the opt-in declared-token path. Seller-wide capabilities are only a ceiling. This field does not claim that a buyer tracker asset is honored or fired.","x-adcp-validation":{"verifier_constraints":{"translation_chain_closure":"every translate_to_native entry must have an exact matching resolve_value entry for its translation_target in this same array"}}},"technical_requirements_complete":{"type":"boolean","description":"Completeness assertion for technical creative acceptance constraints in this declaration. When true, the declaring party asserts that every technical constraint within its authority is expressed by this declaration (including fetched custom-format and platform-extension schemas), and every omitted technical field means no constraint at that layer. A creative that satisfies the complete effective technical contract MUST NOT later be rejected for an undisclosed technical constraint. When false or absent, omitted technical constraints are undeclared: consumers MUST NOT interpret omission as support, no constraint, or a prose/default value. The effective product/placement contract is complete only when every applicable product, publisher, and placement declaration asserts true. This assertion is limited to technical acceptance; it does not waive policy, legal, security, malware, transport/fetch, corrupted-content, or materially misdeclared-asset checks. Creative size fields ending in `_kb` use exactly 1,000 bytes per KB and fields ending in `_mb` use exactly 1,000,000 bytes per MB."},"display_name":{"type":"string","description":"Optional seller-controlled human-readable label for this format declaration. Used by buyer dashboards, catalog UIs, and reporting surfaces to show a seller's own naming ('Homepage Takeover', 'Branded Canvas', 'Reels Premium Video') rather than the raw `format_kind` or `format_option_id`. Has no machine semantics — buyer agents route on `format_kind` and `format_option_id`; `display_name` is purely for human presentation. Freeform; no enumeration. Sellers SHOULD keep it stable once published to avoid dashboard churn."},"sample_render_url":{"type":"string","format":"uri","pattern":"^https://","description":"Optional public HTTPS page where a human can inspect a sample render of this declaration using assets chosen by the party publishing the enclosing declaration. Consumers MUST identify that source correctly: publisher or community mirror for `adagents.json` `formats[]`, seller for product or inline-placement declarations, and creative agent for `creative.supported_formats`. Informational only: this is not a renderer endpoint, buyer-asset preview, validation result, creative approval, proof of publisher acceptance, or guarantee of live delivery. Declaring parties SHOULD keep the URL stable while the declaration is active."},"applies_to_channels":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1channels.json"},"uniqueItems":true,"description":"Optional subset of the parent product's `channels` to which this declaration applies. When omitted, the declaration applies to ALL channels declared on the product. Lets a multi-channel product (e.g., `channels: ['display', 'video']`) carry distinct format_options per channel — `format_options: [{format_kind: 'image', applies_to_channels: ['display']}, {format_kind: 'video_hosted', applies_to_channels: ['video']}]`. Buyers ship channel-appropriate manifests per `applies_to_channels`."},"seller_preference":{"type":"string","enum":["preferred","accepted","discouraged"],"description":"Optional soft routing hint *within* a product's accepted set of formats — NOT an enforcement axis. `preferred` — seller actively recommends this format (often because of measurement, viewability, or render-quality differences); `accepted` — supported on equal footing with other format_options (default when omitted); `discouraged` — supported but suboptimal (e.g., legacy 3p-tag where the seller would prefer html5 for OM-SDK coverage). Buyer agents picking between format_options SHOULD respect seller preferences when their own constraints don't override.\n\n**Not an enforcement axis (normative).** `seller_preference` does NOT carry the meaning of 'this format won't work / required-only'. That case is structural: `format_options[]` IS the closed set of accepted formats; anything outside the list is rejected at `create_media_buy` regardless of preference. A seller that accepts only one format lists exactly that one entry — the structural fact does the enforcement work, no enum value needed. There is intentionally no `required` value; preference is bounded to *ranking within the already-accepted set*, not gating into it."},"locale_policy":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1creative-locale-policy.json","description":"Optional seller-enforced creative-locale constraint for this format option. This is product/placement eligibility, not a new format kind or synthetic locale-specific format ID. Because legacy format_ids cannot preserve this constraint, declarations carrying locale_policy MUST set canonical_formats_only to true and MUST NOT carry v1_format_ref."},"canonical_formats_only":{"type":"boolean","default":false,"description":"When true, this format declaration has no clean v1 projection and SDKs MUST NOT synthesize a v1 `format_id` for it. Buyers reading the product on the v1 wire path see this declaration absent from `format_ids`; only v2-aware buyers (reading `format_options`) discover it. Set explicitly for `format_kind: \"custom\"` declarations (no canonical exists in v1 to project onto) and for declarations whose canonical/parameter shape cannot round-trip through a v1 named format without semantic loss. The protocol does NOT mint synthetic v1 format_ids for unmappable declarations — the alternative (an `aao-synth/*` namespace populated automatically) was considered and rejected because adopters would index on synthetic IDs that have no stable identity. Producers SHOULD set `canonical_formats_only: true` rather than omit the declaration from `format_options` — explicit v2-only is more useful than silent absence."},"experimental":{"type":"boolean","default":false,"description":"When true, this seller's specific canonical declaration may not work as declared even if the underlying canonical is stable. Buyers SHOULD preflight it with validate_input or in a sandbox before routing production budget and SHOULD filter it from default views unless the caller opts in. Experimental status never makes the deprecated named-format path preferable. This field is independent of the canonical's own experimental flag and replaces the earlier runtime_status enum."},"format_shape":{"type":"string","description":"REQUIRED when `format_kind: \"custom\"`; otherwise MUST be absent. Recognized global pattern this custom shape is an instance of, drawn from the [format-shape vocabulary registry](/schemas/core/format-shape-vocabulary.json) (`branded_content`, `cross_screen_sponsorship`, `sponsorship_lockup`, `newsletter_sponsorship`, `ar_lens`, `playable`, `live_event_sponsorship`, …). Non-canonical values are valid (validators MAY soft-warn) — adopters CAN ship a shape that isn't yet in the registry. Adding entries is a vocabulary PR. Once a `format_shape` entry sees 2+ adopters with substantively similar `format_schema` content for 90+ days, the working group may promote it to a first-class canonical. Retired vocabulary entries `multi_state_display` and `multi_placement_takeover` remain temporarily recognizable for migration; new declarations MUST use their promoted canonicals and validators SHOULD emit `FORMAT_SHAPE_PROMOTED`. `roadblock` remains an inventory/exclusivity classifier and is not a promoted creative format."},"v1_format_ref":{"type":"array","minItems":1,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-id.json"},"description":"Authoritative v2 → v1 link, expressed as an array of one or more v1 `format_id` ({agent_url, id}) values. Each entry asserts that this canonical-formats declaration IS the same underlying format as the referenced v1 named format. Always an array (single-ref is `[{...}]`) so the multi-size case below has a clean wire shape — adopters surveyed in the SDK implementor review pushed for this over the lossy single-ref form.\n\nThe v2 declaration's `params` MUST narrow (be compatible with) each referenced v1 format's `requirements` — see the 'Narrows — formal definition' section in canonical-formats.mdx. SDKs comparing dual-emitted shapes (`Product.format_ids[]` ⊇ entries from `v1_format_ref` AND `Product.format_options[]` carrying this declaration) treat the link as the authoritative pairing and run the narrowing check between this declaration and EACH referenced v1 format file's `requirements`.\n\n**Multi-size fan-out (normative).** When the declaration carries `params.sizes: [{w,h}, ...]` (multi-size flexible slot), sellers SHOULD carry one `v1_format_ref[]` entry per size, each pointing at the per-size v1 named format in the AAO catalog. Example: a multi-size image declaration with `sizes: [300x250, 728x90, 970x250]` SHOULD carry `v1_format_ref: [{aao, display_300x250_image}, {aao, display_728x90_image}, {aao, display_970x250_image}]`. v1-only buyers then see the product on all three sizes via the `format_ids[]` dual-emission. When `v1_format_ref[]` count < `sizes[]` count, SDKs MUST emit `FORMAT_DECLARATION_V1_LOSSY_MULTI_SIZE` on the response `errors[]` (advisory, alongside the partial-coverage v1 emit — NOT in place of it). SDKs MAY (non-normative) fan out automatically by catalog lookup when `v1_format_ref[]` has length 1 and `sizes[]` has length N — opt-in, requires catalog access; sellers asserting refs is the source of truth.\n\nMutually exclusive with `canonical_formats_only: true` — a declaration can EITHER assert no v1 projection (`canonical_formats_only: true`) OR link to v1 named formats (`v1_format_ref[]`), never both. When neither is present, SDKs fall back to the resolution order in `v1-canonical-mapping.json` (seller's explicit `canonical` field on the v1 file → registry glob → structural match → fail-closed).\n\nThis is the v2-side authoritative replacement for the v1-side `canonical_parameters` field on `format.json` (which is deprecated for 3.1, removed at 4.0). Sellers SHOULD prefer authoring v2 declarations with `v1_format_ref[]` over mirroring the v2 shape onto v1 files via `canonical_parameters`; the directional link (v2 declaration → v1 identifiers) is the same fact without the parallel-shape drift surface.\n\n**AAO-hosted convention (normative).** For IAB-standard formats (image dimensions, VAST/DAAST tags, standard third-party tags, HTML5 banner bundles), sellers SHOULD point each `v1_format_ref[].agent_url` at the AAO-hosted canonical agent URL `https://creative.adcontextprotocol.org` and use the registry-published id (e.g., `display_300x250_image`, `video_vast_30s`, `audio_standard_30s`, `display_300x250_html`, `display_js`). This converges the v1-wire namespace: every seller's IAB MREC points at the same `{agent_url, id}` pair, so v1-only buyers' allowlists work uniformly. Without this convention, every publisher's 300x250 ships with a different `v1_format_ref` (theirs vs nytimes.example vs cnn.example vs …) and the v1 wire fragments into per-publisher namespaces — exactly what canonical-formats was designed to eliminate.\n\nFor platform-specific formats (Meta Reels, TikTok Spark, Snap Spotlight, etc.), each `v1_format_ref[].agent_url` SHOULD point at the platform's own agent_url when the platform has adopted AdCP and publishes its own `adagents.json` with `formats[]`. When the platform has NOT adopted AdCP, sellers SHOULD point at the AAO community-registry mirror — `https://creative.adcontextprotocol.org/translated/<platform>` + `id: <platform-format-name>` (e.g., `https://creative.adcontextprotocol.org/translated/meta` + `id: meta_reels`). This keeps the v1 namespace converged across all sellers selling that platform's inventory until the platform owns its own adagents.json.\n\n**Platform-adoption cutover (normative).** When a platform adopts AdCP and publishes its own adagents.json, sellers MUST update `v1_format_ref[].agent_url` to the platform's adopted agent_url in the same minor release as the AAO mirror entry's `superseded_by` field goes live (see `static/schemas/source/adagents.json#superseded_by`). The AAO mirror entry SHOULD continue serving for ≥1 minor release after `superseded_by` is set, returning an advisory 'superseded' marker so v1 buyer allowlists keyed on the mirror URL get an explicit signal rather than a silent break. **Identity-confusion note**: the mirror URL is *format-shape namespace*, NOT seller identity. Inventory authorization always flows from `authorized_agents[]` + publisher signing keys; a buyer matching `v1_format_ref[].agent_url` against an allowlist is matching format-shape provenance, not seller identity.\n\n**Mirror domain migration (3.1).** Earlier drafts used `https://mirror.adcontextprotocol.org/translated/<platform>`. As of this release, the convention is `https://creative.adcontextprotocol.org/translated/<platform>` — sibling content under the AAO catalog domain we already host. Adopters who hardcoded the earlier mirror URL MUST migrate to the new path; the canonical-formats.mdx migration section documents the move. No transitional redirect is currently published (the earlier subdomain was never provisioned).\n\nFor seller-bespoke formats (a publisher's `acme_homepage_takeover` that doesn't fit IAB conventions), each `v1_format_ref[].agent_url` is the seller's own agent_url and the id is seller-namespaced. These won't appear in `v1-canonical-mapping.json`'s registry; they're seller-asserted only."},"format_schema":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1platform-extension-ref.json","description":"REQUIRED when `format_kind: \"custom\"`; otherwise MUST be absent. URI+digest reference to a fetchable schema describing this custom shape's actual `params` and `slots`. Same hosting model as `platform_extensions`: open-ecosystem publishers host the artifact at the canonical URI on their subdomain; closed-platform / walled-garden shapes resolve through the AAO mirror at `https://creative.adcontextprotocol.org/translated/...`. Buyer agents fetch by `uri@digest` (immutable per digest, aggressive caching, `Cache-Control: public, max-age=31536000, immutable`), validate `params` and `slots` against the fetched schema, and reason about manifests structurally — same mechanic as platform_extensions but at the format-structure level. Without `format_schema`, custom shapes would be opaque to buyer agents and the protocol would regress to per-seller integration code; that's why the schema is required, not optional.\n\n**Fetch contract (normative)** — `format_schema` is load-bearing for validation (unlike `platform_extensions`, which is informational on the *consumption* side). The *transport* rules below apply identically to BOTH fields — any SDK fetching a `platform-extension-ref.json` URI MUST apply this contract regardless of whether the field name is `format_schema` or `platform_extensions`. A shared SDK fetch path that drops to the weakest bar undermines `format_schema`'s hardening. The consumption distinction (load-bearing vs informational) is about *what the body means*; the transport distinction is `https`-and-allowlisted regardless.\n\n- **Transport**: `https` only. Buyers MUST reject `http://`, `file://`, `data:`, and any non-`https` scheme. The URI MUST resolve to a JSON document that is itself a valid JSON Schema (Draft 07 or 2020-12; producers MUST declare `$schema`).\n- **SSRF protection**: buyers MUST resolve the URI hostname and reject if any resolved address is in RFC 1918 private space (`10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`), loopback (`127.0.0.0/8`, `::1`), link-local (`169.254.0.0/16`, `fe80::/10`), CGNAT (`100.64.0.0/10`), or any RFC 6761 special-use name (`.local`, `.localhost`, `.internal`, `.test`, `.example`, `.invalid`). Cloud metadata endpoints (`169.254.169.254`, `metadata.google.internal`, `kubernetes.default.svc`) are explicitly forbidden — these are credential-leak primitives. Buyers MUST pin the connection to the resolved IP (or re-resolve and re-validate the allowlist per request) to defeat DNS rebinding.\n- **HTTP redirects**: MUST be disabled. If a follow is implemented at all, the redirect target MUST pass the same scheme + SSRF + allowlist checks; otherwise the fetch hard-fails. Open redirects on same-origin paths are otherwise a free SSRF primitive.\n- **Response size cap**: response body MUST be capped at 1 MiB. Enforce during streaming, not after full buffering. Over-cap hard-fails identically to digest mismatch.\n- **Timeout**: SDKs SHOULD apply a fetch timeout ≤5 seconds. Timeout SHOULD be treated identically to an HTTP 5xx response (transient — retry policy at the SDK's discretion; on persistent failure surface as unresolved and skip the declaration for this session).\n- **Digest verification**: SHA-256 of the response body MUST equal `digest`. **Digest mismatch is a hard fail** — the buyer MUST treat the format declaration as unresolvable and MUST NOT validate manifests against the mismatched body. A divergent digest is either a malicious substitution or producer error; either way, falling back to the un-verified body breaks the trust model. Digest format: `sha256:` prefix + 64 lowercase hex characters. Cache key is `uri@digest`; digest mismatch MUST NOT be cached as a negative result keyed on `uri` alone (defeats CDN-flap recovery), and MUST be distinguishable in telemetry from network 5xx / 404 (sustained mismatch is a substitution-attack signal, not a flap).\n- **Sandboxing of `$ref`**: fetched schemas MAY use `$ref`. Buyers MUST resolve `$ref` only to URIs that are (a) same-origin as the parent `format_schema.uri` after RFC 3986 §6 normalization (lowercase scheme + host, strip default port, normalize path dot-segments, no userinfo component), OR (b) hosted under the AAO catalog domain (`https://creative.adcontextprotocol.org/...`), OR (c) intra-document JSON Pointer refs (`#/...`) bounded to the parent document's parsed tree. Cross-origin `$ref` to arbitrary URIs MUST be rejected. `$ref: file://...` MUST be rejected unconditionally. Transitive `$ref` chains MUST be bounded at depth ≤8 AND `$ref` count ≤256 across the resolved tree (depth 8 with breadth 100 per level is 10^16 nodes — depth alone is not enough). Publishers SHOULD inline rather than $ref where possible.\n- **Schema-compile bounds (DoS protection)**: validators MUST bound CPU/memory on fetched schemas. Recommended: compiled-schema keyword count ≤10 000, `pattern` regexes evaluated with a non-backtracking engine (re2) OR under a per-pattern timeout, per-manifest validation budget ≤250 ms (exceeded budget → treat manifest as invalid, surface telemetry signal). Without these, a 'valid' schema with catastrophic regex backtracking or exponential `allOf`/`anyOf` expansion pins a CPU forever.\n- **Cache**: buyers cache fetched schemas by `uri@digest` and treat them as immutable (the same hosting contract as `platform_extensions`). On `404`, network partition, or persistent fetch failure, buyers SHOULD degrade gracefully (treat the declaration as unresolved, skip it for the current `get_products` response, surface via `errors[]` with the relevant code) rather than failing the entire session.\n- **Schema-not-valid handling**: if the fetched body parses as JSON but is not a valid JSON Schema, the buyer MUST treat the declaration as unresolvable (same as digest mismatch) and surface via `errors[]`. Validators MUST NOT attempt partial validation against an invalid schema.\n- **AAO catalog trust**: `https://creative.adcontextprotocol.org/*` is a single trust anchor in the same-origin allowlist; compromise of the catalog domain or its CA compromises every buyer agent. Catalog-served bodies MUST be digest-pinned identically to origin fetches (the digest is on the *parent* `format_schema.uri@digest`, not on the catalog response). Future hardening (signed bodies, transparency log) is tracked separately."}},"allOf":[{"$comment":"A production tracker commitment must be durably addressable; ID-less unique-kind declarations cannot carry seller execution authority.","if":{"required":["tracker_execution_contract"]},"then":{"required":["format_option_id"],"properties":{"format_option_id":{"minLength":1}}}},{"$comment":"Publisher-scoped canonical declarations are addressable only by the complete {publisher_domain, format_option_id} identity pair.","if":{"required":["publisher_domain"]},"then":{"required":["format_option_id"]}},{"if":{"properties":{"format_kind":{"const":"custom"}},"required":["format_kind"]},"then":{"required":["format_shape","format_schema"],"anyOf":[{"properties":{"canonical_formats_only":{"const":true}},"required":["canonical_formats_only"]},{"required":["v1_format_ref"]}]},"else":{"not":{"anyOf":[{"required":["format_shape"]},{"required":["format_schema"]}]}}},{"$comment":"canonical_formats_only:true and v1_format_ref are mutually exclusive — a declaration EITHER asserts no v1 projection OR links to a v1 named format, never both.","not":{"allOf":[{"properties":{"canonical_formats_only":{"const":true}},"required":["canonical_formats_only"]},{"required":["v1_format_ref"]}]}},{"$comment":"Canonical-format product declarations use format_option_id; capability_id belongs only to creative-agent build capabilities.","not":{"required":["capability_id"]}},{"$comment":"Locale policy is a v2-only hard constraint. Legacy format_ids cannot preserve it without allowing non-executable buys.","if":{"required":["locale_policy"]},"then":{"properties":{"canonical_formats_only":{"const":true}},"required":["canonical_formats_only"]}}],"oneOf":[{"title":"Image Format Declaration","properties":{"format_kind":{"type":"string","const":"image"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image.json"}},"required":["format_kind","params"]},{"title":"HTML5 Format Declaration","properties":{"format_kind":{"type":"string","const":"html5"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1html5.json"}},"required":["format_kind","params"]},{"title":"Display Tag Format Declaration","properties":{"format_kind":{"type":"string","const":"display_tag"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1display_tag.json"}},"required":["format_kind","params"]},{"title":"Image Carousel Format Declaration","properties":{"format_kind":{"type":"string","const":"image_carousel"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image_carousel.json"}},"required":["format_kind","params"]},{"title":"Hosted Video Format Declaration","properties":{"format_kind":{"type":"string","const":"video_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_hosted.json"}},"required":["format_kind","params"]},{"title":"VAST Video Format Declaration","properties":{"format_kind":{"type":"string","const":"video_vast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_vast.json"}},"required":["format_kind","params"]},{"title":"Hosted Audio Format Declaration","properties":{"format_kind":{"type":"string","const":"audio_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_hosted.json"}},"required":["format_kind","params"]},{"title":"VAST Audio Format Declaration","properties":{"format_kind":{"type":"string","const":"audio_vast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_vast.json"}},"required":["format_kind","params"]},{"title":"DAAST Audio Format Declaration","properties":{"format_kind":{"type":"string","const":"audio_daast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_daast.json"}},"required":["format_kind","params"]},{"title":"Sponsored Placement Format Declaration","properties":{"format_kind":{"type":"string","const":"sponsored_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1sponsored_placement.json"}},"required":["format_kind","params"]},{"title":"Native In-Feed Format Declaration","properties":{"format_kind":{"type":"string","const":"native_in_feed"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1native_in_feed.json"}},"required":["format_kind","params"]},{"title":"Responsive Creative Format Declaration","properties":{"format_kind":{"type":"string","const":"responsive_creative"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1responsive_creative.json"}},"required":["format_kind","params"]},{"title":"Agent Placement Format Declaration","properties":{"format_kind":{"type":"string","const":"agent_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1agent_placement.json"}},"required":["format_kind","params"]},{"title":"Seller-Rendered Stateful Display Format Declaration","properties":{"format_kind":{"type":"string","const":"seller_rendered_stateful_display"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1seller_rendered_stateful_display.json"}},"required":["format_kind","params"]},{"title":"Coordinated Placements Format Declaration","properties":{"format_kind":{"type":"string","const":"coordinated_placements"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1coordinated_placements.json"}},"required":["format_kind","params"]},{"title":"Custom Format Declaration","description":"Adopter-defined shape that doesn't fit the 15 canonicals. Requires `format_shape` (vocabulary-registered global pattern) and `format_schema` (URI+digest reference to a fetchable schema describing the actual params/slots). `params` shape is governed by the fetched schema rather than baked into AdCP — kept as `type: object` here with `additionalProperties: true` because the canonical schema validates dynamically post-fetch.","properties":{"format_kind":{"type":"string","const":"custom"},"params":{"type":"object","additionalProperties":true,"description":"Custom shape's params. Validated against the schema fetched from `format_schema.uri` at the cached `format_schema.digest`."}},"required":["format_kind","params"]}],"examples":[{"description":"Meta Reels — narrows video_hosted (vertical orientation)","data":{"format_kind":"video_hosted","params":{"orientation":"vertical","aspect_ratio":"9:16","duration_ms_range":[3000,90000],"min_width":1080,"min_height":1920,"max_file_size_mb":200,"video_codecs":["h264"],"audio_codecs":["aac"],"headline_max_chars":25,"primary_text_max_chars":72,"captions":"recommended","cta_values":["LEARN_MORE","SHOP_NOW","DOWNLOAD","SIGN_UP"],"composition_model":"deterministic","platform_extensions":[{"uri":"https://creative.adcontextprotocol.org/translated/meta/extensions/meta_pixel","digest":"sha256:a3f5b7c9d8e2f1a4b6c8d0e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2"}]}}},{"description":"IAB Medium Rectangle (300x250) — narrows image","data":{"format_kind":"image","params":{"width":300,"height":250,"max_file_size_kb":200,"image_formats":["jpg","png","gif"],"ssl_required":true,"composition_model":"deterministic","cta_values":["LEARN_MORE","SHOP_NOW","GET_OFFER"]}}},{"description":"Québec French-only display image — same image shape with a seller-enforced creative locale constraint","data":{"format_kind":"image","format_option_id":"quebec_display_image","display_name":"Québec display image — French creative","canonical_formats_only":true,"locale_policy":{"accepted_language_ranges":["fr"]},"params":{"width":300,"height":250,"max_file_size_kb":200,"image_formats":["jpg","png"]}}},{"description":"Podcast 30s host-read — narrows audio_hosted with a `script` slot the seller's host reads verbatim. No separate `inputs` map; the script lives in the manifest's `assets` like any other text asset.","data":{"format_kind":"audio_hosted","params":{"duration_ms_exact":30000,"audio_codecs":["mp3","aac"],"audio_sample_rates":[44100,48000],"audio_channels":["stereo"],"loudness_lufs":-16,"asset_source":"publisher_host_recorded","buyer_asset_acceptance":"rejected","composition_model":"deterministic","slots":[{"asset_group_id":"script","required":true,"asset_type":"text","max_chars":800},{"asset_group_id":"offering_ref","required":false,"asset_type":"text"}],"production_window_business_days":7}}},{"description":"StreamHaus Branded Feature — a still-custom branded-content format with format_schema pointing at the fictional seller's hosted schema. Buyer agents fetch the schema by uri@digest (cached, immutable) and validate the manifest structurally. `canonical_formats_only: true` is required for custom declarations because no v1 named format expresses this bespoke composition.","data":{"format_kind":"custom","canonical_formats_only":true,"format_shape":"branded_content","format_schema":{"uri":"https://ads.streamhaus.example/schemas/formats/branded_feature_v1","digest":"sha256:e1d4f6a9c2b5e8d1f4a7c0b3e6d9f2a5c8b1e4d7f0a3c6b9e2d5f8a1c4b7e0a3"},"format_option_id":"streamhaus_branded_feature","display_name":"StreamHaus branded feature","applies_to_channels":["display"],"params":{"components":[{"placement_type":"feature_header","required":true},{"placement_type":"sponsored_story_card","required":true},{"placement_type":"sponsorship_lockup","required":true}],"exclusivity_window_hours":12,"ssl_required":true}}}]},"external:core/tracker-execution-contract.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/tracker-execution-contract.json","title":"Tracker Execution Contract","description":"Seller-authored production commitment for first-class buyer-supplied tracker occurrences accepted by one effective product format option. Listed selectors are affirmative commitments. When complete is true, every unlisted combination is explicitly unsupported; when false, omissions are undeclared.","type":"object","properties":{"complete":{"type":"boolean","description":"Whether honored is the complete set. complete:true with an empty honored array explicitly supports no buyer-supplied trackers."},"honored":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1tracker-execution-selector.json"},"uniqueItems":true,"description":"Exact tracker/event selectors the seller accepts and initiates once per manifest instance for each logical event occurrence. selector_id and structural selector identity are each unique within this array."}},"required":["complete","honored"],"x-adcp-validation":{"selector_id_unique":true,"structural_selector_identity_unique":true,"version_sets":"For one non-version selector identity, version sets must be identical or disjoint; overlapping unequal sets are invalid.","asset_normalization":"Before selector matching, omitted pixel_tracker.method becomes img, omitted VAST/DAAST target becomes linear, and offset on a non-progress asset is ignored and removed. Existing 3.x asset schemas remain structurally permissive; the selector schema supplies the closed event/target matrix for contract matching.","format_slot_satisfiability":"Every asset_type named by honored MUST have at least one matching first-class slot in the effective selected canonical format declaration. A contract cannot promise execution for an asset shape that the same format rejects structurally.","layer_derivation":"Publisher, placement, and seller effective-contract derivation is evaluated over atomic tuples of normalized non-version selector identity, one exact version (or null for pixel), execution_actor, and one firing_path. For a complete parent, every child tuple MUST exist in the parent, the child remains complete, and array compression MUST NOT create a version/path cross-product. An incomplete or omitted parent is not a ceiling: a child may add or omit affirmative tuples for its narrower scope, but remains incomplete until every applicable layer is complete. Omission from an incomplete child is undeclared, not an assertion that the tuple is unsupported.","cardinality":"Each accepted manifest tracker instance is initiated exactly once in total for each logical event occurrence; identical URLs are not deduplicated."},"additionalProperties":false},"external:core/tracker-execution-selector.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/tracker-execution-selector.json","title":"Tracker Execution Selector","description":"One exact first-class manifest tracker selector in a seller production execution contract. AdCP 3.2 supports pixel_tracker, vast_tracker, and daast_tracker only; URL-slot selectors are not part of this union.","oneOf":[{"type":"object","properties":{"selector_id":{"type":"string","minLength":1,"x-entity":"tracker_execution_selector","description":"Stable identifier unique within the materialized execution contract."},"asset_type":{"type":"string","const":"pixel_tracker"},"event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1pixel-tracking-event.json"},"method":{"type":"string","const":"img","description":"AdCP 3.2 execution contracts cover image-pixel initiation only; JavaScript response evaluation is outside this contract version."},"custom_event_name":{"type":"string","minLength":1,"description":"Required only when event is custom."},"execution_actor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-execution-actor.json"},"firing_paths":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-firing-path.json"},"minItems":1,"uniqueItems":true,"description":"Complete set of permitted initiation environments. Exactly one path is selected for each logical event occurrence."}},"required":["selector_id","asset_type","event","method","execution_actor","firing_paths"],"allOf":[{"if":{"properties":{"event":{"const":"custom"}},"required":["event"]},"then":{"required":["custom_event_name"]},"else":{"not":{"required":["custom_event_name"]}}}],"additionalProperties":false},{"type":"object","properties":{"selector_id":{"type":"string","minLength":1,"x-entity":"tracker_execution_selector","description":"Stable identifier unique within the materialized execution contract."},"asset_type":{"type":"string","const":"vast_tracker"},"vast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_versions"},"vast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_offset"},"execution_actor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-execution-actor.json"},"firing_paths":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-firing-path.json"},"minItems":1,"uniqueItems":true,"description":"Complete set of permitted initiation environments. Exactly one path is selected for each logical event occurrence."}},"required":["selector_id","asset_type","vast_versions","vast_event","target","execution_actor","firing_paths"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json"}],"additionalProperties":false},{"type":"object","properties":{"selector_id":{"type":"string","minLength":1,"x-entity":"tracker_execution_selector","description":"Stable identifier unique within the materialized execution contract."},"asset_type":{"type":"string","const":"daast_tracker"},"daast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_versions"},"daast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_offset"},"execution_actor":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-execution-actor.json"},"firing_paths":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1tracker-firing-path.json"},"minItems":1,"uniqueItems":true,"description":"Complete set of permitted initiation environments. Exactly one path is selected for each logical event occurrence."}},"required":["selector_id","asset_type","daast_versions","daast_event","target","execution_actor","firing_paths"],"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json"}],"additionalProperties":false}],"discriminator":{"propertyName":"asset_type"}},"external:enums/tracker-execution-actor.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/tracker-execution-actor.json","title":"Tracker Execution Actor","description":"Actor responsible for initiating a buyer-supplied tracker under a seller-authored execution contract. This v1 vocabulary is intentionally narrower than the macro resolver actor vocabulary.","type":"string","enum":["seller","request_executor"]},"external:enums/tracker-firing-path.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/tracker-firing-path.json","title":"Tracker Firing Path","description":"Environment in which the responsible actor initiates a tracker. A selector may permit both values, but exactly one path is used for each logical event occurrence.","type":"string","enum":["client","server"]},"external:core/vast-tracker-constraints.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/vast-tracker-constraints.json","title":"VAST Tracker Constraints","description":"Shared VAST TrackingEvents constraints used by tracker assets and production execution selectors. The target/event matrix is closed, progress alone carries offset, and selector version arrays may contain only versions in which the event exists.","type":"object","properties":{"vast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_offset"},"vast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-tracker-constraints.json/$defs/vast_versions"}},"allOf":[{"if":{"anyOf":[{"not":{"required":["target"]}},{"properties":{"target":{"const":"linear"}},"required":["target"]}]},"then":{"properties":{"vast_event":{"enum":["creativeView","loaded","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","playerExpand","playerCollapse","fullscreen","exitFullscreen","progress","otherAdInteraction","interactiveStart","closeLinear"]}}}},{"if":{"properties":{"target":{"const":"non_linear"}},"required":["target"]},"then":{"properties":{"vast_event":{"enum":["creativeView","acceptInvitation","adExpand","adCollapse","minimize","overlayViewDuration","otherAdInteraction","close"]}}}},{"if":{"properties":{"target":{"const":"companion"}},"required":["target"]},"then":{"properties":{"vast_event":{"const":"creativeView"}}}},{"if":{"properties":{"vast_event":{"const":"progress"}},"required":["vast_event"]},"then":{"required":["offset"]},"else":{"not":{"required":["offset"]}}},{"if":{"properties":{"vast_event":{"enum":["skip","progress"]}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["3.0","4.0","4.1","4.2","4.3"]}}}}},{"if":{"properties":{"vast_event":{"const":"fullscreen"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["2.0","3.0"]}}}}},{"if":{"properties":{"vast_event":{"const":"exitFullscreen"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"const":"3.0"}}}}},{"if":{"properties":{"vast_event":{"enum":["playerExpand","playerCollapse","adExpand","adCollapse","minimize","overlayViewDuration","otherAdInteraction"]}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["4.0","4.1","4.2","4.3"]}}}}},{"if":{"properties":{"vast_event":{"const":"loaded"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["4.1","4.2","4.3"]}}}}},{"if":{"properties":{"vast_event":{"const":"interactiveStart"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["4.2","4.3"]}}}}},{"$comment":"VAST 4.0 omitted closeLinear; VAST 4.1 restored it from VAST 3.0. The 4.0 gap is intentional.","if":{"properties":{"vast_event":{"const":"closeLinear"}},"required":["vast_event"]},"then":{"properties":{"vast_versions":{"items":{"enum":["3.0","4.1","4.2","4.3"]}}}}}],"$defs":{"vast_event":{"type":"string","enum":["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","close","closeLinear"]},"vast_target":{"type":"string","enum":["linear","non_linear","companion"],"default":"linear"},"vast_offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$"},"vast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json"},"minItems":1,"uniqueItems":true}}},"external:core/daast-tracker-constraints.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/daast-tracker-constraints.json","title":"DAAST Tracker Constraints","description":"Shared DAAST tracker vocabulary and execution-selector constraints. The legacy asset vocabulary retains AdCP's historical close extension, while the closed standards selector matrix excludes it. Progress alone carries offset in selectors.","type":"object","properties":{"daast_event":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_event"},"target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_target"},"offset":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_offset"},"daast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_versions"}},"allOf":[{"if":{"anyOf":[{"not":{"required":["target"]}},{"properties":{"target":{"const":"linear"}},"required":["target"]}]},"then":{"properties":{"daast_event":{"enum":["creativeView","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","progress"]}}}},{"if":{"properties":{"target":{"const":"companion"}},"required":["target"]},"then":{"properties":{"daast_event":{"const":"creativeView"}}}},{"if":{"properties":{"daast_event":{"const":"progress"}},"required":["daast_event"]},"then":{"required":["offset"]},"else":{"not":{"required":["offset"]}}}],"$defs":{"daast_event":{"type":"string","enum":["creativeView","start","firstQuartile","midpoint","thirdQuartile","complete","mute","unmute","pause","resume","rewind","skip","progress","close"]},"daast_target":{"type":"string","enum":["linear","companion"],"default":"linear"},"daast_offset":{"type":"string","pattern":"^(\\d{2}:[0-5]\\d:[0-5]\\d(\\.\\d{3})?|(100|\\d{1,2})%)$"},"daast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1daast-version.json"},"minItems":1,"uniqueItems":true}}},"external:core/macro-resolution-capability.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/macro-resolution-capability.json","title":"Macro Processing Capability","description":"One exact processing capability for one governed dialect semantic, operation, actor, occurrence context, and encoding set. Entries are intentionally semantic-specific; they do not create a semantics × maximum-depth cross-product. Seller-wide capabilities are only a ceiling and the selected product format option is binding.","x-adcp-validation":{"verifier_constraints":{"adcp_semantic_identity":"when dialect is adcp, dialect_semantic must equal universal_semantic","translation_chain":"a translate_to_native entry is usable only when the same capability set contains an exact resolve_value entry for translation_target"},"spec":"docs/creative/universal-macros.mdx#capability-matching-and-validation"},"type":"object","properties":{"dialect":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-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":{"type":"string","enum":["verified_universal","dialect_defined"]},"universal_semantic":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1universal-macro.json"},"operation":{"type":"string","enum":["translate_to_native","resolve_value"]},"performed_by":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1macro-resolver.json"},"supported_contexts":{"type":"array","minItems":1,"uniqueItems":true,"items":{"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1macro-value-context.json"},{"not":{"const":"opaque"}}]}},"supported_encodings":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1macro-encoding.json"},"description":"Exact supported encoding profiles, not a maximum depth. Required for value resolution."},"translation_target":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1macro-translation-target.json"}},"required":["dialect","dialect_semantic","mapping_status","operation","performed_by","supported_contexts"],"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":{"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/build-creative-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":{"operation":{"const":"resolve_value"},"performed_by":{"const":"seller"},"supported_contexts":{"items":{"enum":["url_query_value","url_path_segment"]}},"supported_encodings":{"items":{"properties":{"kind":{"const":"rfc3986"},"depth":{"const":1}},"required":["kind","depth"]}}}}},{"if":{"properties":{"operation":{"const":"resolve_value"}},"required":["operation"]},"then":{"required":["supported_encodings"],"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":"translate_to_native"}},"required":["operation"]},"then":{"required":["translation_target"],"not":{"required":["supported_encodings"]}}}]},"external:enums/channels.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/channels.json","title":"Media Channel","description":"Standardized advertising media channels describing how buyers allocate budget. Channels are planning abstractions, not technical substrates. See the Media Channel Taxonomy specification for detailed definitions.","type":"string","enum":["display","olv","social","search","ctv","linear_tv","radio","streaming_audio","podcast","dooh","ooh","print","cinema","email","gaming","retail_media","influencer","affiliate","product_placement","sponsored_intelligence"],"enumDescriptions":{"display":"Digital display advertising (banners, native, rich media) across web and app","olv":"Online video advertising outside CTV (pre-roll, outstream, in-app video)","social":"Social media platforms (Facebook, Instagram, TikTok, LinkedIn, etc.)","search":"Search engine advertising and search networks","ctv":"Connected TV and streaming on television screens","linear_tv":"Traditional broadcast and cable television","radio":"Traditional AM/FM radio broadcast","streaming_audio":"Digital audio streaming services (Spotify, Pandora, etc.)","podcast":"Podcast advertising (host-read or dynamically inserted)","dooh":"Digital out-of-home buying context, including inventory on venue-operated screens and audio players","ooh":"Classic out-of-home (physical billboards, transit, etc.)","print":"Newspapers, magazines, and other print publications","cinema":"Movie theater advertising","email":"Email advertising and sponsored newsletter content","gaming":"In-game advertising across platforms","retail_media":"Retail media networks and commerce marketplaces (Amazon, Walmart, Instacart)","influencer":"Creator and influencer marketing partnerships","affiliate":"Affiliate networks, comparison sites, and performance-based partnerships","product_placement":"Product placement, branded content, and sponsorship integrations","sponsored_intelligence":"Sponsored Intelligence — advertising within AI assistants, AI search, and generative AI experiences via the reversed data flow"}},"external:core/creative-locale-policy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/creative-locale-policy.json","title":"Creative Locale Policy","description":"Seller-declared locale eligibility for one product or placement format declaration. Each accepted_language_ranges entry is a concrete canonical BCP 47 language range evaluated with RFC 4647 section 3.3.1 Basic Filtering: fr accepts fr, fr-CA, and fr-FR, while fr-CA accepts only fr-CA and its more-specific descendants. Ranges are ORed and wildcards are not supported. Presence is a hard assignment constraint, not a preference: at least one materialized creative locale variant must match. The seller filters the creative to eligible variants before applying buyer-declared strict Lookup, locale_fallbacks, or default behavior; buyer policy can never select a seller-ineligible variant.","type":"object","x-adcp-validation":{"verifier_constraints":{"range_matching":"rfc4647_basic_filtering","wildcards":"not_supported","assignment_eligibility":"at_least_one_materialized_variant_must_match","selection_precedence":"filter_seller_eligible_variants_before_buyer_lookup_fallback_or_default","serve_default":"when_unmatched_locale_action_is_serve_default_default_locale_variant_id_must_reference_an_eligible_variant","placement_narrowing":"product_policy_absent_allows_any_placement_policy_else_every_placement_range_must_be_contained_by_a_product_range","legacy_projection":"no_product_or_placement_format_id_may_project_to_a_locale_constrained_option","capability_gate":"seller_must_advertise_creative.localization_and_creative.has_creative_library","assignment_policy_lifecycle":"snapshot_effective_policy_at_acceptance_catalog_changes_apply_only_to_new_or_changed_assignments"},"spec":"docs/creative/canonical-formats.mdx#creative-locale-policy"},"properties":{"accepted_language_ranges":{"type":"array","description":"Concrete canonical BCP 47 language ranges accepted by this format option. RFC 4647 Basic Filtering is directional: seller range fr accepts variant fr-CA, but seller range fr-CA does not accept variant fr or fr-FR. Use zxx explicitly for language-neutral creative; und means unknown and is not a wildcard.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1locale-tag.json"},"minItems":1,"maxItems":50,"uniqueItems":true}},"required":["accepted_language_ranges"],"additionalProperties":true},"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:formats/canonical/image.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/image.json","title":"Canonical Format: Image","description":"Static image creative format. Slots: `image_main` (image asset, file or hosted URL), optional `headline` (text), `body_text` (text), `cta` (text/enum), `landing_page_url` (url). Tracking model: impression pixel + click URL via universal_macros, with optional viewability pixel. Distinct from `html5` (interactive bundles) and `display_tag` (third-party served). AR/dimensions narrow to specific sizes via product parameters — covers IAB display sizes (300x250, 728x90, 970x250, etc.) without a separate iab_size enum.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"title":"Size-mode mutex","description":"Exactly one of: (a) fixed (`width` + `height` both set), (b) multi-size (`sizes` set), (c) responsive (any of `min_width`/`max_width`/`min_height`/`max_height` set), (d) none (no size constraint declared — accepts any dimensions). Combining modes (e.g., `width` + `sizes`) is rejected at schema layer; same rule on `html5` and `display_tag` canonicals.","oneOf":[{"title":"fixed","required":["width","height"],"not":{"anyOf":[{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"multi-size","required":["sizes"],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"responsive","anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]}]}},{"title":"none","not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}}]},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"enum":["pause","screensaver"]}}}},{"properties":{"motion_level":{"enum":["static","limited_motion"]}}}],"properties":{"slots":{"default":[{"asset_group_id":"image_main","asset_type":"image","required":true},{"asset_group_id":"headline","asset_type":"text","required":false},{"asset_group_id":"body_text","asset_type":"text","required":false},{"asset_group_id":"primary_text","asset_type":"text","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for image canonical. Buyer ships an image asset (file or hosted URL) plus optional headline, body text, primary text (long-form caption), CTA (typically constrained to an enum via `cta_values`), and clickthrough URL. Products MAY override the default — make `headline` required, narrow `cta` to a value enum, or remove slots the surface doesn't consume."},"width":{"type":"integer","minimum":1,"description":"Logical render width in pixels — use for fixed-size slots (e.g., a 300×250 IAB MREC). When `pixel_ratios` is absent, the required image asset width is the same value (1x). When `pixel_ratios` is present, an accepted asset's intrinsic width is `width × pixel_ratio`. For multi-size flexible slots, use `sizes[]`; for responsive slots, use the min/max fields. The three size modes are mutually exclusive."},"height":{"type":"integer","minimum":1,"description":"Logical render height in pixels. Intrinsic asset height is `height × pixel_ratio`, where the ratio defaults to 1 when `pixel_ratios` is absent. See `width` for size-mode mutual exclusion."},"sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"List of accepted logical (width, height) render pairs for a multi-size flexible slot. The buyer ships an asset matching one logical size multiplied by one accepted `pixel_ratios` entry (or by 1 when `pixel_ratios` is absent). SDKs MUST treat size and density as separate axes: a 600×500 intrinsic asset at 2x satisfies a logical 300×250 size; it does not create a logical 600×500 placement. Mirrors OpenRTB `banner.format[]` semantics. Mutually exclusive with `(width, height)` and with responsive ranges."},"pixel_ratios":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"number","exclusiveMinimum":0},"description":"Accepted intrinsic-pixel densities for image assets, expressed as intrinsic pixels per logical render pixel (for example `[1, 2]` accepts both standard and Retina renditions). Absence means `[1]` for backward compatibility. This is an acceptance set, not a requirement to submit every rendition: one `image_main` asset satisfying any listed ratio is sufficient unless the effective `image_main` slot declares `required_pixel_ratios`. SDKs determine the effective ratio from `asset.pixel_ratio` when supplied, otherwise infer it from intrinsic asset dimensions divided by the matched logical size. Width and height ratios MUST agree."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted width in pixels for responsive slots that adapt within a range (e.g., 'any width from 300 to 970'). Use with `max_width` (and optionally `min_height`/`max_height`). Mutually exclusive with `(width, height)` and `sizes[]`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted width in pixels for responsive slots. Pair with `min_width`. See `min_width` for size-mode mutual exclusion."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted height in pixels for responsive slots. Pair with `max_height`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted height in pixels for responsive slots. Pair with `min_height`."},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Optional aspect ratio constraint (e.g., '1.91:1', '1:1'). When provided alongside `width`/`height`, must agree. When used with `sizes[]` or responsive ranges, narrows accepted entries to those matching the aspect ratio."},"max_file_size_kb":{"type":"integer","minimum":1,"description":"Maximum file size in kilobytes."},"image_formats":{"type":"array","items":{"type":"string","enum":["jpg","jpeg","png","gif","webp","svg"]},"description":"Permitted image file formats."},"ssl_required":{"type":"boolean","description":"Whether the image and its trackers must be served over HTTPS."},"headline_max_chars":{"type":"integer","minimum":1},"body_text_max_chars":{"type":"integer","minimum":1},"cta_values":{"type":"array","items":{"type":"string"},"description":"Permitted CTA values for this product (e.g., ['LEARN_MORE', 'SHOP_NOW'])."},"asset_source":{"type":"string","enum":["buyer_uploaded","publisher_host_recorded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered asset bytes come from. Single shared enum across all canonicals (`image`, `video_hosted`, `audio_hosted` — replaces the earlier per-canonical `image_source` / `video_source` / `audio_source` fields). `buyer_uploaded` (default): buyer ships a pre-rendered asset. `publisher_host_recorded`: publisher's host records the asset (audio-specific; podcast host-read pattern). `seller_pre_rendered_from_brief`: buyer ships a brief plus structured copy; seller renders ONE asset at sync_creatives or build_creative time (generative-DSP pattern). `seller_human_designed`: seller's design team renders manually from a brief. `agent_synthesized`: AI synthesis pipeline; pair with `synthesis_nondeterministic: true` when the platform cannot guarantee in-spec output (Veo/Sora/Imagen-class). `publisher_owned_reference`: buyer references an existing post or publisher-owned object via a `published_post` slot; the seller resolves and serves the referenced content after authorization/review rather than receiving uploaded bytes.\n\nNot every value is meaningful on every canonical — `publisher_host_recorded` is audio-specific; on `image` or `video_hosted` it has no defined behavior. `publisher_owned_reference` is meaningful only when the product's `slots` declaration accepts a reference asset such as `published_post`. Adopters MUST select a value appropriate to the canonical's asset type. The `slots` declaration is the binding contract for what the buyer ships; `asset_source` is informational and lets buyers understand the production model when picking products."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded assets. When `rejected`, the buyer cannot ship pre-rendered bytes directly — they must use build_creative (or sync_creatives with brief inputs or reference assets) so the seller produces or resolves the asset. Combined with `asset_source`, lets a product declare 'I produce assets from briefs and refuse buyer uploads' (asset_source=`seller_pre_rendered_from_brief`, buyer_asset_acceptance=`rejected`) or 'I accept existing post references, not uploaded bytes' (asset_source=`publisher_owned_reference`, buyer_asset_acceptance=`rejected`)."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On `image` only `pause` and `screensaver` are valid — the image-plus-copy contract the major pause-ad sellers ingest (seller composites the frame; typical canvas 1920×1080 or a transparent-region overlay). Other experiences route per the matrix in docs/creative/ctv-experiences.mdx."},"motion_level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1motion-level.json","description":"Accepted motion class (AdCOM attrs 21-22; `full_motion` is invalid on a static image canonical)."},"activation_methods":{"type":"array","uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1activation-method.json"},"description":"Viewer activation mechanisms this option offers (e.g. `qr_code` on a pause frame). Activations are engagement events, not impressions."}},"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on image must be pause or screensaver","motion_level_static_canonical":"motion_level full_motion is rejected on image","ctv_activation_copy_slots":"push_notification activation_methods SHOULD declare an activation_message slot; text_message SHOULD declare an activation_text_message slot; email SHOULD declare activation_email_subject and activation_email_body slots. Missing copy slots emit a non-blocking validate_input warnings[] entry."},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true},"external:formats/canonical/_base.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/_base.json","title":"Canonical Format Base","description":"Shared parameter fields that apply across canonical formats. Each canonical format extends this base with format-specific parameters (dimensions, durations, codecs, slot constraints).","type":"object","properties":{"experimental":{"type":"boolean","default":false,"description":"When true, this canonical or seller narrowing may not work as declared. Adopters SHOULD preflight it with validate_input or in a sandbox and SHOULD NOT route production budget without testing; experimental status never makes the deprecated v1 path preferable. Drivers include unsettled spec shape, an adopter runtime gap, and custom shapes awaiting promotion. This replaces the earlier status plus runtime_status axes. Sellers SHOULD set experimental whenever a canonical or declaration is not production-ready."},"deprecated":{"type":"boolean","default":false,"description":"When true, this canonical (or a seller's specific narrowing of it) is going away. Existing adopters are supported through the deprecation cycle; new adoption is discouraged. Pair with `migration_target_version` to indicate when the canonical is expected to be removed. Distinct from `experimental`: an experimental canonical may stabilize and stop being experimental; a deprecated canonical is on a sunset path."},"v1_translatable":{"type":"boolean","default":true,"description":"Whether this canonical has any v1 named-format equivalent. `true` (default) — the canonical is structurally expressible as one or more v1 named formats (IAB display sizes, VAST tags, DAAST tags, etc.); v1→v2 projection via `v1-canonical-mapping.json` is meaningful. `false` — the canonical is inherently new in v2 and has no v1 form; v1's `list_creative_formats` couldn't express it because the underlying concept (algorithmic surface composition, AI-surface mentions, retail-media catalog placements, multi-card carousels) didn't exist as a v1 named-format archetype.\n\nLets SDKs distinguish two failure modes that today look identical: (a) the registry hasn't covered this canonical yet (correctable — seller adds explicit `canonical` field or files a registry entry) vs (b) no v1 path is possible (informational — buyer needs v2-aware consumption, or seller declares `canonical_formats_only: true` on the product declaration). SDKs encountering `v1_translatable: false` on a canonical SHOULD NOT emit `FORMAT_PROJECTION_FAILED` (which signals registry-coverage gap) — instead surface the inherent v1-unreachability as a different diagnostic or skip silently. The six inherently-v2 canonicals in 3.2 are `image_carousel`, `sponsored_placement`, `responsive_creative`, `agent_placement`, `seller_rendered_stateful_display`, and `coordinated_placements`."},"since_version":{"type":"string","pattern":"^[1-9]\\d*\\.(0|[1-9]\\d*)$","description":"AdCP MAJOR.MINOR version that introduced this canonical (e.g., '3.1', '3.2'). Lets adopters reason about minimum protocol version requirements when consuming a format declaration. Patch precision is intentionally rejected — canonicals are introduced at minor-version boundaries."},"migration_target_version":{"type":"string","pattern":"^[1-9]\\d*\\.(0|[1-9]\\d*)$","description":"AdCP MAJOR.MINOR version by which the working group expects this canonical to stabilize, surface a breaking revision, or (when `deprecated: true`) be removed. Patch precision is intentionally rejected — canonicals shift at minor-version boundaries. Absence signals 'no specific target' (omit the field rather than use a placeholder like 'unknown')."},"composition_model":{"type":"string","enum":["deterministic","algorithmic"],"description":"Whether the surface composes deterministically (buyer can predict per-slot rendering — sponsored_placement, image, video) or algorithmically (surface chooses combinations or phrasing — responsive_creative, agent_placement)."},"provenance_required":{"type":"boolean","description":"When true, the product rejects unsigned synthesized assets. Builders calling build_creative MUST attach a C2PA-compatible provenance manifest attributing synthesis to the creative agent."},"platform_extensions":{"type":"array","description":"Platform-specific extensions narrowing the canonical (pixel ID shapes, conversion event taxonomies, platform-specific CTAs/destinations). Each extension is a URI+digest reference resolved against the bundled `extensions` map in get_products responses or fetched directly.\n\n**Collision precedence (normative).** When two or more `platform_extensions[]` entries on the same declaration extend the same target (e.g., both extend `tracking`) with overlapping field names, **array order is authoritative — later entries override earlier ones on a per-field basis** (last-in-array-wins). SDKs MUST surface the overlap via the `errors[]` array on the `get_products` response with a structured code (`FORMAT_DECLARATION_DIVERGENT` is appropriate when the overlap appears across dual-emitted shapes; a producer-self-emitted overlap on a single declaration SHOULD use the same code with `error.details: { collision_kind: \"platform_extension_field\", target, overlapping_fields, winning_extension_uri }`). Producers SHOULD avoid the collision by emitting one extension per target or by partitioning fields across extensions; the deterministic precedence is for last-resort consistency across SDK implementations, not a sanctioned merging strategy.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1platform-extension-ref.json"}},"synthesis_nondeterministic":{"type":"boolean","description":"When true, the format's production pipeline is genuinely nondeterministic — the platform cannot guarantee that synthesis from a given input set produces in-spec output. Veo / Sora / Runway-class generative video, and other AI-synthesis flows where output dimensions, duration, or quality vary per run. Implies a different validation contract: predictive `validate_input` is impossible; the platform's own post-synthesis QA loop applies; if the QA loop exhausts without producing a valid artifact, `build_creative` returns task_failed with a synthesis_failed reason. Distinct from `composition_model` (which describes how the surface composes per-slot rendering, not whether synthesis is deterministic). When false or absent, the format's production is predictable enough that `validate_input` can predict output properties from input properties.\n\n**Compatibility with `asset_source` / `item_production_model`**: `synthesis_nondeterministic: true` MAY pair with any of `seller_pre_rendered_from_brief`, `seller_human_designed`, or `agent_synthesized` (the QA loop is concept-level, not source-specific — 'seller renders from brief but each retry differs' is just as nondeterministic as Veo). It MUST NOT pair with `buyer_uploaded` (the buyer ships pre-rendered bytes; there's no synthesis step to be nondeterministic about). It MUST NOT pair with `publisher_host_recorded` (the publisher's host produces a deterministic-from-script output even if the human voice varies). When `synthesis_nondeterministic: true` is set with an incompatible source, validators SHOULD reject with a structured error.","default":false},"slots":{"type":"array","description":"Programmatic declaration of which canonical asset_group_id slots a manifest targeting this format must (or may) populate. Lets SDK codegen and validators enumerate expected slots without parsing the format's prose description. Each entry references an asset_group_id from the canonical vocabulary registry, paired with an `asset_type` so the validator knows which asset schema to apply. Format-level narrowing parameters that apply across all slots (e.g., flat `headline_max_chars` on responsive_creative) may also live on the format declaration; per-slot constraints (a specific slot's `max_chars` or `max_size_kb`) live on the slot entry.","items":{"type":"object","required":["asset_group_id","asset_type"],"properties":{"asset_group_id":{"type":"string","description":"Canonical asset_group_id from /schemas/core/asset-group-vocabulary.json. Non-canonical IDs are valid but trigger soft warnings."},"asset_type":{"type":"string","enum":["image","video","audio","text","markdown","url","html","css","javascript","vast","daast","display_tag","webhook","brief","catalog","published_post","zip","card","object","pixel_tracker","vast_tracker","daast_tracker"],"description":"Discriminator selecting the asset schema this slot accepts. SDK codegen uses this to type the slot value. `display_tag` is the atomic third-party display representation (URL, inline markup, or paired redirect). `published_post` is an existing-post reference asset. `pixel_tracker` / `vast_tracker` / `daast_tracker` are renderer-fired tracker primitives. `object` is a last-resort fallback."},"required":{"type":"boolean","description":"Whether this slot is required for a valid manifest.","default":false},"min":{"type":"integer","minimum":0,"description":"Minimum count for repeatable / pool slots."},"max":{"type":"integer","minimum":1,"description":"Maximum count for repeatable / pool slots."},"max_chars":{"type":"integer","minimum":1,"description":"Per-slot character limit. Valid only when `asset_type` is `text`, `markdown`, or `brief`. Mutually exclusive with `max_size_kb` (which applies to binary asset types). Schema enforces via if/then so a producer can't set both on the same slot."},"max_size_kb":{"type":"integer","minimum":1,"description":"Per-slot file size limit in exact kilobytes, where 1 KB = 1,000 bytes. Valid only when `asset_type` is `image`, `video`, `audio`, or `zip`. Mutually exclusive with `max_chars` (which applies to text asset types). Schema enforces via if/then so a producer can't set both on the same slot."},"pixel_ratios":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"number","exclusiveMinimum":0},"description":"Accepted intrinsic-pixel densities for this image-bearing slot. Valid when `asset_type` is `image`, and on a `card` slot where it constrains each card's image media (video media is unaffected). This makes density available to every canonical carrying image assets (native, carousel, responsive, companion images, and image itself), not only `format_kind: image`. When the image canonical also declares top-level `params.pixel_ratios`, the effective set is the intersection; an empty intersection is invalid. One matching asset satisfies the slot unless `required_pixel_ratios` requires rendition coverage."},"required_pixel_ratios":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"number","exclusiveMinimum":0},"description":"Required density coverage for an image rendition set. Valid only when `asset_type` is `image` and `pixel_ratios` is also declared. Every value MUST appear in the effective accepted set after intersecting any top-level image `params.pixel_ratios`, and the manifest slot value MUST be an array containing exactly one matching image rendition for each required ratio. Other accepted ratios remain optional. For example, `pixel_ratios: [1, 1.5, 2]` with `required_pixel_ratios: [1, 2]` requires the 1x and 2x renditions while making 1.5x optional. SDKs enforce intersection, subset, coverage, and duplicate-ratio rules because JSON Schema draft-07 cannot express them generically."},"logo_slots":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1logo-slot.json"},"uniqueItems":true,"description":"When `asset_group_id` is `logo`, renderer-facing brand.json logo slots acceptable for this format slot. Producers selecting from brand.json SHOULD prefer `logos[]` entries whose `slots[]` intersects this list, then apply `visual_guidelines.logo_usage_rules[]`."},"required_logo_slots":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1logo-slot.json"},"uniqueItems":true,"description":"Subset of `logo_slots` for which this format expects explicit logo coverage. A manifest or brand-derived logo pool SHOULD include at least one usable logo for each required slot; if coverage is missing, builders SHOULD surface a validation warning or approval mapping instead of guessing from prose."},"description":{"type":"string","description":"Human-readable description of what the slot expects from the buyer."},"consumed_for_production":{"type":"boolean","default":false,"description":"Dispatch hint for `build_creative` and v1↔v2 wire translators: when `true`, the slot's value is consumed as INPUT to a production step (host-read script, brief copy fed to generative synthesis, catalog feed driving per-SKU rendering) and is not rendered verbatim. When `false` (default), the slot's value is rendered verbatim on the placement (image bytes, video file, display tag).\n\nMotivates the v1↔v2 dispatch table: pre-v2 buyers shipped production-consumed inputs separately in a `inputs` map on the build_creative request; v2 collapses inputs and rendered assets into a single `assets` map keyed by `asset_group_id`. SDK translators between v1 and v2 use this flag per canonical to know which assets in the v2 manifest map back to v1 `inputs` vs v1 `assets`. Without the per-slot flag the dispatch table lives in adopter code and every SDK gets it slightly different.\n\nProducers SHOULD set this explicitly on slots whose consumption pattern isn't obvious (host-read scripts on `audio_hosted`, briefs on generative `video_hosted`, catalog feeds on `sponsored_placement`). For canonicals where every slot is render-verbatim (`image`, `display_tag`, `video_vast`, `audio_vast`), the default `false` is sufficient and the flag MAY be omitted."}},"additionalProperties":true,"allOf":[{"$comment":"max_chars is valid only for text-shaped asset types; max_size_kb is valid only for binary asset types. A slot MUST NOT carry both; the type-appropriate one is enforced via if/then.","if":{"properties":{"asset_type":{"enum":["text","markdown","brief"]}},"required":["asset_type"]},"then":{"not":{"required":["max_size_kb"]}}},{"if":{"properties":{"asset_type":{"enum":["image","video","audio","zip"]}},"required":["asset_type"]},"then":{"not":{"required":["max_chars"]}}},{"$comment":"Logo slot narrowing is only meaningful on the canonical logo asset group.","if":{"not":{"properties":{"asset_group_id":{"const":"logo"}},"required":["asset_group_id"]}},"then":{"not":{"anyOf":[{"required":["logo_slots"]},{"required":["required_logo_slots"]}]}}},{"if":{"properties":{"asset_type":{"enum":["image","card"]}},"required":["asset_type"]},"else":{"not":{"anyOf":[{"required":["pixel_ratios"]},{"required":["required_pixel_ratios"]}]}}},{"$comment":"A rendition set is representable only by an array-valued image slot. Card media is singular in card-asset.json, so card slots may accept densities but cannot require multiple density renditions.","if":{"required":["required_pixel_ratios"]},"then":{"properties":{"asset_type":{"const":"image"}},"required":["pixel_ratios"]}},{"$comment":"Non-size asset types (url, catalog, published_post, html, css, javascript, webhook, daast, vast, card, object, pixel_tracker, vast_tracker, daast_tracker) reject both — there's no defined per-slot size semantics on those.","if":{"properties":{"asset_type":{"enum":["url","catalog","published_post","html","css","javascript","webhook","daast","vast","display_tag","card","object","pixel_tracker","vast_tracker","daast_tracker"]}},"required":["asset_type"]},"then":{"not":{"anyOf":[{"required":["max_chars"]},{"required":["max_size_kb"]}]}}}]}},"required_connections":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1downstream-connection-requirement.json"},"description":"Downstream platform connections or grants required to use this format declaration. These are in addition to the single AdCP caller credential. Use this when a platform product requires multiple downstream grants, such as an advertiser account connection plus a publisher identity or post authorization for published-post references."},"reference_mutability":{"type":"string","enum":["immutable_snapshot","mutable_requires_reapproval","mutable_auto_recheck"],"description":"Policy for formats whose `slots` accept a `published_post` reference. `immutable_snapshot`: seller snapshots the referenced post at approval and later source changes do not change the served creative. `mutable_requires_reapproval`: the source post may change and material changes require review before continued serving. `mutable_auto_recheck`: the source post may change and the seller continuously or periodically rechecks authorization/policy without requiring buyer resubmission. Omit when the format has no `published_post` slot."},"production_window_business_days":{"type":"integer","minimum":0,"description":"Typical production turnaround in business days when the format requires seller-side production (e.g., host-recording from a buyer-supplied script). 0 for synchronous (e.g., generative AI); >0 for human-produced (e.g., podcast host-read). Absent when no production is required (buyer uploads complete creative)."}},"not":{"required":["macro_resolution_capabilities"]},"additionalProperties":true,"x-canonical-policy-required-params-not-enforced":"Canonical format schemas intentionally do NOT mark parameter fields as required and use additionalProperties: true. The canonical describes which parameters MAY narrow a declaration; it does not supply hidden technical defaults. When a technical parameter is omitted, its meaning comes only from the enclosing declaration's technical_requirements_complete assertion: true means no constraint at that layer, while false or absence means undeclared. Consumers MUST NOT infer an omitted technical constraint from canonical prose, examples, common practice, or implementation defaults. This is intentional: structural schema validation and product-level technical-contract completeness are separate checks.","x-adcp-file-size-units":"Creative file-size fields ending in `_kb` use exactly 1,000 bytes per KB. Fields ending in `_mb` use exactly 1,000,000 bytes per MB. Fields ending in `_bytes` are exact byte counts."},"external:enums/logo-slot.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/logo-slot.json","title":"Logo Slot","description":"Canonical renderer-facing logo slot. Use when selecting a logo variant from brand.json for a specific UI or creative placement.","type":"string","enum":["logo_card_light","logo_card_dark","profile_mark","favicon","app_icon","social_profile_mark","nav_header","footer","email_header","watermark","ad_end_card","co_brand_lockup","marketplace_listing"],"enumDescriptions":{"logo_card_light":"Logo rendered in a card or framed placement on a light background.","logo_card_dark":"Logo rendered in a card or framed placement on a dark background.","profile_mark":"Small square logo mark for profile-style UI. Distinct from brand.json's top-level animated or conversational avatar object.","favicon":"Browser favicon or similarly tiny tab/bookmark icon.","app_icon":"Application icon or launcher icon.","social_profile_mark":"Social profile logo mark or feed identity mark.","nav_header":"Primary navigation header logo.","footer":"Footer logo.","email_header":"Email header logo.","watermark":"Subtle watermark or bug.","ad_end_card":"Advertising end card, especially video or CTV.","co_brand_lockup":"Co-brand, partner, sponsor, or secondary-mark lockup.","marketplace_listing":"Marketplace, catalog, directory, or store listing logo."}},"external:core/downstream-connection-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/downstream-connection-requirement.json","title":"Downstream Connection Requirement","description":"A seller/platform-side connection or grant required by a product, format, or request. This is not the AdCP caller credential: the AdCP request is still authenticated once, and the seller uses these stored downstream connections to call a platform or service on the buyer's behalf. Use this shape for platforms that require more than one downstream grant, such as an advertiser account connection plus a publisher identity or post authorization for published-post references.","type":"object","properties":{"provider":{"type":"string","description":"Stable provider or platform namespace, preferably lowercase. Examples: `social.example`, `shortvideo.example`, or a seller-defined namespace. Omit only when the requirement is provider-agnostic, or when an `authorization_url` fully routes the human to the correct provider-specific connection flow."},"connection_type":{"type":"string","enum":["advertiser_account","publisher_identity","post_authorization"],"description":"Kind of downstream connection required. `advertiser_account` is the platform account used to buy/manage ads. `publisher_identity` is the creator, page, channel, organization, or profile that owns source posts. `post_authorization` is a post-scoped grant when the platform authorizes individual posts instead of, or in addition to, the owning identity."},"required_for":{"type":"array","items":{"type":"string","minLength":1,"examples":["list_creatives","sync_creatives","create_media_buy","get_media_buy_delivery","get_creative_delivery"]},"uniqueItems":true,"description":"Concrete AdCP protocol operation names that require this downstream connection. Sellers SHOULD include this in product declarations when the requirement is known ahead of time, and in AUTHORIZATION_REQUIRED details when it explains the failed operation. Prefer specific operation names such as `list_creatives`, `sync_creatives`, `create_media_buy`, `get_media_buy_delivery`, or `get_creative_delivery` over broad category labels such as `reporting`."},"scope":{"type":"string","enum":["account","identity","post","unknown"],"description":"Granularity of the downstream grant."},"status":{"type":"string","enum":["connected","missing","pending","expired","revoked","not_required","unknown"],"description":"Current seller-observed state for this downstream connection when known. Product declarations MAY omit status or use `unknown`; AUTHORIZATION_REQUIRED details SHOULD use `missing`, `expired`, or `revoked` for the connection that blocked the call."},"connection_id":{"type":"string","description":"Seller-defined identifier for an already-created downstream connection. Omit when no connection exists yet or when exposing it would leak platform/account state."},"resource_ref":{"type":"object","description":"Optional opaque provider-native resource hint, such as a platform account id, profile URL, handle, channel id, post id, or post URL. This is a hint for routing authorization, not proof that authorization exists.","properties":{"platform_account_id":{"type":"string","description":"Provider-native advertiser or business account id, when safe to disclose."},"identity_id":{"type":"string","description":"Provider-native creator, page, channel, organization, or profile id, when safe to disclose."},"handle":{"type":"string","description":"Provider-native public handle for the owning identity, when available."},"profile_url":{"type":"string","format":"uri","description":"Public URL for the owning identity, when available."},"post_id":{"type":"string","description":"Provider-native post id, when the grant is post-scoped or the failed request referenced a specific post."},"post_url":{"type":"string","format":"uri","description":"Public URL for the referenced post, when available."}},"additionalProperties":true},"authorization_url":{"type":"string","format":"uri","description":"Seller-hosted or provider-hosted URL where a human can complete or restore this downstream connection."},"authorization_instructions":{"type":"string","description":"Human-readable instructions for completing or restoring this downstream connection."},"expires_at":{"type":"string","format":"date-time","description":"Expiration time for the downstream grant, when known."}},"required":["connection_type"],"allOf":[{"if":{"properties":{"status":{"enum":["missing","pending","expired","revoked"]}},"required":["status"]},"then":{"anyOf":[{"required":["provider"]},{"required":["authorization_url"]}]}}],"additionalProperties":true,"examples":[{"provider":"social.example","connection_type":"advertiser_account","required_for":["sync_creatives","create_media_buy"],"scope":"account","status":"connected"},{"provider":"social.example","connection_type":"publisher_identity","required_for":["list_creatives","sync_creatives","create_media_buy"],"scope":"identity","status":"missing","resource_ref":{"handle":"@acme","profile_url":"https://social.example/@acme"},"authorization_instructions":"Connect the creator or page that owns the source post."}]},"external:enums/ctv-ad-experience.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/ctv-ad-experience.json","title":"CTV Ad Experience","description":"IAB Tech Lab CTV Ad Portfolio experience for a format option. `menu` covers smart-TV home/menu surfaces (tiles and headline banners, OpenRTB Native plcmttype 1/3); `pause`, `screensaver`, `overlay`, `squeezeback`, and `in_scene` are the on-glass experiences the portfolio signals via OpenRTB Video with VAST NonLinearAds (AdCOM plcmt 5-9). One format option declares at most one experience; sellers offering several publish sibling format options. Each canonical format permits only the experiences in its documented matrix — pairings outside the matrix fail validation. Linear CTV video is ordinary video_vast/video_hosted and declares no experience.","$comment":"Vocabulary and names follow the IAB CTV Ad Format Guidelines v2.0 and the final Signaling Implementation Guidelines. The IAB signaling table (Menu -> Native, others -> NonLinear VAST) is an OpenRTB bridge mapping documented in docs/creative/ctv-experiences.mdx; AdCP creative supply follows the per-canonical experience matrix, which also admits the asset-bundle and image contracts CTV sellers ingest in practice.","type":"string","enum":["menu","pause","screensaver","overlay","squeezeback","in_scene"]},"external:enums/motion-level.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/motion-level.json","title":"Creative Motion Level","description":"Motion class of a rendered creative, mirroring AdCOM creative attributes 21 (Static Visual), 22 (Limited Motion / Cinemagraph), and 23 (Full-Motion Video). Sellers constrain the accepted level on a format option; buyers declare the level their creative carries. OpenRTB bridges map the value to `attr` on the bid and `battr` on the request.","type":"string","enum":["static","limited_motion","full_motion"]},"external:enums/activation-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/activation-method.json","title":"Creative Activation Method","description":"Viewer activation mechanism a CTV or high-impact unit offers beyond a rendered impression: `qr_code` (on-glass QR to a buyer URL), `deep_link` (app or content deep link, including app-store detail pages), `push_notification` and `email` (send-to-device follow-ups with buyer-supplied copy), `tune_in` (jump to linear/virtual channel or content), `text_message` (SMS follow-up with buyer-supplied copy). Activations are engagement events, never additional impressions. Formats offering copy-bearing activations declare normative character-limited copy slots via `slots_override`: `push_notification` → `activation_message`; `text_message` → `activation_text_message`; `email` → `activation_email_subject` + `activation_email_body`. The activation URL rides `landing_page_url` unless a dedicated slot is declared.","type":"string","enum":["qr_code","deep_link","push_notification","email","tune_in","text_message"]},"external:formats/canonical/html5.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/html5.json","title":"Canonical Format: HTML5 Banner","description":"Interactive HTML5 banner delivered as a zip archive. Slot: `html5_bundle` (zip asset). Tracking model: MRAID + IAB Open Measurement (OM-SDK) + click-tag macro substitution + backup image fallback. Receivers unpack the zip, validate internal structure, and serve from CDN. Distinct from `image` (static, non-interactive) and `display_tag` (third-party served). The zip's entry point is typically `index.html`; click handling uses `clickTag` (or `clickTAG`) macro substitution.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"title":"Size-mode mutex","description":"Exactly one of: (a) fixed (`width` + `height` both set), (b) multi-size (`sizes` set), (c) responsive (any of `min_width`/`max_width`/`min_height`/`max_height` set), (d) none (no size constraint declared — accepts any dimensions). Combining modes is rejected at schema layer.","oneOf":[{"title":"fixed","required":["width","height"],"not":{"anyOf":[{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"multi-size","required":["sizes"],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"responsive","anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]}]}},{"title":"none","not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}}]}],"properties":{"slots":{"default":[{"asset_group_id":"html5_bundle","asset_type":"zip","required":true},{"asset_group_id":"backup_image","asset_type":"image","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for html5 canonical. Buyer ships a zip bundle plus optional backup image (required when `backup_image_required: true`) and clickthrough URL. The zip's entry point is typically `index.html`; click handling uses the `clickTag` (or `clickTAG`) macro substituted by the seller at serve time."},"width":{"type":"integer","minimum":1,"description":"Required banner width in pixels — use for fixed-size slots. For multi-size flexible slots use `sizes[]`; for responsive use `min_width`/`max_width`/`min_height`/`max_height`. Exactly one of `(width, height)`, `sizes[]`, or `min/max_width` + `min/max_height` ranges MUST be set."},"height":{"type":"integer","minimum":1,"description":"Required banner height in pixels. See `width` for size-mode mutual exclusion."},"sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"List of accepted (width, height) pairs for a multi-size flexible slot (publisher banner that accepts 300×250 OR 728×90 OR 970×250). Mirrors OpenRTB `banner.format[]`. Mutually exclusive with `(width, height)` and with responsive ranges."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted width for responsive HTML5 banners that adapt within a range. Pair with `max_width`. Mutually exclusive with `(width, height)` and `sizes[]`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted width for responsive HTML5 banners. Pair with `min_width`."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted height for responsive HTML5 banners. Pair with `max_height`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted height for responsive HTML5 banners. Pair with `min_height`."},"max_initial_load_kb":{"type":"integer","minimum":1,"description":"Maximum initial-load file size (zip + above-the-fold assets) in kilobytes. IAB display standards: 200 KB for fixed sizes, 100 KB for mobile."},"max_polite_load_kb":{"type":"integer","minimum":1,"description":"Maximum polite-load file size after host-initiated subload, in kilobytes. IAB display standards: 500 KB for fixed sizes."},"host_initiated_subload":{"type":"boolean","description":"Whether the host page must initiate the polite-load phase. IAB-compliant banners require true."},"max_animation_duration_ms":{"type":"integer","minimum":0,"description":"Maximum total animation duration in milliseconds. IAB standard: 30000 (30 seconds)."},"max_cpu_load_percent":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum CPU load percentage during render."},"mraid_required":{"type":"boolean","description":"Whether MRAID compatibility is required (mobile in-app)."},"mraid_version":{"type":"string","enum":["2.0","3.0"],"description":"Required MRAID version when mraid_required is true."},"om_sdk_required":{"type":"boolean","description":"Whether IAB Open Measurement SDK integration is required."},"clicktag_macro":{"type":"string","enum":["clickTag","clickTAG"],"description":"Name of the click-tag macro the bundle must use."},"backup_image_required":{"type":"boolean","description":"Whether a backup image must accompany the zip for non-HTML5 environments."},"backup_image_max_size_kb":{"type":"integer","minimum":1,"description":"Maximum backup image file size in kilobytes."},"ssl_required":{"type":"boolean"}},"additionalProperties":true},"external:formats/canonical/display_tag.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/display_tag.json","title":"Canonical Format: Display Tag","description":"Third-party-served display creative delivered as one of three explicit representations: a single ad-request URL, byte-preserved inline markup, or an atomic paired redirect (`ad_request_url` plus `clickthrough_url`). The backward-compatible default slot remains `tag_url` (`url_type: ad_request`). Format options accepting inline or paired delivery override `slots` with a `display_tag` asset and declare `supported_delivery_types`. Tracking is opaque to the seller except for declared macro resolution. Distinct from `image` and seller-hosted `html5` zip bundles.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"title":"Size-mode mutex","description":"Exactly one of: (a) fixed (`width` + `height` both set), (b) multi-size (`sizes` set), (c) responsive (any of `min_width`/`max_width`/`min_height`/`max_height` set), (d) none (no size constraint declared — accepts any dimensions). Combining modes is rejected at schema layer.","oneOf":[{"title":"fixed","required":["width","height"],"not":{"anyOf":[{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"multi-size","required":["sizes"],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},{"title":"responsive","anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}],"not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]}]}},{"title":"none","not":{"anyOf":[{"required":["width"]},{"required":["height"]},{"required":["sizes"]},{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}}]}],"properties":{"slots":{"default":[{"asset_group_id":"tag_url","asset_type":"url","required":true},{"asset_group_id":"backup_image","asset_type":"image","required":false}],"description":"Backward-compatible URL-delivery slots. `tag_url` MUST use `url_type: ad_request`. A format option accepting `inline_markup` or `paired_redirect` overrides this list with a required slot whose `asset_type` is `display_tag`; the display-tag asset keeps paired redirect URLs atomic."},"width":{"type":"integer","minimum":1,"description":"Required tag rendering width in pixels — use for fixed-size slots. For multi-size flexible slots use `sizes[]`; for responsive use `min_width`/`max_width`/`min_height`/`max_height`. Exactly one of `(width, height)`, `sizes[]`, or `min/max_width` + `min/max_height` ranges MUST be set."},"height":{"type":"integer","minimum":1,"description":"Required tag rendering height in pixels. See `width` for size-mode mutual exclusion."},"sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"List of accepted (width, height) pairs for a multi-size flexible slot. The buyer's third-party tag must render at one of the listed sizes; the seller picks which size to request at impression time. Mutually exclusive with `(width, height)` and with responsive ranges."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted width for responsive third-party tags. Pair with `max_width`. Mutually exclusive with `(width, height)` and `sizes[]`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted width for responsive third-party tags. Pair with `min_width`."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted height for responsive third-party tags. Pair with `max_height`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted height for responsive third-party tags. Pair with `min_height`."},"supported_tag_types":{"type":"array","deprecated":true,"items":{"type":"string","enum":["iframe","javascript","1x1_redirect"]},"description":"Deprecated ambiguous mechanism list. Use `supported_delivery_types`; markup subtype lives on the `display_tag` asset."},"supported_delivery_types":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["tag_url","inline_markup","paired_redirect"]},"description":"Closed set of delivery types this format option can traffic. `paired_redirect` means one atomic ad-request/click-through pair (Internal Redirect semantics), never independently matchable URL slots."},"ssl_required":{"type":"boolean","description":"Whether the tag URL must be HTTPS."},"max_redirect_depth":{"type":"integer","minimum":0,"description":"Maximum redirect chain depth permitted."},"max_response_time_ms":{"type":"integer","minimum":1,"description":"Maximum tag-server response time in milliseconds."},"backup_image_required":{"type":"boolean","description":"Whether a backup image must accompany the tag for environments that cannot render the third-party tag."},"backup_image_max_size_kb":{"type":"integer","minimum":1},"om_sdk_required":{"type":"boolean","description":"Whether the buyer's tag must integrate IAB Open Measurement SDK for viewability."}},"additionalProperties":true},"external:formats/canonical/image_carousel.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/image_carousel.json","title":"Canonical Format: Image Carousel","description":"Multi-card swipeable carousel. The buyer ships a `cards` slot whose value is an **array** of [card-asset](/schemas/core/assets/card-asset.json) objects (a single key with an array value — NOT one key per card, NOT dotted/bracketed paths). Each card-asset carries: `asset_type: \"card\"`, `media` (an image or video asset), optional `headline` (text), optional `landing_page_url` (url asset). Per-card structure is the same across all cards; mixed orientations not allowed within a single carousel. Tracking model: per-card impression and engagement pixels + carousel-level engagement (swipe, view-time). Allowed asset types for a card's `media` field: `image` and `video` (Meta-style mixed-media); platforms can narrow to image-only or video-only via `allowed_card_media_asset_types`.\n\nThe manifest's `assets.cards` value is an array of card-asset objects. Example: `\"cards\": [{\"asset_type\": \"card\", \"media\": {\"asset_type\": \"image\", \"url\": \"...\"}, \"headline\": \"Buy now\", \"landing_page_url\": {\"asset_type\": \"url\", \"url_type\": \"clickthrough\", \"url\": \"...\"}}, ...]`. Each card-asset validates against the card schema; per-card platform extensions attach via the card's `platform_extensions` field, never via inline non-canonical keys.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"v1_translatable":{"default":false,"description":"Inherently new in v2 — multi-card carousels (Meta carousel, Pinterest pin collections, Snap collection ads) weren't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural."},"slots":{"default":[{"asset_group_id":"cards","asset_type":"card","required":true,"min":2,"max":10},{"asset_group_id":"primary_text","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for image_carousel. The `cards` slot's value in the manifest is an array of [card-asset](/schemas/core/assets/card-asset.json) objects; `min` / `max` constrain card count."},"card_aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Aspect ratio shared across all cards (e.g., '1:1', '1.91:1', '4:5')."},"min_cards":{"type":"integer","minimum":2,"description":"Minimum card count (typical: 2 or 3)."},"max_cards":{"type":"integer","description":"Maximum card count (typical: 6, 10, or 35 depending on platform)."},"allowed_card_media_asset_types":{"type":"array","items":{"type":"string","enum":["image","video"]},"description":"Asset types each card's `media` field may carry. Default: ['image']. Polymorphic carousels (Meta) allow ['image', 'video']. Renamed from `allowed_card_asset_types` to disambiguate that this constrains the card's media payload, not the card-asset itself (which is always asset_type: \"card\")."},"allowed_card_asset_types":{"type":"array","deprecated":true,"items":{"type":"string","enum":["image","video"]},"description":"DEPRECATED — alias for `allowed_card_media_asset_types`. Kept for back-compat; prefer the new field name. Removed in 5.0."},"card_image_max_file_size_kb":{"type":"integer","minimum":1},"card_video_max_file_size_kb":{"type":"integer","minimum":1},"card_video_max_duration_ms":{"type":"integer","minimum":1},"primary_text_max_chars":{"type":"integer","minimum":1,"description":"Maximum length of the carousel-level primary text."},"card_headline_max_chars":{"type":"integer","minimum":1,"description":"Per-card headline character limit. Governs the `headline` field on each card-asset in the `cards` slot."},"card_description_max_chars":{"type":"integer","minimum":1,"description":"Per-card description character limit. Governs the `description` field on each card-asset in the `cards` slot. Distinct from `card_headline_max_chars`: description is longer body copy (typically 100-500 chars); headline is the short label (typically 25-40 chars)."},"ssl_required":{"type":"boolean"}},"additionalProperties":true},"external:formats/canonical/video_hosted.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/video_hosted.json","title":"Canonical Format: Hosted Video","description":"Direct video file (mp4/webm/mov) hosted by the buyer. Slot: `video_main` (video asset, file or hosted URL), optional `headline`, `brand_name`, `cta`, `companion_banner`, `landing_page_url`. Tracking model: IAB Open Measurement SDK + external impression/click/quartile pixels via universal_macros. Orientation is a parameter (vertical 9:16 / horizontal 16:9 / square 1:1); slot shape includes optional `brand_name` (typical for vertical short-form) and optional `companion_banner` (typical for horizontal instream). Distinct from `video_vast` (VAST tag, inherent VAST event tracking) — receivers fire impression and click pixels at delivery time.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"const":"screensaver"}}}}],"properties":{"slots":{"default":[{"asset_group_id":"video_main","asset_type":"video","required":true},{"asset_group_id":"headline","asset_type":"text","required":false},{"asset_group_id":"primary_text","asset_type":"text","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"brand_name","asset_type":"text","required":false},{"asset_group_id":"companion_banner","asset_type":"image","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for video_hosted canonical. Buyer ships a video asset (file or hosted URL); optional headline, primary text (long-form caption), CTA (typically constrained via `cta_values`), brand_name (typical for vertical short-form), companion_banner (typical for horizontal instream), and clickthrough URL. Products MAY override or extend the default — e.g., remove `companion_banner` for short-form vertical, narrow `cta` to a value enum, mark `landing_page_url` as required."},"orientation":{"type":"string","enum":["vertical","horizontal","square"],"description":"Video orientation. Vertical = 9:16 (Reels, Stories, Shorts). Horizontal = 16:9 (instream, CTV). Square = 1:1 (in-feed)."},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Aspect ratio. Inferred from orientation if omitted."},"min_width":{"type":"integer","minimum":1},"min_height":{"type":"integer","minimum":1},"max_width":{"type":"integer","minimum":1},"max_height":{"type":"integer","minimum":1},"duration_ms_range":{"type":"array","items":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"minItems":2,"maxItems":2,"contains":{"type":"integer","minimum":0},"description":"[min, max] duration in milliseconds. Either endpoint MAY be null to express an unbounded side: [null, 60000] means up to 60s; [15000, null] means at least 15s. [null, null] is invalid because at least one endpoint must be bounded. **Precedence**: when both `duration_ms_exact` and `duration_ms_range` ship on the same product, `duration_ms_exact` takes precedence — buyers MUST validate against the exact value and ignore the range. SDKs SHOULD lint a warning when both fields ship; producers SHOULD pick one."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship (see `duration_ms_range` description)."},"video_codecs":{"type":"array","items":{"type":"string","enum":["h264","h265","vp8","vp9","av1","prores"]}},"audio_codecs":{"type":"array","items":{"type":"string","enum":["aac","mp3","opus","pcm"]}},"containers":{"type":"array","items":{"type":"string","enum":["mp4","webm","mov"]}},"min_bitrate_kbps":{"type":"integer","minimum":1},"max_bitrate_kbps":{"type":"integer","minimum":1},"max_file_size_mb":{"type":"integer","minimum":1,"description":"Maximum file size, where 1 MB is exactly 1,000,000 bytes."},"frame_rates":{"type":"array","items":{"type":"number"}},"captions":{"type":"string","enum":["required","recommended","not_required"]},"om_sdk_required":{"type":"boolean"},"headline_max_chars":{"type":"integer","minimum":1},"primary_text_max_chars":{"type":"integer","minimum":1},"brand_name_max_chars":{"type":"integer","minimum":1},"cta_values":{"type":"array","items":{"type":"string"}},"companion_banner_widths":{"type":"array","items":{"type":"integer","minimum":1},"description":"Permitted companion banner widths (instream video)."},"companion_banner_heights":{"type":"array","items":{"type":"integer","minimum":1}},"asset_source":{"type":"string","enum":["buyer_uploaded","publisher_host_recorded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered asset bytes come from. Single shared enum across canonicals. See `image.json#asset_source` for the full semantics. `publisher_host_recorded` is audio-specific and has no defined behavior on video. `publisher_owned_reference` is valid when the product accepts an existing post reference via a `published_post` slot instead of uploaded video bytes. Adopters MUST select a value appropriate to the canonical."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded video. When `rejected`, the buyer cannot ship a video asset directly — they must use build_creative, sync_creatives with brief inputs, or sync_creatives with an accepted reference asset so the seller produces or resolves the video."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On `video_hosted` only `screensaver` is valid (ambient looping video the platform plays on idle). Other experiences route per the matrix in docs/creative/ctv-experiences.mdx; linear CTV video declares no experience."}},"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on video_hosted must be screensaver"},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true},"external:formats/canonical/video_vast.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/video_vast.json","title":"Canonical Format: VAST Video","description":"VAST-tag-delivered video creative. Slot: `vast_tag` (vast asset, URL or inline XML, VAST 2.x-4.x). Tracking model: VAST events inherent to the spec — `impression`, `firstQuartile`, `midpoint`, `thirdQuartile`, `complete`, `start`, `pause`, `resume`, `mute`, `unmute`, `expand`, `collapse`, `fullscreen`, `creativeView`, `clickTracking`, `error`. VPAID interactivity via `vpaid_enabled: true` flag. SIMID is carried by the first-class VAST 4.1+ `<InteractiveCreativeFile apiFramework=\"SIMID\">` element on Linear creatives. Orientation is a parameter (vertical / horizontal / square). Distinct from `video_hosted` (direct file with external tracking).","properties":{"slots":{"default":[{"asset_group_id":"vast_tag","asset_type":"vast","required":true},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for video_vast canonical. Buyer ships a VAST tag (URL or inline XML, VAST 2.x-4.x) plus an optional clickthrough URL (which falls back to the VAST `ClickThrough` element when omitted). Tracking events are inherent to VAST and don't require explicit slots."},"orientation":{"type":"string","enum":["vertical","horizontal","square"]},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$"},"vast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json"},"minItems":1,"uniqueItems":true,"description":"VAST versions accepted by this product format option. The asset still declares exactly one `vast_version`; compatibility requires membership in this set and the seller-wide execution set."},"vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json","deprecated":true,"description":"Deprecated one-element alias for `vast_versions`. Producers use either the singular legacy alias or the plural 3.2 field, never both."},"media_file_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-media-file-requirements.json","description":"Technical acceptance constraints for alternative VAST MediaFile renditions. Each applicable resolved InLine linear creative needs at least one MediaFile satisfying all declared constraints."},"vpaid_enabled":{"type":"boolean","description":"Whether VPAID interactivity is supported. When true, the VAST tag may carry VPAID JS/Flash payloads."},"vpaid_version":{"type":"string","enum":["1.0","2.0"]},"simid_supported":{"type":"boolean","description":"Whether the seller accepts IAB SIMID through `<InteractiveCreativeFile apiFramework=\"SIMID\">` on a Linear VAST creative. SIMID is not a generic VAST extension and cannot be serialized under NonLinearAds; every `ctv_ad_experience` profile therefore forbids `true`."},"duration_ms_range":{"type":"array","items":{"type":"integer","minimum":0},"minItems":2,"maxItems":2,"description":"[min, max] duration in milliseconds. **Precedence**: `duration_ms_exact` takes precedence when both ship. SDKs SHOULD lint a warning when both fields ship."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship."},"min_width":{"type":"integer","minimum":1,"description":"Minimum placement/player width in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"max_width":{"type":"integer","minimum":1,"description":"Maximum placement/player width in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"min_height":{"type":"integer","minimum":1,"description":"Minimum placement/player height in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"max_height":{"type":"integer","minimum":1,"description":"Maximum placement/player height in pixels. MediaFile rendition dimensions are declared in `media_file_requirements`."},"creative_type":{"type":"string","enum":["linear","nonlinear","either"],"description":"Required VAST creative class: `linear` (in-stream Linear), `nonlinear` (NonLinearAds overlay-class), or `either`. Supersedes `linear_required`; when both are present `creative_type` wins, and validators treat `linear_required: true` with no `creative_type` as `linear`."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option is eligible to serve. On video_vast only `pause`, `screensaver`, `overlay`, `squeezeback`, and `in_scene` are valid (`menu` routes to native_in_feed or sponsored_placement), and `creative_type` MUST be `nonlinear`. Because VAST places `<InteractiveCreativeFile>` only under Linear `<MediaFiles>`, `simid_supported` MUST NOT be true on any of these NonLinear profiles. Per-experience floors: `overlay` and `squeezeback` require a 10s minimum duration; `in_scene` requires a 3s minimum brand-exposure duration and forbids interactivity (`vpaid_enabled` MUST NOT be true); `pause` has no duration floor and ends on viewer or device action."},"motion_level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1motion-level.json","description":"Accepted motion class for the rendered creative (AdCOM attrs 21-23)."},"activation_methods":{"type":"array","uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1activation-method.json"},"description":"Viewer activation mechanisms this option offers. Activations are engagement events, not impressions."},"linear_required":{"type":"boolean","description":"Whether the VAST creative must be linear (non-skippable in-stream). Superseded by `creative_type`; retained for pre-3.2 declarations."},"skippable_after_ms":{"type":"integer","minimum":0,"description":"When skippable, the buyer-side skip threshold in milliseconds (e.g., 5000 for 5-second skippable pre-roll)."},"max_wrapper_depth":{"type":"integer","minimum":0,"description":"Maximum VAST wrapper redirect depth permitted."},"ssl_required":{"type":"boolean"}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"not":{"const":"menu"}},"creative_type":{"const":"nonlinear"},"simid_supported":{"const":false}},"required":["creative_type"]}},{"if":{"properties":{"ctv_ad_experience":{"const":"in_scene"}},"required":["ctv_ad_experience"]},"then":{"properties":{"vpaid_enabled":{"const":false}}}}],"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on video_vast must be one of pause, screensaver, overlay, squeezeback, in_scene, with creative_type nonlinear","ctv_nonlinear_no_simid":"Every video_vast CTV experience is nonlinear and forbids simid_supported true because VAST serializes InteractiveCreativeFile only under Linear MediaFiles","ctv_duration_floors":"overlay and squeezeback require duration_ms_exact or duration_ms_range minimum of at least 10000; in_scene at least 3000; pause has no floor","ctv_in_scene_no_interactivity":"in_scene additionally forbids vpaid_enabled","ctv_activation_copy_slots":"push_notification activation_methods SHOULD declare an activation_message slot; text_message SHOULD declare an activation_text_message slot; email SHOULD declare activation_email_subject and activation_email_body slots. Missing copy slots emit a non-blocking validate_input warnings[] entry.","creative_type_precedence":"creative_type wins over linear_required when both are declared; linear_required true with creative_type nonlinear or either is a contradiction and is rejected"},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true,"not":{"required":["vast_version","vast_versions"]}},"external:core/vast-media-file-requirements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/vast-media-file-requirements.json","title":"VAST MediaFile Requirements","description":"Technical acceptance requirements for the alternative video or audio `<MediaFile>` renditions in a resolved VAST `<InLine>` linear creative. A linear creative satisfies this object when at least one of its MediaFile elements satisfies every declared field; incompatible sibling renditions do not reject the creative. Omitted fields are governed by the enclosing format declaration's `technical_requirements_complete` assertion and MUST NOT be inferred from prose or implementation defaults. When a declared constraint cannot be proven from VAST metadata or safe inspection of the referenced media bytes, compatibility is undeclared rather than assumed. Container identity MUST come from authoritative metadata or byte inspection, never only a URI filename extension. Audio VAST declarations use audio MIME types and do not set the dimension constraints below because VAST audio MediaFiles carry width and height values of 0.","type":"object","properties":{"delivery_methods":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-media-delivery-method.json"},"minItems":1,"uniqueItems":true,"description":"Accepted values of the required `MediaFile@delivery` attribute. `progressive` identifies a directly downloadable media file; `streaming` identifies a streaming media resource."},"mime_types":{"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]*/[A-Za-z0-9][A-Za-z0-9!#$&^_.+-]*$"},"minItems":1,"uniqueItems":true,"description":"Accepted MIME types from `MediaFile@type`, compared case-insensitively after trimming optional whitespace. Parameters are not accepted in this field. Examples: `video/mp4`, `video/webm`, `audio/mpeg`, `audio/aac`."},"containers":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9][a-z0-9._+-]*$"},"minItems":1,"uniqueItems":true,"description":"Accepted normalized container identifiers, such as `mp4`, `webm`, or `mpeg_ts`. A receiver MUST determine the container from authoritative metadata or safe byte inspection and MUST NOT guess it only from the media URI suffix."},"codecs":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true,"description":"Accepted codec identifiers for `MediaFile@codec`, using the codec syntax referenced by the applicable VAST version. A missing codec attribute does not satisfy a declared codec constraint unless safe inspection establishes the codec."},"min_width":{"type":"integer","minimum":1,"description":"Minimum accepted `MediaFile@width` in pixels."},"max_width":{"type":"integer","minimum":1,"description":"Maximum accepted `MediaFile@width` in pixels."},"min_height":{"type":"integer","minimum":1,"description":"Minimum accepted `MediaFile@height` in pixels."},"max_height":{"type":"integer","minimum":1,"description":"Maximum accepted `MediaFile@height` in pixels."},"min_bitrate_kbps":{"type":"integer","minimum":1,"description":"Minimum accepted MediaFile bitrate in kilobits per second. A fixed `MediaFile@bitrate` must be at least this value. For adaptive/streaming media, the declared `MediaFile@minBitrate` must be at least this value. Safe byte inspection may establish the value when metadata is absent."},"max_bitrate_kbps":{"type":"integer","minimum":1,"description":"Maximum accepted MediaFile bitrate in kilobits per second. A fixed `MediaFile@bitrate` must not exceed this value. For adaptive/streaming media, the declared `MediaFile@maxBitrate` must not exceed this value. Safe byte inspection may establish the value when metadata is absent."},"max_file_size_bytes":{"type":"integer","minimum":1,"description":"Maximum accepted MediaFile size in exact bytes. `MediaFile@fileSize`, when present, is expressed in bytes; a receiver MAY verify it against safely fetched media bytes and MUST use the verified byte count if the values disagree."}},"x-adcp-validation":{"verifier_constraints":{"range_order":"When both bounds are declared, min_width MUST be <= max_width, min_height MUST be <= max_height, and min_bitrate_kbps MUST be <= max_bitrate_kbps.","adaptive_bitrate_containment":"A MediaFile advertising a minBitrate/maxBitrate interval satisfies declared bitrate bounds only when its entire interval is contained within those bounds; overlap alone is insufficient.","alternative_renditions":"For each applicable resolved InLine linear creative, at least one MediaFile MUST satisfy every declared property in this object; requirements MUST NOT be satisfied by combining properties from different MediaFile elements.","missing_metadata":"If a declared property cannot be established from VAST metadata or safe inspection, compatibility is unproven and the MediaFile does not satisfy that property."}},"additionalProperties":true},"external:enums/vast-media-delivery-method.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/vast-media-delivery-method.json","title":"VAST Media Delivery Method","description":"Delivery method declared by the required VAST MediaFile `delivery` attribute.","type":"string","enum":["progressive","streaming"]},"external:formats/canonical/audio_hosted.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/audio_hosted.json","title":"Canonical Format: Hosted Audio","description":"Direct audio creative — buyer ships an `audio` asset (mp3/aac/wav) for asset-driven products, or ships a `script` / `creative_brief` text asset for products where the seller produces audio internally (podcast host-reads, TTS synthesis). Optional companion slots: `companion_image`, `brand_name`, `landing_page_url`. Tracking model: standard impression + completion + companion-image-click pixels via universal_macros. Distinct from `audio_daast` (DAAST tag, inherent DAAST event tracking). For host-reads and synthesized audio, the format declares `asset_source: 'publisher_host_recorded'` or `'agent_synthesized'` plus `buyer_asset_acceptance: 'rejected'`; the format's `slots` declaration enumerates which assets the buyer ships (e.g., `script` text asset for host-reads). The seller decides how to consume each asset (render verbatim vs produce audio from text) — there is no separate manifest 'inputs' map; everything the buyer ships goes in `assets`.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"slots":{"default":[{"asset_group_id":"audio_main","asset_type":"audio","required":true},{"asset_group_id":"companion_image","asset_type":"image","required":false},{"asset_group_id":"brand_name","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for buyer-uploaded audio. Host-read products override with a `script` (asset_type: text) or `creative_brief` (asset_type: brief) slot in place of `audio_main`, plus `asset_source: 'publisher_host_recorded'` and `buyer_asset_acceptance: 'rejected'`. TTS-from-script products override similarly with `asset_source: 'seller_pre_rendered_from_brief'`."},"duration_ms_range":{"type":"array","items":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"minItems":2,"maxItems":2,"contains":{"type":"integer","minimum":0},"description":"[min, max] duration in milliseconds. Either endpoint MAY be null to express an unbounded side: [null, 60000] means up to 60s; [15000, null] means at least 15s. [null, null] is invalid because at least one endpoint must be bounded. **Precedence**: when both `duration_ms_exact` and `duration_ms_range` ship on the same product, `duration_ms_exact` takes precedence — buyers MUST validate against the exact value and ignore the range. SDKs SHOULD lint a warning when both fields ship; producers SHOULD pick one."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship."},"audio_codecs":{"type":"array","items":{"type":"string","enum":["mp3","aac","wav","opus","flac"]}},"audio_sample_rates":{"type":"array","items":{"type":"integer","minimum":1}},"audio_channels":{"type":"array","items":{"type":"string","enum":["mono","stereo"]}},"min_bitrate_kbps":{"type":"integer","minimum":1},"max_bitrate_kbps":{"type":"integer","minimum":1},"max_file_size_mb":{"type":"number","exclusiveMinimum":0,"description":"Maximum hosted audio file size in decimal megabytes. Agents that proxy or cache media SHOULD advertise their effective transport ceiling here."},"loudness_lufs":{"type":"number","description":"Required integrated loudness in LUFS (typical: -16 for streaming/podcast, -23 for broadcast). Negative values."},"loudness_tolerance_db":{"type":"number","minimum":0,"description":"Permitted deviation from loudness_lufs in dB."},"true_peak_dbfs":{"type":"number","description":"Maximum true-peak level in dBFS (typical: -2)."},"asset_source":{"type":"string","enum":["buyer_uploaded","publisher_host_recorded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered audio bytes come from. Single shared enum across canonicals (see `image.json#asset_source` for the full semantics). `publisher_host_recorded`: the publisher's host records the audio (podcast host-read pattern); buyer must use the publisher's build_creative capability. `publisher_owned_reference` is valid only when the product accepts a reference asset whose publisher-owned source resolves to playable audio. `publisher_host_recorded` remains the normal audio-specific host-read value."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded audio. When `rejected`, the buyer cannot ship an audio asset directly — they must use build_creative (or sync_creatives with brief inputs) so the seller produces the audio. Combined with `asset_source`, lets a product declare 'I produce audio from briefs and refuse buyer uploads' (asset_source=`seller_pre_rendered_from_brief`, buyer_asset_acceptance=`rejected`)."},"companion_image_required":{"type":"boolean"},"companion_image_aspect_ratio":{"type":"string"},"companion_image_max_file_size_kb":{"type":"integer","minimum":1},"brand_name_max_chars":{"type":"integer","minimum":1}},"additionalProperties":true},"external:formats/canonical/audio_vast.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/audio_vast.json","title":"Canonical Format: VAST Audio","description":"VAST-tag-delivered audio creative. Standardized VAST audio support begins at 4.1; a seller may explicitly advertise older VAST versions only for legacy audio interoperability. Slot: `vast_tag` (vast asset, URL or inline XML). Tracking is inherent to VAST, including impression, start, quartiles, complete, click, error, pause/resume, and mute/unmute events. Distinct from `audio_hosted` (direct audio bytes) and `audio_daast` (legacy DAAST tag delivery).","properties":{"slots":{"default":[{"asset_group_id":"vast_tag","asset_type":"vast","required":true},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for the audio_vast canonical. The buyer supplies a VAST tag (URL or inline XML) plus an optional clickthrough URL, which falls back to the VAST ClickThrough when omitted. Tracking events and companion creatives carried by the VAST document do not require separate slots."},"vast_versions":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json"},"minItems":1,"uniqueItems":true,"description":"VAST audio versions accepted by this product format option. Standardized audio support begins at VAST 4.1; listing 2.0, 3.0, or 4.0 explicitly declares seller-supported legacy audio interoperability rather than standards-conformant VAST audio. The asset declares exactly one vast_version; compatibility requires membership in this set and the seller-wide execution set."},"vast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1vast-version.json","deprecated":true,"description":"Deprecated one-element alias for vast_versions. Producers use either the singular legacy alias or the plural 3.2 field, never both. VAST 4.1+ is the standards-conformant audio profile; older values declare legacy audio interoperability."},"media_file_requirements":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1vast-media-file-requirements.json","description":"Technical acceptance constraints for alternative audio MediaFile renditions in each resolved InLine linear creative. Declared MIME types must be audio/*; visual-dimension constraints are invalid because VAST represents audio MediaFiles with width and height 0."},"duration_ms_range":{"type":"array","items":{"type":"integer","minimum":0},"minItems":2,"maxItems":2,"description":"[min, max] duration in milliseconds. duration_ms_exact takes precedence when both fields are present; SDKs SHOULD warn when both are supplied."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, the resolved audio creative duration must equal this value. Takes precedence over duration_ms_range."},"skippable_after_ms":{"type":"integer","minimum":0,"description":"When skippable, the buyer-side skip threshold in milliseconds."},"max_wrapper_depth":{"type":"integer","minimum":0,"description":"Maximum VAST wrapper redirect depth permitted."},"ssl_required":{"type":"boolean"},"companion_image_required":{"type":"boolean","description":"Whether the resolved VAST audio ad must include a companion creative."}},"allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"x-adcp-validation":{"verifier_constraints":{"audio_profile":"The resolved InLine creative MUST be Linear and supply a playable audio MediaFile; VAST 4.1+ documents MUST declare Ad adType audio. Video and hybrid ads do not satisfy audio_vast.","audio_media_files":"Every playable MediaFile used to satisfy the declaration MUST have an audio/* MIME type and the VAST-required width and height values of 0.","audio_version_compatibility":"VAST 4.1+ is the standards-conformant audio profile. A seller accepts 2.0, 3.0, or 4.0 only by listing that version explicitly as legacy audio interoperability."},"spec":"docs/creative/channels/audio.mdx"},"additionalProperties":true,"not":{"anyOf":[{"required":["vast_version","vast_versions"]},{"properties":{"media_file_requirements":{"properties":{"mime_types":{"contains":{"not":{"pattern":"^[Aa][Uu][Dd][Ii][Oo]/"}}}},"required":["mime_types"]}},"required":["media_file_requirements"]},{"properties":{"media_file_requirements":{"anyOf":[{"required":["min_width"]},{"required":["max_width"]},{"required":["min_height"]},{"required":["max_height"]}]}},"required":["media_file_requirements"]}]}},"external:formats/canonical/audio_daast.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/audio_daast.json","title":"Canonical Format: DAAST Audio","description":"DAAST-tag-delivered audio creative (audio analog of VAST). Slot: `daast_tag` (daast asset, URL or inline XML). Tracking model: DAAST events inherent to the spec — `impression`, `firstQuartile`, `midpoint`, `thirdQuartile`, `complete`, `start`, `pause`, `resume`, `mute`, `unmute`, `clickTracking`, `error`. Distinct from `audio_hosted` (direct file with external tracking).","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"slots":{"default":[{"asset_group_id":"daast_tag","asset_type":"daast","required":true},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"Default slots for audio_daast canonical. Buyer ships a DAAST tag (URL or inline XML, 1.0 or 1.1) plus an optional clickthrough URL. Tracking events are inherent to DAAST and don't require explicit slots."},"daast_version":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1daast-version.json","deprecated":true,"description":"Deprecated one-element alias for `daast_versions`. Producers use either the singular legacy alias or the plural 3.2 field, never both."},"daast_versions":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1daast-tracker-constraints.json/$defs/daast_versions","description":"Accepted DAAST versions for this format option. A tracker execution selector's daast_versions must be a nonempty subset of this set."},"duration_ms_range":{"type":"array","items":{"type":"integer","minimum":0},"minItems":2,"maxItems":2,"description":"[min, max] duration in milliseconds. **Precedence**: `duration_ms_exact` takes precedence when both ship. SDKs SHOULD lint a warning when both fields ship."},"duration_ms_exact":{"type":"integer","minimum":1,"description":"When set, duration must equal exactly this value. Takes precedence over `duration_ms_range` when both ship."},"linear_required":{"type":"boolean"},"max_wrapper_depth":{"type":"integer","minimum":0},"ssl_required":{"type":"boolean"},"companion_image_required":{"type":"boolean"}},"not":{"required":["daast_version","daast_versions"]},"additionalProperties":true},"external:formats/canonical/sponsored_placement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/sponsored_placement.json","title":"Canonical Format: Sponsored Placement (retail-media catalog-driven)","description":"Catalog-driven retail-media format. Slot: `source_catalog` (catalog asset — product/SKU/ASIN/GTIN catalog reference, REQUIRED), optional `hero_asset`, optional `landing_page_url`. Buyer supplies the catalog reference; surface composes per-item or multi-item rendering using its native placement template. **Composition is deterministic** — buyer can predict per-slot rendering from the catalog item structure. Tracking model: per-item impression + click + conversion (catalog-keyed via offering_id/sku/gtin macros). Covers Amazon Sponsored Products, Criteo Sponsored Products, CitrusAd Sponsored Products, Walmart Connect Sponsored Products, Pinterest Collection (catalog-driven mode).\n\n**Scope (normative — buyer-agent routing).** This canonical is the home for catalog-driven retail-media placements ONLY. The defining feature is the `source_catalog` slot — products under this canonical compose their creative *per catalog item* using the buyer-supplied catalog feed. Without a catalog feed there is nothing to render against. Buyer agents reading `format_kind: sponsored_placement` MUST attach a catalog reference; sellers MUST require `source_catalog` in the manifest.\n\n**Not this canonical (route elsewhere):**\n- IAB in-feed native ads, content-recommendation widgets (Taboola, Outbrain, Yahoo Native, AdMob Native, in-feed sponsored cards) — use `native_in_feed` (asset-bundle composition; no catalog).\n- Algorithmic surface that picks from a buyer-supplied asset pool (Google PMax, Meta Advantage+) — use `responsive_creative`.\n- Single-image or single-video creative — use `image` or `video_hosted`.\n\nThe earlier broader framing ('any sponsored placement') was too loose for buyer-agent routing — a buyer reading `sponsored_placement` couldn't disambiguate a catalog-driven Amazon SP from an in-feed Taboola widget. As of 3.1, the canonical is narrowed to catalog-keyed retail-media; native moves to `native_in_feed`. Distinct from `responsive_creative` (algorithmic combinator from buyer pool) and `agent_placement` (text/audio AI-surface composition).","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"enum":["menu","squeezeback","in_scene"]}}}}],"properties":{"experimental":{"default":true,"description":"Marked experimental at 3.1 GA: the canonical covers 4 meaningfully different retail-media adapter contracts (Amazon SP, Criteo SP / CitrusAd SP, Pinterest Collection, generative-per-SKU). Adopter contracts vary; buyers MUST validate per-adapter behavior before routing budget. Promotion to non-experimental gated on the #4592 adapter-contract docs work."},"v1_translatable":{"default":false,"description":"Inherently new in v2 — retail-media catalog placements weren't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural, not a registry-coverage gap."},"slots":{"default":[{"asset_group_id":"source_catalog","required":true,"asset_type":"catalog"},{"asset_group_id":"hero_asset","required":false,"asset_type":"image"},{"asset_group_id":"landing_page_url","required":false,"asset_type":"url"}]},"supported_catalog_types":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1catalog-type.json"},"description":"Catalog types this product accepts."},"min_items":{"type":"integer","minimum":1,"description":"Minimum catalog item count buyer must supply."},"max_items":{"type":"integer","description":"Maximum items considered for placement."},"fanout_mode":{"type":"string","enum":["per_item","multi_item_in_creative","single_item"],"description":"How items map to delivery: per_item = one ad per catalog item; multi_item_in_creative = composed multi-item ad (Pinterest Collection, Snap Collection); single_item = one ad showing one item."},"required_catalog_fields":{"type":"array","items":{"type":"string"},"description":"Catalog item fields the seller requires (e.g., ['title', 'image_url', 'price'])."},"supported_id_types":{"type":"array","items":{"type":"string","enum":["asin","sku","gtin","offering_id","store_id","hotel_id","flight_id","vehicle_id","listing_id","program_id","destination_id","app_id","job_id"]},"description":"Catalog identifier types the placement renders against."},"hero_asset_supported":{"type":"boolean","description":"Whether the buyer can supply a hero/banner asset alongside the catalog (Pinterest Collection pattern)."},"item_production_model":{"type":"string","enum":["buyer_uploaded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized"],"default":"buyer_uploaded","description":"How each per-item creative is produced. Covers the same production-source axis as `asset_source` on `image` / `video_hosted` / `audio_hosted` but with a 4-value subset — drops `publisher_host_recorded` because it's audio-specific and doesn't apply to retail-media catalog placements. SDK codegen MAY share a base enum and narrow per-canonical, or emit two distinct enums; either way the wire values overlap exactly for the 4 retained values. `buyer_uploaded` (default, current Amazon/Criteo/CitrusAd pattern): the buyer's catalog already contains rendered assets per item; the seller composes the placement using those assets. (\"Uploaded\" reads slightly off for catalog-keyed items where the buyer didn't actively upload bytes — the catalog ingestion already supplied them — but the semantic is the same: rendered bytes are buyer-supplied, not seller-produced.) `seller_pre_rendered_from_brief`: the buyer ships a brief plus the catalog reference; the seller renders one creative per catalog item from the brief at sync_creatives time. `seller_human_designed`: seller's design team produces per-item renders manually. `agent_synthesized`: AI synthesis pipeline produces per-item renders; pair with `synthesis_nondeterministic: true` for Veo/Sora-class generative video applied per item. Captures the multi-output generative pattern (1 brief × N catalog items → N rendered creatives) under the existing canonical without requiring a separate canonical. Distinct from `fanout_mode`, which describes how items map to delivery slots after rendering."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On `sponsored_placement`: `menu` (sponsored app/content tiles and rows whose assets derive from a catalog listing — Fire-TV-tile pattern), `squeezeback`, and `in_scene` (seller-composited brand integrations produced from the catalog/brief rather than a buyer wire creative). Asset-bundle menu heroes route to `native_in_feed`."}},"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on sponsored_placement must be menu, squeezeback, or in_scene"},"spec":"docs/creative/ctv-experiences.mdx"},"additionalProperties":true},"external:formats/canonical/native_in_feed.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/native_in_feed.json","title":"Canonical Format: Native In-Feed","description":"IAB-shaped native creative for in-feed and content-recommendation surfaces. Default slots cover the primary IAB OpenRTB Native 1.2 asset types — `title` (Title Asset), `body_text` (Data Asset type 2), `main_image` (Image Asset main), `icon` (Image Asset icon), `cta` (Data Asset type 12), `advertiser_name` (Data Asset type 1), `sponsored_label` (Title-adjacent), `landing_page_url` (Link Asset), `display_url` (Data Asset type 11 — visible URL/domain, distinct from clickthrough), `rating` (Data Asset type 3 — app/product rating), `price` (Data Asset type 6 — product price), plus renderer-fired `impression_tracker` / `viewability_tracker` / `click_tracker` (`pixel_tracker`). Products MAY use `slots_override` to add other IAB Native data asset types (likes — type 4, downloads — type 5, saleprice — type 7, phone_number — type 8, address — type 9, desc2 — type 10, etc.) or to remove slots the surface doesn't render. The publisher's renderer assembles these into its own look-and-feel — feed card, content-recommendation slot, in-stream native unit. Buyer ships a single asset bundle; the surface chooses presentation.\n\n**Scope (normative — buyer-agent routing).** This canonical is the home for:\n- IAB OpenRTB Native 1.2 in-feed native ads (publisher feeds, app feeds)\n- Content-recommendation widgets (Taboola, Outbrain, Yahoo Recommendations)\n- AdMob Native / Yahoo Native publisher slots\n- In-feed sponsored placements without catalog dependency\n\n**Not this canonical:**\n- Catalog-driven retail-media (Amazon SP, Criteo SP, CitrusAd SP) — use `sponsored_placement` (requires `source_catalog`).\n- Algorithmic surface that picks from a buyer-supplied asset pool (Google PMax, Meta Advantage+) — use `responsive_creative`.\n- Multi-card carousel — use `image_carousel`.\n- Video-first native units where the asset is a hosted video file — use `video_hosted` with `applies_to_channels: [\"native\"]`. (Distinct from the CTV menu profile: a menu hero remains this canonical because the platform assembles the full asset bundle and the video rides the Native 1.2 `vasttag` video asset, playing on focus rather than being the unit itself.)\n\nDistinct from `sponsored_placement` along the catalog axis: native_in_feed is asset-bundle composition; sponsored_placement is catalog-row composition. A buyer agent reading `format_kind: native_in_feed` knows to assemble title + image + body + CTA; reading `format_kind: sponsored_placement` knows to attach a catalog feed.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"},{"if":{"required":["ctv_ad_experience"]},"then":{"properties":{"ctv_ad_experience":{"enum":["menu","overlay"]}}}},{"if":{"anyOf":[{"required":["menu_placement"]},{"required":["focus_behavior"]}]},"then":{"properties":{"ctv_ad_experience":{"const":"menu"}},"required":["ctv_ad_experience"]}}],"x-adcp-validation":{"verifier_constraints":{"ctv_experience_matrix":"ctv_ad_experience on native_in_feed must be menu or overlay","menu_profile_fields":"menu_placement and focus_behavior require ctv_ad_experience menu","focus_video_pairing":"focus_behavior autoplay_muted or autoplay_sound requires the effective slots to include the video asset group","ctv_activation_copy_slots":"push_notification activation_methods SHOULD declare an activation_message slot; text_message SHOULD declare an activation_text_message slot; email SHOULD declare activation_email_subject and activation_email_body slots. Missing copy slots emit a non-blocking validate_input warnings[] entry."},"spec":"docs/creative/ctv-experiences.mdx"},"properties":{"experimental":{"default":false,"description":"Stable at 3.1 GA. Shape mirrors IAB OpenRTB Native 1.2 — the renderer contract is well-established across in-feed native and content-recommendation adopters."},"v1_translatable":{"default":true,"description":"Translates to v1 named native formats (e.g., `native_standard`, `native_content`) via the projection registry. Sellers with existing v1 named native formats SHOULD point `v1_format_ref[]` at them."},"slots":{"default":[{"asset_group_id":"title","asset_type":"text","required":true},{"asset_group_id":"body_text","asset_type":"text","required":false},{"asset_group_id":"main_image","asset_type":"image","required":false},{"asset_group_id":"icon","asset_type":"image","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"advertiser_name","asset_type":"text","required":true},{"asset_group_id":"sponsored_label","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":true},{"asset_group_id":"display_url","asset_type":"text","required":false},{"asset_group_id":"rating","asset_type":"text","required":false},{"asset_group_id":"price","asset_type":"text","required":false},{"asset_group_id":"video","asset_type":"vast","required":false},{"asset_group_id":"impression_tracker","asset_type":"pixel_tracker","required":false},{"asset_group_id":"viewability_tracker","asset_type":"pixel_tracker","required":false},{"asset_group_id":"click_tracker","asset_type":"pixel_tracker","required":false}],"description":"Default slot shape for native_in_feed. Mirrors IAB OpenRTB Native 1.2 asset types, including the Native video asset: `video` carries a VAST document (the Native 1.2 `vasttag` field) for video-bearing native units such as CTV menu heroes with focus-triggered playback. Products MAY override (`slots_override` on the projection ref) to narrow per-slot limits (`max_chars` on title/body) or remove unused slots (a content-recommendation slot that doesn't display an icon)."},"ctv_ad_experience":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1ctv-ad-experience.json","description":"CTV experience this option serves. On native_in_feed `menu` and `overlay` are valid. `menu`: smart-TV home/menu surfaces where the platform assembles buyer assets (background/main image, logo/icon, copy, optional focus-triggered video); `menu_placement` selects the tile vs headline-banner variant, and catalog-derived sponsored tiles route to `sponsored_placement` instead. `overlay`: seller-composited in-stream overlays supplied as an asset bundle (video, logo, imagery, copy, activation copy) — the contract overlay sellers that do not ingest VAST tags use; VAST-ingesting sellers publish a `video_vast` sibling option instead. The wire name stays `native_in_feed` for 3.x even though neither surface is literally in-feed."},"menu_placement":{"type":"string","enum":["tile","headline_banner"],"description":"Menu surface variant, mapping to OpenRTB Native `plcmttype` 1 (tile/feed) and 3 (headline banner). Valid only with `ctv_ad_experience: \"menu\"`."},"focus_behavior":{"type":"string","enum":["none","autoplay_muted","autoplay_sound"],"description":"What happens when the viewer's remote focus lands on the unit. `autoplay_*` requires a `video` asset; playback method maps to AdCOM playbackmethod on OpenRTB bridges. Valid only with `ctv_ad_experience: \"menu\"`."},"motion_level":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1motion-level.json","description":"Accepted motion class for the rendered unit (AdCOM attrs 21-23)."},"activation_methods":{"type":"array","uniqueItems":true,"items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:enums~1activation-method.json"},"description":"Viewer activation mechanisms this option offers (QR, deep link, send-to-device). Activations are engagement events, not impressions."},"title_max_chars":{"type":"integer","minimum":1,"description":"Maximum character length for the title slot. IAB native typical: 25 (short) to 90 (long). Buyer agents SHOULD validate ship-time title length against this."},"body_text_max_chars":{"type":"integer","minimum":1,"description":"Maximum character length for the body_text slot. IAB native typical: 90 (mainline) to 140 (extended)."},"cta_max_chars":{"type":"integer","minimum":1,"description":"Maximum character length for the cta slot. Typical: 15–25."},"cta_values":{"type":"array","items":{"type":"string"},"description":"Permitted CTA values for this product (e.g., ['LEARN_MORE', 'SHOP_NOW', 'SIGN_UP', 'DOWNLOAD']). When set, narrows the cta slot to a closed enum."},"main_image_sizes":{"type":"array","minItems":1,"items":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false},"description":"Accepted logical (width, height) pairs for the main_image slot. Common IAB native sizes: 1200×627 (1.91:1), 1080×1080 (1:1), 1080×1350 (4:5). When the effective main_image slot declares `pixel_ratios`, intrinsic asset dimensions are the matched logical pair multiplied by the selected ratio; absence remains 1x."},"icon_size":{"type":"object","required":["width","height"],"properties":{"width":{"type":"integer","minimum":1},"height":{"type":"integer","minimum":1}},"additionalProperties":false,"description":"Required logical (width, height) for the icon slot when present (typical: 80×80 or 100×100). When the effective icon slot declares `pixel_ratios`, intrinsic dimensions are multiplied by the selected ratio; absence remains 1x."},"max_image_file_size_kb":{"type":"integer","minimum":1,"description":"Maximum file size in kilobytes for main_image and icon."},"image_formats":{"type":"array","items":{"type":"string","enum":["jpg","jpeg","png","gif","webp"]},"description":"Permitted image file formats."},"ssl_required":{"type":"boolean","description":"Whether trackers, landing pages, and image URLs must be served over HTTPS."},"asset_source":{"type":"string","enum":["buyer_uploaded","seller_pre_rendered_from_brief","seller_human_designed","agent_synthesized","publisher_owned_reference"],"default":"buyer_uploaded","description":"Where the rendered native assets come from. `publisher_host_recorded` is omitted (audio-specific and not meaningful for native). Other values mirror the shared production-source axis used on `image` / `video_hosted`. `buyer_uploaded` (default): buyer ships pre-rendered title/image/body. `seller_pre_rendered_from_brief`: buyer ships a brief, seller renders the native bundle. `agent_synthesized`: AI synthesis pipeline produces title + image + body from a brief; pair with `synthesis_nondeterministic: true` for generative pipelines that can't guarantee in-spec output. `publisher_owned_reference`: buyer ships an existing published post reference; the seller resolves the post into the native presentation after authorization/review."},"buyer_asset_acceptance":{"type":"string","enum":["accepted","rejected"],"default":"accepted","description":"Whether the product accepts buyer-uploaded native assets. When `rejected`, the buyer cannot ship pre-rendered title/image/body — they must use `build_creative`, `sync_creatives` with brief inputs, or an accepted `published_post` reference so the seller produces or resolves the native bundle."}},"additionalProperties":true},"external:formats/canonical/responsive_creative.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/responsive_creative.json","title":"Canonical Format: Responsive Creative","description":"Buyer supplies a pool of typed assets (multiple headlines, descriptions, images, videos, logos); the surface algorithmically composes combinations per placement. **Composition is algorithmic** — surface picks combinations and reports per-asset performance breakdowns. Covers Google Responsive Display Ads (RDA), Responsive Search Ads (RSA), Performance Max (PMax), Demand Gen, and Meta Advantage+ creative. Industry term: \"Responsive\" (Google) / \"Advantage+ creative\" (Meta) / \"Dynamic Creative\" (older Meta term). Distinct from `sponsored_placement` (catalog-driven, deterministic) and `agent_placement` (AI-surface composition). The structured `slots` field below enumerates expected canonical asset_group_id slots; per-slot count/length narrowing lives in flat parameters (`headlines_min`, `headline_max_chars`, etc.).","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Marked experimental at 3.1 GA: composition is algorithmic (the surface picks combinations and reports per-asset breakdowns), and there's no clean v1-translatable equivalent. Buyers ship asset pools rather than rendered creatives; the surface's per-impression composition cannot be predicted by `validate_input`. Adopters SHOULD validate behavior per surface (Google PMax vs Meta Advantage+ creative differ meaningfully)."},"v1_translatable":{"default":false,"description":"Inherently new in v2 — algorithmic asset-pool composition (Google PMax / Meta Advantage+ creative) wasn't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural."},"slots":{"default":[{"asset_group_id":"headlines","asset_type":"text","required":true,"min":3,"max":15},{"asset_group_id":"long_headlines","asset_type":"text","required":false,"min":1,"max":5},{"asset_group_id":"descriptions","asset_type":"text","required":true,"min":2,"max":5},{"asset_group_id":"images_landscape","asset_type":"image","required":false,"min":1,"max":20},{"asset_group_id":"images_square","asset_type":"image","required":false,"min":1,"max":20},{"asset_group_id":"images_vertical","asset_type":"image","required":false,"min":1,"max":20},{"asset_group_id":"video","asset_type":"video","required":false,"min":0,"max":5},{"asset_group_id":"logo","asset_type":"image","required":true,"min":1,"max":5,"logo_slots":["logo_card_light","logo_card_dark","marketplace_listing","ad_end_card"],"required_logo_slots":["logo_card_light","logo_card_dark"]},{"asset_group_id":"landing_page_url","asset_type":"url","required":true,"min":1,"max":1}]},"headlines_min":{"type":"integer","minimum":0},"headlines_max":{"type":"integer","minimum":0},"headline_max_chars":{"type":"integer","minimum":1},"long_headlines_min":{"type":"integer","minimum":0},"long_headlines_max":{"type":"integer","minimum":0},"long_headline_max_chars":{"type":"integer","minimum":1},"descriptions_min":{"type":"integer","minimum":0},"descriptions_max":{"type":"integer","minimum":0},"description_max_chars":{"type":"integer","minimum":1},"images_landscape_min":{"type":"integer","minimum":0},"images_landscape_max":{"type":"integer","minimum":0},"images_landscape_aspect_ratio":{"type":"string"},"images_square_min":{"type":"integer","minimum":0},"images_square_max":{"type":"integer","minimum":0},"images_vertical_min":{"type":"integer","minimum":0},"images_vertical_max":{"type":"integer","minimum":0},"videos_min":{"type":"integer","minimum":0},"videos_max":{"type":"integer","minimum":0},"video_min_duration_ms":{"type":"integer","minimum":1},"video_max_duration_ms":{"type":"integer","minimum":1},"logo_min":{"type":"integer","minimum":0},"logo_max":{"type":"integer","minimum":0},"logo_aspect_ratios":{"type":"array","items":{"type":"string"}},"business_name_max_chars":{"type":"integer","minimum":1},"asset_image_max_file_size_kb":{"type":"integer","minimum":1},"supports_catalog_input":{"type":"boolean","description":"Whether the product can additionally consume a catalog reference (e.g., PMax with product feed)."}},"additionalProperties":true},"external:formats/canonical/agent_placement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/agent_placement.json","title":"Canonical Format: Agent Placement (AI-surface sponsored placement)","description":"**3.2-track canonical.** The structural shape (algorithmic composition + brand-context input + optional offering/landing_page) is captured here so adopters can declare against it in 3.1 catalogs, but the **mention-level tracking contract is intentionally underspecified for 3.1**: no normative macro vocabulary, no postback shape, no cross-surface dedup model. Adopters claiming `agent_placement` in 3.1 ship private tracking integrations and SHOULD leave `experimental: true` on the product declaration that references this canonical; buyer agents MUST treat agent_placement attribution as adapter-defined until the 3.2 tracking-macro spec lands. The canonical promotes to a normatively-buyer-callable surface in 3.2 (or later) once the tracking contract is specified.\n\nSponsored placement integrated into an AI-surface's response to a user. Buyer supplies a `BrandRef` (resolving brand.json for context), an optional `offering_ref` to focus the mention on a specific offering, and an optional `landing_page_url` the surface MAY attach as a citation. The surface (LLM, voice assistant, sponsored-search ranker) composes a natural-language mention, sponsored card, or audio snippet within its response to a user query. **Composition is algorithmic** — the agent chooses phrasing and presentation. Output asset_type varies by surface: `text` for chat UIs and sponsored search snippets; `audio` (synthesized) for voice assistants; `card` for structured AI-surface result cards. Tracking model: mention-level impression + attribution events; per-mention id keys back to brand and offering — but see the 3.2-track note above; the wire shape of these events is not yet specified. Distinct from `si_chat` (which is the user-converses-with-brand's-agent pattern — brand owns the conversational surface) and from `sponsored_placement` (retail-media catalog-driven). Parallels `sponsored_placement` structurally: both are surface-composed placements; agent_placement is for AI/agentic surfaces, sponsored_placement is for retail media.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Marked experimental at 3.1 GA: the canonical's tracking model (mention-level impression + attribution, postback shape, cross-surface dedup) is intentionally underspecified for 3.1. Adopters claiming `agent_placement` ship private tracking integrations; buyer agents MUST treat attribution as adapter-defined until the 3.2 tracking-macro spec lands. Promotion to non-experimental gated on the 3.2 tracking-contract spec."},"v1_translatable":{"default":false,"description":"Inherently new in v2 — AI-surface sponsored mentions weren't expressible as v1 named formats. SDKs MUST NOT emit `FORMAT_PROJECTION_FAILED` for products using this canonical; the v1-unreachability is structural."},"slots":{"default":[{"asset_group_id":"offering_ref","asset_type":"text","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":false}],"description":"agent_placement has minimal buyer-shipped slots — the surface composes the rendered output from brand context (resolved via the manifest's top-level `brand` BrandRef) plus optional offering_ref and landing_page_url assets. None of these assets are rendered verbatim by the buyer; the agent chooses how to use them."},"output_modality":{"type":"string","enum":["text","audio","card"],"description":"How the surface presents the mention. `text` = inline text (chat, search snippet). `audio` = TTS-synthesized voice. `card` = structured card with optional image + text."},"max_mention_length_chars":{"type":"integer","minimum":1,"description":"For text output: maximum length of the surface-composed mention text."},"max_mention_duration_ms":{"type":"integer","minimum":1,"description":"For audio output: maximum duration of the spoken mention in milliseconds."},"supports_offering_reference":{"type":"boolean","description":"Whether the product accepts an offering reference (specific product/service to promote within the mention) in addition to brand context."},"supports_landing_page_url":{"type":"boolean","description":"Whether the surface attaches a landing page URL to the mention (citation, learn-more link)."},"tone_constraints":{"type":"array","items":{"type":"string"},"description":"**Advisory only.** Buyer-declared brand-voice preferences the surface SHOULD honor (e.g., ['formal', 'no_superlatives']). LLM/agentic surfaces have no protocol-level mechanism to verify enforcement — adopters that need hard guarantees should rely on brand.json voice declarations and post-mention review rather than this field. Future revisions may tie this to a structured tone vocabulary; for now treat as free-text guidance."},"disclosure_required":{"type":"boolean","description":"Whether the surface must include an explicit sponsorship disclosure label."}},"additionalProperties":true},"external:formats/canonical/seller_rendered_stateful_display.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/seller_rendered_stateful_display.json","title":"Canonical Format: Seller-Rendered Stateful Display","description":"Seller-rendered display unit whose declaration is an executable template contract: buyer-known visual states, explicit transitions, breakpoint canvases, and per-state slot bindings. The seller owns the runtime; `supply_mode` declares which end the buyer feeds. For machine-rendered `components` and `rendered_canvases` supply, sellers MUST support `preview_creative` returning every state × breakpoint from a candidate manifest. `layered_source` instead follows the asynchronous seller-production preview path after the declared production window. `composition_model: deterministic` describes serving the finished states, not instant derivation from layered source. Buyer-executable HTML/MRAID is `html5`, a buyer-delivered tag is `display_tag`, arbitrary games/hotspots/scripts remain `custom`, and per-impression algorithmic assembly is `responsive_creative`.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Experimental in AdCP 3.2 while the creative working group gathers implementation evidence across premium web and mobile/app sellers."},"v1_translatable":{"default":false,"description":"No v1 named-format equivalent can express multiple seller-rendered states and their breakpoint bindings."},"since_version":{"default":"3.2"},"composition_model":{"default":"deterministic"},"supply_mode":{"type":"string","enum":["components","rendered_canvases","layered_source"],"default":"components","description":"Which end of the template contract the buyer feeds. `components`: buyer supplies component slots; seller renders states (no `state_canvases`/`layered_source` assets allowed). `rendered_canvases`: buyer supplies exactly one `state_canvases` image per declared state × breakpoint pair. `layered_source`: buyer ships design source (+ optional `font_files`); seller production derives states (`production_window_business_days` applies) — transitional for sellers without executable templates."},"slots":{"default":[{"asset_group_id":"state_canvases","asset_type":"image","required":false,"min":1},{"asset_group_id":"logo","asset_type":"image","required":false},{"asset_group_id":"imagery","asset_type":"image","required":false,"min":0},{"asset_group_id":"headline","asset_type":"text","required":false},{"asset_group_id":"messaging","asset_type":"text","required":false},{"asset_group_id":"cta","asset_type":"text","required":false},{"asset_group_id":"legal_text","asset_type":"text","required":false},{"asset_group_id":"video_main","asset_type":"video","required":false},{"asset_group_id":"landing_page_url","asset_type":"url","required":true},{"asset_group_id":"state_click_urls","asset_type":"url","required":false,"min":0},{"asset_group_id":"layered_source","asset_type":"zip","required":false},{"asset_group_id":"font_files","asset_type":"zip","required":false}],"description":"Default manifest slots; which are consumed depends on `supply_mode`. `state_canvases` images MUST carry `state_id` and `breakpoint_id`, and `state_click_urls` entries MUST carry `state_id` (semantic validators resolve the bindings). Component images SHOULD carry `focal_point` for deterministic seller cropping. `landing_page_url` is the default destination (see `clickthrough`). `font_files` MUST contain only buyer-licensed fonts; publisher-proprietary fonts never travel in manifests. Only image, video, text, url, zip, and pixel_tracker slot asset types are accepted — executable types (javascript, html, css, webhook) are rejected even via `slots` overrides."},"states":{"type":"array","minItems":1,"description":"Finite visual states known at buy time; state and breakpoint IDs form the canvas-key matrix. Runtime causes live in `transitions[]`. A single-state unit (topscroll, interscroller, skin) declares one state, no transitions, and typically a `reveal` mechanic.","items":{"type":"object","properties":{"state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable identifier used by `state_canvases[].state_id` and `state_click_urls[].state_id`."},"anchoring":{"type":"string","enum":["inline","sticky_top","sticky_bottom","overlay","fullscreen_overlay","underlay"],"description":"`underlay` renders the canvas beneath page content, which scrolls over it (IAB New Ad Portfolio underlay class: skins, reveal units). Transitions into `overlay`/`fullscreen_overlay` states SHOULD be user-initiated; non-user-action entries emit LEAN policy warnings."},"slot_bindings":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^[a-z0-9_]+$"},"description":"Asset group IDs rendered in this state (components mode). Makes the template executable: given components and bindings, assembly is deterministic. Every value MUST resolve to a declared slot. Omitted means all supplied component slots may render."},"motion":{"type":"string","enum":["static","animated"],"default":"static","description":"Whether the seller-rendered layout animates within this state (attract loops, load animations). Intra-state animation is seller-rendered; buyer canvases stay static images."},"max_animation_s":{"type":"number","exclusiveMinimum":0,"description":"Upper bound on intra-state animation duration. Required when `motion` is `animated`."},"breakpoints":{"type":"array","minItems":1,"items":{"type":"object","properties":{"breakpoint_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable identifier used by `state_canvases[].breakpoint_id`."},"width":{"type":"integer","minimum":1},"width_range":{"type":"array","items":{"type":"integer","minimum":1},"minItems":2,"maxItems":2,"description":"Inclusive [minimum, maximum] accepted canvas width. The first value MUST be no greater than the second; semantic validators enforce ordering."},"width_mode":{"type":"string","enum":["full_bleed","gutter_residual"],"description":"Fluid width classes. `full_bleed`: edge-to-edge viewport width (IAB adhesion, topscroll). `gutter_residual`: the margin remaining beside the page content column (desktop skins). Fluid breakpoints cannot be targeted by `rendered_canvases` supply — semantic validation rejects that pairing."},"height":{"type":"integer","minimum":1},"height_range":{"type":"array","items":{"type":"integer","minimum":1},"minItems":2,"maxItems":2,"description":"Inclusive [minimum, maximum] accepted canvas height. The first value MUST be no greater than the second; semantic validators enforce ordering."},"viewport_height_percent":{"type":"number","exclusiveMinimum":0,"maximum":100,"description":"Height as a percentage of the viewport (topscroll 80%, mobile skin panel 15%). Fluid; cannot be targeted by `rendered_canvases` supply."},"canvas_aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Aspect ratio the rendered canvas maintains across the size range (IAB flexible units, ratio-bucket responsive). When both fixed `width` and `height` are declared, the ratio MUST be consistent with them."}},"required":["breakpoint_id"],"allOf":[{"anyOf":[{"required":["width"],"not":{"anyOf":[{"required":["width_range"]},{"required":["width_mode"]}]}},{"required":["width_range"],"not":{"anyOf":[{"required":["width"]},{"required":["width_mode"]}]}},{"required":["width_mode"],"not":{"anyOf":[{"required":["width"]},{"required":["width_range"]}]}}]},{"anyOf":[{"required":["height"],"not":{"anyOf":[{"required":["height_range"]},{"required":["viewport_height_percent"]}]}},{"required":["height_range"],"not":{"anyOf":[{"required":["height"]},{"required":["viewport_height_percent"]}]}},{"required":["viewport_height_percent"],"not":{"anyOf":[{"required":["height"]},{"required":["height_range"]}]}}]}],"additionalProperties":true}},"close_affordance":{"type":"boolean","description":"Whether this state visibly renders a seller-controlled close affordance. When true, rendering MUST follow IAB New Ad Portfolio close-button guidance (top-right, minimum 50×50 dp, available from state entry)."}},"required":["state_id","anchoring","breakpoints","close_affordance"],"additionalProperties":true}},"initial_state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"State rendered when the unit first becomes visible. MUST resolve to `states[].state_id`; for a single-state unit it MUST equal the sole state."},"reveal":{"type":"string","enum":["none","clip_window","scroll_parallax"],"default":"none","description":"How the unit enters view, distinct from state changes. `clip_window`: canvas fixed and progressively exposed through a scrolling window (interscroller, topscroll). `scroll_parallax`: canvas moves at a different rate than content. Reveal is presentation of one canvas, not a transition; do not fabricate a second state to express it."},"transitions":{"type":"array","minItems":1,"description":"Bounded seller-rendered transitions between declared visual states. Required when `states` has more than one entry; MUST be omitted for single-state units. Every non-initial state MUST be reachable from `initial_state_id`. Dismissal is terminal unit behavior declared by `user_controls.dismissible`, not a hidden visual state.","items":{"type":"object","properties":{"transition_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable transition identifier for preview and reporting."},"from_state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"to_state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"trigger":{"type":"string","enum":["timer","in_view_timer","scroll_threshold","scroll_progress","user_action","media_event"],"description":"Cause of the transition. `timer` counts from state entry; `in_view_timer` counts viewable time in the current state (industry auto-collapse is N seconds in view). `media_event` fires on `video_main` playback milestones. The outcome is expressed separately by `to_state_id`."},"input":{"type":"string","enum":["tap","hover","swipe_up","swipe_down","swipe_left","swipe_right","scroll","expand_control","collapse_control"],"description":"Input driving a user or scroll transition. `hover` expansion is disallowed by IAB NAP guidance and emits a LEAN policy warning visible to buyers."},"media_event":{"type":"string","enum":["video_start","video_complete"],"description":"Playback milestone of `video_main` driving a `media_event` transition (endframes, collapse-on-complete)."},"direction":{"type":"string","enum":["down","up"],"default":"down","description":"Scroll direction that arms a `scroll_threshold` transition; enables direction-aware expand/collapse cycles. Re-crossing in the opposite direction does not re-fire this transition."},"transition_mode":{"type":"string","enum":["instant","animated","scroll_linked"],"default":"instant","description":"`scroll_linked` continuously interpolates the seller-owned layout between the two declared endpoint states; it is valid only with trigger `scroll_progress` and does not permit buyer scripting."},"delay_ms":{"type":"integer","minimum":0,"description":"For `timer`: delay after `from_state_id` activates (re-entry restarts it). For `in_view_timer`: accumulated viewable milliseconds in `from_state_id`. Timer-class transitions in a state cycle MUST declare at least 1000 (anti-strobe floor)."},"duration_ms":{"type":"integer","minimum":0,"description":"Duration of a seller-rendered animated transition."},"scroll_threshold_percent":{"type":"number","minimum":0,"maximum":100,"description":"Viewport/page scroll threshold that starts a `scroll_threshold` transition."},"scroll_reference":{"type":"string","enum":["document_progress","containing_scroller_progress"],"description":"Reference frame for scroll percentages. Progress is `scroll_offset / max(scroll_extent - viewport_extent, 1) * 100`, measured on either the page document or the nearest seller-declared containing scroller."},"scroll_start_percent":{"type":"number","minimum":0,"maximum":100,"description":"Start of the bounded scroll interval for a `scroll_progress` transition."},"scroll_end_percent":{"type":"number","minimum":0,"maximum":100,"description":"End of the bounded scroll interval for a `scroll_progress` transition. MUST be greater than `scroll_start_percent`."},"preserve_playback":{"type":"boolean","default":false,"description":"Whether `video_main` continues without restart while the seller changes state."}},"required":["transition_id","from_state_id","to_state_id","trigger","transition_mode"],"oneOf":[{"properties":{"trigger":{"type":"string","const":"timer"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","delay_ms"],"not":{"anyOf":[{"required":["input"]},{"required":["media_event"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]}]}},{"properties":{"trigger":{"type":"string","const":"in_view_timer"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","delay_ms"],"not":{"anyOf":[{"required":["input"]},{"required":["media_event"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]}]}},{"properties":{"trigger":{"type":"string","const":"scroll_threshold"},"input":{"type":"string","const":"scroll"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","input","scroll_reference","scroll_threshold_percent"],"not":{"anyOf":[{"required":["delay_ms"]},{"required":["media_event"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]}]}},{"properties":{"trigger":{"type":"string","const":"scroll_progress"},"input":{"type":"string","const":"scroll"},"transition_mode":{"type":"string","const":"scroll_linked"}},"required":["trigger","input","scroll_reference","scroll_start_percent","scroll_end_percent"],"not":{"anyOf":[{"required":["delay_ms"]},{"required":["media_event"]},{"required":["scroll_threshold_percent"]},{"required":["direction"]}]}},{"properties":{"trigger":{"type":"string","const":"user_action"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","input"],"not":{"anyOf":[{"required":["delay_ms"]},{"required":["media_event"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]},{"required":["direction"]}]}},{"properties":{"trigger":{"type":"string","const":"media_event"},"transition_mode":{"type":"string","enum":["instant","animated"]}},"required":["trigger","media_event"],"not":{"anyOf":[{"required":["input"]},{"required":["delay_ms"]},{"required":["scroll_reference"]},{"required":["scroll_threshold_percent"]},{"required":["scroll_start_percent"]},{"required":["scroll_end_percent"]},{"required":["direction"]}]}}],"additionalProperties":true}},"clickthrough":{"type":"string","enum":["required","optional","none"],"default":"required","description":"Destination policy. `required` (default): manifest MUST supply `landing_page_url`. `optional`: click-optional units (in-feed brand units) may omit it. `none`: unit is non-clickable; manifests MUST NOT supply `landing_page_url` or `state_click_urls`. Per-state overrides via `state_click_urls` entries carrying `state_id`; `landing_page_url` is the fallback for unlisted states."},"user_controls":{"type":"object","properties":{"dismissible":{"type":"boolean"},"user_collapsible":{"type":"boolean"}},"required":["dismissible","user_collapsible"],"additionalProperties":true,"description":"When any state anchors as `overlay` or `fullscreen_overlay`, either `dismissible` MUST be true or that state's `close_affordance` MUST be true (dismissibility floor; semantic validators enforce)."},"canvas_constraints":{"type":"array","description":"Rectangular areas constraining buyer artwork. Omitted state/breakpoint selectors apply the constraint to every canvas. For fluid or range-sized breakpoints, use percent-unit regions.","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canvas-constraint.json"}},"duration_ms_range":{"type":"array","items":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"minItems":2,"maxItems":2,"contains":{"type":"integer","minimum":0},"description":"Accepted embedded-video duration [min, max]. `duration_ms_exact` takes precedence when both are present."},"duration_ms_exact":{"type":"integer","minimum":1},"aspect_ratio":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?:[0-9]+(\\.[0-9]+)?$","description":"Embedded-video aspect ratio."},"containers":{"type":"array","items":{"type":"string","enum":["mp4","webm","mov"]},"uniqueItems":true},"video_playback":{"type":"string","enum":["none","auto_muted","user_initiated"]},"max_initial_load_kb":{"type":"integer","minimum":1},"max_subload_kb":{"type":"integer","minimum":1,"description":"Ceiling on assets loaded after the window load event (IAB LEAN subload). Pairs with `max_initial_load_kb` to mirror the New Ad Portfolio initial/subload weight pair."},"polite_load":{"type":"boolean","description":"When true, non-initial assets load only after the host page's window load event (IAB LEAN subload boundary)."}},"x-adcp-validation":{"allowed_slot_asset_types":["image","video","text","url","zip","pixel_tracker"],"verifier_constraints":{"state_id_uniqueness":"states[].state_id values must be unique","initial_state_resolution":"initial_state_id must resolve to a declared state","single_state_shape":"when states has one entry, transitions must be absent or empty and initial_state_id must equal the sole state; when states has more than one entry, transitions must be present and non-empty","transition_id_uniqueness":"transitions[].transition_id values must be unique","transition_exit_determinism":"at most one transition out of a given state per cause tuple (trigger, plus input for user_action, media_event for media_event, direction for scroll_threshold); distinct causes may coexist and the seller runtime arms whichever inputs the device supports","transition_state_resolution":"transition endpoints must resolve to distinct declared states","scroll_progress_bounds":"scroll_start_percent must be less than scroll_end_percent","scroll_linked_binding":"transition_mode scroll_linked is valid only with trigger scroll_progress","state_reachability":"every non-initial state must be reachable from initial_state_id","timer_cycle_floor":"timer and in_view_timer transitions participating in a state cycle must declare delay_ms >= 1000","dismissibility_floor":"any state anchored overlay or fullscreen_overlay requires user_controls.dismissible true or that state's close_affordance true","breakpoint_id_uniqueness":"breakpoints[].breakpoint_id values must be unique within each state","width_range_order":"width_range minimum must be less than or equal to maximum","height_range_order":"height_range minimum must be less than or equal to maximum","aspect_consistency":"canvas_aspect_ratio must be consistent with fixed width and height when both are declared","duration_ms_range_order":"duration_ms_range[0] must be less than or equal to duration_ms_range[1] when both are non-null","motion_animation_bound":"max_animation_s is required when a state's motion is animated and forbidden when static","slot_binding_resolution":"states[].slot_bindings values must resolve to declared slot asset_group_ids","allowed_slot_asset_types":"declaration slots (including params.slots overrides) must not widen the canonical's allowed asset types; executable types are rejected","supply_mode_manifest":"components mode forbids state_canvases and layered_source assets; rendered_canvases mode requires full canvas coverage and forbids layered_source; layered_source mode requires a layered_source asset and forbids state_canvases","fluid_breakpoint_supply":"breakpoints using width_mode or viewport_height_percent cannot be targeted by rendered_canvases supply","state_canvas_coverage":"in rendered_canvases mode, exactly one state_canvases image per declared state and breakpoint pair","state_canvas_dimensions":"canvas width must equal declared width or fall within width_range; height must equal fixed height or fall within height_range","state_canvas_extras":"undeclared and duplicate state/breakpoint pairs are rejected","clickthrough_policy":"landing_page_url required when clickthrough is required; landing_page_url and state_click_urls forbidden when clickthrough is none","state_click_url_resolution":"state_click_urls entries must carry state_id resolving to a declared state, with at most one entry per state","lean_policy_warnings":"non-user-action transitions into overlay/fullscreen_overlay anchoring, hover-triggered expansion, and scroll transitions into overlay anchoring emit policy warnings (non-blocking)"},"spec":"docs/creative/canonical-formats.mdx#premium-display-in-32"},"required":["states","initial_state_id","user_controls"],"additionalProperties":true},"external:core/canvas-constraint.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/canvas-constraint.json","title":"Canvas Constraint","description":"Rectangular rule applied to buyer artwork. State and breakpoint selectors are optional so the same shape can constrain a coordinated-placement component or a specific stateful-display canvas.","type":"object","properties":{"constraint":{"type":"string","enum":["safe_area","reserved_region","decoration_only_edge","no_text_or_logos"]},"state_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"breakpoint_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$"},"region":{"type":"object","properties":{"x":{"type":"number","minimum":0},"y":{"type":"number","minimum":0},"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0},"unit":{"type":"string","enum":["px","percent"],"default":"px"}},"required":["x","y","width","height"],"allOf":[{"if":{"properties":{"unit":{"const":"percent"}},"required":["unit"]},"then":{"properties":{"x":{"maximum":100},"y":{"maximum":100},"width":{"maximum":100},"height":{"maximum":100}}}}],"additionalProperties":true}},"required":["constraint","region"],"x-adcp-validation":{"verifier_constraints":{"selector_resolution":"state_id and breakpoint_id resolve against the containing seller_rendered_stateful_display declaration; coordinated_placements component constraints omit both selectors","region_bounds":"percent regions satisfy x + width <= 100 and y + height <= 100; pixel regions fit within every selected canvas"},"spec":"docs/creative/canonical-formats.mdx#premium-display-in-32"},"additionalProperties":true,"dependentRequired":{"breakpoint_id":["state_id"]}},"external:formats/canonical/coordinated_placements.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/formats/canonical/coordinated_placements.json","title":"Canonical Format: Coordinated Placements","description":"One creative manifest atomically supplies assets for multiple declared product placements. Each component binds to a public `Product.placements[]` entry and either declares an inline non-custom canonical format or references a sibling format option on the same product. Components cannot nest coordinated placements. The manifest supplies component slots under `component_assets.<component_id>`; `shared_slots` assets are supplied once at top level. Inventory exclusivity remains `Product.exclusivity`, not a creative-format parameter. Ordinary products whose placements accept independently assigned creatives do not need this canonical.","allOf":[{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1_base.json"}],"properties":{"experimental":{"default":true,"description":"Experimental in AdCP 3.2 while the creative working group gathers implementation evidence for atomic cross-placement composition."},"v1_translatable":{"default":false,"description":"No v1 named-format equivalent can express a coordinated multi-placement buy."},"since_version":{"default":"3.2"},"composition_model":{"default":"deterministic"},"components":{"type":"array","minItems":2,"contains":{"type":"object","properties":{"required":{"type":"boolean","const":true}},"required":["required"]},"items":{"type":"object","properties":{"component_id":{"type":"string","pattern":"^[a-z][a-z0-9_]*$","description":"Stable coordination-local component identifier. Values MUST be unique within `components[]`."},"placement_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1placement-ref.json","description":"Public product placement this component supplies. MUST resolve against the containing product's `placements[]`."},"required":{"type":"boolean"},"sequence":{"type":"integer","minimum":1,"description":"Declared presentation order for sequential-messaging coordinated buys. Components sharing a sequence value present simultaneously; absent means unordered/simultaneous (default). Sequence declares seller-rendered ordering, not buyer-controlled timing."},"serving_policy":{"type":"string","enum":["seller_served_only","third_party_allowed"],"description":"Per-component serving/tracking policy. Some sellers restrict specific components (e.g., page skins) to first-party serving while allowing third-party tags on sibling components. Defaults to the product-level policy when absent."},"canvas_constraints":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canvas-constraint.json"},"description":"Artwork constraints applied to this component, including safe areas and seller-reserved regions."},"format_option_ref":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-option-ref.json","description":"Reference to a sibling `format_options[]` entry on the same product. It MUST NOT resolve to `custom` or `coordinated_placements`."},"format_kind":{"type":"string"},"params":{"type":"object"}},"required":["component_id","placement_ref","required"],"anyOf":[{"required":["format_option_ref"],"not":{"anyOf":[{"required":["format_kind"]},{"required":["params"]}]}},{"required":["format_kind","params"],"not":{"required":["format_option_ref"]},"oneOf":[{"properties":{"format_kind":{"type":"string","const":"image"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"html5"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1html5.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"display_tag"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1display_tag.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"image_carousel"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1image_carousel.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"video_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_hosted.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"video_vast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1video_vast.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"audio_hosted"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_hosted.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"audio_daast"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1audio_daast.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"sponsored_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1sponsored_placement.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"native_in_feed"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1native_in_feed.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"responsive_creative"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1responsive_creative.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"agent_placement"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1agent_placement.json"}},"required":["format_kind"]},{"properties":{"format_kind":{"type":"string","const":"seller_rendered_stateful_display"},"params":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:formats~1canonical~1seller_rendered_stateful_display.json"}},"required":["format_kind"]}]}],"additionalProperties":true}},"shared_slots":{"type":"array","description":"Manifest slots supplied once and consumed by one or more coordinated components.","items":{"type":"object","properties":{"asset_group_id":{"type":"string","pattern":"^[a-z0-9_]+$"},"asset_type":{"type":"string","enum":["image","video","audio","text","markdown","url","html","css","javascript","vast","daast","webhook","brief","catalog","published_post","zip","card","object","pixel_tracker","vast_tracker","daast_tracker"]},"required":{"type":"boolean","default":false},"min":{"type":"integer","minimum":0},"max":{"type":"integer","minimum":1},"consumed_by":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string"},"description":"Component IDs that consume this shared asset. Every value MUST resolve to `components[].component_id`."}},"required":["asset_group_id","asset_type","consumed_by"],"additionalProperties":true}}},"x-adcp-validation":{"verifier_constraints":{"component_id_uniqueness":"components[].component_id values must be unique","required_component":"at least one component must be required","placement_ref_resolution":"components[].placement_ref values must resolve to distinct Product.placements[] entries","format_option_ref_resolution":"component references resolve only against sibling format_options entries on the same product","component_kind":"resolved and inline components cannot be custom or coordinated_placements","inline_params":"inline params validate against the schema selected by inline format_kind","component_assets":"required components have a component_assets entry satisfying their resolved canonical slots","sequence_values":"when any component declares sequence, sequence values must start at 1 and be contiguous across the declared set","referenced_option_schema":"declarations resolved via format_option_ref are schema-validated identically to inline params","shared_slot_consumers":"every shared_slots[].consumed_by value resolves to a declared component_id whose canonical slots accept the shared asset_group_id and asset_type"},"spec":"docs/creative/canonical-formats.mdx#premium-display-in-32"},"required":["components"],"additionalProperties":true},"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/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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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/build-creative-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-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/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:enums/creative-selection-strategy.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/creative-selection-strategy.json","title":"Creative Selection Strategy","description":"How a creative agent samples which catalog items / signal conditions to produce creatives for when max_creatives is below the eligible count (#5262). Selection ordering surfaces on the existing rank/recommended fields of build_creative's creatives[].variants[]. This is a curated set, not an open extension point — new strategies are added per the enum-membership criterion in spec-guidelines.md. Part of the experimental signal-fanout surface (x-status: experimental; feature id `creative.signal_fanout`).","x-status":"experimental","type":"string","enum":["audience_relevance","contextual_fit","performance","proximity","inventory_priority","random"],"enumDescriptions":{"audience_relevance":"Rank by relevance to the buyer's audience signal(s) — the user-side axis. Drawn from the SAME signal_ref pointers in signal_conditions / package targeting, not a parallel signals[] array.","contextual_fit":"Rank by fit to the content/context the creative renders against — the content-side counterpart to audience_relevance (user-side). Uses the same signal_ref mechanism with a context signal rather than an audience signal. Mirrors the Trusted Match Protocol Context Match / Identity Match split.","performance":"Rank by the catalog item's historical delivery performance (e.g. CTR, completion, conversion) where the agent has that signal.","proximity":"Rank by proximity to a location input. Reuse the existing geo targeting shape (see docs/media-buy/advanced-topics/targeting.mdx) rather than a parallel one; the exact geo-input binding is still being settled, which the experimental status of this surface keeps revisable.","inventory_priority":"Rank by seller-side catalog metadata (margin, overstock, promotional priority). No buyer input.","random":"Status-quo fallback: agent samples without a ranking preference. Default when selection_strategy is omitted."}},"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/build-creative-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/build-creative-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/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:enums/creative-quality.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/creative-quality.json","title":"Creative Quality","description":"Quality tier for creative generation, controlling the fidelity and cost tradeoff","type":"string","enum":["draft","production"],"enumDescriptions":{"draft":"Fast, lower-fidelity output for iteration and review","production":"Full-quality output for final delivery"}},"external:core/evaluator-spec.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/evaluator-spec.json","title":"Evaluator Spec","description":"Advisory buyer-attached pointer (#5280) declaring HOW produced build_creative variants should be evaluated and ranked. The rank-side of the get_creative_features feature oracle: the chosen form is the SOURCE of feature evaluation that yields creative-feature values for each leaf, `feature_requirement` is an optional hard GATE over those values, and `rank_by` is the RANK ordering over the survivors. Informs the agent's best_of_n recommended/rank and, when the agent advertises creative.supports_evaluator, populates a per-leaf `eval` block (creative-feature-result[]) on the response.\n\nGate-then-rank pipeline (per produced leaf in a best_of_n run): the producing agent (1) evaluates the leaf via the chosen form, obtaining creative-feature values; (2) when `feature_requirement` is present, applies those predicates and DROPS any leaf that fails (internal best_of_n pruning) — survivors only; (3) orders survivors by `rank_by`. The gate operates BEFORE return: it prunes which leaves the agent recommends/returns from its own best_of_n exploration, never an AdCP-layer block of an already-produced billable leaf — what is produced and billed is governed by max_variants/max_creatives/max_spend, not by the evaluator. With no `feature_requirement`, evaluation stays advisory: every produced leaf is returned and billed and ranking is a soft preference, so `rank_by` failures rank lower but are never dropped.\n\nWhen the chosen form is `feature_agent` (or `agent_url`), the seller calls an external get_creative_features-capable agent, so the pointer is subject to the seller's `creative_policy.accepted_verifiers[]` allowlist exactly as #5280 established for provenance verify_agent: the buyer REPRESENTS which on-list agent it used, the seller (verifier-of-record) CALLS it. An off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED` (mirrors PROVENANCE_VERIFIER_NOT_ACCEPTED) before any outbound call; an on-list agent that is unreachable or unknown degrades to seller-default ranking with an advisory errors[] note (non-terminal), NOT a failure.\n\nEvaluator credentials and caller-supplied trust material are never carried in this object, `context`, `ext`, or the creative payload. The producing creative agent authenticates its outbound call to the evaluator on the transport (RFC 9421 request signing/JWKS, mTLS, or a pre-provisioned Bearer/API-key credential). Credential- or trust-material payload keys (for example `api_key`, `client_secret`, `authorization`, `jwk`, `jwks`, or `jwks_uri`) are non-conforming and should be rejected with `CREDENTIAL_IN_ARGS`.\n\nProvide exactly one of three forms; an optional `feature_requirement` gate, an optional `rank_by` ordering, an optional `feature_agent` allowlisted pointer, and a shared optional eval_budget apply to whichever form is chosen. Feature discovery uses the existing governance.creative_features catalog on get_adcp_capabilities; evaluator outputs reuse creative-feature-result[] and do not mint a parallel verdict/result surface. `evaluator_id` is not discovered from governance.creative_features: it is a pre-provisioned, account-arranged preset whose emitted feature_ids still come from that catalog.\n\nExperimental (x-status: experimental): this whole evaluator surface — the `evaluator` input, the per-leaf `eval` response block, and `creative.supports_evaluator` — is new and not yet field-tested across parties. Sellers that implement it MUST list `creative.evaluator` in `experimental_features`. Reserved 3.x follow-ons that may reshape these fields: a separate `supports_evaluator_gate` capability and a hard MUST-enforce-gate semantic. Per docs/reference/experimental-status, it MAY change between 3.x releases with notice.","x-status":"experimental","type":"object","properties":{"feature_requirement":{"type":"array","description":"Optional hard GATE over creative-feature values — the predicates a leaf MUST satisfy for the producing agent to recommend/return it. Reuses the feature-requirement shape (min_value/max_value for quantitative features like creative_quality_score, allowed_values for binary/categorical) — the same predicate vocabulary that gates property/audience filters, which its own schema names as an intended creative-gate reuse. A leaf that fails any predicate is DROPPED from the agent's best_of_n survivors before ranking — this is internal pruning of which leaves the agent recommends, not an AdCP-layer block of an already-produced billable leaf (what is produced/billed is governed by max_variants/max_creatives/max_spend). Distinct from `rank_by`: the gate is a pass/fail predicate (drop on fail), `rank_by` is an ordering over survivors. Each predicate's `if_not_covered` (exclude|include, default exclude) is the fail-open knob when the source cannot measure that feature. A pass/warn/fail verdict is expressed as a categorical string feature value gated via `allowed_values` (e.g. [\"pass\"] or [\"pass\",\"warn\"]) — the buyer's predicate decides whether warn passes; the verdict is derived, never stored on creative-feature-result. Omit to leave evaluation advisory (no leaf is dropped).","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1feature-requirement.json"},"minItems":1},"rank_by":{"type":"array","description":"Optional RANK ordering over creative-feature values — an ordered list (most significant first) the agent uses to order the gate survivors into recommended/rank. An explicit {feature_id, direction} ordering rather than the feature-requirement predicate (which has no sort direction): the gate decides pass/fail, rank_by decides better/worse. Soft preference, never a gate: leaves are not dropped by rank_by, they are only ordered. Omit to let the evaluator/seller choose the ordering.","items":{"type":"object","properties":{"feature_id":{"type":"string","description":"Creative feature to order by (discovered via get_adcp_capabilities; the same feature_id space the chosen evaluator form returns in eval.features[])."},"direction":{"type":"string","enum":["maximize","minimize"],"default":"maximize","description":"Sort direction for this feature: `maximize` ranks higher feature values first (e.g. creative_quality_score), `minimize` ranks lower values first (e.g. predicted_cpa)."}},"required":["feature_id"],"additionalProperties":false},"minItems":1},"feature_agent":{"type":"object","description":"Optional buyer-attached pointer to a get_creative_features-capable creative-feature / governance agent the producing agent calls to evaluate each leaf (the gate's SOURCE of feature values). This is the buyer-represents → seller-calls pattern #5280 established for provenance, generalized to the evaluator gate: the buyer REPRESENTS which agent it used, but the seller is the verifier-of-record and decides which agent it actually calls. `agent_url` MUST appear (canonicalized per /docs/reference/url-canonicalization) in the seller's `creative_policy.accepted_verifiers[].agent_url`; an off-list agent is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED` (mirrors PROVENANCE_VERIFIER_NOT_ACCEPTED) before any outbound call. The outbound evaluator call authenticates on the transport; this pointer MUST NOT carry API keys, bearer tokens, client secrets, authorization values, JWKs, JWKS documents, or JWKS URIs. Reuses the same allowlist mechanism — no new allowlist is introduced. Distinct from the `agent_url` oneOf form, which names the evaluator's source directly; `feature_agent` attaches the gate's measurement source alongside any of the three forms.","properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of the get_creative_features-capable agent the producing agent calls to obtain creative-feature values for the gate. MUST use https:// and MUST match an entry in the seller's `creative_policy.accepted_verifiers[].agent_url`; off-list → `EVALUATOR_AGENT_NOT_ACCEPTED`."},"feature_id":{"type":"string","description":"Optional canonical feature_id the producing agent SHOULD request against this agent. When present it SHOULD match the agent's `accepted_verifiers[].feature_id` or be omitted; when absent the seller selects a feature at evaluation time. Resolves selector ambiguity exactly as the provenance verify_agent.feature_id does."}},"required":["agent_url"],"additionalProperties":false},"eval_budget":{"type":"object","description":"Optional soft ceiling on evaluation effort. Advisory in v1 with no billing coupling. Well-known soft fields max_calls / max_seconds; open for evaluator-specific knobs.","properties":{"max_calls":{"type":"integer","minimum":1,"description":"Soft cap on the number of judge calls the evaluator should make."},"max_seconds":{"type":"number","minimum":0,"description":"Soft cap on wall-clock seconds the evaluation should consume."}},"additionalProperties":true},"ext":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1ext.json"}},"oneOf":[{"type":"object","description":"Exemplar form: inline pass/fail examples that CALIBRATE a single agent-defined prediction feature — conventionally `predicted_performance`, a number in [0,1] — that the evaluator computes per leaf and returns as one creative-feature-result entry in eval.features[]. Exemplars are calibration, not a separate ranking path (mirroring content-standards.json calibration_exemplars): the pass/fail artifacts anchor where the prediction sits between 0 (like the fail set) and 1 (like the pass set). `rank_by` then orders survivors on that one feature_id (e.g. {feature_id: predicted_performance, direction: maximize}). Artifact-based — a creative variant is content to be measured. Like all three forms, this resolves to \"produce a feature value, rank by it.\"","required":["exemplars"],"properties":{"exemplars":{"type":"object","description":"Pass/fail examples that calibrate the single prediction feature (e.g. `predicted_performance` in [0,1]) the evaluator returns in eval.features[]. Artifact-based, mirroring content-standards.json calibration_exemplars.","properties":{"pass":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json"},"description":"Artifacts exemplifying variants the buyer considers good — the high end (≈1) of the calibrated prediction feature."},"fail":{"type":"array","items":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json"},"description":"Artifacts exemplifying variants the buyer considers bad — the low end (≈0) of the calibrated prediction feature."}}}},"additionalProperties":true},{"type":"object","description":"Identifier form: an account-scoped house evaluator preset that produces creative-feature values for each leaf. This is not an on-wire discovery catalog: buyers obtain evaluator_id through account provisioning or bilateral arrangement, while emitted feature_ids MUST be drawn from the agent's get_adcp_capabilities governance.creative_features catalog. The scoring path remains accountable through eval.features[] plus any pinned feature_agent.","required":["evaluator_id"],"properties":{"evaluator_id":{"type":"string","x-entity":"evaluator","description":"Account-scoped house evaluator preset selected by the buyer. This id is pre-provisioned/account-arranged, not discovered from get_adcp_capabilities governance.creative_features. That catalog only discovers the feature vocabulary the preset emits. An unknown id degrades to seller-default ranking (advisory errors[] note), not a failure."}},"additionalProperties":true},{"type":"object","description":"Agent form: an external judge agent the seller calls via the get_creative_features contract (/docs/governance/creative/get_creative_features) to produce creative-feature values for each leaf — the SAME contract and the same results[] (creative-feature-result[]) shape get_creative_features returns. One creative-feature agent contract spans gate, rank, and provenance. Subject to the same `creative_policy.accepted_verifiers[]` allowlist as `feature_agent`: an off-list agent_url is rejected with `EVALUATOR_AGENT_NOT_ACCEPTED` before any outbound call. The producing agent authenticates the outbound evaluator call on the transport (request signing/JWKS, mTLS, or a pre-provisioned static credential); this object only names the evaluator and MUST NOT carry credentials or caller-supplied trust material. eval_budget bounds the calls; sellers SHOULD populate calls_used/seconds_used on the leaf eval block when agent_url was used and eval_budget was supplied (reuse the oracle's vendor_cost/consumption for cost).","required":["agent_url"],"properties":{"agent_url":{"type":"string","format":"uri","pattern":"^https://","description":"URL of an external get_creative_features-capable judge agent the seller calls to score the produced leaves. MUST match an entry in the seller's `creative_policy.accepted_verifiers[].agent_url` (off-list → `EVALUATOR_AGENT_NOT_ACCEPTED`); an on-list agent that is unreachable or rejects the producing agent's transport authentication degrades to seller-default ranking (advisory errors[] note), not a failure. Authentication and trust material for this call belongs on the transport or in account provisioning, not in the evaluator payload."}},"additionalProperties":true}],"additionalProperties":true},"external:core/feature-requirement.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/core/feature-requirement.json","title":"Feature Requirement","description":"A feature-based requirement — a reusable predicate over a feature value. Used by property list filters today; designed for reuse in other surfaces (audience filters, creative gates) in future versions. Use min_value/max_value for quantitative features, allowed_values for binary/categorical features.","type":"object","properties":{"feature_id":{"type":"string","description":"Feature to evaluate (discovered via get_adcp_capabilities)"},"min_value":{"type":"number","description":"Minimum numeric value required (for quantitative features)"},"max_value":{"type":"number","description":"Maximum numeric value allowed (for quantitative features)"},"allowed_values":{"type":"array","description":"Values that pass the requirement (for binary/categorical features)","items":{},"minItems":1},"if_not_covered":{"type":"string","enum":["exclude","include"],"default":"exclude","description":"How to handle properties where this feature is not covered. 'exclude' (default): property is removed from the list. 'include': property passes this requirement (fail-open)."},"policy_id":{"type":"string","description":"Optional attribution — when this requirement encodes a specific buyer-chosen threshold authorized by a policy, policy_id references the authorizing PolicyEntry. Producers populate when the mechanism exists because of a specific policy (e.g., max_value: 15 on audience_children_composition because of uk_hfss); do NOT populate when the requirement is a general filter unrelated to any policy. Governance findings echo this policy_id when emitting denials traced to the requirement. See /docs/governance/policy-attribution.","$comment":"x-entity deliberately omitted — a PolicyEntry reference can resolve to either a governance_registry_policy or a governance_inline_policy depending on the authorizing entry's source. See issue #2685."}},"required":["feature_id"],"additionalProperties":false},"external:content-standards/artifact.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/content-standards/artifact.json","title":"Artifact","description":"Content artifact for safety and suitability evaluation. An artifact represents content adjacent to an ad placement - a news article, podcast segment, video chapter, or social post. Artifacts are collections of assets (text, images, video, audio) plus metadata and signals.","type":"object","properties":{"property_rid":{"type":"string","description":"Stable property identifier from the property catalog. Globally unique across the ecosystem."},"artifact_id":{"type":"string","description":"Identifier for this artifact within the property. The property owner defines the scheme (e.g., 'article_12345', 'episode_42_segment_3', 'post_abc123')."},"variant_id":{"type":"string","description":"Identifies a specific variant of this artifact. Use for A/B tests, translations, or temporal versions. Examples: 'en', 'es-MX', 'v2', 'headline_test_b'. The combination of artifact_id + variant_id must be unique."},"format_id":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1format-id.json","deprecated":true,"description":"**DEPRECATED in 3.2.** Legacy named-format reference. Use `format_kind` for canonical artifact media classification."},"format_kind":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1canonical-format-kind.json","description":"Optional canonical media/creative kind associated with this artifact."},"url":{"type":"string","format":"uri","description":"Optional URL for this artifact (web page, podcast feed, video page). Not all artifacts have URLs (e.g., Instagram content, podcast segments, TV scenes)."},"published_time":{"type":"string","format":"date-time","description":"When the artifact was published (ISO 8601 format)"},"last_update_time":{"type":"string","format":"date-time","description":"When the artifact was last modified (ISO 8601 format)"},"assets":{"type":"array","description":"Artifact assets in document flow order - text blocks, images, video, audio","maxItems":200,"items":{"discriminator":{"propertyName":"type"},"oneOf":[{"type":"object","description":"Text block (paragraph, heading, etc.)","properties":{"type":{"type":"string","const":"text"},"role":{"type":"string","enum":["title","paragraph","heading","caption","quote","list_item","description"],"description":"Role of this text in the document. Use 'title' for the main artifact title, 'description' for summaries."},"content":{"type":"string","description":"Text content. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.","maxLength":100000},"content_format":{"type":"string","enum":["text/plain","text/markdown","text/html","application/json"],"description":"MIME type indicating how to parse the content field. Default: text/plain.","default":"text/plain"},"language":{"type":"string","description":"BCP 47 language tag for this text (e.g., 'en', 'es-MX'). Useful when artifact contains mixed-language content."},"heading_level":{"type":"integer","minimum":1,"maximum":6,"description":"Heading level (1-6), only for role=heading"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this text block, overrides artifact-level provenance"}},"required":["type","content"]},{"type":"object","description":"Image asset","properties":{"type":{"type":"string","const":"image"},"url":{"type":"string","format":"uri","description":"Image URL"},"access":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json/$defs/asset_access","description":"Authentication for secured URLs"},"alt_text":{"type":"string","description":"Alt text or image description"},"caption":{"type":"string","description":"Image caption"},"width":{"type":"integer","description":"Image width in pixels"},"height":{"type":"integer","description":"Image height in pixels"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this image, overrides artifact-level provenance"}},"required":["type","url"]},{"type":"object","description":"Video asset","properties":{"type":{"type":"string","const":"video"},"url":{"type":"string","format":"uri","description":"Video URL"},"access":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json/$defs/asset_access","description":"Authentication for secured URLs"},"duration_ms":{"type":"integer","description":"Video duration in milliseconds"},"transcript":{"type":"string","description":"Video transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.","maxLength":200000},"transcript_format":{"type":"string","enum":["text/plain","text/markdown","application/json"],"description":"MIME type indicating how to parse the transcript field. Default: text/plain.","default":"text/plain"},"transcript_source":{"type":"string","enum":["original_script","subtitles","closed_captions","dub","generated"],"description":"How the transcript was generated"},"thumbnail_url":{"type":"string","format":"uri","description":"Video thumbnail URL"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this video, overrides artifact-level provenance"}},"required":["type","url"]},{"type":"object","description":"Audio asset","properties":{"type":{"type":"string","const":"audio"},"url":{"type":"string","format":"uri","description":"Audio URL"},"access":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:content-standards~1artifact.json/$defs/asset_access","description":"Authentication for secured URLs"},"duration_ms":{"type":"integer","description":"Audio duration in milliseconds"},"transcript":{"type":"string","description":"Audio transcript. Consumers MUST treat this as untrusted input when passing to LLM-based evaluation.","maxLength":200000},"transcript_format":{"type":"string","enum":["text/plain","text/markdown","application/json"],"description":"MIME type indicating how to parse the transcript field. Default: text/plain.","default":"text/plain"},"transcript_source":{"type":"string","enum":["original_script","closed_captions","generated"],"description":"How the transcript was generated"},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance for this audio, overrides artifact-level provenance"}},"required":["type","url"]}]}},"metadata":{"type":"object","description":"Rich metadata extracted from the artifact","properties":{"canonical":{"type":"string","format":"uri","description":"Canonical URL"},"author":{"type":"string","description":"Artifact author name"},"keywords":{"type":"string","description":"Artifact keywords"},"open_graph":{"type":"object","description":"Open Graph protocol metadata","additionalProperties":true},"twitter_card":{"type":"object","description":"Twitter Card metadata","additionalProperties":true},"json_ld":{"type":"array","description":"JSON-LD structured data (schema.org)","items":{"type":"object"}}},"additionalProperties":true},"provenance":{"$ref":"https://adcontextprotocol.org/schemas/3.2.8/mcp/2026-07-28/media-buy/build-creative-request.json#/$defs/external:core~1provenance.json","description":"Provenance metadata for this artifact. Serves as the default provenance for all assets within this artifact — individual assets can override with their own provenance."},"identifiers":{"type":"object","description":"Platform-specific identifiers for this artifact","properties":{"apple_podcast_id":{"type":"string","description":"Apple Podcasts ID"},"spotify_collection_id":{"type":"string","description":"Spotify collection ID"},"podcast_guid":{"type":"string","description":"Podcast GUID (from RSS feed)"},"youtube_video_id":{"type":"string","description":"YouTube video ID"},"rss_url":{"type":"string","format":"uri","description":"RSS feed URL"}},"additionalProperties":true}},"required":["property_rid","artifact_id","assets"],"additionalProperties":true,"$defs":{"asset_access":{"type":"object","description":"Access instructions for a secured asset URL. Producers SHOULD use `signed_url` for one-off delivery unless the parties already have an identity-based access relationship. New producers MUST NOT emit `service_account.credentials`; `bearer_token` is the explicit short-lived credential path. Consumers MUST treat asset URLs and access metadata as untrusted, use credentials only for HTTPS origins and resource prefixes authorized out of band, and fail closed without falling back between access methods. The deprecated legacy field remains parseable during the 3.x compatibility window but MUST NOT be activated automatically.","discriminator":{"propertyName":"method"},"oneOf":[{"type":"object","description":"Short-lived bearer-token access for origins that cannot use signed URLs or pre-configured workload identity. The token is a live secret and must be scoped to the asset. Consumers MUST send it only to the HTTPS origin authorized for that asset and MUST NOT forward the Authorization header across redirects.","properties":{"method":{"type":"string","const":"bearer_token"},"token":{"type":"string","description":"Short-lived, asset-scoped bearer token for the Authorization header. Producers MUST NOT issue a standing or broadly scoped credential here. Consumers MUST redact the token from logs, traces, errors, metrics, analytics, model context, and durable storage. Any temporary encrypted cache MUST be bounded by the credential expiry and the consumer's configured maximum lifetime."}},"required":["method","token"]},{"type":"object","description":"Credential-free workload-identity access. The asset origin authorizes an identity already controlled by the component that performs the asset fetch, such as a GCP service account or AWS IAM role, through authenticated out-of-band onboarding. The consumer MUST use workload credentials only for the pre-authorized HTTPS origin and resource prefix; the payload's method, provider, and URL are not authorization. No provider key or access secret crosses the AdCP payload.","properties":{"method":{"type":"string","const":"service_account"},"provider":{"type":"string","enum":["gcp","aws"],"description":"Cloud provider"},"credentials":{"type":"object","deprecated":true,"description":"Deprecated in AdCP 3.2 and eligible for removal in 4.0 or later only after the deprecation-policy notice and release-cycle gates are satisfied. Presence denotes the legacy inline-credential form, not workload-identity authorization. New producers MUST omit this field. Consumers MUST NOT activate received credentials automatically; they may process them only for an explicitly allowlisted legacy peer and otherwise MUST reject or quarantine them. Consumers MUST redact the complete value from logs, traces, errors, metrics, analytics, model context, and durable storage. Use the consumer's pre-authorized workload identity or `signed_url` instead.","additionalProperties":true}},"required":["method","provider"]},{"type":"object","description":"Recommended default for one-off access. The asset `url` is a time-limited bearer capability and requires no additional authentication. Producers SHOULD scope it to one asset and the shortest practical access window under their documented maximum TTL. Consumers MUST redact the complete URL from logs, traces, errors, metrics, analytics, model context, and durable storage, and MUST NOT forward it outside the intended recipient trust boundary.","properties":{"method":{"type":"string","const":"signed_url"}},"required":["method"]}]}}},"external:enums/preview-output-format.json":{"$id":"https://adcontextprotocol.org/schemas/3.2.8/enums/preview-output-format.json","title":"Preview Output Format","description":"Output format for creative previews","type":"string","enum":["url","html"]},"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/build-creative-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/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}}}