{
  "version": 1,
  "schema": "/schemas/media-buy/get-media-buys-response.json",
  "description": "Positive wire-level vectors for PackageStatus targeting readback in get_media_buys responses, including audience targeting, purchased inventory selection, demographic execution under targeting_resolution.demographics, and the geo-place catalog audit MUST. Vectors are dedicated JSON payloads that MUST validate against the bundled schema and whose shape is asserted by SDK code generators. Each vector contains a stable `id` (kebab-case; the stable reference for cross-SDK conformance), a human-readable `description`, the `payload` returned by the seller, and `assertions` — dotted JSON paths that MUST be present with the given value. Downstream tests SHOULD look up vectors by `id`; `description` prose may be revised without notice.",
  "vectors": [
    {
      "id": "property-and-collection-list-echo",
      "description": "Specialism MUST — seller echoes persisted PropertyListReference and CollectionListReference under packages[0].targeting_overlay. Mirrors the create/get/update cycle in the inventory_list_targeting storyboard.",
      "payload": {
        "status": "completed",
        "media_buys": [
          {
            "media_buy_id": "mb_acme_outdoor_001",
            "status": "pending_start",
            "currency": "USD",
            "total_budget": 20000,
            "confirmed_at": "2026-06-25T12:00:00Z",
            "revision": 1,
            "start_time": "2026-07-01T00:00:00Z",
            "end_time": "2026-09-30T23:59:59Z",
            "created_at": "2026-06-25T12:00:00Z",
            "updated_at": "2026-06-25T12:00:00Z",
            "packages": [
              {
                "package_id": "pkg_acme_outdoor_video",
                "product_id": "prod_ctv_outdoor_lifestyle",
                "budget": 20000,
                "currency": "USD",
                "start_time": "2026-07-01T00:00:00Z",
                "end_time": "2026-09-30T23:59:59Z",
                "targeting_overlay": {
                  "property_list": {
                    "agent_url": "https://governance.pinnacle-agency.example",
                    "list_id": "acme_outdoor_allowlist_v1"
                  },
                  "collection_list": {
                    "agent_url": "https://governance.pinnacle-agency.example",
                    "list_id": "acme_outdoor_collections_v1"
                  }
                }
              }
            ]
          }
        ]
      },
      "assertions": [
        {
          "path": "media_buys[0].packages[0].targeting_overlay.property_list.list_id",
          "value": "acme_outdoor_allowlist_v1"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.property_list.agent_url",
          "value": "https://governance.pinnacle-agency.example"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.collection_list.list_id",
          "value": "acme_outdoor_collections_v1"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.collection_list.agent_url",
          "value": "https://governance.pinnacle-agency.example"
        }
      ]
    },
    {
      "id": "plain-overlay-fields-echo",
      "description": "General SHOULD — seller echoes persisted plain overlay fields (geo_countries, frequency_cap, device_type) under packages[0].targeting_overlay. Exercises the non-specialism path that the inventory_list_targeting storyboard does not cover.",
      "payload": {
        "status": "completed",
        "media_buys": [
          {
            "media_buy_id": "mb_beverage_summer_042",
            "status": "active",
            "currency": "USD",
            "total_budget": 75000,
            "confirmed_at": "2026-05-20T09:15:00Z",
            "revision": 2,
            "start_time": "2026-06-01T00:00:00Z",
            "end_time": "2026-08-31T23:59:59Z",
            "created_at": "2026-05-20T09:15:00Z",
            "updated_at": "2026-06-02T14:22:00Z",
            "packages": [
              {
                "package_id": "pkg_beverage_ctv",
                "product_id": "prod_ctv_run_of_network",
                "budget": 75000,
                "currency": "USD",
                "start_time": "2026-06-01T00:00:00Z",
                "end_time": "2026-08-31T23:59:59Z",
                "targeting_overlay": {
                  "geo_countries": ["US", "CA"],
                  "device_type": ["ctv"],
                  "frequency_cap": {
                    "max_impressions": 3,
                    "per": "households",
                    "window": {
                      "interval": 7,
                      "unit": "days"
                    }
                  }
                }
              }
            ]
          }
        ]
      },
      "assertions": [
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_countries",
          "value": ["US", "CA"]
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.device_type",
          "value": ["ctv"]
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.frequency_cap.max_impressions",
          "value": 3
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.frequency_cap.per",
          "value": "households"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.frequency_cap.window.interval",
          "value": 7
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.frequency_cap.window.unit",
          "value": "days"
        }
      ]
    },
    {
      "id": "geo-place-targeting-echo",
      "description": "Place-targeting MUST — seller echoes persisted identifier-based geo_places and geo_places_exclude so the buyer can audit the catalog namespace, place type, values, and diagnostic labels that were applied.",
      "payload": {
        "status": "completed",
        "media_buys": [
          {
            "media_buy_id": "mb_nova_local_001",
            "status": "active",
            "currency": "EUR",
            "total_budget": 18000,
            "confirmed_at": "2026-07-01T09:00:00Z",
            "revision": 1,
            "start_time": "2026-07-15T00:00:00Z",
            "end_time": "2026-08-15T23:59:59Z",
            "created_at": "2026-07-01T09:00:00Z",
            "updated_at": "2026-07-15T10:30:00Z",
            "packages": [
              {
                "package_id": "pkg_nova_local_video",
                "product_id": "prod_local_video_nl",
                "budget": 18000,
                "currency": "EUR",
                "start_time": "2026-07-15T00:00:00Z",
                "end_time": "2026-08-15T23:59:59Z",
                "targeting_overlay": {
                  "geo_places": [{
                    "country": "NL",
                    "system": "geonames",
                    "system_version": "2026-05",
                    "place_type": "city",
                    "values": ["2759794"],
                    "value_labels": {
                      "2759794": "Amsterdam, North Holland, Netherlands"
                    }
                  }],
                  "geo_places_exclude": [{
                    "country": "NL",
                    "system": "geonames",
                    "system_version": "2026-05",
                    "place_type": "city",
                    "values": ["2747373"],
                    "value_labels": {
                      "2747373": "The Hague, South Holland, Netherlands"
                    }
                  }]
                }
              }
            ]
          }
        ]
      },
      "assertions": [
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_places[0].values",
          "value": ["2759794"]
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_places[0].country",
          "value": "NL"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_places[0].system",
          "value": "geonames"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_places[0].system_version",
          "value": "2026-05"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_places[0].place_type",
          "value": "city"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_places[0].value_labels.2759794",
          "value": "Amsterdam, North Holland, Netherlands"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.geo_places_exclude[0].values",
          "value": ["2747373"]
        }
      ]
    },
    {
      "id": "signal-targeting-groups-echo",
      "description": "General SHOULD — seller echoes grouped package-level signal_targeting_groups under packages[0].targeting_overlay so buyers can audit include/exclude signal composition.",
      "payload": {
        "status": "completed",
        "media_buys": [
          {
            "media_buy_id": "mb_retail_signal_groups_001",
            "status": "pending_start",
            "currency": "USD",
            "total_budget": 25000,
            "confirmed_at": "2026-08-15T10:00:00Z",
            "revision": 1,
            "start_time": "2026-09-01T00:00:00Z",
            "end_time": "2026-09-30T23:59:59Z",
            "created_at": "2026-08-15T10:00:00Z",
            "updated_at": "2026-08-15T10:00:00Z",
            "packages": [
              {
                "package_id": "pkg_retail_signal_groups_video",
                "product_id": "prod_retail_video_premium",
                "budget": 25000,
                "currency": "USD",
                "start_time": "2026-09-01T00:00:00Z",
                "end_time": "2026-09-30T23:59:59Z",
                "targeting_overlay": {
                  "signal_targeting_groups": {
                    "operator": "all",
                    "groups": [
                      {
                        "operator": "any",
                        "signals": [
                          {
                            "signal_ref": {
                              "scope": "product",
                              "signal_id": "high_intent_shoppers"
                            },
                            "value_type": "binary",
                            "value": true,
                            "pricing_option_id": "signal_cpm_usd_250",
                            "signal_agent_segment_id": "sig_high_intent_shoppers"
                          },
                          {
                            "signal_ref": {
                              "scope": "product",
                              "signal_id": "loyalty_members"
                            },
                            "value_type": "binary",
                            "value": true,
                            "pricing_option_id": "signal_cpm_usd_250",
                            "signal_agent_segment_id": "sig_loyalty_members"
                          }
                        ]
                      },
                      {
                        "operator": "none",
                        "signals": [
                          {
                            "signal_ref": {
                              "scope": "product",
                              "signal_id": "recent_purchasers"
                            },
                            "value_type": "binary",
                            "value": true,
                            "signal_agent_segment_id": "sig_recent_purchasers"
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      },
      "assertions": [
        {
          "path": "media_buys[0].packages[0].targeting_overlay.signal_targeting_groups.operator",
          "value": "all"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.signal_targeting_groups.groups[0].operator",
          "value": "any"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.signal_targeting_groups.groups[0].signals[1].signal_ref.signal_id",
          "value": "loyalty_members"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.signal_targeting_groups.groups[1].operator",
          "value": "none"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.signal_targeting_groups.groups[1].signals[0].signal_agent_segment_id",
          "value": "sig_recent_purchasers"
        }
      ]
    },
    {
      "id": "placement-selection-echo",
      "description": "Purchased-inventory targeting — seller echoes the committed publisher-scoped placement selection under packages[0].targeting_overlay; creative routing remains a separate package concern.",
      "payload": {
        "status": "completed",
        "media_buys": [
          {
            "media_buy_id": "mb_social_placement_001",
            "status": "active",
            "currency": "USD",
            "total_budget": 30000,
            "confirmed_at": "2026-08-01T10:00:00Z",
            "revision": 2,
            "start_time": "2026-08-01T10:00:00Z",
            "end_time": "2026-08-31T23:59:59Z",
            "created_at": "2026-08-01T10:00:00Z",
            "updated_at": "2026-08-03T12:00:00Z",
            "packages": [
              {
                "package_id": "pkg_social_placement_video",
                "product_id": "prod_configured_social_video_001",
                "budget": 30000,
                "currency": "USD",
                "start_time": "2026-08-01T10:00:00Z",
                "end_time": "2026-08-31T23:59:59Z",
                "targeting_overlay": {
                  "geo_countries": ["US"],
                  "placement_selection": {
                    "mode": "selected",
                    "placement_refs": [
                      {
                        "publisher_domain": "pinnacle-media.example",
                        "placement_id": "short_video"
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      },
      "assertions": [
        {
          "path": "media_buys[0].packages[0].targeting_overlay.placement_selection.mode",
          "value": "selected"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.placement_selection.placement_refs[0].publisher_domain",
          "value": "pinnacle-media.example"
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.placement_selection.placement_refs[0].placement_id",
          "value": "short_video"
        }
      ]
    },
    {
      "id": "demographic-targeting-exact-readback",
      "description": "AdCP 3.2 — seller echoes the applied canonical demographic predicate and lossless requested/applied continuous-bounds resolution.",
      "payload": {
        "status": "completed",
        "media_buys": [
          {
            "media_buy_id": "mb_acme_demographic_001",
            "status": "pending_start",
            "currency": "USD",
            "total_budget": 15000,
            "confirmed_at": "2026-09-01T10:00:00Z",
            "revision": 1,
            "start_time": "2026-10-01T00:00:00Z",
            "end_time": "2026-10-31T23:59:59Z",
            "created_at": "2026-09-01T10:00:00Z",
            "updated_at": "2026-09-01T10:00:00Z",
            "packages": [
              {
                "package_id": "pkg_acme_demographic_display",
                "product_id": "prod_demographic_continuous_display",
                "budget": 15000,
                "currency": "USD",
                "start_time": "2026-10-01T00:00:00Z",
                "end_time": "2026-10-31T23:59:59Z",
                "targeting_overlay": {
                  "demographics": {
                    "age": {
                      "min": 21,
                      "max": 35,
                      "include_unknown": false
                    }
                  }
                },
                "targeting_resolution": {
                  "demographics": {
                    "requested": {
                      "age": {
                        "min": 21,
                        "max": 35,
                        "include_unknown": false
                      }
                    },
                    "applied": {
                      "age": {
                        "min": 21,
                        "max": 35,
                        "include_unknown": false
                      }
                    },
                    "equivalent": true,
                    "execution": {
                      "type": "continuous_bounds"
                    }
                  }
                }
              }
            ]
          }
        ]
      },
      "assertions": [
        {
          "path": "media_buys[0].packages[0].targeting_overlay.demographics.age.min",
          "value": 21
        },
        {
          "path": "media_buys[0].packages[0].targeting_overlay.demographics.age.include_unknown",
          "value": false
        },
        {
          "path": "media_buys[0].packages[0].targeting_resolution.demographics.equivalent",
          "value": true
        },
        {
          "path": "media_buys[0].packages[0].targeting_resolution.demographics.execution.type",
          "value": "continuous_bounds"
        }
      ]
    }
  ]
}