adcp 2.19.0__py3-none-any.whl → 3.1.0__py3-none-any.whl

adcp/types/generated_poc/media_buy/update_media_buy_async_response_submitted.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/update_media_buy_async_response_submitted.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -13,7 +13,7 @@ from ..core import ext as ext_1
 
 class UpdateMediaBuySubmitted(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None

adcp/types/generated_poc/media_buy/update_media_buy_async_response_working.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/update_media_buy_async_response_working.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -15,17 +15,17 @@ from ..core import ext as ext_1
 
 class UpdateMediaBuyWorking(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = None
     current_step: Annotated[
-        str | None, Field(description="Current step or phase of the operation")
+        str | None, Field(description='Current step or phase of the operation')
     ] = None
     ext: ext_1.ExtensionObject | None = None
     percentage: Annotated[
-        float | None, Field(description="Completion percentage (0-100)", ge=0.0, le=100.0)
+        float | None, Field(description='Completion percentage (0-100)', ge=0.0, le=100.0)
     ] = None
-    step_number: Annotated[int | None, Field(description="Current step number", ge=1)] = None
+    step_number: Annotated[int | None, Field(description='Current step number', ge=1)] = None
     total_steps: Annotated[
-        int | None, Field(description="Total number of steps in the operation", ge=1)
+        int | None, Field(description='Total number of steps in the operation', ge=1)
     ] = None

adcp/types/generated_poc/media_buy/update_media_buy_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/update_media_buy_request.json
-#   timestamp: 2026-01-14T17:08:13+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -10,174 +10,78 @@ from adcp.types.base import AdCPBaseModel
 from pydantic import AwareDatetime, ConfigDict, Field, RootModel
 
 from ..core import context as context_1
-from ..core import creative_asset, creative_assignment
 from ..core import ext as ext_1
 from ..core import push_notification_config as push_notification_config_1
-from ..core import start_timing, targeting
-from ..enums import pacing as pacing_1
-
-
-class Packages(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra="allow",
-    )
-    bid_price: Annotated[
-        float | None,
-        Field(
-            description="Updated bid price for auction-based pricing options (only applies when pricing_option is auction-based)",
-            ge=0.0,
-        ),
-    ] = None
-    budget: Annotated[
-        float | None,
-        Field(
-            description="Updated budget allocation for this package in the currency specified by the pricing option",
-            ge=0.0,
-        ),
-    ] = None
-    buyer_ref: Annotated[
-        str | None, Field(description="Buyer's reference for the package to update")
-    ] = None
-    creative_assignments: Annotated[
-        list[creative_assignment.CreativeAssignment] | None,
-        Field(
-            description="Full creative assignment objects with weights and placement targeting (alternative to creative_ids - provides granular control over weights and placement targeting). Uses replacement semantics like creative_ids."
-        ),
-    ] = None
-    creative_ids: Annotated[
-        list[str] | None,
-        Field(description="Update creative assignments (references existing library creatives)"),
-    ] = None
-    creatives: Annotated[
-        list[creative_asset.CreativeAsset] | None,
-        Field(
-            description="Full creative objects to upload and assign to this package (alternative to creative_ids - creatives will be added to library). Supports both static and generative creatives.",
-            max_length=100,
-        ),
-    ] = None
-    impressions: Annotated[
-        float | None, Field(description="Updated impression goal for this package", ge=0.0)
-    ] = None
-    pacing: pacing_1.Pacing | None = None
-    package_id: Annotated[str, Field(description="Publisher's ID of package to update")]
-    paused: Annotated[
-        bool | None,
-        Field(description="Pause/resume specific package (true = paused, false = active)"),
-    ] = None
-    targeting_overlay: targeting.TargetingOverlay | None = None
-
-
-class Packages1(AdCPBaseModel):
-    model_config = ConfigDict(
-        extra="allow",
-    )
-    bid_price: Annotated[
-        float | None,
-        Field(
-            description="Updated bid price for auction-based pricing options (only applies when pricing_option is auction-based)",
-            ge=0.0,
-        ),
-    ] = None
-    budget: Annotated[
-        float | None,
-        Field(
-            description="Updated budget allocation for this package in the currency specified by the pricing option",
-            ge=0.0,
-        ),
-    ] = None
-    buyer_ref: Annotated[str, Field(description="Buyer's reference for the package to update")]
-    creative_assignments: Annotated[
-        list[creative_assignment.CreativeAssignment] | None,
-        Field(
-            description="Full creative assignment objects with weights and placement targeting (alternative to creative_ids - provides granular control over weights and placement targeting). Uses replacement semantics like creative_ids."
-        ),
-    ] = None
-    creative_ids: Annotated[
-        list[str] | None,
-        Field(description="Update creative assignments (references existing library creatives)"),
-    ] = None
-    creatives: Annotated[
-        list[creative_asset.CreativeAsset] | None,
-        Field(
-            description="Full creative objects to upload and assign to this package (alternative to creative_ids - creatives will be added to library). Supports both static and generative creatives.",
-            max_length=100,
-        ),
-    ] = None
-    impressions: Annotated[
-        float | None, Field(description="Updated impression goal for this package", ge=0.0)
-    ] = None
-    pacing: pacing_1.Pacing | None = None
-    package_id: Annotated[str | None, Field(description="Publisher's ID of package to update")] = (
-        None
-    )
-    paused: Annotated[
-        bool | None,
-        Field(description="Pause/resume specific package (true = paused, false = active)"),
-    ] = None
-    targeting_overlay: targeting.TargetingOverlay | None = None
+from ..core import reporting_webhook as reporting_webhook_1
+from ..core import start_timing
+from . import package_update
 
 
 class UpdateMediaBuyRequest1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     buyer_ref: Annotated[
         str | None, Field(description="Buyer's reference for the media buy to update")
     ] = None
     context: context_1.ContextObject | None = None
     end_time: Annotated[
-        AwareDatetime | None, Field(description="New end date/time in ISO 8601 format")
+        AwareDatetime | None, Field(description='New end date/time in ISO 8601 format')
     ] = None
     ext: ext_1.ExtensionObject | None = None
     media_buy_id: Annotated[str, Field(description="Publisher's ID of the media buy to update")]
     packages: Annotated[
-        list[Packages | Packages1] | None, Field(description="Package-specific updates")
+        list[package_update.PackageUpdate] | None, Field(description='Package-specific updates')
     ] = None
     paused: Annotated[
         bool | None,
-        Field(description="Pause/resume the entire media buy (true = paused, false = active)"),
+        Field(description='Pause/resume the entire media buy (true = paused, false = active)'),
     ] = None
     push_notification_config: Annotated[
         push_notification_config_1.PushNotificationConfig | None,
         Field(
-            description="Optional webhook configuration for async update notifications. Publisher will send webhook when update completes if operation takes longer than immediate response time."
+            description='Optional webhook configuration for async update notifications. Publisher will send webhook when update completes if operation takes longer than immediate response time. This is separate from reporting_webhook which configures ongoing campaign reporting.'
+        ),
+    ] = None
+    reporting_webhook: Annotated[
+        reporting_webhook_1.ReportingWebhook | None,
+        Field(
+            description='Optional webhook configuration for automated reporting delivery. Updates the reporting configuration for this media buy.'
         ),
     ] = None
     start_time: start_timing.StartTiming | None = None
 
 
-class Packages2(Packages):
-    pass
-
-
-class Packages3(Packages1):
-    pass
-
-
 class UpdateMediaBuyRequest2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     buyer_ref: Annotated[str, Field(description="Buyer's reference for the media buy to update")]
     context: context_1.ContextObject | None = None
     end_time: Annotated[
-        AwareDatetime | None, Field(description="New end date/time in ISO 8601 format")
+        AwareDatetime | None, Field(description='New end date/time in ISO 8601 format')
     ] = None
     ext: ext_1.ExtensionObject | None = None
     media_buy_id: Annotated[
         str | None, Field(description="Publisher's ID of the media buy to update")
     ] = None
     packages: Annotated[
-        list[Packages2 | Packages3] | None, Field(description="Package-specific updates")
+        list[package_update.PackageUpdate] | None, Field(description='Package-specific updates')
     ] = None
     paused: Annotated[
         bool | None,
-        Field(description="Pause/resume the entire media buy (true = paused, false = active)"),
+        Field(description='Pause/resume the entire media buy (true = paused, false = active)'),
     ] = None
     push_notification_config: Annotated[
         push_notification_config_1.PushNotificationConfig | None,
         Field(
-            description="Optional webhook configuration for async update notifications. Publisher will send webhook when update completes if operation takes longer than immediate response time."
+            description='Optional webhook configuration for async update notifications. Publisher will send webhook when update completes if operation takes longer than immediate response time. This is separate from reporting_webhook which configures ongoing campaign reporting.'
+        ),
+    ] = None
+    reporting_webhook: Annotated[
+        reporting_webhook_1.ReportingWebhook | None,
+        Field(
+            description='Optional webhook configuration for automated reporting delivery. Updates the reporting configuration for this media buy.'
         ),
     ] = None
     start_time: start_timing.StartTiming | None = None
@@ -187,7 +91,7 @@ class UpdateMediaBuyRequest(RootModel[UpdateMediaBuyRequest1 | UpdateMediaBuyReq
     root: Annotated[
         UpdateMediaBuyRequest1 | UpdateMediaBuyRequest2,
         Field(
-            description="Request parameters for updating campaign and package settings",
-            title="Update Media Buy Request",
+            description='Request parameters for updating campaign and package settings',
+            title='Update Media Buy Request',
         ),
     ]

adcp/types/generated_poc/media_buy/update_media_buy_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/update_media_buy_response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -17,30 +17,30 @@ from ..core import package
 
 class UpdateMediaBuyResponse2(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     context: context_1.ContextObject | None = None
     errors: Annotated[
         list[error.Error],
-        Field(description="Array of errors explaining why the operation failed", min_length=1),
+        Field(description='Array of errors explaining why the operation failed', min_length=1),
     ]
     ext: ext_1.ExtensionObject | None = None
 
 
 class UpdateMediaBuyResponse1(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     affected_packages: Annotated[
         list[package.Package] | None,
-        Field(description="Array of packages that were modified with complete state information"),
+        Field(description='Array of packages that were modified with complete state information'),
     ] = None
     buyer_ref: Annotated[str, Field(description="Buyer's reference identifier for the media buy")]
     context: context_1.ContextObject | None = None
     ext: ext_1.ExtensionObject | None = None
     implementation_date: Annotated[
         AwareDatetime | None,
-        Field(description="ISO 8601 timestamp when changes take effect (null if pending approval)"),
+        Field(description='ISO 8601 timestamp when changes take effect (null if pending approval)'),
     ] = None
     media_buy_id: Annotated[str, Field(description="Publisher's identifier for the media buy")]
 
@@ -49,7 +49,7 @@ class UpdateMediaBuyResponse(RootModel[UpdateMediaBuyResponse1 | UpdateMediaBuyR
     root: Annotated[
         UpdateMediaBuyResponse1 | UpdateMediaBuyResponse2,
         Field(
-            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.",
-            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.',
+            title='Update Media Buy Response',
         ),
     ]

adcp/types/generated_poc/pricing_options/cpc_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pricing_options/cpc_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -10,34 +10,59 @@ from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
 
+class PriceGuidance(AdCPBaseModel):
+    p25: Annotated[
+        float | None, Field(description='25th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p50: Annotated[float | None, Field(description='Median of recent winning bids', ge=0.0)] = None
+    p75: Annotated[
+        float | None, Field(description='75th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p90: Annotated[
+        float | None, Field(description='90th percentile of recent winning bids', ge=0.0)
+    ] = None
+
+
 class CpcPricingOption(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     currency: Annotated[
         str,
         Field(
-            description="ISO 4217 currency code",
-            examples=["USD", "EUR", "GBP", "JPY"],
-            pattern="^[A-Z]{3}$",
+            description='ISO 4217 currency code',
+            examples=['USD', 'EUR', 'GBP', 'JPY'],
+            pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[True],
-        Field(description="Whether this is a fixed rate (true) or auction-based (false)"),
-    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Fixed price per click. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
     min_spend_per_package: Annotated[
         float | None,
         Field(
-            description="Minimum spend requirement per package using this pricing option, in the specified currency",
+            description='Minimum spend requirement per package using this pricing option, in the specified currency',
             ge=0.0,
         ),
     ] = None
-    pricing_model: Annotated[Literal["cpc"], Field(description="Cost per click")]
-    pricing_option_id: Annotated[
-        str,
+    price_guidance: Annotated[
+        PriceGuidance | None,
         Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'cpc_usd_fixed')"
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
         ),
+    ] = None
+    pricing_model: Annotated[Literal['cpc'], Field(description='Cost per click')]
+    pricing_option_id: Annotated[
+        str, Field(description='Unique identifier for this pricing option within the product')
     ]
-    rate: Annotated[float, Field(description="Fixed CPC rate (cost per click)", ge=0.0)]

adcp/types/generated_poc/pricing_options/cpcv_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pricing_options/cpcv_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -10,36 +10,61 @@ from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
 
+class PriceGuidance(AdCPBaseModel):
+    p25: Annotated[
+        float | None, Field(description='25th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p50: Annotated[float | None, Field(description='Median of recent winning bids', ge=0.0)] = None
+    p75: Annotated[
+        float | None, Field(description='75th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p90: Annotated[
+        float | None, Field(description='90th percentile of recent winning bids', ge=0.0)
+    ] = None
+
+
 class CpcvPricingOption(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     currency: Annotated[
         str,
         Field(
-            description="ISO 4217 currency code",
-            examples=["USD", "EUR", "GBP", "JPY"],
-            pattern="^[A-Z]{3}$",
+            description='ISO 4217 currency code',
+            examples=['USD', 'EUR', 'GBP', 'JPY'],
+            pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[True],
-        Field(description="Whether this is a fixed rate (true) or auction-based (false)"),
-    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Fixed price per completed view. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
     min_spend_per_package: Annotated[
         float | None,
         Field(
-            description="Minimum spend requirement per package using this pricing option, in the specified currency",
+            description='Minimum spend requirement per package using this pricing option, in the specified currency',
             ge=0.0,
         ),
     ] = None
+    price_guidance: Annotated[
+        PriceGuidance | None,
+        Field(
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
+        ),
+    ] = None
     pricing_model: Annotated[
-        Literal["cpcv"], Field(description="Cost per completed view (100% completion)")
+        Literal['cpcv'], Field(description='Cost per completed view (100% completion)')
     ]
     pricing_option_id: Annotated[
-        str,
-        Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'cpcv_usd_guaranteed')"
-        ),
+        str, Field(description='Unique identifier for this pricing option within the product')
     ]
-    rate: Annotated[float, Field(description="Fixed CPCV rate (cost per 100% completion)", ge=0.0)]

adcp/types/generated_poc/pricing_options/cpm_option.py

@@ -0,0 +1,62 @@
+# generated by datamodel-codegen:
+#   filename:  pricing_options/cpm_option.json
+#   timestamp: 2026-01-26T11:40:01+00:00
+
+from __future__ import annotations
+
+from typing import Annotated, Literal
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field
+
+
+class PriceGuidance(AdCPBaseModel):
+    p25: Annotated[float | None, Field(description='25th percentile winning price', ge=0.0)] = None
+    p50: Annotated[float | None, Field(description='Median winning price', ge=0.0)] = None
+    p75: Annotated[float | None, Field(description='75th percentile winning price', ge=0.0)] = None
+    p90: Annotated[float | None, Field(description='90th percentile winning price', ge=0.0)] = None
+
+
+class CpmPricingOption(AdCPBaseModel):
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    currency: Annotated[
+        str,
+        Field(
+            description='ISO 4217 currency code',
+            examples=['USD', 'EUR', 'GBP', 'JPY'],
+            pattern='^[A-Z]{3}$',
+        ),
+    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Fixed price per unit. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
+    min_spend_per_package: Annotated[
+        float | None,
+        Field(
+            description='Minimum spend requirement per package using this pricing option, in the specified currency',
+            ge=0.0,
+        ),
+    ] = None
+    price_guidance: Annotated[
+        PriceGuidance | None,
+        Field(
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
+        ),
+    ] = None
+    pricing_model: Annotated[Literal['cpm'], Field(description='Cost per 1,000 impressions')]
+    pricing_option_id: Annotated[
+        str, Field(description='Unique identifier for this pricing option within the product')
+    ]

adcp/types/generated_poc/pricing_options/cpp_option.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pricing_options/cpp_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -12,53 +12,76 @@ from pydantic import ConfigDict, Field
 
 class Parameters(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     demographic: Annotated[
         str,
         Field(
-            description="Target demographic in Nielsen format: P/M/W/A/C + age range. Examples: P18-49 (Persons 18-49), M25-54 (Men 25-54), W35+ (Women 35+), A18-34 (Adults 18-34), C2-11 (Children 2-11)",
-            pattern="^[PMWAC][0-9]{2}(-[0-9]{2}|\\+)$",
+            description='Target demographic in Nielsen format (P18-49, M25-54, W35+, etc.)',
+            pattern='^[PMWAC][0-9]{2}(-[0-9]{2}|\\+)$',
         ),
     ]
-    min_points: Annotated[
-        float | None,
-        Field(description="Minimum GRPs/TRPs required for this pricing option", ge=0.0),
+    min_points: Annotated[float | None, Field(description='Minimum GRPs/TRPs required', ge=0.0)] = (
+        None
+    )
+
+
+class PriceGuidance(AdCPBaseModel):
+    p25: Annotated[
+        float | None, Field(description='25th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p50: Annotated[float | None, Field(description='Median of recent winning bids', ge=0.0)] = None
+    p75: Annotated[
+        float | None, Field(description='75th percentile of recent winning bids', ge=0.0)
+    ] = None
+    p90: Annotated[
+        float | None, Field(description='90th percentile of recent winning bids', ge=0.0)
     ] = None
 
 
 class CppPricingOption(AdCPBaseModel):
     model_config = ConfigDict(
-        extra="allow",
+        extra='allow',
     )
     currency: Annotated[
         str,
         Field(
-            description="ISO 4217 currency code",
-            examples=["USD", "EUR", "GBP", "JPY"],
-            pattern="^[A-Z]{3}$",
+            description='ISO 4217 currency code',
+            examples=['USD', 'EUR', 'GBP', 'JPY'],
+            pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[True],
-        Field(description="Whether this is a fixed rate (true) or auction-based (false)"),
-    ]
+    fixed_price: Annotated[
+        float | None,
+        Field(
+            description='Fixed price per rating point. If present, this is fixed pricing. If absent, auction-based.',
+            ge=0.0,
+        ),
+    ] = None
+    floor_price: Annotated[
+        float | None,
+        Field(
+            description='Minimum acceptable bid for auction pricing (mutually exclusive with fixed_price). Bids below this value will be rejected.',
+            ge=0.0,
+        ),
+    ] = None
     min_spend_per_package: Annotated[
         float | None,
         Field(
-            description="Minimum spend requirement per package using this pricing option, in the specified currency",
+            description='Minimum spend requirement per package using this pricing option, in the specified currency',
             ge=0.0,
         ),
     ] = None
     parameters: Annotated[
-        Parameters,
-        Field(description="CPP-specific parameters for demographic targeting and GRP requirements"),
+        Parameters, Field(description='CPP-specific parameters for demographic targeting')
     ]
-    pricing_model: Annotated[Literal["cpp"], Field(description="Cost per Gross Rating Point")]
-    pricing_option_id: Annotated[
-        str,
+    price_guidance: Annotated[
+        PriceGuidance | None,
         Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'cpp_usd_p18-49')"
+            description='Optional pricing guidance for auction-based bidding. Helps buyers calibrate bids with historical percentiles.'
         ),
+    ] = None
+    pricing_model: Annotated[Literal['cpp'], Field(description='Cost per Gross Rating Point')]
+    pricing_option_id: Annotated[
+        str, Field(description='Unique identifier for this pricing option within the product')
     ]
-    rate: Annotated[float, Field(description="Fixed CPP rate (cost per rating point)", ge=0.0)]