adcp 2.18.0__py3-none-any.whl → 3.0.0__py3-none-any.whl

adcp/types/generated_poc/media_buy/package_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/package_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from typing import Annotated
 from adcp.types.base import AdCPBaseModel
 from pydantic import ConfigDict, Field
 
-from ..core import creative_asset
+from ..core import creative_asset, creative_assignment
 from ..core import ext as ext_1
 from ..core import format_id, targeting
 from ..enums import pacing as pacing_1
@@ -31,16 +31,16 @@ class PackageRequest(AdCPBaseModel):
         Field(description="Budget allocation for this package in the media buy's currency", ge=0.0),
     ]
     buyer_ref: Annotated[str, Field(description="Buyer's reference identifier for this package")]
-    creative_ids: Annotated[
-        list[str] | None,
+    creative_assignments: Annotated[
+        list[creative_assignment.CreativeAssignment] | None,
         Field(
-            description='Creative IDs to assign to this package at creation time (references existing library creatives)'
+            description='Assign existing library creatives to this package with optional weights and placement targeting'
         ),
     ] = None
     creatives: Annotated[
         list[creative_asset.CreativeAsset] | None,
         Field(
-            description='Full creative objects to upload and assign to this package at creation time (alternative to creative_ids - creatives will be added to library). Supports both static and generative creatives.',
+            description='Upload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.',
             max_length=100,
         ),
     ] = None
@@ -52,7 +52,16 @@ class PackageRequest(AdCPBaseModel):
             min_length=1,
         ),
     ] = None
+    impressions: Annotated[
+        float | None, Field(description='Impression goal for this package', ge=0.0)
+    ] = None
     pacing: pacing_1.Pacing | None = None
+    paused: Annotated[
+        bool | None,
+        Field(
+            description='Whether this package should be created in a paused state. Paused packages do not deliver impressions. Defaults to false.'
+        ),
+    ] = False
     pricing_option_id: Annotated[
         str,
         Field(

adcp/types/generated_poc/media_buy/package_update.py

@@ -0,0 +1,119 @@
+# generated by datamodel-codegen:
+#   filename:  media_buy/package_update.json
+#   timestamp: 2026-01-25T21:17:54+00:00
+
+from __future__ import annotations
+
+from typing import Annotated
+
+from adcp.types.base import AdCPBaseModel
+from pydantic import ConfigDict, Field, RootModel
+
+from ..core import creative_asset, creative_assignment
+from ..core import ext as ext_1
+from ..core import targeting
+from ..enums import pacing as pacing_1
+
+
+class PackageUpdate1(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='Replace creative assignments for this package with optional weights and placement targeting. Uses replacement semantics - omit to leave assignments unchanged.'
+        ),
+    ] = None
+    creatives: Annotated[
+        list[creative_asset.CreativeAsset] | None,
+        Field(
+            description='Upload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.',
+            max_length=100,
+        ),
+    ] = None
+    ext: ext_1.ExtensionObject | None = 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 PackageUpdate2(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='Replace creative assignments for this package with optional weights and placement targeting. Uses replacement semantics - omit to leave assignments unchanged.'
+        ),
+    ] = None
+    creatives: Annotated[
+        list[creative_asset.CreativeAsset] | None,
+        Field(
+            description='Upload new creative assets and assign to this package (creatives will be added to library). Use creative_assignments instead for existing library creatives.',
+            max_length=100,
+        ),
+    ] = None
+    ext: ext_1.ExtensionObject | None = 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
+
+
+class PackageUpdate(RootModel[PackageUpdate1 | PackageUpdate2]):
+    root: Annotated[
+        PackageUpdate1 | PackageUpdate2,
+        Field(
+            description='Package update configuration for update_media_buy. Identifies package by package_id or buyer_ref and specifies fields to modify. Fields not present are left unchanged. Note: product_id, format_ids, and pricing_option_id cannot be changed after creation.',
+            title='Package Update',
+        ),
+    ]

adcp/types/generated_poc/media_buy/provide_performance_feedback_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/provide_performance_feedback_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/media_buy/provide_performance_feedback_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/provide_performance_feedback_response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/media_buy/sync_creatives_async_response_input_required.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/sync_creatives_async_response_input_required.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/media_buy/sync_creatives_async_response_submitted.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/sync_creatives_async_response_submitted.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/media_buy/sync_creatives_async_response_working.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/sync_creatives_async_response_working.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/media_buy/sync_creatives_request.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/sync_creatives_request.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/media_buy/sync_creatives_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/sync_creatives_response.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

adcp/types/generated_poc/media_buy/update_media_buy_async_response_input_required.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  media_buy/update_media_buy_async_response_input_required.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 

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
 

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
 

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-08T19:25:24+00:00
+#   timestamp: 2026-01-25T21:17:54+00:00
 
 from __future__ import annotations
 
@@ -10,105 +10,11 @@ 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
-    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
-    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):
@@ -125,7 +31,7 @@ class UpdateMediaBuyRequest1(AdCPBaseModel):
     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,
@@ -134,18 +40,18 @@ class UpdateMediaBuyRequest1(AdCPBaseModel):
     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
 
 
-Packages2 = Packages
-
-
-Packages3 = Packages1
-
-
 class UpdateMediaBuyRequest2(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
@@ -160,7 +66,7 @@ class UpdateMediaBuyRequest2(AdCPBaseModel):
         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,
@@ -169,7 +75,13 @@ class UpdateMediaBuyRequest2(AdCPBaseModel):
     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

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
 

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,6 +10,19 @@ 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',
@@ -22,10 +35,20 @@ class CpcPricingOption(AdCPBaseModel):
             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(
@@ -33,11 +56,13 @@ class CpcPricingOption(AdCPBaseModel):
             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,6 +10,19 @@ 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',
@@ -22,10 +35,20 @@ class CpcvPricingOption(AdCPBaseModel):
             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(
@@ -33,13 +56,15 @@ class CpcvPricingOption(AdCPBaseModel):
             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)')
     ]
     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_auction_option.py → cpm_option.py}

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
-#   filename:  pricing_options/cpm_auction_option.json
-#   timestamp: 2026-01-08T19:25:24+00:00
+#   filename:  pricing_options/cpm_option.json
+#   timestamp: 2026-01-26T11:40:01+00:00
 
 from __future__ import annotations
 
@@ -11,19 +11,13 @@ from pydantic import ConfigDict, Field
 
 
 class PriceGuidance(AdCPBaseModel):
-    floor: Annotated[
-        float,
-        Field(
-            description='Minimum bid price - publisher will reject bids under this value', ge=0.0
-        ),
-    ]
     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 CpmAuctionPricingOption(AdCPBaseModel):
+class CpmPricingOption(AdCPBaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
@@ -35,10 +29,20 @@ class CpmAuctionPricingOption(AdCPBaseModel):
             pattern='^[A-Z]{3}$',
         ),
     ]
-    is_fixed: Annotated[
-        Literal[False],
-        Field(description='Whether this is a fixed rate (true) or auction-based (false)'),
-    ]
+    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(
@@ -47,12 +51,12 @@ class CpmAuctionPricingOption(AdCPBaseModel):
         ),
     ] = None
     price_guidance: Annotated[
-        PriceGuidance, Field(description='Pricing guidance for auction-based CPM bidding')
-    ]
-    pricing_model: Annotated[Literal['cpm'], Field(description='Cost per 1,000 impressions')]
-    pricing_option_id: Annotated[
-        str,
+        PriceGuidance | None,
         Field(
-            description="Unique identifier for this pricing option within the product (e.g., 'cpm_usd_auction')"
+            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')
     ]