@adcp/sdk 13.1.2 → 13.1.4

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "13.1.2";
+export declare const RUNNER_CAPABILITY_VERSION = "13.1.4";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "13.1.2";
+export declare const RUNNER_CAPABILITY_VERSION = "13.1.4";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/types/build-creative.d.ts

@@ -1499,10 +1499,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -1526,10 +1523,7 @@ export interface DAASTTrackerAsset {
      * 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`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -1904,6 +1898,11 @@ export interface LegacyManifestNamedFormatReference {
     ext?: ExtensionObject;
 }
 
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
+
 /**
  * Manifest declares which canonical format it targets via `format_kind` (e.g., `image`). This 3.1+ canonical-format path was introduced by RFC #3305.
  */
@@ -2036,10 +2035,7 @@ export interface PixelTrackerAsset {
      * Matches 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.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -2830,10 +2826,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -2893,10 +2886,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -2920,10 +2910,7 @@ export interface VASTTrackerAsset {
      * 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`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/comply-test-controller.d.ts

@@ -4450,10 +4450,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -4482,10 +4479,7 @@ export interface DAASTTrackerAsset {
      * 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`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -6698,6 +6692,11 @@ export interface ListScenariosSuccess {
     ext?: ExtensionObject;
 }
 
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
+
 /**
  * Remedy types available when a performance standard or billing measurement threshold is breached.
  */
@@ -7588,10 +7587,7 @@ export interface PixelTrackerAsset {
      * Matches 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.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -10796,10 +10792,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -11089,10 +11082,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -11116,10 +11106,7 @@ export interface VASTTrackerAsset {
      * 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`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/core.generated.d.mts

@@ -2158,10 +2158,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -2180,6 +2177,10 @@ export type VASTVersion = '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
  * Tracking events for video 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). `fullscreen` / `exitFullscreen` are retained for VAST 2.x / 3.x compatibility (VAST 4.0+ replaced them with `playerExpand` / `playerCollapse`). `measurableImpression` is an AdCP extension for MRC measurability signals.
  */
 export type VASTTrackingEvent = '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';
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
 /**
  * Mechanism a receiver uses to invoke this URL (distinct from purpose, which lives in `url-asset-requirements.role`): `clickthrough` for user click destination (landing page), `tracker_pixel` for impression/event tracking via HTTP request (fires GET, expects pixel/204 response), `tracker_script` for measurement SDKs that must load as a <script> tag (OMID verification, native event trackers using method:2). SHOULD be present on every URL asset; senders that omit it force the receiver into the role-based fallback described in this schema's top-level description.
  */
@@ -2236,10 +2237,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -2471,10 +2469,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -3053,10 +3048,7 @@ export interface PixelTrackerAsset {
      * Matches 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.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -3075,10 +3067,7 @@ export interface VASTTrackerAsset {
      * 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`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -3102,10 +3091,7 @@ export interface DAASTTrackerAsset {
      * 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`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$

package/dist/lib/types/core.generated.d.ts

@@ -2158,10 +2158,7 @@ export type VASTAsset = {
      * Discriminator indicating VAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating VAST is delivered as inline XML content
@@ -2180,6 +2177,10 @@ export type VASTVersion = '2.0' | '3.0' | '4.0' | '4.1' | '4.2';
  * Tracking events for video 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). `fullscreen` / `exitFullscreen` are retained for VAST 2.x / 3.x compatibility (VAST 4.0+ replaced them with `playerExpand` / `playerCollapse`). `measurableImpression` is an AdCP extension for MRC measurability signals.
  */
 export type VASTTrackingEvent = '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';
+/**
+ * URL endpoint that returns VAST XML. May carry unsubstituted ad-server macros — VAST-style `[MACRO]`, `${MACRO}`, and `%%MACRO%%` placeholders are accepted as-is; buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
+ */
+export type MacroBearingURL = string;
 /**
  * Mechanism a receiver uses to invoke this URL (distinct from purpose, which lives in `url-asset-requirements.role`): `clickthrough` for user click destination (landing page), `tracker_pixel` for impression/event tracking via HTTP request (fires GET, expects pixel/204 response), `tracker_script` for measurement SDKs that must load as a <script> tag (OMID verification, native event trackers using method:2). SHOULD be present on every URL asset; senders that omit it force the receiver into the role-based fallback described in this schema's top-level description.
  */
@@ -2236,10 +2237,7 @@ export type DAASTAsset = {
      * Discriminator indicating DAAST is delivered via URL endpoint
      */
     delivery_type: 'url';
-    /**
-     * URL endpoint that returns DAAST XML. May carry unsubstituted ad-server macros — DAAST/VAST-style `[MACRO]` and `${MACRO}` placeholders are accepted as-is (RFC 6570 syntax); buyers MUST NOT pre-encode macro delimiters, since players match the literal token at substitution time.
-     */
-    url: string;
+    url: MacroBearingURL;
 } | {
     /**
      * Discriminator indicating DAAST is delivered as inline XML content
@@ -2471,10 +2469,7 @@ export interface URLAsset {
      * Discriminator identifying this as a URL asset. See /schemas/creative/asset-types for the registry.
      */
     asset_type: 'url';
-    /**
-     * URL reference. May be a plain URI or an RFC 6570 URI template carrying AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`). Buyers MUST NOT pre-encode macro braces at sync time; the ad server URL-encodes substituted values at impression time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     url_type?: URLAssetType;
     /**
      * Description of what this URL points to
@@ -3053,10 +3048,7 @@ export interface PixelTrackerAsset {
      * Matches 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.
      */
     method?: 'img' | 'js';
-    /**
-     * Tracker URL fired when `event` occurs. May carry AdCP universal macros (e.g., `{MEDIA_BUY_ID}`, `{CREATIVE_ID}`, `{CACHEBUSTER}`); the seller's renderer URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * REQUIRED when `event` is `custom`; otherwise MUST be absent. Adopter-defined event name. Sellers without registered handling for a given custom_event_name MUST silently no-op (do not fire) rather than reject — custom events are forward-compatible probes.
      */
@@ -3075,10 +3067,7 @@ export interface VASTTrackerAsset {
      * 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`).
      */
     vast_event: VASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `vast_event` occurs. May carry AdCP universal macros (e.g., `{SKU}`, `{MEDIA_BUY_ID}`); the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * VAST `offset` attribute. Required when `vast_event` is `progress`; ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$
@@ -3102,10 +3091,7 @@ export interface DAASTTrackerAsset {
      * 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`).
      */
     daast_event: DAASTTrackingEvent;
-    /**
-     * Tracker URL that fires when `daast_event` occurs. May carry AdCP universal macros; the sales agent or ad server URL-encodes substituted values at serve time. See docs/creative/universal-macros.mdx.
-     */
-    url: string;
+    url: MacroBearingURL;
     /**
      * DAAST `offset` attribute. Required when `daast_event` is `progress` (DAAST 1.1 §3.2.4.3); ignored otherwise. 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.
      * @pattern ^(\d{2}:[0-5]\d:[0-5]\d(\.\d{3})?|(100|\d{1,2})%)$