@adcp/sdk 5.23.0

package/dist/lib/schemas-data/3.0.1/bundled/media-buy/update-media-buy-response.json

@@ -0,0 +1,2799 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "/schemas/3.0.1/bundled/media-buy/update-media-buy-response.json",
+  "title": "Update Media Buy Response",
+  "description": "Response payload for update_media_buy task. Returns either complete success data OR error information, never both. This enforces atomic operation semantics - updates are either fully applied or not applied at all.",
+  "type": "object",
+  "oneOf": [
+    {
+      "title": "UpdateMediaBuySuccess",
+      "description": "Success response - media buy updated successfully",
+      "type": "object",
+      "properties": {
+        "media_buy_id": {
+          "type": "string",
+          "description": "Seller's identifier for the media buy",
+          "x-entity": "media_buy"
+        },
+        "status": {
+          "title": "Media Buy Status",
+          "description": "Media buy status after the update. Present when the update changes the media buy's status (e.g., cancellation transitions to 'canceled', pause transitions to 'paused').",
+          "type": "string",
+          "enum": [
+            "pending_creatives",
+            "pending_start",
+            "active",
+            "paused",
+            "completed",
+            "rejected",
+            "canceled"
+          ],
+          "enumDescriptions": {
+            "pending_creatives": "Media buy is approved but has no creatives assigned. The buyer must attach creatives via sync_creatives before the buy can serve.",
+            "pending_start": "Media buy is ready to serve and waiting for its flight date to begin.",
+            "active": "Media buy is currently running",
+            "paused": "Media buy is temporarily paused",
+            "completed": "Media buy has finished running",
+            "rejected": "Media buy was declined by the seller after creation",
+            "canceled": "Media buy was terminated before natural completion. Check cancellation.canceled_by to determine whether the buyer or seller initiated."
+          }
+        },
+        "revision": {
+          "type": "integer",
+          "description": "Revision number after this update. Use this value in subsequent update_media_buy requests for optimistic concurrency.",
+          "minimum": 1
+        },
+        "implementation_date": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "format": "date-time",
+          "description": "ISO 8601 timestamp when changes take effect (null if pending approval)"
+        },
+        "invoice_recipient": {
+          "title": "Business Entity",
+          "description": "Updated invoice recipient, echoed from the request when provided. Confirms the seller accepted the billing override. Bank details are omitted (write-only).",
+          "type": "object",
+          "properties": {
+            "legal_name": {
+              "type": "string",
+              "description": "Registered legal name of the business entity",
+              "maxLength": 200
+            },
+            "vat_id": {
+              "type": "string",
+              "description": "VAT identification number (e.g., DE123456789 for Germany, FR12345678901 for France). Required for B2B invoicing in the EU. Must be normalized: no spaces, dots, or dashes.",
+              "pattern": "^[A-Z]{2}[A-Z0-9]{2,13}$"
+            },
+            "tax_id": {
+              "type": "string",
+              "description": "Tax identification number for jurisdictions that do not use VAT (e.g., US EIN)",
+              "maxLength": 30
+            },
+            "registration_number": {
+              "type": "string",
+              "description": "Company registration number (e.g., HRB 12345 for German Handelsregister)",
+              "maxLength": 50
+            },
+            "address": {
+              "type": "object",
+              "description": "Postal address for invoicing and legal correspondence",
+              "properties": {
+                "street": {
+                  "type": "string",
+                  "description": "Street address including building number",
+                  "maxLength": 200
+                },
+                "city": {
+                  "type": "string",
+                  "maxLength": 100
+                },
+                "postal_code": {
+                  "type": "string",
+                  "maxLength": 20
+                },
+                "region": {
+                  "type": "string",
+                  "description": "State, province, or region",
+                  "maxLength": 100
+                },
+                "country": {
+                  "type": "string",
+                  "description": "ISO 3166-1 alpha-2 country code",
+                  "pattern": "^[A-Z]{2}$"
+                }
+              },
+              "required": [
+                "street",
+                "city",
+                "postal_code",
+                "country"
+              ],
+              "additionalProperties": false
+            },
+            "contacts": {
+              "type": "array",
+              "description": "Contacts for billing, legal, and operational matters. Contains personal data subject to GDPR and equivalent regulations. Implementations MUST use this data only for invoicing and account management.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "role": {
+                    "type": "string",
+                    "enum": [
+                      "billing",
+                      "legal",
+                      "creative",
+                      "general"
+                    ],
+                    "enumDescriptions": {
+                      "billing": "Accounts payable and invoice queries",
+                      "legal": "Contract and compliance matters",
+                      "creative": "Material submission and creative approval",
+                      "general": "Default contact when no specific role applies"
+                    },
+                    "description": "Contact's functional role in the business relationship"
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "Full name of the contact",
+                    "maxLength": 200
+                  },
+                  "email": {
+                    "type": "string",
+                    "format": "email",
+                    "maxLength": 254
+                  },
+                  "phone": {
+                    "type": "string",
+                    "maxLength": 30
+                  }
+                },
+                "required": [
+                  "role"
+                ],
+                "additionalProperties": false
+              },
+              "maxItems": 10
+            },
+            "bank": {
+              "type": "object",
+              "writeOnly": true,
+              "description": "Bank account details for payment processing. Write-only: included in requests to provide payment coordinates, but MUST NOT be echoed in responses. Sellers store these details and confirm receipt without returning them.",
+              "properties": {
+                "account_holder": {
+                  "type": "string",
+                  "description": "Name on the bank account",
+                  "maxLength": 200
+                },
+                "iban": {
+                  "type": "string",
+                  "description": "International Bank Account Number (SEPA markets)",
+                  "pattern": "^[A-Z]{2}[0-9]{2}[A-Z0-9]{4,30}$"
+                },
+                "bic": {
+                  "type": "string",
+                  "description": "Bank Identifier Code / SWIFT code (SEPA markets)",
+                  "pattern": "^[A-Z]{4}[A-Z]{2}[A-Z0-9]{2}([A-Z0-9]{3})?$"
+                },
+                "routing_number": {
+                  "type": "string",
+                  "description": "Bank routing number for non-SEPA markets (e.g., US ABA routing number, Canadian transit/institution number)",
+                  "maxLength": 30
+                },
+                "account_number": {
+                  "type": "string",
+                  "description": "Bank account number for non-SEPA markets",
+                  "maxLength": 30
+                }
+              },
+              "required": [
+                "account_holder"
+              ],
+              "additionalProperties": false
+            },
+            "ext": {
+              "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
+            }
+          },
+          "required": [
+            "legal_name"
+          ],
+          "additionalProperties": false,
+          "examples": [
+            {
+              "description": "German agency with full B2B details",
+              "data": {
+                "legal_name": "Pinnacle Media GmbH",
+                "vat_id": "DE123456789",
+                "registration_number": "HRB 12345",
+                "address": {
+                  "street": "Friedrichstrasse 100",
+                  "city": "Berlin",
+                  "postal_code": "10117",
+                  "country": "DE"
+                },
+                "contacts": [
+                  {
+                    "role": "billing",
+                    "name": "Sam Adeyemi",
+                    "email": "billing@pinnacle-media.com",
+                    "phone": "+49 30 12345678"
+                  }
+                ],
+                "bank": {
+                  "account_holder": "Pinnacle Media GmbH",
+                  "iban": "DE89370400440532013000",
+                  "bic": "COBADEFFXXX"
+                }
+              }
+            },
+            {
+              "description": "US advertiser with EIN and domestic bank details",
+              "data": {
+                "legal_name": "Acme Corporation",
+                "tax_id": "12-3456789",
+                "address": {
+                  "street": "123 Main St",
+                  "city": "New York",
+                  "postal_code": "10001",
+                  "region": "NY",
+                  "country": "US"
+                },
+                "contacts": [
+                  {
+                    "role": "billing",
+                    "name": "AP Department",
+                    "email": "ap@acme-corp.com"
+                  }
+                ],
+                "bank": {
+                  "account_holder": "Acme Corporation",
+                  "routing_number": "021000021",
+                  "account_number": "123456789"
+                }
+              }
+            }
+          ]
+        },
+        "affected_packages": {
+          "type": "array",
+          "description": "Array of packages that were modified with complete state information",
+          "items": {
+            "title": "Package",
+            "description": "A specific product within a media buy (line item)",
+            "type": "object",
+            "properties": {
+              "package_id": {
+                "type": "string",
+                "description": "Seller's unique identifier for the package",
+                "x-entity": "package"
+              },
+              "product_id": {
+                "type": "string",
+                "description": "ID of the product this package is based on",
+                "x-entity": "product"
+              },
+              "budget": {
+                "type": "number",
+                "description": "Budget allocation for this package in the currency specified by the pricing option",
+                "minimum": 0
+              },
+              "pacing": {
+                "title": "Pacing",
+                "description": "Budget pacing strategy",
+                "type": "string",
+                "enum": [
+                  "even",
+                  "asap",
+                  "front_loaded"
+                ],
+                "enumDescriptions": {
+                  "even": "Allocate remaining budget evenly over remaining campaign duration (default)",
+                  "asap": "Spend remaining budget as quickly as possible",
+                  "front_loaded": "Allocate more remaining budget earlier in the remaining campaign period"
+                }
+              },
+              "pricing_option_id": {
+                "type": "string",
+                "description": "ID of the selected pricing option from the product's pricing_options array",
+                "x-entity": "product_pricing_option"
+              },
+              "bid_price": {
+                "type": "number",
+                "description": "Bid price for auction-based pricing. This is the exact bid/price to honor unless the selected pricing option has max_bid=true, in which case bid_price is the buyer's maximum willingness to pay (ceiling).",
+                "minimum": 0
+              },
+              "price_breakdown": {
+                "description": "Breaks down the composition of fixed_price from a list (rate card) price through adjustments. Adjustments fall into four kinds: fees (increase buyer price), discounts (reduce buyer price), commissions (revenue splits that don't affect buyer price), and settlement terms (applied at invoicing). The invariant is: list_price with all fee and discount adjustments applied sequentially equals fixed_price. Fees increase the running price; discounts reduce it. This invariant applies only when fixed_price is present on the parent object; on auction-based packages the breakdown is informational only. All monetary values are rounded to currency precision at each step. Budgets are always denominated at the fixed_price level, inclusive of commissions.",
+                "title": "Price Breakdown",
+                "type": "object",
+                "properties": {
+                  "list_price": {
+                    "type": "number",
+                    "description": "Rate card or base price before any adjustments. The starting point from which fixed_price is derived by applying fee and discount adjustments sequentially.",
+                    "exclusiveMinimum": 0
+                  },
+                  "adjustments": {
+                    "type": "array",
+                    "description": "Ordered list of price adjustments. Fee and discount adjustments walk list_price to fixed_price — fees increase the running price, discounts reduce it. Commission and settlement adjustments are disclosed for transparency but do not affect the buyer's committed price.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "kind": {
+                          "title": "Price Adjustment Kind",
+                          "description": "Categorizes how a price adjustment affects the transaction",
+                          "type": "string",
+                          "enum": [
+                            "fee",
+                            "discount",
+                            "commission",
+                            "settlement"
+                          ],
+                          "enumDescriptions": {
+                            "fee": "Increases the price the buyer pays and the revenue the seller receives. Applied between list_price and fixed_price (e.g., ad serving fees, data/targeting surcharges, brand safety verification).",
+                            "discount": "Reduces the price the buyer pays and the revenue the seller receives. Applied between list_price and fixed_price (e.g., volume discounts, negotiated rates, early booking).",
+                            "commission": "Does not change the buyer's price or budget. Represents a revenue split — the portion retained by an intermediary (e.g., agency commission). Budgets are managed inclusive of commissions.",
+                            "settlement": "Does not change the committed price or budget. Applied at invoicing or payment time (e.g., cash discount for early payment). Informational for buyer agents; affects actual settlement amount."
+                          }
+                        },
+                        "name": {
+                          "type": "string",
+                          "description": "Specific adjustment name. Use well-known values where applicable for interoperability.",
+                          "maxLength": 64,
+                          "examples": [
+                            "ad_serving",
+                            "data_targeting",
+                            "brand_safety",
+                            "volume",
+                            "negotiated",
+                            "early_booking",
+                            "agency",
+                            "intermediary",
+                            "cash_discount",
+                            "early_payment"
+                          ]
+                        },
+                        "rate": {
+                          "type": "number",
+                          "description": "Adjustment as a decimal proportion (e.g., 0.15 for 15%). Always positive — kind determines the economic effect. Mutually exclusive with amount.",
+                          "exclusiveMinimum": 0,
+                          "exclusiveMaximum": 1
+                        },
+                        "amount": {
+                          "type": "number",
+                          "description": "Adjustment as a fixed monetary amount in the pricing option's currency. Always positive — kind determines the economic effect. Mutually exclusive with rate.",
+                          "exclusiveMinimum": 0
+                        },
+                        "description": {
+                          "type": "string",
+                          "description": "Human-readable description of this adjustment (e.g., 'Malstaffel 12x', '2% Skonto 10 Tage')",
+                          "maxLength": 256
+                        },
+                        "beneficiary": {
+                          "type": "string",
+                          "description": "Identifies who receives this adjustment's value. For commissions, the intermediary (e.g., a sellers.json domain, an AdCP account ID, or a human-readable party name). Optional but recommended for multi-intermediary transparency.",
+                          "maxLength": 256
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "name"
+                      ],
+                      "oneOf": [
+                        {
+                          "required": [
+                            "rate"
+                          ]
+                        },
+                        {
+                          "required": [
+                            "amount"
+                          ]
+                        }
+                      ],
+                      "additionalProperties": true
+                    },
+                    "minItems": 1,
+                    "maxItems": 20
+                  }
+                },
+                "required": [
+                  "list_price",
+                  "adjustments"
+                ],
+                "additionalProperties": true
+              },
+              "impressions": {
+                "type": "number",
+                "description": "Impression goal for this package",
+                "minimum": 0
+              },
+              "catalogs": {
+                "type": "array",
+                "description": "Catalogs this package promotes. Each catalog MUST have a distinct type (e.g., one product catalog, one store catalog). This constraint is enforced at the application level — sellers MUST reject requests containing multiple catalogs of the same type with a validation_error. Echoed from the create_media_buy request.",
+                "items": {
+                  "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": {
+                      "title": "Catalog Type",
+                      "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.",
+                      "type": "string",
+                      "enum": [
+                        "offering",
+                        "product",
+                        "inventory",
+                        "store",
+                        "promotion",
+                        "hotel",
+                        "flight",
+                        "job",
+                        "vehicle",
+                        "real_estate",
+                        "education",
+                        "destination",
+                        "app"
+                      ]
+                    },
+                    "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": {
+                      "title": "Feed Format",
+                      "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.",
+                      "type": "string",
+                      "enum": [
+                        "google_merchant_center",
+                        "facebook_catalog",
+                        "shopify",
+                        "linkedin_jobs",
+                        "custom"
+                      ]
+                    },
+                    "update_frequency": {
+                      "title": "Update Frequency",
+                      "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.",
+                      "type": "string",
+                      "enum": [
+                        "realtime",
+                        "hourly",
+                        "daily",
+                        "weekly"
+                      ]
+                    },
+                    "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 specific item IDs. For offering-type catalogs, these are offering_id values. For product-type catalogs, these are SKU identifiers.",
+                      "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": "#/$defs/EventType"
+                      },
+                      "minItems": 1,
+                      "uniqueItems": true
+                    },
+                    "content_id_type": {
+                      "title": "Content ID Type",
+                      "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.",
+                      "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"
+                      ]
+                    },
+                    "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": {
+                        "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": {
+                            "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
+                          }
+                        },
+                        "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
+                            }
+                          }
+                        ]
+                      },
+                      "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"
+                              }
+                            ]
+                          }
+                        ]
+                      }
+                    }
+                  ]
+                }
+              },
+              "format_ids": {
+                "type": "array",
+                "description": "Format IDs active for this package. Echoed from the create_media_buy request; omitted means all formats for the product are active.",
+                "items": {
+                  "title": "Format Reference (Structured Object)",
+                  "description": "A JSON object — never a plain string — that identifies a creative format by its declaring agent and local slug. Required properties: agent_url (URI of the agent that owns the format) and id (slug matching [a-zA-Z0-9_-]+). Example: {\"agent_url\": \"https://creative.adcontextprotocol.org\", \"id\": \"display_300x250\"}. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants. Using a plain string here is a schema violation.",
+                  "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."
+                    }
+                  },
+                  "required": [
+                    "agent_url",
+                    "id"
+                  ],
+                  "additionalProperties": true,
+                  "dependencies": {
+                    "width": [
+                      "height"
+                    ],
+                    "height": [
+                      "width"
+                    ]
+                  }
+                }
+              },
+              "targeting_overlay": {
+                "title": "Targeting Overlay",
+                "description": "Optional restriction overlays for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are for functional restrictions: geographic (RCT testing, regulatory compliance, proximity targeting), age verification (alcohol, gambling), device platform (app compatibility), language (localization), and keyword targeting (search/retail media).",
+                "type": "object",
+                "properties": {
+                  "geo_countries": {
+                    "type": "array",
+                    "description": "Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^[A-Z]{2}$"
+                    },
+                    "minItems": 1
+                  },
+                  "geo_countries_exclude": {
+                    "type": "array",
+                    "description": "Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^[A-Z]{2}$"
+                    },
+                    "minItems": 1
+                  },
+                  "geo_regions": {
+                    "type": "array",
+                    "description": "Restrict delivery to specific regions/states. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^[A-Z]{2}-[A-Z0-9]{1,3}$"
+                    },
+                    "minItems": 1
+                  },
+                  "geo_regions_exclude": {
+                    "type": "array",
+                    "description": "Exclude specific regions/states from delivery. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^[A-Z]{2}-[A-Z0-9]{1,3}$"
+                    },
+                    "minItems": 1
+                  },
+                  "geo_metros": {
+                    "type": "array",
+                    "description": "Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "system": {
+                          "$ref": "#/$defs/MetroAreaSystem"
+                        },
+                        "values": {
+                          "type": "array",
+                          "description": "Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)",
+                          "items": {
+                            "type": "string"
+                          },
+                          "minItems": 1
+                        }
+                      },
+                      "required": [
+                        "system",
+                        "values"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  },
+                  "geo_metros_exclude": {
+                    "type": "array",
+                    "description": "Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "system": {
+                          "$ref": "#/$defs/MetroAreaSystem"
+                        },
+                        "values": {
+                          "type": "array",
+                          "description": "Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)",
+                          "items": {
+                            "type": "string"
+                          },
+                          "minItems": 1
+                        }
+                      },
+                      "required": [
+                        "system",
+                        "values"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  },
+                  "geo_postal_areas": {
+                    "type": "array",
+                    "description": "Restrict delivery to specific postal areas. Each entry specifies the postal system and target values. Seller must declare supported systems in get_adcp_capabilities.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "system": {
+                          "$ref": "#/$defs/PostalCodeSystem"
+                        },
+                        "values": {
+                          "type": "array",
+                          "description": "Postal codes within the system (e.g., ['10001', '10002'] for us_zip)",
+                          "items": {
+                            "type": "string"
+                          },
+                          "minItems": 1
+                        }
+                      },
+                      "required": [
+                        "system",
+                        "values"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  },
+                  "geo_postal_areas_exclude": {
+                    "type": "array",
+                    "description": "Exclude specific postal areas from delivery. Each entry specifies the postal system and excluded values. Seller must declare supported systems in get_adcp_capabilities.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "system": {
+                          "$ref": "#/$defs/PostalCodeSystem"
+                        },
+                        "values": {
+                          "type": "array",
+                          "description": "Postal codes to exclude within the system (e.g., ['10001', '10002'] for us_zip)",
+                          "items": {
+                            "type": "string"
+                          },
+                          "minItems": 1
+                        }
+                      },
+                      "required": [
+                        "system",
+                        "values"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  },
+                  "daypart_targets": {
+                    "type": "array",
+                    "description": "Restrict delivery to specific time windows. Each entry specifies days of week and an hour range.",
+                    "items": {
+                      "title": "Daypart Target",
+                      "description": "A time window for daypart targeting. Specifies days of week and an hour range. start_hour is inclusive, end_hour is exclusive (e.g., 6-10 = 6:00am to 10:00am). Follows the Google Ads AdScheduleInfo / DV360 DayPartTargeting pattern.",
+                      "type": "object",
+                      "properties": {
+                        "days": {
+                          "type": "array",
+                          "description": "Days of week this window applies to. Use multiple days for compact targeting (e.g., monday-friday in one object).",
+                          "items": {
+                            "title": "Day of Week",
+                            "description": "Days of the week for daypart targeting",
+                            "type": "string",
+                            "enum": [
+                              "monday",
+                              "tuesday",
+                              "wednesday",
+                              "thursday",
+                              "friday",
+                              "saturday",
+                              "sunday"
+                            ]
+                          },
+                          "minItems": 1
+                        },
+                        "start_hour": {
+                          "type": "integer",
+                          "description": "Start hour (inclusive), 0-23 in 24-hour format. 0 = midnight, 6 = 6:00am, 18 = 6:00pm.",
+                          "minimum": 0,
+                          "maximum": 23
+                        },
+                        "end_hour": {
+                          "type": "integer",
+                          "description": "End hour (exclusive), 1-24 in 24-hour format. 10 = 10:00am, 24 = midnight. Must be greater than start_hour.",
+                          "minimum": 1,
+                          "maximum": 24
+                        },
+                        "label": {
+                          "type": "string",
+                          "description": "Optional human-readable name for this time window (e.g., 'Morning Drive', 'Prime Time')"
+                        }
+                      },
+                      "required": [
+                        "days",
+                        "start_hour",
+                        "end_hour"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  },
+                  "axe_include_segment": {
+                    "type": "string",
+                    "description": "Deprecated: Use TMP provider fields instead. AXE segment ID to include for targeting.",
+                    "deprecated": true
+                  },
+                  "axe_exclude_segment": {
+                    "type": "string",
+                    "description": "Deprecated: Use TMP provider fields instead. AXE segment ID to exclude from targeting.",
+                    "deprecated": true
+                  },
+                  "audience_include": {
+                    "type": "array",
+                    "description": "Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.",
+                    "items": {
+                      "type": "string"
+                    },
+                    "minItems": 1
+                  },
+                  "audience_exclude": {
+                    "type": "array",
+                    "description": "Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.",
+                    "items": {
+                      "type": "string"
+                    },
+                    "minItems": 1
+                  },
+                  "frequency_cap": {
+                    "title": "Frequency Cap",
+                    "description": "Frequency capping settings for package-level application. Two types of frequency control can be used independently or together: suppress enforces a cooldown between consecutive exposures; max_impressions + per + window caps total exposures per entity in a time window. When both suppress and max_impressions are set, an impression is delivered only if both constraints permit it (AND semantics). At least one of suppress, suppress_minutes, or max_impressions must be set.",
+                    "type": "object",
+                    "properties": {
+                      "suppress": {
+                        "allOf": [
+                          {
+                            "title": "Duration",
+                            "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+                            "type": "object",
+                            "properties": {
+                              "interval": {
+                                "type": "integer",
+                                "minimum": 1,
+                                "description": "Number of time units. Must be 1 when unit is 'campaign'."
+                              },
+                              "unit": {
+                                "type": "string",
+                                "enum": [
+                                  "seconds",
+                                  "minutes",
+                                  "hours",
+                                  "days",
+                                  "campaign"
+                                ],
+                                "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+                              }
+                            },
+                            "required": [
+                              "interval",
+                              "unit"
+                            ],
+                            "additionalProperties": false
+                          }
+                        ],
+                        "description": "Cooldown period between consecutive exposures to the same entity. Prevents back-to-back ad delivery (e.g. {\"interval\": 60, \"unit\": \"minutes\"} for a 1-hour cooldown). Preferred over suppress_minutes."
+                      },
+                      "suppress_minutes": {
+                        "type": "number",
+                        "description": "Deprecated — use suppress instead. Cooldown period in minutes between consecutive exposures to the same entity (e.g. 60 for a 1-hour cooldown).",
+                        "minimum": 0
+                      },
+                      "max_impressions": {
+                        "type": "integer",
+                        "description": "Maximum number of impressions per entity per window. For duration windows, implementations typically use a rolling window; 'campaign' applies a fixed cap across the full flight.",
+                        "minimum": 1
+                      },
+                      "per": {
+                        "allOf": [
+                          {
+                            "$ref": "#/$defs/ReachUnit"
+                          }
+                        ],
+                        "description": "Entity granularity for impression counting. Required when max_impressions is set."
+                      },
+                      "window": {
+                        "allOf": [
+                          {
+                            "title": "Duration",
+                            "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+                            "type": "object",
+                            "properties": {
+                              "interval": {
+                                "type": "integer",
+                                "minimum": 1,
+                                "description": "Number of time units. Must be 1 when unit is 'campaign'."
+                              },
+                              "unit": {
+                                "type": "string",
+                                "enum": [
+                                  "seconds",
+                                  "minutes",
+                                  "hours",
+                                  "days",
+                                  "campaign"
+                                ],
+                                "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+                              }
+                            },
+                            "required": [
+                              "interval",
+                              "unit"
+                            ],
+                            "additionalProperties": false
+                          }
+                        ],
+                        "description": "Time window for the max_impressions cap (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Required when max_impressions is set."
+                      }
+                    },
+                    "anyOf": [
+                      {
+                        "required": [
+                          "suppress"
+                        ]
+                      },
+                      {
+                        "required": [
+                          "suppress_minutes"
+                        ]
+                      },
+                      {
+                        "required": [
+                          "max_impressions"
+                        ]
+                      }
+                    ],
+                    "dependencies": {
+                      "max_impressions": [
+                        "per",
+                        "window"
+                      ],
+                      "per": [
+                        "max_impressions"
+                      ],
+                      "window": [
+                        "max_impressions"
+                      ]
+                    },
+                    "additionalProperties": true
+                  },
+                  "property_list": {
+                    "title": "Property List Reference",
+                    "description": "Reference to a property list for targeting specific properties within this product. The package runs on the intersection of the product's publisher_properties and this list. Sellers SHOULD return a validation error if the product has property_targeting_allowed: false.",
+                    "type": "object",
+                    "properties": {
+                      "agent_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "URL of the agent managing the property list"
+                      },
+                      "list_id": {
+                        "type": "string",
+                        "description": "Identifier for the property list within the agent",
+                        "minLength": 1,
+                        "x-entity": "property_list"
+                      },
+                      "auth_token": {
+                        "type": "string",
+                        "description": "JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+                      }
+                    },
+                    "required": [
+                      "agent_url",
+                      "list_id"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "collection_list": {
+                    "title": "Collection List Reference",
+                    "description": "Reference to a collection list for including specific collections (programs, shows) within this product. The package runs on the intersection of matched collections and this list. Use for inclusion-based collection targeting. Seller must declare support in get_adcp_capabilities.",
+                    "type": "object",
+                    "properties": {
+                      "agent_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "URL of the agent managing the collection list"
+                      },
+                      "list_id": {
+                        "type": "string",
+                        "description": "Identifier for the collection list within the agent",
+                        "minLength": 1,
+                        "x-entity": "collection_list"
+                      },
+                      "auth_token": {
+                        "type": "string",
+                        "description": "JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+                      }
+                    },
+                    "required": [
+                      "agent_url",
+                      "list_id"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "collection_list_exclude": {
+                    "title": "Collection List Reference",
+                    "description": "Reference to a collection list for excluding specific collections (programs, shows) from this product. Matched collections must not carry the buyer's ads. Use for brand safety do-not-air lists. Seller must declare support in get_adcp_capabilities.",
+                    "type": "object",
+                    "properties": {
+                      "agent_url": {
+                        "type": "string",
+                        "format": "uri",
+                        "description": "URL of the agent managing the collection list"
+                      },
+                      "list_id": {
+                        "type": "string",
+                        "description": "Identifier for the collection list within the agent",
+                        "minLength": 1,
+                        "x-entity": "collection_list"
+                      },
+                      "auth_token": {
+                        "type": "string",
+                        "description": "JWT or other authorization token for accessing the list. Optional if the list is public or caller has implicit access."
+                      }
+                    },
+                    "required": [
+                      "agent_url",
+                      "list_id"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "age_restriction": {
+                    "type": "object",
+                    "description": "Age restriction for compliance. Use for legal requirements (alcohol, gambling), not audience targeting.",
+                    "properties": {
+                      "min": {
+                        "type": "integer",
+                        "minimum": 13,
+                        "maximum": 99,
+                        "description": "Minimum age required"
+                      },
+                      "verification_required": {
+                        "type": "boolean",
+                        "default": false,
+                        "description": "Whether verified age (not inferred) is required for compliance"
+                      },
+                      "accepted_methods": {
+                        "type": "array",
+                        "description": "Accepted verification methods. If omitted, any method the platform supports is acceptable.",
+                        "items": {
+                          "title": "Age Verification Method",
+                          "description": "Methods for verifying user age for compliance. Does not include 'inferred' as it is not accepted for regulatory compliance.",
+                          "type": "string",
+                          "enum": [
+                            "facial_age_estimation",
+                            "id_document",
+                            "digital_id",
+                            "credit_card",
+                            "world_id"
+                          ]
+                        },
+                        "minItems": 1
+                      }
+                    },
+                    "required": [
+                      "min"
+                    ],
+                    "additionalProperties": false
+                  },
+                  "device_platform": {
+                    "type": "array",
+                    "description": "Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.",
+                    "items": {
+                      "title": "Device Platform",
+                      "description": "Operating system platforms for device targeting. Browser values from Sec-CH-UA-Platform standard, extended for CTV.",
+                      "type": "string",
+                      "enum": [
+                        "ios",
+                        "android",
+                        "windows",
+                        "macos",
+                        "linux",
+                        "chromeos",
+                        "tvos",
+                        "tizen",
+                        "webos",
+                        "fire_os",
+                        "roku_os",
+                        "unknown"
+                      ]
+                    },
+                    "minItems": 1
+                  },
+                  "device_type": {
+                    "type": "array",
+                    "description": "Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).",
+                    "items": {
+                      "$ref": "#/$defs/DeviceType"
+                    },
+                    "minItems": 1
+                  },
+                  "device_type_exclude": {
+                    "type": "array",
+                    "description": "Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).",
+                    "items": {
+                      "$ref": "#/$defs/DeviceType"
+                    },
+                    "minItems": 1
+                  },
+                  "store_catchments": {
+                    "type": "array",
+                    "description": "Target users within store catchment areas from a synced store catalog. Each entry references a store-type catalog and optionally narrows to specific stores or catchment zones.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "catalog_id": {
+                          "type": "string",
+                          "description": "Synced store-type catalog ID from sync_catalogs."
+                        },
+                        "store_ids": {
+                          "type": "array",
+                          "description": "Filter to specific stores within the catalog. Omit to target all stores.",
+                          "items": {
+                            "type": "string"
+                          },
+                          "minItems": 1
+                        },
+                        "catchment_ids": {
+                          "type": "array",
+                          "description": "Catchment zone IDs to target (e.g., 'walk', 'drive'). Omit to target all catchment zones.",
+                          "items": {
+                            "type": "string"
+                          },
+                          "minItems": 1
+                        }
+                      },
+                      "required": [
+                        "catalog_id"
+                      ],
+                      "additionalProperties": true
+                    },
+                    "minItems": 1
+                  },
+                  "geo_proximity": {
+                    "type": "array",
+                    "description": "Target users within travel time, distance, or a custom boundary around arbitrary geographic points. Multiple entries use OR semantics — a user within range of any listed point is eligible. For campaigns targeting 10+ locations, consider using store_catchments with a location catalog instead. Seller must declare support in get_adcp_capabilities.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "lat": {
+                          "type": "number",
+                          "minimum": -90,
+                          "maximum": 90,
+                          "description": "Latitude in decimal degrees (WGS 84). Required for travel_time and radius methods."
+                        },
+                        "lng": {
+                          "type": "number",
+                          "minimum": -180,
+                          "maximum": 180,
+                          "description": "Longitude in decimal degrees (WGS 84). Required for travel_time and radius methods."
+                        },
+                        "label": {
+                          "type": "string",
+                          "description": "Human-readable label for this entry (e.g., 'Düsseldorf', 'Heathrow Airport', 'Primary trade area')."
+                        },
+                        "travel_time": {
+                          "type": "object",
+                          "description": "Travel time limit for isochrone calculation. The platform resolves this to a geographic boundary based on actual transportation networks.",
+                          "properties": {
+                            "value": {
+                              "type": "number",
+                              "minimum": 1,
+                              "description": "Travel time limit."
+                            },
+                            "unit": {
+                              "title": "Travel Time Unit",
+                              "description": "Time unit for isochrone (travel-time catchment) calculations.",
+                              "type": "string",
+                              "enum": [
+                                "min",
+                                "hr"
+                              ],
+                              "enumDescriptions": {
+                                "min": "Minutes",
+                                "hr": "Hours"
+                              }
+                            }
+                          },
+                          "required": [
+                            "value",
+                            "unit"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "transport_mode": {
+                          "title": "Transport Mode",
+                          "description": "Transportation mode for isochrone calculation. Required when travel_time is provided.",
+                          "type": "string",
+                          "enum": [
+                            "walking",
+                            "cycling",
+                            "driving",
+                            "public_transport"
+                          ],
+                          "enumDescriptions": {
+                            "walking": "Pedestrian travel on walkable paths and sidewalks",
+                            "cycling": "Bicycle travel on roads and cycle paths",
+                            "driving": "Motor vehicle travel on road networks",
+                            "public_transport": "Public transit including bus, rail, metro, and ferry"
+                          }
+                        },
+                        "radius": {
+                          "type": "object",
+                          "description": "Simple radius from the point. The platform draws a circle of this distance around the coordinates.",
+                          "properties": {
+                            "value": {
+                              "type": "number",
+                              "exclusiveMinimum": 0,
+                              "description": "Radius distance."
+                            },
+                            "unit": {
+                              "title": "Distance Unit",
+                              "description": "Distance unit.",
+                              "type": "string",
+                              "enum": [
+                                "km",
+                                "mi",
+                                "m"
+                              ],
+                              "enumDescriptions": {
+                                "km": "Kilometers",
+                                "mi": "Miles",
+                                "m": "Meters"
+                              }
+                            }
+                          },
+                          "required": [
+                            "value",
+                            "unit"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "geometry": {
+                          "type": "object",
+                          "description": "Pre-computed GeoJSON geometry defining the proximity boundary. Use when the buyer has already calculated isochrones (via TravelTime, Mapbox, etc.) or has custom boundaries. When geometry is provided, lat/lng are not required.",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "enum": [
+                                "Polygon",
+                                "MultiPolygon"
+                              ],
+                              "description": "GeoJSON geometry type."
+                            },
+                            "coordinates": {
+                              "type": "array",
+                              "description": "GeoJSON coordinates array. For Polygon: array of linear rings. For MultiPolygon: array of polygons."
+                            }
+                          },
+                          "required": [
+                            "type",
+                            "coordinates"
+                          ],
+                          "additionalProperties": false
+                        },
+                        "ext": {
+                          "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
+                        }
+                      },
+                      "oneOf": [
+                        {
+                          "required": [
+                            "lat",
+                            "lng",
+                            "travel_time",
+                            "transport_mode"
+                          ],
+                          "not": {
+                            "anyOf": [
+                              {
+                                "required": [
+                                  "radius"
+                                ]
+                              },
+                              {
+                                "required": [
+                                  "geometry"
+                                ]
+                              }
+                            ]
+                          }
+                        },
+                        {
+                          "required": [
+                            "lat",
+                            "lng",
+                            "radius"
+                          ],
+                          "not": {
+                            "anyOf": [
+                              {
+                                "required": [
+                                  "travel_time"
+                                ]
+                              },
+                              {
+                                "required": [
+                                  "geometry"
+                                ]
+                              }
+                            ]
+                          }
+                        },
+                        {
+                          "required": [
+                            "geometry"
+                          ],
+                          "not": {
+                            "anyOf": [
+                              {
+                                "required": [
+                                  "travel_time"
+                                ]
+                              },
+                              {
+                                "required": [
+                                  "radius"
+                                ]
+                              }
+                            ]
+                          }
+                        }
+                      ],
+                      "additionalProperties": true
+                    },
+                    "minItems": 1
+                  },
+                  "language": {
+                    "type": "array",
+                    "description": "Restrict to users with specific language preferences. ISO 639-1 codes (e.g., 'en', 'es', 'fr').",
+                    "items": {
+                      "type": "string",
+                      "pattern": "^[a-z]{2}$"
+                    },
+                    "minItems": 1
+                  },
+                  "keyword_targets": {
+                    "type": "array",
+                    "description": "Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "keyword": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "The keyword to target"
+                        },
+                        "match_type": {
+                          "$ref": "#/$defs/MatchType"
+                        },
+                        "bid_price": {
+                          "type": "number",
+                          "minimum": 0,
+                          "description": "Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies."
+                        }
+                      },
+                      "required": [
+                        "keyword",
+                        "match_type"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  },
+                  "negative_keywords": {
+                    "type": "array",
+                    "description": "Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "keyword": {
+                          "type": "string",
+                          "minLength": 1,
+                          "description": "The keyword to exclude"
+                        },
+                        "match_type": {
+                          "$ref": "#/$defs/MatchType"
+                        }
+                      },
+                      "required": [
+                        "keyword",
+                        "match_type"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "minItems": 1
+                  }
+                },
+                "additionalProperties": true
+              },
+              "measurement_terms": {
+                "title": "Measurement Terms",
+                "description": "Agreed billing measurement and makegood terms for this package. Reflects what was negotiated — may differ from the buyer's proposal or the product's defaults. When present, these terms are binding for the package's duration.",
+                "type": "object",
+                "properties": {
+                  "billing_measurement": {
+                    "type": "object",
+                    "description": "Which vendor's count of the billing metric governs invoicing. The billing metric is determined by the pricing_model on the selected pricing_option (e.g., impressions for CPM, completed views for CPCV).",
+                    "properties": {
+                      "vendor": {
+                        "title": "Brand Reference",
+                        "description": "Vendor whose measurement of the billing metric is authoritative for invoicing (e.g., { domain: 'campaignmanager.google.com' } for buyer's DCM, { domain: 'admanager.google.com' } for seller's GAM).",
+                        "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": {
+                            "title": "Brand ID",
+                            "description": "Brand identifier within the house portfolio. Optional for single-brand domains.",
+                            "type": "string",
+                            "pattern": "^[a-z0-9_]+$",
+                            "x-entity": "advertiser_brand",
+                            "examples": [
+                              "tide",
+                              "cheerios",
+                              "air_jordan",
+                              "nike",
+                              "pampers"
+                            ]
+                          },
+                          "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
+                          }
+                        },
+                        "required": [
+                          "domain"
+                        ],
+                        "additionalProperties": false,
+                        "examples": [
+                          {
+                            "domain": "nova-brands.com",
+                            "brand_id": "spark"
+                          },
+                          {
+                            "domain": "nova-brands.com",
+                            "brand_id": "glow"
+                          },
+                          {
+                            "domain": "acme-corp.com"
+                          }
+                        ]
+                      },
+                      "max_variance_percent": {
+                        "type": "number",
+                        "minimum": 0,
+                        "exclusiveMaximum": 100,
+                        "description": "Maximum acceptable variance between the billing vendor's count and the other party's count before resolution is triggered (e.g., 10 means a 10% divergence triggers review)."
+                      },
+                      "measurement_window": {
+                        "type": "string",
+                        "description": "Which measurement maturation stage the billing metric is reconciled against. References a window_id from the product's reporting_capabilities.measurement_windows. Examples: 'c7' for broadcast TV guarantees (live + 7 days DVR), 'final' for DOOH after IVT/fraud-check processing, 'post_sivt' for digital after sophisticated invalid-traffic filtering, 'downloads_30d' for podcast. When absent, billing is based on the seller's standard reporting without windowed maturation.",
+                        "examples": [
+                          "live",
+                          "c3",
+                          "c7",
+                          "tentative",
+                          "final",
+                          "post_ivt",
+                          "post_sivt",
+                          "downloads_30d"
+                        ]
+                      }
+                    },
+                    "required": [
+                      "vendor"
+                    ],
+                    "additionalProperties": true
+                  },
+                  "makegood_policy": {
+                    "type": "object",
+                    "description": "Remedies available when a performance standard or billing measurement variance is breached. Seller declares which remedy types they support. When a breach occurs, the seller proposes a remedy from this menu; the buyer accepts or disputes.",
+                    "properties": {
+                      "available_remedies": {
+                        "type": "array",
+                        "description": "Remedy types the seller supports. Ordered by seller preference (first = preferred). Seller proposes from this list when a breach occurs; buyer accepts or disputes.",
+                        "items": {
+                          "title": "Makegood Remedy",
+                          "description": "Remedy types available when a performance standard or billing measurement threshold is breached.",
+                          "type": "string",
+                          "enum": [
+                            "additional_delivery",
+                            "credit",
+                            "invoice_adjustment"
+                          ],
+                          "enumDescriptions": {
+                            "additional_delivery": "Seller extends or adds impressions to compensate for the shortfall. Delivery is like-for-like on the same campaign or a subsequent campaign within the same account.",
+                            "credit": "Seller issues a credit toward future media buys on the same account.",
+                            "invoice_adjustment": "Seller reduces the invoice for the current media buy to reflect actual delivered value."
+                          }
+                        },
+                        "minItems": 1,
+                        "uniqueItems": true
+                      }
+                    },
+                    "required": [
+                      "available_remedies"
+                    ],
+                    "additionalProperties": true
+                  }
+                },
+                "additionalProperties": true
+              },
+              "performance_standards": {
+                "type": "array",
+                "description": "Agreed performance standards for this package. When any entry specifies a vendor, creatives assigned to this package MUST include corresponding tracker_script or tracker_pixel assets from that vendor.",
+                "items": {
+                  "title": "Performance Standard",
+                  "description": "A rate threshold for a performance metric, measured by a specified vendor. The threshold is a floor or ceiling depending on the metric: viewability, completion_rate, brand_safety, and attention_score are floors (must exceed); ivt is a ceiling (must not exceed).",
+                  "type": "object",
+                  "properties": {
+                    "metric": {
+                      "title": "Performance Standard Metric",
+                      "description": "The performance metric this standard applies to.",
+                      "type": "string",
+                      "enum": [
+                        "viewability",
+                        "ivt",
+                        "completion_rate",
+                        "brand_safety",
+                        "attention_score"
+                      ],
+                      "enumDescriptions": {
+                        "viewability": "Viewable impression rate (floor — must exceed threshold). Requires viewability_standard. Denominator: measurable_impressions.",
+                        "ivt": "Invalid Traffic rate (ceiling — must not exceed threshold). Denominator: total_impressions.",
+                        "completion_rate": "Video or audio completion rate (floor — must exceed threshold). Denominator: total_impressions.",
+                        "brand_safety": "Brand-safe impression rate (floor — must exceed threshold). Denominator: total_impressions.",
+                        "attention_score": "Attention score rate (floor — must exceed threshold). Denominator: measurable_impressions."
+                      }
+                    },
+                    "threshold": {
+                      "type": "number",
+                      "minimum": 0,
+                      "maximum": 1,
+                      "description": "Rate threshold as a decimal (e.g., 0.70 for 70%). Whether this is a floor or ceiling depends on the metric: for viewability, completion_rate, brand_safety, attention_score the actual rate must be >= threshold; for ivt the actual rate must be <= threshold."
+                    },
+                    "standard": {
+                      "title": "Viewability Standard",
+                      "description": "Measurement standard. Required when metric is 'viewability' (MRC and GroupM define materially different thresholds). Omit for other metrics.",
+                      "type": "string",
+                      "enum": [
+                        "mrc",
+                        "groupm"
+                      ],
+                      "enumDescriptions": {
+                        "mrc": "MRC/IAB standard: 50% of pixels in view for 1 continuous second (display) or 2 continuous seconds (video).",
+                        "groupm": "GroupM standard: 100% of pixels in view for 1 continuous second (display) or 50% of video duration."
+                      }
+                    },
+                    "vendor": {
+                      "title": "Brand Reference",
+                      "description": "Vendor measuring this metric (e.g., { domain: 'doubleverify.com' }). The vendor's brand.json agents array (type: 'measurement') is the discovery point for their measurement agent. When specified on a confirmed package, creatives MUST include tracker_script or tracker_pixel assets from this vendor.",
+                      "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": {
+                          "title": "Brand ID",
+                          "description": "Brand identifier within the house portfolio. Optional for single-brand domains.",
+                          "type": "string",
+                          "pattern": "^[a-z0-9_]+$",
+                          "x-entity": "advertiser_brand",
+                          "examples": [
+                            "tide",
+                            "cheerios",
+                            "air_jordan",
+                            "nike",
+                            "pampers"
+                          ]
+                        },
+                        "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
+                        }
+                      },
+                      "required": [
+                        "domain"
+                      ],
+                      "additionalProperties": false,
+                      "examples": [
+                        {
+                          "domain": "nova-brands.com",
+                          "brand_id": "spark"
+                        },
+                        {
+                          "domain": "nova-brands.com",
+                          "brand_id": "glow"
+                        },
+                        {
+                          "domain": "acme-corp.com"
+                        }
+                      ]
+                    }
+                  },
+                  "required": [
+                    "metric",
+                    "threshold",
+                    "vendor"
+                  ],
+                  "additionalProperties": true
+                },
+                "minItems": 1
+              },
+              "creative_assignments": {
+                "type": "array",
+                "description": "Creative assets assigned to this package",
+                "items": {
+                  "title": "Creative Assignment",
+                  "description": "Assignment of a creative asset to a package with optional placement targeting. Used in create_media_buy and update_media_buy requests. Note: sync_creatives does not support placement_ids - use create/update_media_buy for placement-level targeting.",
+                  "type": "object",
+                  "properties": {
+                    "creative_id": {
+                      "type": "string",
+                      "description": "Unique identifier for the creative",
+                      "x-entity": "creative"
+                    },
+                    "weight": {
+                      "type": "number",
+                      "description": "Relative delivery weight for this creative (0–100). When multiple creatives are assigned to the same package, weights determine impression distribution proportionally — a creative with weight 2 gets twice the delivery of weight 1. When omitted, the creative receives equal rotation with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).",
+                      "minimum": 0,
+                      "maximum": 100
+                    },
+                    "placement_ids": {
+                      "type": "array",
+                      "description": "Optional array of placement IDs where this creative should run. When omitted, the creative runs on all placements in the package. References placement_id values from the product's placements array.",
+                      "items": {
+                        "type": "string"
+                      },
+                      "minItems": 1
+                    }
+                  },
+                  "required": [
+                    "creative_id"
+                  ],
+                  "additionalProperties": true
+                }
+              },
+              "format_ids_to_provide": {
+                "type": "array",
+                "description": "Format IDs that creative assets will be provided for this package",
+                "items": {
+                  "title": "Format Reference (Structured Object)",
+                  "description": "A JSON object — never a plain string — that identifies a creative format by its declaring agent and local slug. Required properties: agent_url (URI of the agent that owns the format) and id (slug matching [a-zA-Z0-9_-]+). Example: {\"agent_url\": \"https://creative.adcontextprotocol.org\", \"id\": \"display_300x250\"}. Can reference: (1) a concrete format with fixed dimensions (id only), (2) a template format without parameters (id only), or (3) a template format with parameters (id + dimensions/duration). Template formats accept parameters in format_id while concrete formats have fixed dimensions in their definition. Parameterized format IDs create unique, specific format variants. Using a plain string here is a schema violation.",
+                  "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."
+                    }
+                  },
+                  "required": [
+                    "agent_url",
+                    "id"
+                  ],
+                  "additionalProperties": true,
+                  "dependencies": {
+                    "width": [
+                      "height"
+                    ],
+                    "height": [
+                      "width"
+                    ]
+                  }
+                }
+              },
+              "optimization_goals": {
+                "type": "array",
+                "description": "Optimization targets for this package. The seller optimizes delivery toward these goals in priority order. Common pattern: event goals (purchase, install) as primary targets at priority 1; metric goals (clicks, views) as secondary proxy signals at priority 2+.",
+                "items": {
+                  "title": "Optimization Goal",
+                  "description": "A single optimization target for a package. Packages accept an array of optimization_goals. When multiple goals are present, priority determines which the seller focuses on — 1 is highest priority (primary goal); higher numbers are secondary. Duplicate priority values result in undefined seller behavior.",
+                  "oneOf": [
+                    {
+                      "type": "object",
+                      "description": "Optimize for a seller-tracked delivery metric. No event source required — the seller tracks these natively.",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "metric"
+                        },
+                        "metric": {
+                          "type": "string",
+                          "enum": [
+                            "clicks",
+                            "views",
+                            "completed_views",
+                            "viewed_seconds",
+                            "attention_seconds",
+                            "attention_score",
+                            "engagements",
+                            "follows",
+                            "saves",
+                            "profile_visits",
+                            "reach"
+                          ],
+                          "description": "Seller-native metric to optimize for. Delivery metrics: clicks (link clicks, swipe-throughs, CTA taps that navigate away), views (viewable impressions), completed_views (video/audio completions — see view_duration_seconds), reach (unique audience reach — see reach_unit and target_frequency). Duration/score metrics: viewed_seconds (time in view per impression), attention_seconds (attention time per impression), attention_score (vendor-specific attention score). Audience action metrics: engagements (any direct interaction with the ad unit beyond viewing — social reactions/comments/shares, story/unit opens, interactive overlay taps, companion banner interactions on audio and CTV), follows (new followers, page likes, artist/podcast/channel subscribes), saves (saves, bookmarks, playlist adds, pins — signals of intent to return), profile_visits (visits to the brand's in-platform page — profile, artist page, channel, or storefront. Does not include external website clicks, which are covered by 'clicks')."
+                        },
+                        "reach_unit": {
+                          "allOf": [
+                            {
+                              "$ref": "#/$defs/ReachUnit"
+                            }
+                          ],
+                          "description": "Unit for reach measurement. Required when metric is 'reach'. Must be a value declared in the product's metric_optimization.supported_reach_units."
+                        },
+                        "target_frequency": {
+                          "type": "object",
+                          "description": "Target frequency band for reach optimization. Only applicable when metric is 'reach'. Frames frequency as an optimization signal: the seller should treat impressions toward entities already within the [min, max] band as lower-value, and impressions toward unreached entities as higher-value. This shifts budget toward fresh reach rather than re-reaching known users. When omitted, the seller maximizes unique reach without a frequency constraint. A hard cap can still be layered via targeting_overlay.frequency_cap if a ceiling is needed.",
+                          "properties": {
+                            "min": {
+                              "type": "integer",
+                              "minimum": 1,
+                              "description": "Minimum frequency for an entity to be considered meaningfully reached within the window. Impressions that would bring an entity below this threshold are treated as high-value (growing reach). When omitted, the seller uses their platform default (typically 1)."
+                            },
+                            "max": {
+                              "type": "integer",
+                              "minimum": 1,
+                              "description": "Frequency at which an entity is considered saturated within the window. Impressions toward entities at or above this threshold are treated as lower-value. When both min and max are present, max must be greater than or equal to min. When omitted, the seller determines the saturation point."
+                            },
+                            "window": {
+                              "allOf": [
+                                {
+                                  "title": "Duration",
+                                  "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+                                  "type": "object",
+                                  "properties": {
+                                    "interval": {
+                                      "type": "integer",
+                                      "minimum": 1,
+                                      "description": "Number of time units. Must be 1 when unit is 'campaign'."
+                                    },
+                                    "unit": {
+                                      "type": "string",
+                                      "enum": [
+                                        "seconds",
+                                        "minutes",
+                                        "hours",
+                                        "days",
+                                        "campaign"
+                                      ],
+                                      "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+                                    }
+                                  },
+                                  "required": [
+                                    "interval",
+                                    "unit"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              ],
+                              "description": "Time window over which frequency is measured (e.g. {\"interval\": 7, \"unit\": \"days\"} or {\"interval\": 1, \"unit\": \"campaign\"} for the full flight). Weekly windows are typical for brand campaigns; daily windows suit high-cadence direct response."
+                            }
+                          },
+                          "required": [
+                            "window"
+                          ],
+                          "anyOf": [
+                            {
+                              "required": [
+                                "min"
+                              ]
+                            },
+                            {
+                              "required": [
+                                "max"
+                              ]
+                            }
+                          ],
+                          "additionalProperties": true
+                        },
+                        "view_duration_seconds": {
+                          "type": "number",
+                          "exclusiveMinimum": 0,
+                          "description": "Minimum video view duration in seconds that qualifies as a completed_view for this goal. Only applicable when metric is 'completed_views'. When omitted, the seller uses their platform default (typically 2–15 seconds). Common values: 2 (Snap/LinkedIn default), 6 (TikTok), 15 (Snap 15-second views, Meta ThruPlay). Sellers declare which durations they support in metric_optimization.supported_view_durations. Sellers must reject goals with unsupported values — silent rounding would create measurement discrepancies."
+                        },
+                        "target": {
+                          "description": "Target for this metric. When omitted, the seller optimizes for maximum metric volume within budget.",
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "description": "Target cost per unit of the metric (e.g., cost per click, cost per completed view).",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "cost_per"
+                                },
+                                "value": {
+                                  "type": "number",
+                                  "exclusiveMinimum": 0,
+                                  "description": "Target cost per metric unit in the buy currency"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "value"
+                              ],
+                              "additionalProperties": true
+                            },
+                            {
+                              "type": "object",
+                              "description": "Minimum per-impression rate for this metric. The metric defines the units: proportions for count metrics (e.g., 0.001 for 0.1% CTR, 0.70 for 70% viewability), seconds for duration metrics (e.g., 3.0 for 3s in view), or score for score metrics.",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "threshold_rate"
+                                },
+                                "value": {
+                                  "type": "number",
+                                  "exclusiveMinimum": 0,
+                                  "description": "Minimum per-impression value. Units depend on the metric: proportion (clicks, views, completed_views), seconds (viewed_seconds, attention_seconds), or score (attention_score)."
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "value"
+                              ],
+                              "additionalProperties": true
+                            }
+                          ]
+                        },
+                        "priority": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "Relative priority among all optimization goals on this package. 1 = highest priority (primary goal); higher numbers are lower priority (secondary signals). When omitted, sellers may use array position as priority."
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "metric"
+                      ],
+                      "additionalProperties": true
+                    },
+                    {
+                      "type": "object",
+                      "description": "Optimize for advertiser-tracked conversion events. Requires event sources registered via sync_event_sources.",
+                      "properties": {
+                        "kind": {
+                          "type": "string",
+                          "const": "event"
+                        },
+                        "event_sources": {
+                          "type": "array",
+                          "description": "Event source and type pairs that feed this goal. Each entry identifies a source and event type to include. When the seller supports multi_source_event_dedup (declared in get_adcp_capabilities), they deduplicate by event_id across all entries — the same business event from multiple sources counts once, using value_field and value_factor from the first matching entry. When multi_source_event_dedup is false or absent, buyers should use a single entry per goal; the seller will use only the first entry. All event sources must be configured via sync_event_sources.",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "event_source_id": {
+                                "type": "string",
+                                "minLength": 1,
+                                "description": "Event source to include (must be configured on this account via sync_event_sources)"
+                              },
+                              "event_type": {
+                                "$ref": "#/$defs/EventType"
+                              },
+                              "custom_event_name": {
+                                "type": "string",
+                                "description": "Required when event_type is 'custom'. Platform-specific name for the custom event."
+                              },
+                              "value_field": {
+                                "type": "string",
+                                "description": "Which field in the event's custom_data carries the monetary value. The seller must use this field for value extraction and aggregation when computing ROAS and conversion value metrics. Required on at least one entry when target.kind is 'per_ad_spend' or 'maximize_value' — sellers must reject these target kinds when no event source entry includes value_field. When present without a value-oriented target, the seller may use it for delivery reporting (conversion_value, roas) but must not change the optimization objective. Common values: 'value', 'order_total', 'profit_margin'. This is not passed as a parameter to underlying platform APIs — the seller maps it to their platform's value ingestion mechanism."
+                              },
+                              "value_factor": {
+                                "type": "number",
+                                "default": 1,
+                                "description": "Multiplier the seller must apply to value_field before aggregation. Use -1 for refund events (negate the value), 0.01 for values in cents, -0.01 for refunds in cents. A value of 0 zeroes out this source's value contribution (the source still counts for event dedup). Defaults to 1. This is not passed as a parameter to underlying platform APIs — the seller applies it when computing aggregated value metrics."
+                              }
+                            },
+                            "required": [
+                              "event_source_id",
+                              "event_type"
+                            ],
+                            "additionalProperties": true
+                          },
+                          "minItems": 1
+                        },
+                        "target": {
+                          "description": "Target cost or return for this event goal. When omitted, the seller optimizes for maximum conversion count within budget — regardless of whether value_field is present on event sources. The presence of value_field alone does not change the optimization objective; it only makes value available for reporting. An explicit target of maximize_value or per_ad_spend is required to steer toward value.",
+                          "oneOf": [
+                            {
+                              "type": "object",
+                              "description": "Target cost per conversion event (after deduplication across event_sources).",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "cost_per"
+                                },
+                                "value": {
+                                  "type": "number",
+                                  "exclusiveMinimum": 0,
+                                  "description": "Target cost per event in the buy currency"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "value"
+                              ],
+                              "additionalProperties": true
+                            },
+                            {
+                              "type": "object",
+                              "description": "Target return per unit of ad spend, calculated as sum(value_field * value_factor) / spend across all deduplicated events. Requires value_field on at least one event_sources entry.",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "per_ad_spend"
+                                },
+                                "value": {
+                                  "type": "number",
+                                  "exclusiveMinimum": 0,
+                                  "description": "Target return ratio (e.g., 4.0 means $4 of value per $1 spent)"
+                                }
+                              },
+                              "required": [
+                                "kind",
+                                "value"
+                              ],
+                              "additionalProperties": true
+                            },
+                            {
+                              "type": "object",
+                              "description": "Maximize total conversion value within budget, without a specific return ratio target. Steers spend toward higher-value conversions rather than maximizing conversion count. Requires value_field on at least one event_sources entry.",
+                              "properties": {
+                                "kind": {
+                                  "type": "string",
+                                  "const": "maximize_value"
+                                }
+                              },
+                              "required": [
+                                "kind"
+                              ],
+                              "additionalProperties": true
+                            }
+                          ]
+                        },
+                        "attribution_window": {
+                          "type": "object",
+                          "description": "Attribution window for this optimization goal. Values must match an option declared in the seller's conversion_tracking.attribution_windows capability. Sellers must reject windows not in their declared capabilities. When omitted, the seller uses their default window.",
+                          "properties": {
+                            "post_click": {
+                              "allOf": [
+                                {
+                                  "title": "Duration",
+                                  "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+                                  "type": "object",
+                                  "properties": {
+                                    "interval": {
+                                      "type": "integer",
+                                      "minimum": 1,
+                                      "description": "Number of time units. Must be 1 when unit is 'campaign'."
+                                    },
+                                    "unit": {
+                                      "type": "string",
+                                      "enum": [
+                                        "seconds",
+                                        "minutes",
+                                        "hours",
+                                        "days",
+                                        "campaign"
+                                      ],
+                                      "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+                                    }
+                                  },
+                                  "required": [
+                                    "interval",
+                                    "unit"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              ],
+                              "description": "Post-click attribution window. Conversions within this duration after a click are attributed to the ad (e.g. {\"interval\": 7, \"unit\": \"days\"})."
+                            },
+                            "post_view": {
+                              "allOf": [
+                                {
+                                  "title": "Duration",
+                                  "description": "A time duration expressed as an interval and unit. Used for frequency cap windows, attribution windows, reach optimization windows, time budgets, and other time-based settings. When unit is 'campaign', interval must be 1 — the window spans the full campaign flight.",
+                                  "type": "object",
+                                  "properties": {
+                                    "interval": {
+                                      "type": "integer",
+                                      "minimum": 1,
+                                      "description": "Number of time units. Must be 1 when unit is 'campaign'."
+                                    },
+                                    "unit": {
+                                      "type": "string",
+                                      "enum": [
+                                        "seconds",
+                                        "minutes",
+                                        "hours",
+                                        "days",
+                                        "campaign"
+                                      ],
+                                      "description": "Time unit. 'seconds' for sub-minute precision. 'campaign' spans the full campaign flight."
+                                    }
+                                  },
+                                  "required": [
+                                    "interval",
+                                    "unit"
+                                  ],
+                                  "additionalProperties": false
+                                }
+                              ],
+                              "description": "Post-view attribution window. Conversions within this duration after an ad impression (without click) are attributed to the ad (e.g. {\"interval\": 1, \"unit\": \"days\"})."
+                            }
+                          },
+                          "required": [
+                            "post_click"
+                          ],
+                          "additionalProperties": true
+                        },
+                        "priority": {
+                          "type": "integer",
+                          "minimum": 1,
+                          "description": "Relative priority among all optimization goals on this package. 1 = highest priority (primary goal); higher numbers are lower priority (secondary signals). When omitted, sellers may use array position as priority."
+                        }
+                      },
+                      "required": [
+                        "kind",
+                        "event_sources"
+                      ],
+                      "additionalProperties": true
+                    }
+                  ]
+                },
+                "minItems": 1
+              },
+              "start_time": {
+                "type": "string",
+                "format": "date-time",
+                "not": {
+                  "const": "asap"
+                },
+                "description": "Flight start date/time for this package in ISO 8601 format. When omitted, the package inherits the media buy's start_time. Sellers SHOULD always include the resolved value in responses, even when inherited."
+              },
+              "end_time": {
+                "type": "string",
+                "format": "date-time",
+                "description": "Flight end date/time for this package in ISO 8601 format. When omitted, the package inherits the media buy's end_time. Sellers SHOULD always include the resolved value in responses, even when inherited."
+              },
+              "paused": {
+                "type": "boolean",
+                "description": "Whether this package is paused by the buyer. Paused packages do not deliver impressions. Defaults to false.",
+                "default": false
+              },
+              "canceled": {
+                "type": "boolean",
+                "description": "Whether this package has been canceled. Canceled packages stop delivery and cannot be reactivated. Defaults to false.",
+                "default": false
+              },
+              "cancellation": {
+                "type": "object",
+                "description": "Cancellation metadata. Present only when canceled is true.",
+                "required": [
+                  "canceled_at",
+                  "canceled_by"
+                ],
+                "properties": {
+                  "canceled_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "ISO 8601 timestamp when this package was canceled."
+                  },
+                  "canceled_by": {
+                    "title": "Canceled By",
+                    "description": "Which party initiated the package cancellation.",
+                    "type": "string",
+                    "enum": [
+                      "buyer",
+                      "seller"
+                    ],
+                    "enumDescriptions": {
+                      "buyer": "Cancellation initiated by the buyer via update_media_buy",
+                      "seller": "Cancellation initiated by the seller (e.g., policy violation, inventory withdrawal)"
+                    }
+                  },
+                  "reason": {
+                    "type": "string",
+                    "description": "Reason the package was canceled.",
+                    "maxLength": 500
+                  },
+                  "acknowledged_at": {
+                    "type": "string",
+                    "format": "date-time",
+                    "description": "ISO 8601 timestamp when the seller acknowledged the cancellation. Confirms inventory has been released and billing stopped. Absent until the seller processes the cancellation."
+                  }
+                },
+                "additionalProperties": false
+              },
+              "agency_estimate_number": {
+                "type": "string",
+                "maxLength": 100,
+                "description": "Agency estimate or authorization number for this package. Echoed from the buyer's request. When present on the package, takes precedence over the media buy-level estimate number."
+              },
+              "creative_deadline": {
+                "type": "string",
+                "format": "date-time",
+                "description": "ISO 8601 timestamp for creative upload or change deadline for this package. After this deadline, creative changes are rejected. When absent, the media buy's creative_deadline applies."
+              },
+              "context": {
+                "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
+              },
+              "ext": {
+                "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
+              }
+            },
+            "required": [
+              "package_id"
+            ],
+            "additionalProperties": true
+          }
+        },
+        "valid_actions": {
+          "type": "array",
+          "description": "Actions the buyer can perform after this update. Saves a round-trip to get_media_buys.",
+          "items": {
+            "title": "Media Buy Valid Action",
+            "description": "Actions the buyer can perform on a media buy",
+            "type": "string",
+            "enum": [
+              "pause",
+              "resume",
+              "cancel",
+              "update_budget",
+              "update_dates",
+              "update_packages",
+              "add_packages",
+              "sync_creatives"
+            ]
+          }
+        },
+        "sandbox": {
+          "type": "boolean",
+          "description": "When true, this response contains simulated data from sandbox mode."
+        },
+        "context": {
+          "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
+        },
+        "ext": {
+          "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
+        }
+      },
+      "required": [
+        "media_buy_id"
+      ],
+      "additionalProperties": true,
+      "not": {
+        "required": [
+          "errors"
+        ]
+      }
+    },
+    {
+      "title": "UpdateMediaBuyError",
+      "description": "Error response - operation failed, no changes applied",
+      "type": "object",
+      "properties": {
+        "errors": {
+          "type": "array",
+          "description": "Array of errors explaining why the operation failed",
+          "items": {
+            "title": "Error",
+            "description": "Standard error structure for task-specific errors and warnings",
+            "type": "object",
+            "properties": {
+              "code": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 64,
+                "description": "Error code for programmatic handling. Standard codes are defined in error-code.json and enable autonomous agent recovery. Sellers MAY use codes not in the standard vocabulary for platform-specific errors; agents MUST handle unknown codes gracefully by falling back to the recovery classification."
+              },
+              "message": {
+                "type": "string",
+                "description": "Human-readable error message"
+              },
+              "field": {
+                "type": "string",
+                "description": "Field path associated with the error (e.g., 'packages[0].targeting')"
+              },
+              "suggestion": {
+                "type": "string",
+                "description": "Suggested fix for the error"
+              },
+              "retry_after": {
+                "type": "number",
+                "description": "Seconds to wait before retrying the operation. Sellers MUST return values between 1 and 3600. Clients MUST clamp values outside this range.",
+                "minimum": 1,
+                "maximum": 3600
+              },
+              "details": {
+                "type": "object",
+                "description": "Additional task-specific error details",
+                "additionalProperties": true
+              },
+              "recovery": {
+                "type": "string",
+                "enum": [
+                  "transient",
+                  "correctable",
+                  "terminal"
+                ],
+                "description": "Agent recovery classification. transient: retry after delay (rate limit, service unavailable, timeout). correctable: fix the request and resend (invalid field, budget too low, creative rejected). terminal: requires human action (account suspended, payment required, account not found)."
+              }
+            },
+            "required": [
+              "code",
+              "message"
+            ],
+            "additionalProperties": true
+          },
+          "minItems": 1
+        },
+        "context": {
+          "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
+        },
+        "ext": {
+          "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
+        }
+      },
+      "required": [
+        "errors"
+      ],
+      "additionalProperties": true,
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "media_buy_id"
+            ]
+          },
+          {
+            "required": [
+              "affected_packages"
+            ]
+          },
+          {
+            "required": [
+              "sandbox"
+            ]
+          }
+        ]
+      }
+    }
+  ],
+  "$defs": {
+    "EventType": {
+      "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",
+        "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 subscribed to a service or newsletter",
+        "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)"
+      }
+    },
+    "MetroAreaSystem": {
+      "title": "Metro Area System",
+      "description": "Metro area classification system (e.g., 'nielsen_dma', 'uk_itl2')",
+      "type": "string",
+      "enum": [
+        "nielsen_dma",
+        "uk_itl1",
+        "uk_itl2",
+        "eurostat_nuts2",
+        "custom"
+      ]
+    },
+    "PostalCodeSystem": {
+      "title": "Postal Code System",
+      "description": "Postal code system (e.g., 'us_zip', 'gb_outward'). System name encodes country and precision.",
+      "type": "string",
+      "enum": [
+        "us_zip",
+        "us_zip_plus_four",
+        "gb_outward",
+        "gb_full",
+        "ca_fsa",
+        "ca_full",
+        "de_plz",
+        "fr_code_postal",
+        "au_postcode",
+        "ch_plz",
+        "at_plz"
+      ]
+    },
+    "ReachUnit": {
+      "title": "Reach Unit",
+      "description": "Unit of measurement for reach and audience size metrics. Different channels and measurement providers count reach in fundamentally different units, making cross-channel comparison impossible without declaring the unit.",
+      "type": "string",
+      "enum": [
+        "individuals",
+        "households",
+        "devices",
+        "accounts",
+        "cookies",
+        "custom"
+      ],
+      "enumDescriptions": {
+        "individuals": "Unique people. Panel-based or identity-resolved measurement.",
+        "households": "Unique households or TV homes.",
+        "devices": "Unique device identifiers (IDFA, GAID, CTV device ID).",
+        "accounts": "Unique logged-in accounts (platform-specific identity).",
+        "cookies": "Unique browser cookies.",
+        "custom": "Publisher-defined reach unit. Describe in ext."
+      }
+    },
+    "DeviceType": {
+      "title": "Device Type",
+      "description": "Device form factor categories for targeting and reporting. Complements device-platform (operating system) with hardware classification. OpenRTB mapping: 1 (Mobile/Tablet General) → mobile, 2 (PC) → desktop, 4 (Phone) → mobile, 5 (Tablet) → tablet, 6 (Connected Device) → ctv, 7 (Set Top Box) → ctv. DOOH inventory uses dooh.",
+      "type": "string",
+      "enum": [
+        "desktop",
+        "mobile",
+        "tablet",
+        "ctv",
+        "dooh",
+        "unknown"
+      ]
+    },
+    "MatchType": {
+      "title": "Match Type",
+      "description": "Keyword targeting match type. broad: ads may serve on queries semantically related to the keyword. phrase: ads serve when the query contains the keyword phrase. exact: ads serve only when the query matches the keyword exactly.",
+      "type": "string",
+      "enum": [
+        "broad",
+        "phrase",
+        "exact"
+      ],
+      "enumDescriptions": {
+        "broad": "Ads may serve on queries semantically related to the keyword",
+        "phrase": "Ads serve when the query contains the keyword phrase in order",
+        "exact": "Ads serve only when the query matches the keyword exactly"
+      }
+    }
+  },
+  "_bundled": {
+    "generatedAt": "2026-04-28T12:32:23.032Z",
+    "note": "This is a bundled schema with all $ref resolved inline. For the modular version with references, use the parent directory."
+  }
+}