Video Ads

​

Hosted video

{
  "format_option_id": "preroll_30s_hosted",
  "format_kind": "video_hosted",
  "params": {
    "width": 1920,
    "height": 1080,
    "duration_ms_exact": 30000,
    "containers": ["mp4"],
    "video_codecs": ["h264"],
    "audio_codecs": ["aac"],
    "max_file_size_kb": 51200,
    "slots": [
      { "asset_group_id": "video_main", "asset_type": "video", "required": true },
      { "asset_group_id": "landing_page_url", "asset_type": "url", "required": false }
    ]
  }
}

{
  "format_kind": "video_hosted",
  "assets": {
    "video_main": {
      "asset_type": "video",
      "url": "https://cdn.acmeoutdoor.example/trail-pro-30s.mp4",
      "width": 1920,
      "height": 1080,
      "duration_ms": 30000,
      "container_format": "mp4",
      "codec": "h264"
    }
  }
}

​

VAST

{
  "technical_requirements_complete": true,
  "format_kind": "video_vast",
  "params": {
    "duration_ms_range": [15000, 30000],
    "vast_versions": ["3.0", "4.0", "4.1", "4.2"],
    "media_file_requirements": {
      "delivery_methods": ["progressive"],
      "mime_types": ["video/mp4"],
      "containers": ["mp4"],
      "codecs": ["avc1.4d401f"],
      "min_width": 1280,
      "max_width": 1920,
      "min_height": 720,
      "max_height": 1080,
      "min_bitrate_kbps": 1500,
      "max_bitrate_kbps": 8000,
      "max_file_size_bytes": 50000000
    },
    "slots": [{ "asset_group_id": "vast_tag", "asset_type": "vast", "required": true }]
  }
}

asset.vast_version
  ∈ product.format_option.params.vast_versions
  ∩ seller.execution.creative_specs.vast_versions

​

MediaFile technical acceptance

​

VAST Validation

• MUST parse the document (inline content, or one response fetched from url) as XML and reject unparseable documents with VAST_PARSE_FAILED (error.details.reason: "not_xml").
• MUST reject documents whose root element is not <VAST> with VAST_PARSE_FAILED (error.details.reason: "no_vast_root").
• MUST reject the submitted document when its <VAST version> attribute is missing or differs from the asset’s singular vast_version. The asset declaration describes this submitted URL response or inline document, not every later wrapper hop.
• MUST reject an asset whose vast_version is outside the product params.vast_versions and seller creative_specs.vast_versions intersection with VAST_VERSION_MISMATCH.
• MUST emit mismatch_reason: "asset_outside_acceptance", asset_vast_version, product_vast_versions, and seller_vast_versions for an acceptance-set failure. Include format_option_ref only when the selected option is addressable; a unique id-less option has no reference to invent.
• MUST emit mismatch_reason: "document_version_mismatch", asset_vast_version, raw observed_document_vast_version, and document_role when an inspected document violates its applicable version rule. For wrapper and terminal_inline roles, also emit product_vast_versions and seller_vast_versions, plus format_option_ref when the selected option is addressable, because those documents are compared with the acceptance intersection. Use null when the required version attribute is missing; preserve unknown/future strings verbatim for diagnosis. supported_versions remains a deprecated compatibility field for older 3.x peers.
• MUST make VAST_VERSION_MISMATCH details conform to error-details/vast-version-mismatch.json.
• SHOULD reject documents containing no <Ad> element, and <InLine> linear creatives carrying no <MediaFile>, with VAST_PARSE_FAILED (error.details.reason: "no_ad" / "no_media_file").
• MUST evaluate declared media_file_requirements against each applicable <InLine> linear creative and reject a creative for which no single <MediaFile> satisfies the full declared set. A document-level check evaluates the fetched document; wrapper-level validation evaluates the terminal resolved <InLine> document.
• SHOULD verify that media, tracking, and click URLs use HTTPS.
• MUST preserve undeclared macro tokens as opaque bytes. When an asset supplies macro_declarations, validate each token against the product and seller macro-resolution capability intersection and report per-token results.

• MUST resolve <Wrapper> redirects via <VASTAdTagURI> up to the format’s declared max_wrapper_depth (when present) and reject deeper chains with VAST_WRAPPER_DEPTH_EXCEEDED (error.details.reason: "depth").
• MUST reject chains that revisit a <VASTAdTagURI> already seen (a loop) with VAST_WRAPPER_DEPTH_EXCEEDED (error.details.reason: "loop").
• SHOULD apply a per-hop timeout, rejecting with VAST_WRAPPER_DEPTH_EXCEEDED (error.details.reason: "timeout"), and MUST fetch wrapper hops over HTTPS only.
• MUST parse every fetched wrapper and the terminal <InLine> document, and require each observed document version to be in the product/seller acceptance intersection. Only the submitted document is compared for equality with the asset’s singular declaration; wrapper and terminal documents are not relabeled as the outer asset.

​

Vertical and flexible video