@adcp/sdk 14.0.0-rc.37 → 14.0.0-rc.39

package/dist/lib/types/buy-products.d.ts

@@ -2618,6 +2618,20 @@ export interface TargetingCollectionList {
  */
 export type TargetingCollectionSelection = SelectedCollections | ProductDefaultCollections;
 
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
+
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
+
 /**
  * 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. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.
  */
@@ -2652,6 +2666,13 @@ export type TargetingFrequencyCap = {} & {
  */
 export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]];
 
+/**
+ * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
+
 /**
  * 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.
  *
@@ -2682,6 +2703,36 @@ export type TargetingKeywords = [
     }[]
 ];
 
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingKeywordsInput = [
+    {
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    },
+    ...{
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    }[]
+] | null;
+
 /**
  * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
  *
@@ -2689,6 +2740,13 @@ export type TargetingKeywords = [
  */
 export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
 
+/**
+ * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
+ *
+ * @minItems 1
+ */
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
+
 /**
  * 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.
  *
@@ -2696,6 +2754,13 @@ export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
  */
 export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]];
 
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
+
 /**
  * Concrete delivery constraints the buyer expects to carry into create_media_buy. Buyers SHOULD use this field instead of putting equivalent exact targeting only in brief prose. Sellers evaluate these constraints during discovery and scope returned pricing and forecasts to the effective targeting. If a product cannot honor the request exactly, the seller may omit it or return a request-scoped configured product with Product targeting_resolution modifications. Absence of Product targeting_resolution means exact acceptance of this structured overlay; it does not confirm how targeting in the brief was interpreted. On refine, presence is complete replacement state for returned configurations; when omitted, each referenced product's bound targeting remains in force.
  */
@@ -2938,7 +3003,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -2966,17 +3031,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 
 /**

package/dist/lib/types/control-media-buy.d.ts

@@ -1520,6 +1520,20 @@ export interface TargetingCollectionList {
  */
 export type TargetingCollectionSelection = SelectedCollections | ProductDefaultCollections;
 
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
+
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
+
 /**
  * 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. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.
  */
@@ -1552,14 +1566,14 @@ export type TargetingFrequencyCap = {} & {
  *
  * @minItems 1
  */
-export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]];
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
 
 /**
  * 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.
  *
  * @minItems 1
  */
-export type TargetingKeywords = [
+export type TargetingKeywordsInput = [
     {
         /**
          * The keyword to target
@@ -1582,21 +1596,21 @@ export type TargetingKeywords = [
          */
         bid_price?: number;
     }[]
-];
+] | null;
 
 /**
  * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
  *
  * @minItems 1
  */
-export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
 
 /**
  * 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.
  *
  * @minItems 1
  */
-export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]];
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
 
 /**
  * Per-dimension targeting input. Omission inherits the selected product's configured/default dimension, a non-null value replaces it, and null explicitly suppresses it. A clear cannot remove inherent product scope.
@@ -1606,7 +1620,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -1634,17 +1648,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 
 /**

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

@@ -4054,7 +4054,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -4082,17 +4082,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 /**
  * Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').
@@ -4123,7 +4123,7 @@ export type GeoRegionsExclude = [string, ...string[]];
  *
  * @minItems 1
  */
-export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]] | null;
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
 /**
  * Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.
  *
@@ -4409,12 +4409,24 @@ export type PlacementIdentity = PublisherCatalogPlacementIdentity | SellerInline
  * Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set.
  */
 export type TargetingCollectionSelection = SelectedCollections | ProductDefaultCollections;
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
 /**
  * Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.
  *
  * @minItems 1
  */
 export type DevicePlatformExclude = [DevicePlatform, ...DevicePlatform[]];
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
 /**
  * Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).
  *
@@ -4490,13 +4502,13 @@ export type GeoProximity = [
  *
  * @minItems 1
  */
-export type TargetingLanguages = [LanguageTag, ...LanguageTag[]] | null;
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
 /**
  * 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.
  *
  * @minItems 1
  */
-export type TargetingKeywords = [
+export type TargetingKeywordsInput = [
     {
         /**
          * The keyword to target
@@ -4525,7 +4537,7 @@ export type TargetingKeywords = [
  *
  * @minItems 1
  */
-export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]] | null;
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
 /**
  * Assignment of a creative asset to a package with optional rotation and placement routing. Used in create_media_buy and update_media_buy requests. Buyers identify the stored creative with `creative_id` only. A generic `id` alias, if present due to adapter-internal payload reuse, is not an AdCP identifier and sellers MUST ignore it on input. Note: sync_creatives does not support package rotation, placement_refs, or placement_ids - use create/update_media_buy for package-level trafficking controls.
  */
@@ -13862,6 +13874,53 @@ export type TargetingOverlay = TargetingUnknownAgeEligibilityConstraint & Target
     keyword_targets?: TargetingKeywords;
     negative_keywords?: TargetingNegativeKeywords;
 };
+/**
+ * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]];
+/**
+ * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
+ *
+ * @minItems 1
+ */
+export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingKeywords = [
+    {
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    },
+    ...{
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    }[]
+];
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]];
 /**
  * Canonical demographic predicate and exact seller execution details. Include whenever demographic targeting was requested or applied.
  */

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

@@ -4054,7 +4054,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -4082,17 +4082,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 /**
  * Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').
@@ -4123,7 +4123,7 @@ export type GeoRegionsExclude = [string, ...string[]];
  *
  * @minItems 1
  */
-export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]] | null;
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
 /**
  * Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.
  *
@@ -4409,12 +4409,24 @@ export type PlacementIdentity = PublisherCatalogPlacementIdentity | SellerInline
  * Purchased collection selection within the product. On create, mode selected supplies the complete selected set and mode default uses the product's full bundle. On package readback this is the committed selection sellers MUST echo as concrete selectors, materializing any collection_list composition; collection_list fields remain the buyer-managed list mechanism. In request-side Targeting Input, a non-null value replaces this dimension, omission preserves or inherits it, and null clears it when the product permits that broader inventory set.
  */
 export type TargetingCollectionSelection = SelectedCollections | ProductDefaultCollections;
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
 /**
  * Exclude specific operating-system platforms from delivery. When a platform appears in both device_platform and device_platform_exclude, exclusion wins. Sellers MUST reject a request they cannot enforce rather than silently dropping the exclusion.
  *
  * @minItems 1
  */
 export type DevicePlatformExclude = [DevicePlatform, ...DevicePlatform[]];
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
 /**
  * Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).
  *
@@ -4490,13 +4502,13 @@ export type GeoProximity = [
  *
  * @minItems 1
  */
-export type TargetingLanguages = [LanguageTag, ...LanguageTag[]] | null;
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
 /**
  * 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.
  *
  * @minItems 1
  */
-export type TargetingKeywords = [
+export type TargetingKeywordsInput = [
     {
         /**
          * The keyword to target
@@ -4525,7 +4537,7 @@ export type TargetingKeywords = [
  *
  * @minItems 1
  */
-export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]] | null;
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
 /**
  * Assignment of a creative asset to a package with optional rotation and placement routing. Used in create_media_buy and update_media_buy requests. Buyers identify the stored creative with `creative_id` only. A generic `id` alias, if present due to adapter-internal payload reuse, is not an AdCP identifier and sellers MUST ignore it on input. Note: sync_creatives does not support package rotation, placement_refs, or placement_ids - use create/update_media_buy for package-level trafficking controls.
  */
@@ -13862,6 +13874,53 @@ export type TargetingOverlay = TargetingUnknownAgeEligibilityConstraint & Target
     keyword_targets?: TargetingKeywords;
     negative_keywords?: TargetingNegativeKeywords;
 };
+/**
+ * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]];
+/**
+ * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
+ *
+ * @minItems 1
+ */
+export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingKeywords = [
+    {
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    },
+    ...{
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    }[]
+];
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]];
 /**
  * Canonical demographic predicate and exact seller execution details. Include whenever demographic targeting was requested or applied.
  */

package/dist/lib/types/create-media-buy.d.ts

@@ -11012,6 +11012,20 @@ export interface TargetingCollectionList {
  */
 export type TargetingCollectionSelection = SelectedCollections | ProductDefaultCollections;
 
+/**
+ * Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.
+ *
+ * @minItems 1
+ */
+export type TargetingDevicePlatformsInput = [DevicePlatform, ...DevicePlatform[]];
+
+/**
+ * Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).
+ *
+ * @minItems 1
+ */
+export type TargetingDeviceTypesInput = [DeviceType, ...DeviceType[]];
+
 /**
  * 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. Field location determines scope; this value has no scope discriminator. The MediaBuy root uses the narrower media-buy-frequency-cap schema, which permits maximum impressions only in 3.2.
  */
@@ -11046,6 +11060,13 @@ export type TargetingFrequencyCap = {} & {
  */
 export type TargetingGeoMetros = [GeoMetro, ...GeoMetro[]];
 
+/**
+ * Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.
+ *
+ * @minItems 1
+ */
+export type TargetingGeoMetrosInput = [GeoMetro, ...GeoMetro[]] | null;
+
 /**
  * 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.
  *
@@ -11076,6 +11097,36 @@ export type TargetingKeywords = [
     }[]
 ];
 
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingKeywordsInput = [
+    {
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    },
+    ...{
+        /**
+         * The keyword to target
+         */
+        keyword: string;
+        match_type: MatchType;
+        /**
+         * 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.
+         */
+        bid_price?: number;
+    }[]
+] | null;
+
 /**
  * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
  *
@@ -11083,6 +11134,13 @@ export type TargetingKeywords = [
  */
 export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
 
+/**
+ * Restrict to users with specific language preferences using canonical BCP 47 language ranges. Each buyer range is evaluated against a user's language-preference tag with RFC 4647 section 3.3.1 Basic Filtering: 'fr' matches 'fr', 'fr-CA', and 'fr-FR', while 'fr-CA' matches 'fr-CA' and more-specific descendants but not 'fr' or 'fr-FR'. Values use OR logic.
+ *
+ * @minItems 1
+ */
+export type TargetingLanguagesInput = [LanguageTag, ...LanguageTag[]] | null;
+
 /**
  * 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.
  *
@@ -11090,6 +11148,13 @@ export type TargetingLanguages = [LanguageTag, ...LanguageTag[]];
  */
 export type TargetingNegativeKeywords = [NegativeKeyword, ...NegativeKeyword[]];
 
+/**
+ * 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.
+ *
+ * @minItems 1
+ */
+export type TargetingNegativeKeywordsInput = [NegativeKeyword, ...NegativeKeyword[]] | null;
+
 /**
  * Concrete delivery constraints the buyer expects to carry into create_media_buy. Buyers SHOULD use this field instead of putting equivalent exact targeting only in brief prose. Sellers evaluate these constraints during discovery and scope returned pricing and forecasts to the effective targeting. If a product cannot honor the request exactly, the seller may omit it or return a request-scoped configured product with Product targeting_resolution modifications. Absence of Product targeting_resolution means exact acceptance of this structured overlay; it does not confirm how targeting in the brief was interpreted. On refine, presence is complete replacement state for returned configurations; when omitted, each referenced product's bound targeting remains in force.
  */
@@ -11332,7 +11397,7 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     geo_countries_exclude?: GeoCountriesExclude | null;
     geo_regions?: GeoRegions | null;
     geo_regions_exclude?: GeoRegionsExclude | null;
-    geo_metros?: TargetingGeoMetros;
+    geo_metros?: TargetingGeoMetrosInput;
     geo_metros_exclude?: GeoMetrosExclude | null;
     geo_postal_areas?: GeoPostalAreas | null;
     geo_postal_areas_exclude?: GeoPostalAreasExclude | null;
@@ -11360,17 +11425,17 @@ export type TargetingOverlayInput = TargetingUnknownAgeEligibilityConstraint & T
     placement_selection?: PlacementSelection | null;
     collection_selection?: TargetingCollectionSelection | null;
     age_restriction?: AgeRestriction | null;
-    device_platform?: [DevicePlatform, ...DevicePlatform[]] | null;
+    device_platform?: TargetingDevicePlatformsInput | null;
     device_platform_exclude?: DevicePlatformExclude | null;
-    device_type?: [DeviceType, ...DeviceType[]] | null;
+    device_type?: TargetingDeviceTypesInput | null;
     device_type_exclude?: DeviceTypeExclude | null;
     browser?: Browser | null;
     browser_exclude?: BrowserExclude | null;
     store_catchments?: StoreCatchments | null;
     geo_proximity?: GeoProximity | null;
-    language?: TargetingLanguages;
-    keyword_targets?: TargetingKeywords;
-    negative_keywords?: TargetingNegativeKeywords;
+    language?: TargetingLanguagesInput;
+    keyword_targets?: TargetingKeywordsInput;
+    negative_keywords?: TargetingNegativeKeywordsInput;
 };
 
 /**